PvPIndex Factions is a long-term modernization of the classic Factions experience for modern Paper servers.
The goal is simple: revive Factions with a timeless architecture, reliable persistence, clean gameplay UX, and API-connectable systems that can integrate with modern server ecosystems for years to come.
If you love classic Factions gameplay but need something maintainable, scalable, and integration-ready, PvPIndex Factions is built for exactly that.
TeamsAPI integration available - PvPIndex Factions connects natively with TeamsAPI to expose faction data to other compatible plugins and services. Requires TeamsAPI 2.4.0+. Download TeamsAPI on Modrinth →
Supported platforms
| Platform |
Version |
Notes |
| Paper |
1.21.x, 1.26.x |
Recommended |
| Folia |
1.21.x, 1.26.x |
Native Folia scheduler support |
| Spigot |
1.21.x, 1.26.x |
Legacy compatibility mode |
| Java |
21+ |
|
Vision: timeless Factions, modern backend
PvPIndex Factions is not a quick port. It is an active refactor effort to make Factions:
- Easier to operate in production
- Easier to integrate with APIs and external systems
- Easier to maintain across future Minecraft/Paper updates
- More consistent for players and staff
This project keeps the recognizable Factions identity while replacing legacy internals with a modern service/repository model and optional integration adapters.
What is modernized vs legacy Factions
Compared to older Factions-era plugins, PvPIndex Factions focuses on:
- Modern command ergonomics and guided help UX
- Persistent invite lifecycle with login notifications
- Better map readability and interaction flow
- More complete claim/unclaim modes
- Configurable GUI-driven navigation
- Optional tax/economy control for faction banks
- Cleaner permissions and admin workflows
- Soft-dependency integrations that fail gracefully
- Documentation and operational runbooks for real server owners
You keep the Factions gameplay loop, but gain a modern operational foundation.
Why server owners choose PvPIndex Factions
- Modernized
/f command experience with familiar muscle memory
- Persistent faction invites with login-time invite notifications
- Advanced land control:
claim/unclaim modes (one, square, circle, fill, auto)
- Interactive
/f map with clearer territory context
- Faction bank with deposit/withdraw/transfer/history and optional tax engine
- Configurable
/f GUI via gui.yml
- Scales from standalone setup to larger integrated networks
Feature overview
Faction lifecycle
- Create, rename, describe, and disband factions
- Member administration with invite/revoke/accept/decline flows
- Leadership transfer and rank movement (promote/demote)
- Fully manageable custom roles (
/f role ...) with configurable priorities and prefixes
- Clear onboarding through
/f help
Land and map
- Claim/unclaim behavior designed for both casual and advanced use
square, circle, and fill modes for territory management- Auto claim/unclaim modes for movement-driven workflows
- Modernized
/f map display and improved territorial context messaging
Economy and bank
- Faction bank deposit, withdraw, transfer, and history
- Optional periodic tax engine with configurable rates/intervals
- Works with Vault-based economy stacks
Homes and warps
- Faction home and warp management
- Warp listing/set/delete flows
- Compatibility-oriented command structure for player familiarity
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; all 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 can page through their faction's action history with
/f audit [page] [--action=<action>]
- Staff can 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 the request- All claims, warps, bank balance, and members are transferred atomically; the sender faction is then 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 item text, 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
Power and war mechanics
- Configurable power model with per-player max, regen rate, loss on death, and grace period
- Optional kill power rewards, with configurable flat or scaled amounts (scale rewards by victim/killer power ratio)
- Optional death streak multiplier — consecutive deaths in a short window incur escalating loss
- Optional inactive member exclusion — long-offline members do not count toward max-land
- Overclaiming with enemy-relation guard and optional offline protection (block raids when all defenders are offline)
- Raidable state broadcast — members (and optionally the server) are notified when a faction crosses the raidable threshold
- War shield system — admins assign a daily UTC protection window; during the window territory cannot be overclaimed
/f powerhistory — paginated per-player power change log (alias: /f phist); shows death, kill, and passive-regen events
Notifications and QoL
- Invite visibility for online and returning players
- Territory and event notifications
- Player-level notification controls
- PlaceholderAPI role placeholders:
%pvpindex_player_role% and %pvpindex_player_role_prefix%
API and integration direction
PvPIndex’s long-term direction is an API-connectable Factions core.
That means systems are designed to be:
- Adapter-friendly
- Service-oriented
- Compatible with external plugins/services without hard coupling
- Reliable even when optional integrations are absent
This creates a stable base for future extensions, panels, tooling, and ecosystem plugins.
Integrations
PvPIndex Factions runs standalone, and integrates when available:
- Vault (economy API)
- 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)
- DiscordSRV (faction event broadcasts to Discord)
Integration downloads
Configuration and operations
Generated config files:
config.ymlroles.ymldatabase.ymlmessages.ymlgui.yml
Storage options:
- Embedded H2 for quick setup
- MySQL/MariaDB for larger networks
Docs include:
- Installation and setup guides
- Full config reference
- Feature-by-feature documentation
- Integrations setup notes
- Operations runbook and troubleshooting
Visual preview
GUI:
Map:
Faction info:
Faction info page 2:
Top tab-complete:
Faction Flags:
Set flag state:
Flag autocomplete:
Audit log:
Admin power history:
Commands at a glance
- Player root:
/f (/faction, /factions)
- Admin root:
/fa (/factionadmin)
- Highlights:
/f create, /f invite, /f join, /f claim, /f unclaim, /f map, /f info, /f top, /f bank, /f warp, /f chest, /f audit
Designed for migration-minded communities
If your server comes from legacy Factions communities, PvPIndex Factions is intentionally built to feel familiar while offering a cleaner and more future-proof base.
The objective is not to erase Factions identity; it is to preserve it and make it sustainable for modern server operations.
Documentation
For setup, configuration, operations, and troubleshooting:
PvPIndex is partnered with NeyHost
Use the coupon code PVPINDEX for 10% off on checkout.
License and attribution
- LGPL-3.0
- Derivative of MassiveCraft Factions (LGPL-3.0)
- Refactor by PvPIndex.com team (Shadow48402, Epildev)
