Installation

Requirements

Server software: Paper, Purpur or Folia
Minecraft version: 1.21.6 up to the latest supported version (currently 26.2)
Java: 25 or newer (whatever your server platform requires)
Spigot/Bukkit (without Paper) is not supported — PlainBase relies on Paper-only APIs (Brigadier command registration, region schedulers, etc.).

Download the PlainBase-<version>.jar from the latest release, Modrinth or Hangar.
Drop the jar into your server's plugins/ folder.
Start (or restart) the server. This generates:
- plugins/PlainBase/config.yml — the master file, only used to enable/disable modules.
- plugins/PlainBase/modules/*.yml — one file per module, only created for modules once they're referenced.
Open config.yml and set the modules you want to true.
Run /plainbase reload (or restart the server) to apply the change.
Edit the corresponding modules/<name>.yml file to configure that module, then /plainbase reload again.

PlaceholderAPI — if installed, PlainBase automatically registers its %plainbase_*% placeholder expansion. Not required; everything else works without it. See PlaceholderAPI.

Replace the old jar in plugins/ with the new one and restart the server.
Check the console/OP join warnings for outdated config files — PlainBase does not silently rewrite your configs. See Configuration & Versioning for exactly how this works and what to do about it.
Read the release notes on the Releases page for anything module-specific.

Getting Started

Modules

More