Modern Factions Docs

Why This Plugin Is Different

Modern Factions is designed as a distinct factions framework rather than a patchwork on top of the MassiveCraft design pattern.

Fresh Architecture

Not MassiveCraft-Derived UX

The plugin does not center the user experience around a text-only command tree. The main flow opens with /f and pushes players into actual menus for members, audit, warps, upgrades, permissions, Discord, and more.

Modern Data and Services

It supports SQLite and MongoDB storage, RabbitMQ cross-server messaging, PlaceholderAPI expansion, Vault economy, and optional proxy-assisted teleport handoff.

Role and Menu Access Control

Instead of only raw command permissions, the plugin lets faction leaders define who can even see specific menu features like chest, warps, shop, missions, upgrades, map, home, permissions, and audit.

Faction Management Depth

Audit history, faction Discord linking, alt handling, check alerts, reserves, member-specific overrides, TNT banking, and upgrade-driven territory effects are all native systems in the plugin.

Typical Player Workflow

This is the intended normal path for users interacting with the plugin.

Player Journey

1. Create or Join

Use /f create <tag> or the creation GUI.
Join open factions or accept invites.
Roles are assigned immediately and shown through menus and placeholders.

2. Open the Main Menu

/f opens the faction hub.
From there players move to faction info, manage, upgrades, shop, warps, missions, audit, chest, map, and home actions.

3. Build Territory

Claim connected land.
Use /f map or /f sc for chunk visibility.
Set home and warps to anchor movement and logistics.

4. Progress the Faction

Earn points from kills, claims, missions, and logins.
Spend points on upgrades and shop items.
Track activity with audit logs and organize access through permissions and menu access control.

GUI Breakdown

The plugin exposes a large amount of functionality through menus. This is one of its biggest differences from older factions plugins.

Menus

Main Menu

The top-level faction hub. For players without a faction it offers creation and faction browsing. For players in a faction it exposes faction info, manage menu, tag changes, chat switching, upgrades, shop, warps, missions, audit log, permissions, faction chest, home teleport, map, and PvP/raid state visibility.

Manage Menu

The administrative center for a faction. It links into member management, relations, tag editing, Discord management, permission menus, invitation guidance, faction settings guidance, ban list guidance, bank guidance, home guidance, alt overview, audit access, menu access control, and disband confirmation guidance.

Members Menu

Shows every member head with role and online status. Clicking a member opens a per-member override screen instead of only relying on global role defaults.

Member Manage Menu

Cycles per-member overrides for build, break, container, and interaction permissions. Left click cycles default, allow, deny. Right click resets to role defaults.

Permissions Menu

Lists roles and links into role-level permission editors. This is a native faction permission layer, not just Bukkit permission nodes.

Role Permissions Menu

Toggles default role permissions stored in the plugin permission config. Changes are saved and reloaded live.

Menu Access Menu

Leader-only UI for setting the minimum role required to see specific entries in the main faction menu. This includes warps, shop, missions, chest, upgrades, audit log, permissions, map, and teleport home.

Relations Menu

Displays ally, pending ally, enemy, and truce sections. Pending ally requests are fully interactive from GUI. Some ally, enemy, and truce management buttons still route users toward command-based management or placeholder behavior rather than a full relation browser.

Pending Allies Menu

Accepts, denies, or cancels ally requests directly in the GUI and writes those actions to faction audit history.

Audit Log Menu

Paged faction history view showing real stored audit entries, with click-to-chat detail output. This is no longer just a decorative book.

Upgrades Menu

Reads upgrades.yml and shows members, power, claims, TNT bank, warps, crop growth, spawner boost, and damage reduction. Purchases consume points and use per-level value data.

Shop Menus

The faction shop uses categories and item definitions from factionshop.yml. Categories open into paged buy screens and can hand out native or custom items.

Faction Chest Menu

Shared storage with role-aware write permissions, chest level display, and chest upgrade flow. This is a faction-owned storage system, not just a normal chest wrapper.

Discord Link Menu

Shows whether the faction Discord link is set, lets permitted users set, test, or remove the link, and provides a member-friendly join flow with supported invite formats.

Warps Menu

Currently a lightweight shell that points players toward /f setwarp when no warps are configured and serves as a navigation endpoint. Warp usage itself is command-driven.

Chat Switcher

Lets members move between public, faction, ally, enemy, truce, moderator, and coleader channels according to their faction status and enabled settings.

Create Faction GUI

A direct creation entry point for players who enter the system through the GUI instead of text commands.

Feature Systems

This plugin is broader than a classic claim-and-raid factions plugin. These systems all exist in the shipped configuration and codebase.

Gameplay Layer

Power and DTR

Supports both a normal power model and DTR mode with regen, freeze timing, kills, deaths, and raidable logic.

Claims and Entry UI

Claim connectivity, radius limits, claim costs, unclaim refunds, titles, subtitles, actionbars, and sounds are configurable.

Block Protection

Protected materials gain extra health, regen, health bars, relation-aware multipliers, and raidable-state reduction.

Relations

Allies, enemies, truces, neutral rules, mutual acceptance, and auto-enemy on attack are part of the diplomacy system.

Faction Chat

Public, faction, ally, enemy, truce, mod, and coleader channels are natively supported with their own formatting.

Economy

Faction bank, taxes, limits, starting balance, and TNT bank with capacity and interest are configurable.

Warps and Home

Password warps, warmups, movement cancellation, damage cancellation, cooldowns, and cross-server handoff are supported.

Fly and Combat

Territory-aware faction fly, combat disable, enemy-nearby disable, auto-fly, and particle trails are supported.

Shield and Grace

Strategic temporary protection windows with costs, cooldowns, and rule toggles.

Points and Missions

Points earned from activity feed into upgrades and shop purchases. Missions add structured progression and repeatable goals.

Upgrades

Faction-wide upgrades affect member cap, power cap, claim cap, TNT bank, warp slots, crop growth, spawner output, and territory damage reduction.

Audit and Checks

Audit logs track operational history while automated checks can alert for buffer damage, walls, TNT, creepers, and nearby enemies.

Reserves and Alts

Name reservations and alt-account rules let network owners enforce structure around faction ownership and roster quality.

Discord Integration

Faction-specific Discord invite links and webhook-based notifications are built in.

Custom Items

Custom items, cave blocks, and dynamite systems let the plugin extend beyond vanilla faction utilities.

Network and Integration Notes

Modern Factions is designed to coexist with a broader network stack rather than pretending to be the only plugin on the server.

Integrations

Integration	Role	Notes
Vault	Economy hookup	Needed for money bank and economy-dependent faction systems.
PlaceholderAPI	Text expansion	Exposes `%oreofactions_...%` placeholders and enriches chat or scoreboards.
RabbitMQ	Cross-server messaging	Used for faction-private cross-server chat and pending teleport transfer data.
Velocity	Proxy travel support	Cross-server home and warp transfers rely on BungeeCord message-channel compatibility on Velocity.
OreoEssentials	Coexistence layer	Public chat and public scoreboard can be left to OreoEssentials while Modern Factions keeps private faction channels and faction systems.
Nexo / ItemsAdder	Item visuals	Custom faction items can use external visual bases while preserving plugin-owned metadata.

Recommended split with OreoEssentials: OreoEssentials handles public chat and optional public cross-server chat. Modern Factions handles faction, ally, enemy, truce, moderator, and coleader channels plus faction travel logic.