SimpleScripting for Hytale - JavaScript Mod Development Framework

Pre-Release Version

This documentation is for the pre-release version of SimpleScripting. The plugin is currently only available for download from GitHub:

Download SimpleScripting on GitHub

SimpleScripting is a server-side scripting framework for Hytale that allows developers to create mods using JavaScript instead of Java.

It is designed to lower the barrier of entry for server modding, enable fast iteration without recompilation, and preserve full compatibility with Hytale’s native modding and asset pipeline.

SimpleScripting runs JavaScript mods alongside native Hytale mods and focuses on server-side logic, rules, automation, and mod interoperability.

What SimpleScripting Is

SimpleScripting provides:

• A JavaScript execution layer embedded into the Hytale server
• A mod loader and lifecycle manager for JavaScript-based mods
• A safe interoperability layer between JavaScript mods

JavaScript Runtime API

SimpleScripting wraps native Hytale classes with safe JavaScript facades for events, commands, players, worlds, tasks, networking, UI, module loading, shared services, and per-mod databases. If you need deeper native behavior, extend these wrappers in Java instead of passing raw objects into scripts.

See the API Overview for the full surface and examples.

What SimpleScripting Is Not

Caution

SimpleScripting is not:

• A replacement for native Hytale mods
• A system for defining assets (blocks, items, models, UI)
• A client-side scripting solution

Assets must always be defined in native Hytale mods.

Current Feature Set

• JavaScript mod discovery and loading
• Strict mod manifests (mod.json)
• Validated mod lifecycle hooks
• Deterministic dependency-based load order
• Cross-mod APIs via Shared Services

Documentation Scope

This documentation covers only implemented functionality. Future features will be documented once finalized and released.

Getting Started with SimpleScripting

Ready to start building JavaScript mods?

1. Installation Guide - Set up SimpleScripting on your server
2. Folder Structure - Understand the mod directory layout
3. Mod Layout - Learn the structure of a JavaScript mod
4. API Overview - Explore the runtime API

Related Documentation

• JavaScript API Overview - Complete API reference
• Events & Commands - Handle game events and create commands
• Inventory & Items - ItemStack APIs and planned inventory management
• Database API - Persist data with SQLite
• ECS for SimpleScripting - Work with the Entity Component System
• Current Limitations - Understand design constraints

---

Last updated: February 2026