NekoJS - Modern Minecraft Scripting Engine
A powerful, fast, and elegant Minecraft modding engine powered by NeoForge and GraalVM.
NekoJS is a next-generation Minecraft scripting runtime that goes beyond simple JavaScript execution. It provides pack makers and mod developers with an exceptional development experience that rivals modern frontend engineering.
Core Features
High-Performance Engine
- GraalVM Powered: Blazing-fast execution speeds.
- Modern Standards: Full support for modern ECMAScript.
- Legacy-Free: Say goodbye to outdated Rhino or Nashorn engines.
TypeScript and JSX Support (NekoSWC)
- Write .ts and .tsx files directly.
- Zero-Config: No complex build pipeline configuration needed.
Modern Module System
- CommonJS Support: Full require() and module.exports support.
- Node-style Resolution: Native Node.js module resolution logic.
- NPM Integration: Use npm to install pure JavaScript libraries directly into your nekojs folder.
Quick Start
1. Write a Module (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 Logic with Events (main.ts)
// server_scripts/main.ts
const { calculateDamage, MOD_NAME } = require('./utils.ts');
console.log(`[${MOD_NAME}] Loading custom logic...`);
ServerEvents.tickPre(event => {
// Your tick logic here
});
In-Game Tools
Built-in Code Editor
- Integrated IDE: Full-featured code editor accessible within Minecraft.
- Developer Friendly: Syntax highlighting and real-time error tracking with stack traces.
- File Management: Built-in file browser.
Ecosystem Extensions
- NekoSWC: Unlocks full TypeScript and JSX/TSX capabilities with a Rust-powered compilation engine for millisecond-level transpilation.
- NekoProbe: Provides type declarations for IDE intelligent code completion and an enhanced development experience.
Requirements
- Minecraft: 1.21.1+
- NeoForge: 26.1.2+
- Graal Mod: Download Here (Required dependency)
Contributing
NekoJS is actively developed! We welcome bug reports, feature suggestions, and pull requests.
Transform your Minecraft experience with the power of modern JavaScript.
