Laplace Core

Laplace is a Minecraft server management core that combines:

• secure backend API
• WebSocket real-time console/status
• TUI (Terminal User Interface)
• plugin runtime (built-in + external plugins)

Highlight

An outstanding foolproof system

Quick Start

Requirements

• Node.js (v16+)
• Java (Required to run Minecraft server core)

Installation

npm install

Start Core

Standard mode:

npm run start

Debug mode:

npm run start:debug

Clean mode, no plugins loaded:

npm run start:clean

Debug + clean:

npm run start:debug-clean

Direct CLI flags are also supported:

ts-node --esm backend/server.ts --debug --clean

Environment aliases:

LAPLACE_DEBUG=1 npm run start
LAPLACE_CLEAN=1 npm run start

Plugin System (v4)

Laplace Core ships with the plugin runtime only. The public webui is a separate repository and is installed as an external plugin.

• built-in plugins: backend/plugins/<plugin-id> for internal distribution only
• external plugins: laplace_data/plugins/<plugin-id>
• required manifest: laplace.plugin.json
• plugins are distributed as pre-built release zips — no npm install or build step inside the plugin folder

Install a plugin

Start laplace-core, then in the TUI:

plugin registry          # list official plugins
plugin install webui     # install latest release of the official WebUI
plugin list              # see what is currently loaded

Restart laplace-core after install to load the plugin.

Manual drop-in is also supported: download the plugin's release zip from its GitHub Releases page and unzip it into laplace_data/plugins/<id>/.

See detailed spec:

• docs/plugin_system.md

Security Notes

• URL query token auth is disabled for API and WebSocket.
• Use Authorization: Bearer <token> (or legacy x-auth-token) for API auth.
• WebSocket uses Sec-WebSocket-Protocol with a signed token payload.
• High-risk API actions are protected by role-based authorization (RBAC).

docs

docs/tui_manual.md

credits

First author - 只吃香菜/EdEncore
Second author - 唐晓翼/Tangxiaoyi97

contributors:

• 缅甸高薪招聘13845785726
• carnival
• 令狐睡觉
• karl e.

special thanks - Gemini 3 pro & google ai studio

License

MIT License