ServerFactions

A GUI-driven faction system for Paper/Purpur 1.21.x (Java 21).

Version 1.0.0 · Minecraft 1.21 – 1.21.11 · Server-side

ServerFactions lets players create factions, organize members with custom priority-ordered roles and granular permissions, and manage everything through inventory GUIs. It integrates optionally with MultiBank for per-faction banks, Vault for a creation cost, and PlaceholderAPI for placeholders.

Note: ServerFactions is a social/group plugin. It does not implement land claims, war, power or territory capture. For land protection, pair it with a claim plugin such as LandClaim.

Features

• Factions with identity. Name, short tag, primary/secondary colors and public/private visibility, all editable from a settings GUI.
• Custom roles. Priority-ordered roles with per-role permissions: invite, kick, edit settings, manage roles, promote, demote and access bank. The leader role (priority 0) is protected and cannot be assigned or recreated. New factions get default Officer / Member / Recruit roles.
• GUI-first management. Members, roles, invites, settings, member limit, color picker, transfer leadership, public faction browser and confirmation dialogs are all inventory GUIs; all clicks are fully cancelled server-side (no inventory duping). Text input uses a sign editor.
• Invites. Time-limited invites with a configurable expiry.
• Faction chat. Toggle faction-only chat with /fac chat.
• Optional faction bank. Auto-creates a MultiBank account per faction when MultiBank is present.
• Configurable creation cost. Charged through the economy (MultiBank or Vault).
• Friendly fire toggle, configurable action sounds, and member limits.
• Persistence. SQLite with asynchronous writes on a single-thread executor and a flushed shutdown; all SQL uses prepared statements.
• Localization. Bundled en_US, pt_PT and fr_FR (MiniMessage) for all chat messages and feedback; some GUI button labels are currently English-only.
• Integrations & API. PlaceholderAPI expansion, plus a developer API (ServerFactionsProvider) with faction lifecycle events.

Commands

Single command /fac with aliases /f and /faction.

Command	Description	Permission
/fac	Open the main faction menu.	serverfactions.use
/fac create	Start faction creation.	serverfactions.use
/fac invite <player>	Invite a player to your faction.	serverfactions.use
/fac chat	Toggle faction chat.	serverfactions.use
/fac info [faction]	Show your faction, or another faction by name.	serverfactions.use
/fac list	Browse public factions.	serverfactions.use
/fac invites	View your pending invites.	serverfactions.use
/fac leave	Leave your faction.	serverfactions.use
/fac admin disband <faction>	Force-disband a faction.	serverfactions.admin
/fac admin reload	Reload the configuration.	serverfactions.admin

Permissions

Node	Description	Default
serverfactions.use	Use the base /fac commands.	true
serverfactions.admin	Access /fac admin (disband, reload).	op

Configuration

Key config.yml settings:

faction:
  creation-cost: 100.0
  max-tag-length: 4
  max-name-length: 24
  min-name-length: 3
  invite-expiry-hours: 24
  default-member-limit: 0        # 0 = unlimited
  default-member-limit-enabled: false
  absolute-max-members: 50
  max-roles: 15                  # custom roles per faction
  friendly-fire: true

economy:
  mode: auto                     # auto (MultiBank then Vault), MultiBank, or Vault
  priority: ["MultiBank", "Vault"]

multibank:
  auto-create-bank: true
  bank-name-prefix: "Faction: "

The config.yml also exposes a full gui: section to reposition and resize every menu (sizes must be multiples of 9), plus a sounds: section for action feedback. Faction names and tags are restricted to a safe character set to prevent formatting injection in chat, tab list and GUIs.

Installation

1. Requires Paper or Purpur 1.21+ and Java 21.
2. Optional companions (see Dependencies): MultiBank, Vault, PlaceholderAPI, PlayerSettings.
3. Drop ServerFactions-1.0.0.jar into plugins/ and start the server to generate config.yml.
4. Tune the faction: and economy: sections and run /fac admin reload.

Dependencies

All integrations are optional (soft dependencies); the plugin runs without them.

Plugin	Purpose
MultiBank	Per-faction bank accounts and economy (companion plugin).
Vault	Economy fallback for the faction creation cost.
PlaceholderAPI	Faction placeholders (e.g. formatted tag).
PlayerSettings	Per-player language resolution (companion plugin).

Support / Source

Source and issues: https://github.com/henriquescrrrr/carrageis-serverfactions

License

Released under the GNU General Public License v3.0. See LICENSE.