RainAPI

RainJava API

Продвинутый фреймворк для трансформации классов во время выполнения

Фундаментальная библиотека, предоставляющая слои совместимости Mixin и Coremod, работающая на базе корпоративных инструментов байт-кода и компиляции.

Обзор

RainJava API создаёт критическую инфраструктуру для конвейеров трансформации классов во время выполнения. Он служит мостом-посредником между рабочими процессами динамической компиляции и стандартными системами модификации Minecraft (Mixin и Coremod), обеспечивая совместимость на уровне байт-кода без ущерба для стабильности игры.

Хотя API задуман как обязательная основа для будущей экосистемы RainJava, он функционирует независимо как надёжный набор инструментов для разработчиков, которым требуются глубокие возможности манипуляции классами.

Встроенные библиотеки

Этот мод поставляется с версиями отраслевых стандартных инструментов, не требующими внешних зависимостей:

• Javassist — высокоуровневая библиотека манипуляции байт-кодом для инженерии классов во время выполнения

• ECJ (Eclipse Compiler for Java) — полнофункциональный компилятор Java, способный преобразовывать исходный код в байт-код во время выполнения

• JavaParser — фреймворк анализа абстрактного синтаксического дерева (AST) и генерации кода

Эти библиотеки затенены и изолированы во избежание конфликтов с другими модами.

Технический охват

• Мост трансформации — обеспечивает связь между определениями классов, сгенерированными во время выполнения, и устоявшимися фреймворками модификации байт-кода

• Слой совместимости Mixin — позволяет стандартизированным шаблонам инъекций распознавать и обрабатывать динамически предоставляемые классы

• Интеграция с Coremod — предоставляет стабильные хуки для определений классов во время выполнения, позволяя им участвовать в цепочке трансформации Forge

• Изолированное выполнение — реализует границы безопасности для сред оценки кода во время выполнения

Для моддеров

Установите этот API, если вы:

• Планируете разрабатывать для будущего фреймворка RainJava или использовать его

• Нуждаетесь во встроенных Javassist/ECJ/JavaParser без необходимости включать их самостоятельно

• Нуждаетесь в стабильной совместимости Mixin/Coremod для продвинутых операций с байт-кодом