[1.21.* - 26.1.*] PvPIndex Factions - API ; Faction Power ; Faction Claims ; GUI

PvPIndex Factions is a long-term modernization of the classic Factions experience for modern Paper servers.

The mission is to revive Factions as an API-connectable, timeless, and production-ready plugin while preserving the gameplay identity players already love.

Supported platforms

• Paper 1.21.x / 1.26.x - Recommended; full feature set
• Folia 1.21.x / 1.26.x - Supported; uses Folia-native regional and async schedulers
• Spigot 1.21.x / 1.26.x - Supported; runs in legacy compatibility mode (standard Bukkit scheduler, legacy chat listener)
• Java 21+

Vision: timeless Factions with modern internals

• Preserve familiar faction gameplay while modernizing architecture
• Provide stable persistence and operational reliability
• Enable long-term ecosystem/API connectivity
• Reduce technical debt from legacy-era implementations

What is improved vs old Factions-era plugins

• Cleaner command UX and help discoverability
• Persistent invite lifecycle with login-time invite summaries
• Improved /f map readability and interaction flow
• Expanded claim and unclaim argument modes
• Configurable GUI navigation via gui.yml
• Optional faction bank tax with configurable controls
• Modern permission structure for admins and staff
• Soft integrations that fail gracefully when providers are missing

Why PvPIndex Factions

• Modernized /f command surface with familiar Factions flow
• Persistent invite lifecycle with login-time notification summaries
• Advanced land control: claim/unclaim one, square, circle, fill, auto
• Interactive map and improved faction territory context
• Faction bank system with history, transfer support, and optional tax
• Configurable /f GUI via gui.yml
• Leaderboard sorting with /f top power|bank|land

Feature overview
Faction lifecycle

• Create, rename, describe, and disband factions
• Invite/revoke/accept/decline/decline-all flows
• Rank management with promote, demote, and leader transfer

Land and territory

• Claim and unclaim with one/square/circle/fill/auto variants
• Map-centered territory interaction and visibility
• Territory context messaging for better player clarity
• Overclaiming with enemy-relation guard, offline protection, and war shield support

Power and war mechanics

• Configurable power model: per-player max, regen rate, loss on death, grace period
• Optional kill power rewards — flat or scaled by victim/killer power ratio
• Optional death streak multiplier — escalating loss for consecutive deaths
• Optional inactive member exclusion — long-offline members excluded from max-land
• Raidable state broadcast — notify members (and optionally the server) on threshold crossing
• War shield system — admins set a daily UTC protection window per faction
• /f powerhistory — paginated per-player power change log (alias: /f phist); shows death, kill, and passive-regen events

Economy and bank

• Deposit, withdraw, transfer, and bank history tracking
• Optional periodic tax engine with configurable rate and interval
• Vault-ready for economy ecosystem compatibility

Homes, warps, and QoL

• Faction home and warp systems
• Warp management commands and listing flows
• Notification controls for invite and territory updates

Faction chests

• Shared faction storage with /f chest for fast default chest access
• Named chest management: /f chest list, /f chest open <name>, /f chest create <name>, /f chest delete <name>
• Officers can create/delete chests; faction members can open/list based on permission nodes
• Default chest name is configurable via factions.team-chest.default-name
• Per-faction chest count is configurable via factions.max-team-chests (default 1)

Faction flags

• Per-faction boolean toggles: pvp, friendly-fire, explosions, fire-spread, open
• Officers manage flags in-game with /f flag set; defaults and editability configurable per-flag
• Admins override any flag via /fa flag regardless of the player-editable setting

Audit log

• Officers and above page through faction history with /f audit [page] [--action=<action>]
• Staff view any faction's history with /fa audit <faction> [page] [--action=<action>]
• Tracks claims, unclaims, relation changes, kicks, promotions, demotions, bank transactions, and merge events
• Page size configurable via factions.audit.page-size in config.yml

Faction merges

• /f merge send <faction> — officers can propose dissolving their faction into another
• /f merge accept <faction> — officers of the target faction accept and complete the merge
• All claims, warps, bank balance, and members are transferred atomically; sender faction is disbanded
• Online target members are notified immediately when a request arrives

Internationalization

• Eight built-in locale bundles: en, es, de, fr, pt-BR, ja, zh, ru
• Players choose their language with /f language [code|reset]
• Server default locale configurable via factions.language.default in config.yml
• All command output, GUI items, and map display respect the resolved locale
• Message lookup order: player locale → server default → English → inline fallback
• Community locale contributions welcomed — see the i18n guide in the docs

Integrations

• Vault
• PlaceholderAPI
• TeamsAPI
• WorldGuard / WorldEdit
• dynmap (3.x, tested 3.4 – 3.8)
• EssentialsX
• LWC / LWCX
• EzAuction (faction auctions)
• EzShops (faction shops)
• EzRTP (avoids faction claims)
• EzClean (avoids faction claims)

Integration downloads

• PlaceholderAPI: https://modrinth.com/plugin/placeholderapi
• WorldEdit: https://modrinth.com/plugin/worldedit
• WorldGuard: https://modrinth.com/plugin/worldguard
• dynmap: https://modrinth.com/plugin/dynmap
• EssentialsX: https://modrinth.com/plugin/essentialsx
• LWC: https://modrinth.com/plugin/lwc
• Vault API (official): https://www.spigotmc.org/resources/vault.34315/
• TeamsAPI: https://modrinth.com/plugin/teams-api
• EzAuction: https://modrinth.com/plugin/ezauction
• EzShops: https://modrinth.com/plugin/ezshops
• EzRTP: https://modrinth.com/plugin/ezplugins-ezrtp
• EzClean: https://modrinth.com/plugin/ezclean

API/connectability direction
PvPIndex Factions is designed as a modern service-oriented base so it can integrate cleanly with optional plugins and future ecosystem tooling.

This refactor direction focuses on long-term maintainability, adapter-based integration, and reliable standalone operation.

Visual preview
GUI


Map


Faction info


Faction info page 2


/f top tab-complete


Faction Flags


Set flag state


Flag autocomplete


Faction audit log


Admin power history


Command roots

• Player: /f (aliases: /faction, /factions)
• Admin: /fa (alias: /factionadmin)
• Highlights: /f create, /f invite, /f claim, /f map, /f bank, /f warp, /f chest, /f audit

Configuration and operations

• Generated files: config.yml, database.yml, messages.yml, gui.yml
• Storage support: embedded H2 or MySQL/MariaDB
• Operations docs available for rollout, troubleshooting, and scaling

Migration-oriented for existing communities
If your network comes from legacy Factions servers, PvPIndex Factions is built to keep the familiar gameplay loop while giving you a cleaner and more future-proof backend.

Documentation and links

• Docs: https://pvp-index.github.io/pvpindex-factions
• Getting started: https://pvp-index.github.io/pvpindex-factions/getting-started
• Installation: https://pvp-index.github.io/pvpindex-factions/installation
• Step-by-step guides: https://pvp-index.github.io/pvpindex-factions/guides
• Core configuration: https://pvp-index.github.io/pvpindex-factions/configuration/core-settings
• Full config reference: https://pvp-index.github.io/pvpindex-factions/configuration/reference
• Features overview: https://pvp-index.github.io/pvpindex-factions/features
• Integrations docs: https://pvp-index.github.io/pvpindex-factions/integrations
• Operations runbook: https://pvp-index.github.io/pvpindex-factions/operations/admin-runbook
• Troubleshooting: https://pvp-index.github.io/pvpindex-factions/operations/troubleshooting
• Commands reference: https://pvp-index.github.io/pvpindex-factions/commands
• Permissions reference: https://pvp-index.github.io/pvpindex-factions/permissions
• Source: https://github.com/PVP-Index/pvpindex-factions
• Issues: https://github.com/PVP-Index/pvpindex-factions/issues

License and attribution

• LGPL-3.0
• Derivative of MassiveCraft Factions (LGPL-3.0)
• Refactor attribution: PvPIndex.com team (Shadow48402, Epildev)