Arcane Loader is a Lua mod loader for Hytale servers that allows server-side mods to run without restarting the server.

It provides a structured runtime for Lua mods, including hot-reload workflows, deterministic lifecycle management, and safety-focused APIs for scalable server-side mod development.

---

Installation (For Mods That Require This)

If another mod says “Requires Arcane Loader”, install it like this:

1. Install Arcane Loader

1. Download the Arcane Loader .jar
2. Place it in your server’s plugin/mod folder
3. Start the server once

Arcane Loader will automatically initialize its runtime and create the required folders.

2. Install Lua Mods

Mods that depend on Arcane Loader should be placed in:

lua_mods/

Each mod should have its own folder inside lua_mods.

Example:

lua_mods/example_mod/

⚠️ Important:
Some Lua mods may include their own installation instructions, required configuration files, or additional assets. Always read the instructions provided by the mod you are installing.

Folders Created by Arcane Loader

After first launch, Arcane Loader typically creates:

lua_mods/

lua_cache/

lua_data/

lua_assets/

logs/

arcane-loader.json

For most servers, no additional setup is required.

---

What Arcane Loader Does

Arcane Loader adds a Lua scripting runtime to Hytale servers.

It allows mods to be written in Lua and loaded dynamically without restarting the server.

Core capabilities include:

• Hot-reload Lua mods without restarting the server
• Deterministic mod enable/disable/reload ordering
• Per-mod sandboxed data storage
• Built-in debugging and profiling tools
• Structured APIs for gameplay systems
• Controlled access to sensitive server functionality
• Async webhook support for external integrations

This project is a framework/loader, not a gameplay mod by itself.

---

Server Commands

Arcane Loader includes built-in commands for managing Lua mods.

Common commands:

/lua new <modId>

/lua reload <modId>

/lua mods

/lua enable <modId>

/lua disable <modId>

/lua errors

/lua doctor

/lua profile

/lua config reload

These commands allow server operators and developers to manage mods without restarting the server.

---

For Lua Mod Developers

Arcane Loader provides a structured Lua API for server-side mod development.

Available API areas include:

• commands
• events
• players
• entities
• world interaction
• filesystem utilities
• persistent data storage
• networking
• UI systems
• simulation tools

This allows Lua mods to implement gameplay mechanics, commands, server systems, and integrations.

---

Typical Mod Structure

A basic Lua mod looks like this:

lua_mods/<modId>/

manifest.json

init.lua

Example manifest.json:

{

  "id": "example",

  "name": "Example Mod",

  "version": "1.0.0",

  "entry": "init.lua"

}

Mods can be reloaded instantly using the /lua reload command.

---

Safety and Runtime Controls

Arcane Loader includes safeguards intended for live server environments:

• Per-mod filesystem sandboxing
• Configurable API capability restrictions
• Audit logging for sensitive actions
• Deterministic lifecycle control
• Performance profiling and diagnostics

These systems help keep servers stable and manageable.

---

Notes

• Arcane Loader is a dependency/framework, not a content mod.
• Lua mods must be placed in the lua_mods/ directory.
• Some features depend on the Hytale server runtime.

---

Version

Current version: 1.1.0