
NativeLoader
一个Fabric模组,允许你使用原生代码(如C++、C# NativeAOT)通过JNA和JNI来修改游戏。
English
NativeLoader 是一个兼容层 Fabric 模组,旨在通过除 Java、Kotlin 以外的、可编译为原生代码的其他语言来修改游戏内容。它通过 JNI 和 JNA 与原生代码交互,既赋予原生代码足够的灵活性,又尽可能减少性能开销。
使用
NativeLoader 本身只负责调用原生代码并提供包装类,并不会修改游戏内容。你需要使用其他能够编译为原生代码的语言,并将其发布为 dll/so/dylib,才能真正修改游戏。
编写代码时通常需要使用第三方库,这样可以避免用户直接与 JNI 交互而导致 Invalid Memory Access。
尽管这不是必需的,但我们建议其他语言的库提供相应的 Java 类绑定,以尽可能提供与 Java 相似的编程体验。
目前可用的库有 Mliybs.Minecraft.Fabric,用于 C# NativeAOT。
加载你的代码
假设你已经制作好了一个 dll,你需要在游戏目录下的 nativepacks 文件夹(若不存在,游戏在开始运行时会自动创建)中创建一个合法的资源包,并在 assets/任意命名空间 ID/natives/ 目录中放置你的 dll,例如:

需要注意的是,路径和文件名必须是合法的标识符,只能包含小写字母、数字,以及 ,.-_ 几个字符。
完成后,启动游戏,游戏就会自动加载所有命名空间中 natives 路径下的所有 dll/so/dylib(资源包也会被强制加载)。
如果你的 dll 中包含修改游戏的代码,你应该就能在游戏中看到它的更改了。
如果你的 dll 来自其他人,请确保它是安全的。
附言
NativeLoader 目前仍处于开发阶段,但基本功能已完成。
我们预计将来 Mixin 不太可能添加支持,但 Java 中的反射不受此限制(可直接通过 JNI 函数进行调用)。
NativeLoader 需要更多人来帮助完善,欢迎所有人的贡献!
简体中文
NativeLoader是一个兼容层Fabric Mod,旨在通过除Java Kotlin以外的能编译成原生代码的其他语言修改游戏内容。它通过JNI和JNA与原生代码交互,不仅给了原生代码足够的灵活程度还尽可能减少了性能开销。
使用
NativeLoader本身只负责调用本机的原生代码以及提供包装类,并不会修改游戏内容,你需要使用其他能够编译成原生代码的语言并将它们发布成dll/so/dylib才能真正修改游戏
在编写代码的时候往往需要使用第三方库,这能够避免让用户直接与JNI交互导致Invalid Memory Access
尽管这不是必要的,但我们建议其他语言的库提供相对应的Java类绑定,尽力提供与Java相似的编程体验
目前的可用库有 Mliybs.Minecraft.Fabric,用于C# NativeAOT
调用你的代码
假设你已经制作好了一个dll,你需要在游戏目录下的nativepacks文件夹(若不存在则游戏在开始运行时会自动创建)中创建一个合法的资源包(这个资源包后续也会用来存放资源),在assets/任意命名空间ID/natives/目录中放置你的dll,例如:

需要注意的是,路径和文件名必须是合法的标识符,只能包含小写字母,数字,以及,.-_几个字符
完成后,启动游戏,游戏就会自动加载所有命名空间中natives路径下的所有dll/so/dylib(资源包也会被强制加载)
如果你的dll中包含了修改游戏的代码,你应该就能在游戏中看到它的更改了
如果你的dll来自其他人,请确保它是安全的
附言
NativeLoader目前还处于开发阶段,但基本功能已完成
我们预计将来Mixin不太可能添加支持,但Java中的反射不受此限制(直接通过JNI函数进行调用)
NativeLoader需要更多人来帮助完善,欢迎所有人的贡献!
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。