雨Java

雨Java

支持 Mixin 注入和 ASM 转换的运行时 Java 编译器

RainJava

在 Minecraft 中编写 Java 代码。即时重载。无需重启。

RainJava 是一个强大的游戏内脚本模组,将完整的 Java 语言引入 Minecraft。你可以在游戏运行时编写、编译并执行 Java 代码——修改行为、注入方法、转换字节码,并立即看到变更效果,无需重启。


你可以做什么

实时编码

创建在启动时、服务器启动时或客户端启动阶段执行的 Java 脚本。用任意文本编辑器编辑代码,保存文件,然后使用 /java reload 立即应用更改。内置的 Eclipse 编译器会自动处理一切,即使你的系统未安装 Java 编译器。

Mixin 注入

直接以源码形式编写 Mixin 类,将代码注入任意 Minecraft 方法。使用 @Inject.At("HEAD") 定位方法开头,使用 "RETURN" 捕获返回点,或使用 "TAIL" 拦截最终退出。所有游戏类均可修改,并支持完整的 IDE 风格自动补全。

CoreMod 与 ASM 转换

对于深度修改,编写 CoreMod 插件,在 JVM 看到原始字节码之前对其进行转换。访问任意已加载类的每条指令、字段和方法。这与传统 Forge coremod 的能力级别相同,但可通过按需编译的简单 Java 源文件访问。

资源与数据包

在你的 RainJava 项目中直接打包自定义纹理、模型、声音、配方、战利品表和标签。assets/ 和 data/ 文件夹的工作方式与标准资源包和数据包完全一致,会随脚本自动加载。


工作原理

将 Java 源文件放入 Minecraft 目录下的 RainJava/ 文件夹。文件夹结构决定代码何时运行:

  • startup/ — 游戏初始化时执行一次

  • server/ — 每次服务器启动时执行

  • client/ — 客户端启动阶段执行

  • mixins/ — 用于运行时方法注入的 Mixin 类

  • coremod/ — CoreMod 插件与 ASM 转换器

每个脚本都声明一个简单的 init() 方法。框架会自动发现、编译并执行。错误会显示在专用日志文件和游戏内聊天中,可通过 /java errors 命令查看。


必备文档

每次安装都会在 RainJava/ 文件夹中包含一份详尽的 README.txt。该文件包含包声明、Mixin 语法、注入点、CoreMod 架构、可用命令和故障排除的完整参考资料——全部可离线使用,无需互联网访问。

README 会随每个版本更新,以反映当前 API 行为和受支持的功能。遇到语法问题、错误消息或高级用法模式时,请优先查阅它。


命令

  • /java reload [startup|server|client] — 无需重启即可热重载脚本

  • /java hand getId — 显示手持物品的注册表 ID

  • /java hand getClass — 显示手持物品的 Java 类名

  • /java errors [type] — 在聊天中显示编译与运行时错误


要求

  • Minecraft 1.20.1 与 Forge

  • Java 17 或更高版本

  • 兼容标准 Forge 模组与 Mixin 系统