Installation:
1. Download and place in your plugins folder
2. Restart your server
3. Edit config.yml and messages.yml as needed
4. Use /f reload to apply changes
Player Commands:
- /f create <name> - Create a faction
- /f join <faction> - Join a faction (requires invite)
- /f leave - Leave your current faction
- /f home - Teleport to faction home
- /f sethome - Set faction home location
- /f warp <name> - Teleport to a faction warp
- /f claim - Claim the chunk you're standing in
- /f unclaim - Unclaim the current chunk
- /f unclaimall - Unclaim all faction territory
- /f map - View ASCII territory map
- /f menu - Open the GUI menu
- /f fly - Toggle flight in faction territory
- /f unstuck - Teleport to safety from enemy land
- /f chat [mode] - Toggle faction/ally/public chat
- /f seechunk - Visualize chunk borders with particles
Faction Management:
- /f invite <player> - Invite a player to your faction
- /f kick <player> - Kick a member from your faction
- /f rank <player> <rank> - Change a member's rank
- /f title <player> <title> - Set a member's custom title
- /f name <newname> - Change faction name
- /f desc <description> - Set faction description
- /f motd <message> - Set message of the day
- /f flag <flag> [on/off] - Toggle faction flags
- /f perm - Manage role permissions
- /f disband - Disband your faction
Relations:
- /f ally <faction> - Request alliance
- /f truce <faction> - Request truce
- /f neutral <faction> - Set neutral relation
- /f enemy <faction> - Declare as enemy
- /f relation list - View all relations
- /f relation wishes - View pending requests
Economy:
- /f money balance - View faction bank balance
- /f money deposit <amount> - Deposit money
- /f money withdraw <amount> - Withdraw money
- /f vault - Open faction vault (shared storage)
- /f upgrade - Open upgrades menu
Information:
- /f help [page] - View command help
- /f show [faction] - View faction information
- /f player [name] - View player information
- /f list [page] - List all factions
- /f top [page] - View faction leaderboard
- /f status - View online member status
Advanced Claiming:
- /f autoclaim - Toggle automatic claiming while walking
- /f claim square <radius> - Claim a square of chunks
- /f claim circle <radius> - Claim a circle of chunks
- /f claim fill [limit] - Fill in surrounded unclaimed chunks
- /f claim selection - Claim WorldEdit selection
- /f access <player/faction> - Grant territory access
Admin Commands:
- /f admin - Force join/leave factions
- /f override - Toggle admin bypass mode
- /f setpower <player> <amount> - Set player power
- /f powerboost <player/faction> <amount> - Add power boost
- /f config <path> [value] - View/edit configuration
- /f clean - Remove inactive factions/players
Ranks (lowest to highest):
- Recruit - New members
- Member - Standard members
- Officer - Can invite and manage lower ranks
- Coleader - Co-leadership permissions
- Leader - Full faction control
Faction Flags:
- open - Anyone can join without invite
- pvp - Allow PvP between faction members
- friendlyfire - Allow damage to allies
- explosions - Allow explosions in territory
- mobs - Allow mob spawning in territory
Permissions:
- factions.player.* - All player commands (default: true)
- factions.admin.* - All admin commands (default: op)
- factions.bypass - Bypass territory protection
- factions.bypass.cooldown - Bypass teleport cooldowns
- factions.fly - Use /f fly command
Configuration:
config.yml contains:
- Database settings (SQLite/MySQL)
- Power settings (min, max, per death, regen rate)
- Claim settings (max claims, claim costs)
- Teleport warmups and cooldowns
- Raid shield schedule
- Economy costs for actions
- Territory protection rules
messages.yml contains:
- All plugin messages (MiniMessage format)
- Supports colors, gradients, hover text, click actions
- Full localization support
PlaceholderAPI Placeholders:
- %factions_faction_name% - Faction name
- %factions_faction_power% - Current power
- %factions_faction_maxpower% - Maximum power
- %factions_faction_claims% - Number of claims
- %factions_faction_members% - Member count
- %factions_faction_online% - Online member count
- %factions_player_power% - Player's power
- %factions_player_maxpower% - Player's max power
- %factions_player_rank% - Player's faction rank
- %factions_player_title% - Player's title
- %factions_location_faction% - Faction at current location
- %factions_location_relation% - Relation to faction at location
Raid Shields:
Configure time windows when raiding is disabled:
- Set daily schedules in config.yml
- Protects factions during off-hours
- Configurable per-day schedules
Faction Upgrades:
- Power Boost - Increase faction max power
- Claims Boost - Increase max claims
- Crop Growth - Faster crop growth in territory
- Spawner Rate - Increased spawner rates
- Exp Boost - Bonus XP in territory
- Damage Boost - Extra damage in territory
Support & Issues:
GitHub: github.com/roydogman/Factions
Issues: github.com/roydogman/Factions/issues