NekoJS

NekoJS - 现代 Minecraft 脚本引擎

一款由 NeoForge 和 GraalVM 驱动的强大、快速且优雅的 Minecraft 模组引擎。

NekoJS 是下一代 Minecraft 脚本运行时，超越了简单的 JavaScript 执行。它为包制作者和模组开发者提供了可媲美现代前端工程的卓越开发体验。

---

核心特性

高性能引擎

• GraalVM 驱动：极速执行速度。
• 现代标准：完全支持现代 ECMAScript。
• 无遗留负担：告别过时的 Rhino 或 Nashorn 引擎。

TypeScript 和 JSX 支持 (NekoSWC)

• 直接编写 .ts 和 .tsx 文件。
• 零配置：无需复杂的构建流水线配置。

现代模块系统

• CommonJS 支持：完整的 require() 和 module.exports 支持。
• Node 风格解析：原生 Node.js 模块解析逻辑。
• NPM 集成：使用 npm 直接将纯 JavaScript 库安装到你的 nekojs 文件夹中。

---

快速入门

1. 编写一个模块 (utils.ts)

// server_scripts/utils.ts
function calculateDamage(base: number, multiplier: number): number {
    return base * multiplier;
}
const MOD_NAME: string = "NekoJS";
module.exports = {
    calculateDamage,
    MOD_NAME
};

2. 使用事件实现主逻辑 (main.ts)

// server_scripts/main.ts
const { calculateDamage, MOD_NAME } = require('./utils.ts');
console.log([${MOD_NAME}] 加载自定义逻辑...);
ServerEvents.tickPre(event => {
    // 在此处编写你的 tick 逻辑
});

---

游戏内工具

内置代码编辑器

• 集成 IDE：可在 Minecraft 内访问的功能齐全的代码编辑器。
• 开发者友好：语法高亮和带有堆栈跟踪的实时错误提示。
• 文件管理：内置文件浏览器。

---

生态扩展

• NekoSWC：通过 Rust 驱动的编译引擎解锁完整的 TypeScript 和 JSX/TSX 功能，实现毫秒级转译。
• NekoProbe：为 IDE 智能代码补全和增强的开发体验提供类型声明。

---

环境要求

• Minecraft: 1.21.1+
• NeoForge: 26.1.2+
• Graal 模组：在此下载（必需依赖）

---

贡献

NekoJS 正在积极开发中！我们欢迎错误报告、功能建议和拉取请求。

• Discord：加入我们的社区
• GitHub：报告问题

---

借助现代 JavaScript 的力量，改变你的 Minecraft 体验。