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.

• Discord: Join our community
• GitHub: Report Issues

Transform your Minecraft experience with the power of modern JavaScript.