Chunk Survival Plugins

Chunk Survival Plugins – Documentation | Stoxello

Stoxello | Chunk Survival Plugins

Chunk Survival servers are extended with plugins: self-contained packages that add minigames, NPCs, and world modes to a running server. Stoxello distributes a set of eight official plugins — Spleef, BedWars, SkyWars, DeathRun, HideAndSeek, SkyBlock, PlotMe, and Citizens — as signed release packages with checksum manifests.

Installing a plugin is a copy-and-restart operation: place each plugin's folder into the server's plugin directory and restart the server. Plugins run inside the server process, so only install packages from sources you trust.

Product: Chunk Survival Official Plugins
Platforms: Any Chunk Survival dedicated server (Windows/Linux)
Distribution: Signed plugin ZIP packages with SHA256SUMS manifest from your Stoxello distribution
Type: Server plugin collection

Key Features

Spleef – the classic dig-the-floor arena minigame; the reference implementation.
BedWars – team beds, resource generators, item shops, and elimination.
SkyWars – island spawns, loot chests, last-survivor rounds.
DeathRun – runner-vs-activator trap course with checkpoints.
HideAndSeek – seekers versus players disguised as blocks.
SkyBlock – persistent island worlds with templates and generators.
PlotMe – creative plot grid with claims, roads, and protection.
Citizens – named persistent clickable NPCs with waypoint routes.
Self-contained packages – each ZIP carries everything its plugin needs except the core API, which the server supplies automatically.

System Requirements

Requirement	Details
Server	A running Chunk Survival dedicated server
Plugin root	The server's plugin directory (`Plugins/` by default; relocatable via `PLUGINS_PATH`)
Compatibility	Packages state their required API version; use releases matching your server version

Installation

Download the plugin ZIP for each gamemode you want from your Stoxello distribution and verify against the included checksum manifest.
Extract each package into its own subfolder beneath the server's plugin root:

# Server plugin layout (default root: Plugins/)
Plugins/
├── BedWars/
│   ├── plugin.yml
│   └── (plugin files)
├── SkyWars/
│   └── ...
└── Spleef/
    └── ...

Restart the server. Plugins load at startup only — runtime reload is intentionally unsupported.
To update a plugin, replace its folder contents while the server is stopped, then start it again.

Usage

Minigame plugins declare themselves as round-based games: configure them per backend role and players join rounds in-game.
World-mode plugins such as SkyBlock and PlotMe create their own persistent data folders under the server's plugin data path.
Citizens NPCs persist across restarts and respond to clicks/commands defined by their routes.
Data locations – writable plugin data defaults next to the plugins; set PLUGIN_DATA_PATH on the server to keep it elsewhere (e.g., on a backup volume).

Configuration

Server-side environment variables control where plugins live:

Setting	Purpose
`PLUGINS_PATH`	Plugin root directory on the server (default `Plugins/`)
`PLUGIN_DATA_PATH`	Optional separate location for writable plugin data (defaults to `PLUGINS_PATH`)

Each package contains a plugin.yml describing its name, version, entry file, API-version compatibility, and dependencies. Do not remove entries from a shipped manifest; when installing third-party plugins, check api-version and any listed dependencies before adding them.