SimpleScripting — JavaScript Mods for Hytale Servers

Write server mods in JavaScript. No Java required.

SimpleScripting lets you create powerful server-side mods using simple JavaScript — the same language used on millions of websites. Each mod runs in its own safe sandbox, so you can install, update, and remove mods without worrying about conflicts.

Full documentation, guides, and tutorials: wiki.hosttale.com

Join to our discord if any issue or help needed: Discord

Source Code: HostTale-Project/SimpleScripting

---

Why SimpleScripting?

Easy to learn	Write mods in JavaScript — no Java, no compiling, no complex setup.
Safe by design	Every mod runs in its own isolated environment. One mod crashing won't take down others or your server.
Hot reload	Edit your mod, reload in-game — see changes instantly without restarting the server.
Batteries included	Ready-to-use APIs for players, worlds, commands, events, chat, UI, economy, and more.
Starter examples	Ships with 4 fully working example mods to learn from and customize.

---

How It Works

1. Drop the plugin into your server's plugins folder and start the server.
2. Mods live in mods/SimpleScripting/mods-js/ — each mod is a folder with a mod.json config and a main.js script.
3. The plugin automatically loads, validates, and runs each mod in its own sandbox.
4. Edit files and reload in-game — no server restart needed.

For detailed setup instructions and mod creation guides, visit the official wiki.

---

What Can You Build?

Almost anything that runs on the server side:

• Custom commands (/home, /warp, /stats, /shop, etc.)
• Player join/leave messages and welcome kits
• AFK detection and idle player management
• Economy systems with shops and trading
• Stat tracking and leaderboards
• Teleportation and home systems
• Timed events and scheduled tasks
• Cross-mod APIs so your mods can work together
• …and much more!

---

Commands

Plugin Commands

Command	Description
/createmod <mod-id>	Creates a new mod folder with all starter files ready to go
/updatetypes <mod-id>	Updates type definitions for editor autocomplete support

Example Mod Commands

The bundled example mods add these commands (when enabled):

Command	Mod	Description
/playtime	Welcome Rewards	Check your total playtime
/online	Welcome Rewards	See who's currently online
/sethome	Home & Warps	Save your current location as home
/home	Home & Warps	Teleport back to your saved home
/warp	Home & Warps	Teleport to a server warp point
/afk	AFK Manager	Toggle your AFK status
/afklist	AFK Manager	See which players are currently idle
/stats	Simple Stats	View your player statistics
/top	Simple Stats	View server-wide leaderboards

---

Bundled Example Mods

SimpleScripting comes with 4 complete example mods installed on first run — disabled by default so you choose which ones to activate. To enable one, open its mod.json and set "enabled": true.

Welcome Rewards

A complete welcome system: starter kits for new players, join/leave broadcast messages, and playtime tracking.

Home & Warps

Full teleportation system with personal player homes and server-wide warp points.

AFK Manager

Automatically detects idle players with configurable timeouts. Players can also manually toggle AFK status.

Simple Stats

Tracks player statistics and displays them with leaderboards and rankings.

---

What Mod Authors Can Do

SimpleScripting gives mod authors a rich set of capabilities — no Java imports needed:

Capability	What it does
Commands	Register custom commands with descriptions and permissions
Events	React to player actions, chat messages, block breaks, server boot, and more
Players	Find players, send messages, kick, check online status
Worlds	List worlds, find players in a world, broadcast messages
Scheduling	Run delayed or repeating tasks
UI	Build colored and styled chat messages
Economy	Manage player balances, deposits, and withdrawals (requires economy plugin)
Logging	Print info, warnings, and errors to the server console
Modules	Split your mod into multiple files for better organization
Shared Services	Expose APIs that other mods can use, enabling cross-mod collaboration

---

Extension Support

Other Hytale plugins can extend SimpleScripting with new capabilities — adding custom APIs, type definitions, and example mods that integrate seamlessly. For example, the EconomySS extension adds a full economy API with a player shops example.

---

Key Features at a Glance

• Per-mod sandboxing — mods can't interfere with each other
• Automatic cleanup — disabling a mod unregisters all its commands, events, and tasks
• Dependency ordering — declare which mods must load first
• Live reload — update mods without restarting the server
• Editor support — TypeScript definitions provide autocomplete and inline docs
• Actionable errors — clear messages tell you exactly what's wrong and how to fix it

---

Requirements

• A Hytale dedicated server
• No additional dependencies (economy features require an economy plugin like VaultUnlocked or EliteEssentials)

---

Documentation & Guides · Made with care for the Hytale modding community.