Reflectors — внеочередной способ немного похукать

Reflectors — внеочередной способ немного похукать v1

Нет прав для скачивания
Версия(и) Minecraft
1.7+
Reflectors
Библиотека, позволяющая легко заменять методы классов.
Сама по себе библиотека состоит из одного класса, что позволяет просто встраивать её в свой небольшой мод.

Как пользоваться?
Для начала, скачиваем класс и помещаем его в свой проект.
Также можно воспользоваться shade'дингом с репозитория jitpack.io.
build.gradle:
// Добавляем репозиторий jitpack в свои
repositories {
    maven {
        name 'jitpack'
        url 'https://jitpack.io'
    }
}

// Простая реализация shade'динга (включения зависимостей с
// указанной конфигурацией (shade) в jar мода
configurations {
    shade

    compile.extendsFrom(shade)
}

jar {
    configurations.shade.each { dep ->
        from project.zipTree(dep)
    }
}

// Shade'им библиотеку
dependencies {
    // Подставляем выбранную версию (начиная от v1 включительно)
    shade "com.github.MJaroslav.Reflectors:library:%VERSION%"
}

Также для работы в обфусцированной среде требуется добавить ваши маппинги методов в корень ресурсов проекта (methods.csv или methods.txt, во втором случае формат строк маппингов такой: srg,map для каждого метода).

Создаем свой FMLLoadingPlugin:
Java:
package com.github.mjaroslav.reflectors.example;

import com.github.mjaroslav.reflectors.example.reflector.BlockStoneReflector;
import com.github.mjaroslav.reflectors.v1.Reflectors;
import cpw.mods.fml.relauncher.IFMLLoadingPlugin;
import net.minecraft.launchwrapper.IClassTransformer;

@IFMLLoadingPlugin.MCVersion("1.7.10")
// Эта аннотация требуется для работы плагина в среде SRG имён
@IFMLLoadingPlugin.SortingIndex(1001)
@IFMLLoadingPlugin.Name("ReflectorsExamplePlugin")
// Можно воспользоваться встроенным адаптером, который также
// выставляет поле Reflections.obfuscated.
// В противном случае вы должны определять его сами
public class ReflectorsExamplePlugin extends Reflectors.FMLLoadingPluginAdapter
        implements IFMLLoadingPlugin, IClassTransformer {
    public ReflectorsExamplePlugin() {
        // Включаем логирование библиотеки (необязательно)
        Reflectors.enabledLogs = true;
    }

    @Override
    public String[] getASMTransformerClass() {
        // Для удобства, будем использовать в качестве трансформера
        // этот же класс
        return new String[]{getClass().getName()};
    }

    @Override
    public byte[] transform(String name, String transformedName, byte[] basicClass) {
        // Давайте применим рефлекторы к блоку камня.
        if (transformedName.equals("net.minecraft.block.BlockStone"))
            // Достаточно просто вызвать этот метод и указать класс-рефлектор.
            return Reflectors.reflectClass(basicClass, transformedName, BlockStoneReflector.class.getName());
        return basicClass;
    }
}

Создаем сам рефлектор:
Java:
package com.github.mjaroslav.reflectors.example.reflector;

import net.minecraft.block.BlockStone;
import net.minecraft.init.Items;
import net.minecraft.item.Item;
import java.util.Random;

// Все оригинальные методы будут заменены соответствующими методами из
// этого класса-рефлектора. Но заменить можно (на данный момент) только
// декларированные методы целевого класса
// Все методы-рефлекторы должны быть public static
public class BlockStoneReflector {
    // У всех методов-рефлекторов нестатичных методов должен быть объект
    // целевого класса в качестве первого аргумента
    public static Item getItemDropped(BlockStone instance, int meta, Random rand, int fortune) {
        // В качестве примера, заменим дроп камня с булыжника на алмаз
        return Items.diamond;
    }
}

Вот и всё, не забудьте добавить ваш FMLLoadingPlugin в манифест или аргументы запуска:

Добавление в манифест:
build.gradle:
jar {
    manifest {
        attributes "FMLCorePlugin": "com.github.mjaroslav.reflectors.example.ReflectorsExamplePlugin"
        // Требуется для загрузки вместе с обычными модами
        attributes "FMLCorePluginContainsFMLMod": "true"
    }
}

Добавление в аргументы запуска: -Dfml.coreMods.load=com.github.mjaroslav.reflectors.example.ReflectorsExamplePlugin

Этот же пример можно найти в подпроекте example


(Замечания и правки приветствуются)​
  • Like
Реакции: Gunirs и tox1cozZ
Автор
MJaroslav
Скачивания
8
Просмотры
943
Первый выпуск
Обновление
Оценка
0.00 звёзд 0 оценок

Другие ресурсы пользователя MJaroslav

  • Bon2Gradle
    Bon2Gradle
    Плагин для Minecraft проектов, что позволяет использовать BON2 как аналог fg.reobf из ForgeGradle.
  • MCInGameTester
    Движок для тестов, которые требуют загруженный Minecraft.
  • BookStealer
    BookStealer
    Клиентский мод для сохранения контента книг.
  • Train Diesel Fix
    Train Diesel Fix
    Совместимость топлива Traincraft с Immersive Engineering (и, теперь, с Arcane Engineering).
  • AngrySun
    AngrySun
    Вы будете гореть под Солнцем!
Сверху