Installation

Requirements

• Java 21 or newer
• Paper 1.21.11+ (or compatible Folia/Canvas fork)
• Required plugins — see Dependencies

Steps

1. Download DonutSMPCore-1.0.0-all.jar from your release channel.
2. Place the jar in your server's plugins/ folder.
3. Install all required dependencies (Vault, LuckPerms, PlaceholderAPI, TAB, FancyHolograms, PlayTimed, voicechat, CoordinateOffset).
4. Start the server once to generate config files.
5. Set your license key in plugins/DonutSMPCore/config.yml:

license-key: "your-key-here"

1. Configure storage (SQLite works for single-server; use MySQL for networks).
2. Restart the server.

First boot

On first enable, DonutSMPCore creates default YAML configs for every enabled module. Messages, GUIs, and permissions are all configurable.

Single-server vs network

Setup	Storage	Redis
Single Paper server	SQLITE (default)	redis.enabled: false
Proxy network (Velocity/Bungee)	MYSQL (shared DB)	redis.enabled: true

See Redis & Network for multi-server setup.

Updating

1. Stop the server (or use a maintenance window).
2. Replace the jar in plugins/.
3. Start the server — configs auto-migrate via version fields in each YAML file.
4. Run /donutsmpcore reload if hot-reload is supported for your change.

Storage migrations

When switching database backends, use /donutsmpcore storage export before changing storage.yml, then import after restart. See Storage.