
雨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 系统
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。