SimpleTeams — Getting Started

Requirements

Before installing, make sure your server meets the minimum requirements. SimpleTeams targets modern Paper builds — legacy Spigot is also supported but Paper is recommended.

Dependency	Version	Required
Paper / Folia	1.21 or newer	Required
Java	21 or newer	Required
PlaceholderAPI	2.11.0 or newer	Optional

Spigot support. SimpleTeams also works on Spigot servers, but Paper is recommended for the best experience with MiniMessage formatting and async chat events.

Installation

Installation is a standard plugin drop-in. No build step required.

1

Download the jar

Grab the latest release from Modrinth or GitHub Releases. Always prefer the Modrinth release for stable builds.

2

Drop it into your plugins folder

Copy SimpleTeams-x.x.x.jar into your server's /plugins directory.

3

Start the server

Start or restart your server. SimpleTeams will generate its configuration files under /plugins/SimpleTeams/ on first run.

4

Verify it loaded

Run /plugins or check the console for the SimpleTeams startup banner confirming the plugin loaded correctly.

After first boot, you can customise all messages by editing messages.yml and configure limits, chat formatting, and invites in config.yml.

Integrations

SimpleTeams detects supported plugins at startup and hooks into them automatically. No extra configuration is required to enable a hook — just have the plugin loaded before SimpleTeams starts.

PlaceholderAPI

Installing PlaceholderAPI automatically registers the SimpleTeams expansion, exposing placeholders for team name, rank, prefix, leader, member count, and more. Use %simpleteams_<placeholder>% in any PAPI-compatible plugin.

Paper API

On Paper servers, SimpleTeams uses AsyncChatEvent for chat formatting and rendering. All messages are sent through the Adventure API using MiniMessage format.

Folia

SimpleTeams detects Folia at runtime and uses region-aware scheduling for async and sync tasks. Folia support is built-in — no extra configuration required.