NativeLoader

NativeLoader

一个Fabric模组,允许你使用原生代码(如C++、C# NativeAOT)通过JNA和JNI来修改游戏。

游戏机制

English|简体中文

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,例如:

dll example

需要注意的是,路径和文件名必须是合法的标识符,只能包含小写字母、数字,以及 ,.-_ 几个字符。

完成后,启动游戏,游戏就会自动加载所有命名空间中 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,例如:

dll example

需要注意的是,路径和文件名必须是合法的标识符,只能包含小写字母,数字,以及,.-_几个字符

完成后,启动游戏,游戏就会自动加载所有命名空间中natives路径下的所有dll/so/dylib(资源包也会被强制加载)

如果你的dll中包含了修改游戏的代码,你应该就能在游戏中看到它的更改了

如果你的dll来自其他人,请确保它是安全的

附言

NativeLoader目前还处于开发阶段,但基本功能已完成

我们预计将来Mixin不太可能添加支持,但Java中的反射不受此限制(直接通过JNI函数进行调用)

NativeLoader需要更多人来帮助完善,欢迎所有人的贡献!