Modern Factions logo
Modern Factions | Commands and Permissions

Commands and Permissions

This page documents the player command tree, admin command tree, and the major permission nodes that ship with the plugin. It is intended for both server staff and end users.

Player Command Tree

The root player command is /f. Running it with no arguments opens the main faction GUI.

/f
CommandPurposeTypical Permission
/fOpen the main faction menu. This is the normal GUI entry point.oreofactions.use
/f create <tag>Create a faction and become leader.oreofactions.create
/f disbandDelete the faction. Intended for the faction leader.oreofactions.disband
/f show [faction]Show faction information and summary data.oreofactions.show
/f listList factions on the server.oreofactions.list
/f topView faction leaderboards such as power, points, members, or balance.oreofactions.top
/f join <faction>Join an open faction or accept an invite flow.oreofactions.join
/f leaveLeave your current faction.oreofactions.leave
/f invite <player>Invite a player into the faction.oreofactions.invite
/f kick <player>Kick a member from the faction.oreofactions.kick
/f ban <player>Ban a player from joining the faction.oreofactions.ban
/f unban <player>Remove a faction ban.oreofactions.unban
/f role ...Promote, demote, or otherwise manage faction roles depending on context.oreofactions.role
/f alt ...Manage alternate accounts in the faction using the alt system rules.Faction role controlled plus oreofactions.use
/f claimClaim the current chunk for the faction.oreofactions.claim
/f unclaimUnclaim the current chunk.oreofactions.unclaim
/f mapShow the faction territory map around the player.oreofactions.map
/f scAlias of the faction map for quick chunk scanning.oreofactions.map
/f zone <type>Assign a zone type to an owned chunk.oreofactions.zone
/f ally [faction]With a target faction, manage ally relations. With no target, switch to ally chat.oreofactions.ally
/f enemy [faction]With a target faction, declare enemy relations. With no target, switch to enemy chat.oreofactions.enemy
/f truce [faction]With a target faction, manage truces. With no target, switch to truce chat.oreofactions.truce
/f neutral <faction>Return a relation to neutral when allowed by config.oreofactions.neutral
/f relation ...General relation command wrapper for diplomacy management.oreofactions.use
/f chat [mode]Switch between public and faction-private channels.oreofactions.chat
/f announce <message>Broadcast an internal faction announcement.oreofactions.announce
/f money ...Check faction balance, deposit, withdraw, or pay depending on sub-usage.oreofactions.money
/f tnt ...Check, deposit, or withdraw TNT from the faction TNT bank.oreofactions.tnt
/f homeTeleport to faction home, including cross-server home when configured.oreofactions.home
/f warp [name] [password]List faction warps or teleport to a named warp.oreofactions.warp
/f setwarp <name> [password]Create a named faction warp.oreofactions.setwarp
/f delwarp <name>Delete a faction warp.oreofactions.delwarp
/f flyToggle faction fly subject to territory and combat rules.oreofactions.fly
/f shieldWork with the faction shield system.oreofactions.shield
/f graceCheck or interact with grace period behavior where enabled.oreofactions.grace
/f upgradesOpen the faction upgrades menu.oreofactions.upgrades
/f shopOpen the faction points shop.oreofactions.shop
/f missionsOpen or inspect faction missions.oreofactions.missions
/f powerDisplay power or DTR-related information.oreofactions.power
/f nearInspect nearby players or faction presence.oreofactions.near
/f coordsShare or inspect coordinate information.oreofactions.coords
/f statusShow faction status information.oreofactions.status
/f linkFaction utility command included in the root command tree.oreofactions.use
/f discordOpen or use the faction Discord link flow.oreofactions.use
/f stuckUse the recovery command when allowed.oreofactions.stuck
/f chestOpen the faction chest system where permitted.oreofactions.use
/f set ...Modify faction metadata such as name or description.oreofactions.set
/f toggle ...Toggle faction options such as open or peaceful status.oreofactions.toggle
/f clearUtility command present in the command tree.oreofactions.use
/f menu / /f guiExplicit menu aliases for opening the GUI flow.oreofactions.use
/f vaultCurrently a placeholder command marked as coming soon.oreofactions.use

Admin Command Tree

The root admin command is /fa. Running it with no arguments opens the formatted admin help flow.

/fa
CommandPurposeExpected Permission
/fa helpShow the admin help menu.oreofactions.admin
/fa reloadReload all plugin configs and managers.oreofactions.admin.reload
/fa saveForce-save all faction and player data.oreofactions.admin.save
/fa bypassToggle bypass mode for a player, ignoring normal faction restrictions.oreofactions.admin.bypass
/fa info <faction>Dump a rich admin summary of a faction including members, economy, power, DTR, claims, and status.oreofactions.admin
/fa giveitems <item_id> [player] [amount]Give a configured custom item to a player.oreofactions.admin
/fa setpower <faction> <amount>Force a faction power value.oreofactions.admin.setpower
/fa setdtr <faction> <amount>Force a faction DTR value.oreofactions.admin.setdtr
/fa setpoints <faction> <amount>Force faction points.oreofactions.admin.setpoints
/fa setbalance <faction> <amount>Force faction balance.oreofactions.admin.setbalance
/fa force ...Administrative force actions such as disband, join, kick, or leader reassignment.oreofactions.admin
/fa chatspyWork with faction chat spy administration.oreofactions.admin.chatspy
/fa reserve ...Create or manage reserved faction names.oreofactions.admin.reserve
/fa grace ...Grant or manage faction grace.oreofactions.admin.grace
/fa shield ...Grant or manage faction shields.oreofactions.admin.shield
/fa peaceful ...Manage peaceful-state behavior on a faction.oreofactions.admin
/fa zone ...Administrative zone control.oreofactions.admin
/fa rg ...Region/zone administration path for region-linked controls.oreofactions.admin

Permission Nodes

The plugin ships a large permission tree. These are the important groups and commonly assigned nodes.

Permissions

Root and Group Nodes

  • oreofactions.* - full access
  • oreofactions.use - basic usage
  • oreofactions.user.* - standard user bundle
  • oreofactions.admin - admin entry permission
  • oreofactions.admin.* - full admin bundle

Common Player Nodes

  • oreofactions.create
  • oreofactions.join
  • oreofactions.claim
  • oreofactions.map
  • oreofactions.home
  • oreofactions.warp
  • oreofactions.money
  • oreofactions.chat
  • oreofactions.fly
  • oreofactions.upgrades

Admin Nodes

  • oreofactions.admin.reload
  • oreofactions.admin.save
  • oreofactions.admin.setpower
  • oreofactions.admin.setdtr
  • oreofactions.admin.setpoints
  • oreofactions.admin.setbalance
  • oreofactions.admin.chatspy
  • oreofactions.admin.reserve
  • oreofactions.admin.grace
  • oreofactions.admin.shield

Bypass Nodes

  • oreofactions.bypass.build
  • oreofactions.bypass.destroy
  • oreofactions.bypass.container
  • oreofactions.bypass.interact
  • oreofactions.bypass.damage
  • oreofactions.bypass.claim
  • oreofactions.bypass.cooldown

Special Nodes

  • oreofactions.create.free
  • oreofactions.claim.free
  • oreofactions.fly.anywhere
  • oreofactions.fly.combat
  • oreofactions.home.nocooldown
  • oreofactions.warp.nocooldown
  • oreofactions.power.infinite
  • oreofactions.claims.unlimited
  • oreofactions.members.unlimited
  • oreofactions.warps.unlimited

Rank Bundles

  • oreofactions.vip
  • oreofactions.premium
  • oreofactions.ultimate
Bukkit permissions decide whether a player can access a feature at all. Faction role rules and menu-access rules decide what that player can do or even see inside their faction once they have access to the plugin.