Leader Plugin

LeaderPlugin

LeaderPlugin adds a full political leadership system to Paper servers. Players elect a leader, the leader gains dramatic powers, and the rest of the server can support them, fund the realm, collect bounties, or rise up in rebellion.

Built for Java 21 with Java 21.

Features

- Player-driven leader elections - Persistent leader, vote, treasury, decree, rebel, and bounty data - Leader powers with configurable cooldowns - Optional sacrifice ritual event - Treasury and tribute economy using a configurable item - Tax collection from online players - Decrees that change server gameplay - Bounties funded from the realm treasury - Rebellion system that can overthrow the current leader - Sanctuary zones that temporarily prevent PvP - Admin controls for forcing, clearing, and reloading leadership state

Leadership

Players vote for an online candidate with:

```text /leader vote <player> ```

When a candidate reaches the configured vote threshold, they become the elected leader. The leader keeps their role until they abdicate, are cleared by an admin, or are overthrown by a rebellion.

Useful election commands:

```text /leader current /leader votes /leader abdicate /leader realm ```

Leader Powers

The elected leader can use a wide range of abilities:

```text /leader lightning <player> /leader imprison <player> /leader rally /leader judgement <player> /leader pardon <player> /leader sacrifice <player> /leader exile <player> /leader sanctuary /leader warcry /leader beacon /leader feast /leader summon <player> /leader loyalty <player> /leader crown /leader proclaim <message> /leader locate <player> ```

Examples:

- Proclaim strikes a target with lightning effects and damage. - Proclaim traps a target in a temporary cage. - Proclaim buffs nearby players. - Proclaim marks and weakens a target. - Proclaim clears negative effects and rebel status. - Proclaim starts an optional delayed ritual that kills the chosen victim. - Proclaim teleports a target far into the wilderness. - Proclaim creates a temporary no-PvP area. - Proclaim damages, weakens, and knocks back nearby players. - Proclaim grants strong utility buffs nearby. - Proclaim spends treasury resources to heal and feed nearby players. - Proclaim pulls a target to the leader after a warning delay. - Proclaim broadcasts a royal message to the whole server.

Realm Systems

LeaderPlugin includes more than simple powers. The realm itself can evolve:

```text /leader tribute <amount> /leader tax /leader decree <none|war|peace|prosperity|storm> /leader rebel /leader rebels /leader bounty <player> <reward> /leader bounties /leader clearbounty <player> ```

Treasury

Players can contribute the configured treasury item, defaulting to emeralds. Leaders can spend treasury resources on feasts and bounties.

Taxes

The leader can collect a small configured amount of the treasury item from online non-exempt players.

Decrees

Leaders can set realm-wide decrees:

- `none` - no active decree - `war` - leader attacks hit harder - `peace` - PvP damage is reduced - `prosperity` - mining ores can create bonus rewards - `storm` - leader attacks can trigger lightning sparks

Rebellion

Players can join a rebellion with `/leader rebel`. If enough eligible online players rebel, the current leader is overthrown and the throne becomes empty.

Bounties

The leader can fund bounties from the treasury. When a target is killed by another player, the killer receives the configured reward item and experience.

Configuration

Almost every major value is configurable in `config.yml`, including:

- vote threshold - cooldowns - damage amounts - ability durations - aura radius - sacrifice enable/disable - treasury material - tax amount - rebellion threshold - bounty reward limits - decree effects

To disable sacrifices:

```yaml sacrifice: enabled: false ```

Admin Commands

```text /leader force <player> /leader clear /leader reload ```

Permissions

```text leaderplugin.use leaderplugin.vote leaderplugin.admin leaderplugin.exempt.lightning leaderplugin.exempt.imprison leaderplugin.exempt.sacrifice leaderplugin.exempt.exile leaderplugin.exempt.summon leaderplugin.exempt.tax ```

Requirements

- PaperMC 1.21.1 - Java 21

This is a server-side Paper plugin. It is not a Fabric, Forge, NeoForge, or client-side mod.