JavaScript API Overview
SimpleScripting exposes Hytale server capabilities through safe JavaScript facades. Native classes stay private; mods interact with wrappers that enforce isolation and predictable behavior.
Wrapper Map
Section titled “Wrapper Map”Each wrapper sits on top of a native system:
events→com.hypixel.hytale.event.EventRegistry+ event classescommands→CommandRegistry,CommandContextplayers/PlayerHandle→PlayerRef(not exposed directly)worlds/WorldHandle→Worldserver→HytaleServer,TaskRegistrynet→ networking helpers (no raw packet APIs)assets→AssetRegistry(limited helper surface)ui→ safe message builders (no nativeMessageclass)require→ module loader for.jsfiles inside a modSharedServices→ cross-mod API bridgedb→ SQLite database per mod under the SimpleScripting data folderinventory→ ItemStack creation, ItemContainerHandle for managing inventorieseconomy→ Extension API (requires EconomySS plugin) - unified economy interface for VaultUnlocked/EliteEssentials
Reading the API docs
Section titled “Reading the API docs”Each API page lists the wrapper methods, their native counterpart, and usage examples:
- Events & Commands
- Inventory & Items
- Players & Worlds
- Server, Net & Assets
- UI & Messages
- Modules & Shared Services
- Database
- Economy (Extension)
- Example Packs
You can mix these surfaces freely within a mod. All messaging methods accept plain strings or the ui builders documented below.