Nations

---

Overview

Nations is a feature-rich Minecraft plugin that allows players to create and manage their own nations, form alliances, and engage in organized warfare. Whether you're running a survival server, a roleplay server, or a political faction server, Nations provides all the tools you need for immersive geopolitical gameplay.

---

Features

Nation Management

• Create Nations - Players can establish their own nations with custom names
• Multiple Join Types - Open, approval-based, or application-based joining
• Custom Application Questions - Nation leaders can set up to 5 questions for applicants
• Role System - Create custom roles with specific permissions
• Multi-Leader Support - Nations can have multiple co-leaders

Alliance System

• Create Alliances - Nation leaders can form alliances with other nations
• Alliance Leadership - Multiple nations can share leadership of an alliance
• Diplomatic Relations - Invite nations, manage membership, and coordinate strategy

Warfare System

• Declare War - Nation leaders can declare war on rival nations
• Two War Modes:
  • Mode 1 (Instant): Combat begins immediately
  • Mode 2 (Grace Period): Configurable grace period before combat
• Casualty Tracking - Real-time kill tracking during wars
• War Scoreboard - Live scoreboard showing war status and casualties
• Alliance Support - Allies are notified and can join wars

Admin Controls

• War Approval System - Optionally require admin approval for wars
• Restrict Nation Creation - Limit nation creation to admins only
• In-Game Config Editing - Modify all settings without touching files
• Full Override Permissions - Admins can manage any nation

LuckPerms Integration

• Automatic Groups - Nations automatically create LuckPerms groups
• Name Tags - Players display their nation and role in chat/name tags

---

Installation

1. Download the Nations-1.0.0.jar file
2. Stop your Minecraft server
3. Place the JAR file in your server's plugins folder
4. Start your server
5. The plugin will generate its configuration files automatically
6. (Optional) Install LuckPerms for name tag integration

---

Commands

General Commands

Command	Description	Permission
/nations help [page]	Show help pages	Everyone
/nations creator	Show plugin creator	Everyone
/nations list	List all nations	nations.player.list
/nations info [nation]	View nation information	nations.player.info

Nation Management

Command	Description	Permission
/nations create <name> [type]	Create a nation	nations.player.create
/nations delete	Delete your nation	Nation Leader
/nations join <nation>	Join a nation	nations.player.join
/nations leave	Leave your nation	nations.player.leave
/nations kick <player>	Kick a member	Role permission
/nations notifications	Toggle join notifications	Nation Leader

Join Requests & Applications

Command	Description	Permission
/nations requests [page]	View pending requests	Role permission
/nations accept <player>	Accept a request	Role permission
/nations deny <player>	Deny a request	Role permission
/nations questions list	List application questions	Nation Leader
/nations questions add <q>	Add a question	Nation Leader
/nations questions remove <#>	Remove a question	Nation Leader

Role Management

Command	Description	Permission
/nations role create <name>	Create a role	Role permission
/nations role delete <name>	Delete a role	Role permission
/nations role list	List all roles	Role permission
/nations role perms <role> <perm> <true|false>	Set role permission	Role permission
/nations setrole <player> <role>	Assign role to player	Role permission

Available Role Permissions:

• accept_requests - Accept/deny join requests
• declare_war - Declare war on other nations
• kick_members - Kick members from the nation
• invite_members - Invite players to the nation
• manage_roles - Create, edit, and assign roles

Leadership Commands

Command	Description	Permission
/nations leader add <player>	Add a co-leader	Nation Leader
/nations leader remove <player>	Remove a co-leader	Nation Leader
/nations leader transfer <player>	Transfer leadership	Nation Leader

War Commands

Command	Description	Permission
/nations war declare <nation>	Declare war	Role permission
/nations war confirm	Confirm war declaration	Role permission
/nations war list	List active wars	Everyone
/nations war join <warId> <side>	Join an ongoing war	Role permission
/nations war end <warId> <outcome>	End a war	nations.admin.war
/nations war approve <warId>	Approve pending war	nations.admin.war

War Outcomes: attacker, defender, draw, attacker_surrender, defender_surrender

Alliance Commands

Command	Description	Permission
/nations alliance create <name>	Create an alliance	Nation Leader
/nations alliance invite <nation>	Invite nation to alliance	Alliance Leader
/nations alliance join <alliance>	Join an alliance	Nation Leader
/nations alliance leave	Leave your alliance	Nation Leader
/nations alliance kick <nation>	Kick from alliance	Alliance Leader
/nations alliance delete	Delete your alliance	Alliance Leader
/nations alliance info [name]	View alliance info	Everyone
/nations alliance list	List all alliances	Everyone

Admin Commands

Command	Description	Permission
/nations reload	Reload configuration	nations.admin.reload
/nations config get <path>	Get config value	nations.admin.config
/nations config set <path> <value>	Set config value	nations.admin.config
/nations config list [section]	List config keys	nations.admin.config
/nations admin create <nation> <player>	Create nation for player	nations.admin.create
/nations admin delete <nation>	Delete any nation	nations.admin.delete
/nations admin setleader <nation> <player>	Set nation leader	nations.admin.leader

---

Permissions

Player Permissions (Default: true)

Permission	Description
nations.player.*	All player permissions
nations.player.create	Create a nation
nations.player.join	Join a nation
nations.player.leave	Leave a nation
nations.player.info	View nation information
nations.player.list	List all nations

Admin Permissions (Default: OP)

Permission	Description
nations.admin.*	All admin permissions
nations.admin	General admin permission
nations.admin.reload	Reload configuration
nations.admin.config	Edit configuration in-game
nations.admin.create	Create nations for players
nations.admin.delete	Delete any nation
nations.admin.kick	Kick from any nation
nations.admin.leader	Manage any nation's leadership
nations.admin.roles	Manage any nation's roles
nations.admin.war	Approve and end wars

Bypass Permissions (Default: OP)

Permission	Description
nations.bypass.*	Bypass all restrictions
nations.bypass.cooldown	Bypass join/leave cooldowns

---

Configuration

The configuration file (config.yml) is automatically generated with extensive comments. Here's an overview of key settings:

Messages

messages:
  prefix: "&8[&6Nations&8] &r"

Appearance

appearance:
  primary-color: "&6"
  secondary-color: "&e"
  accent-color: "&7"
  error-color: "&c"
  success-color: "&a"

Nation Settings

nations:
  player-creation-enabled: true    # Allow players to create nations
  join-requests-enabled: true      # Allow join requests
  max-application-questions: 5     # Max questions per application
  join-cooldown-seconds: 0         # Cooldown before joining (0 = disabled)
  leave-cooldown-seconds: 0        # Cooldown before leaving (0 = disabled)

War Settings

war:
  mode: 1                          # 1 = Instant, 2 = Grace Period
  require-admin-approval: false    # Require admin approval for wars
  grace-period-seconds: 300        # Grace period duration (mode 2 only)
  chat-notifications: true         # Announce kills in chat
  scoreboard-enabled: true         # Show war scoreboard

Integrations

integrations:
  luckperms-enabled: true          # Enable LuckPerms integration

---

In-Game Config Editing

You can modify any configuration value without editing files:

/nations config get war.mode
/nations config set war.mode 2
/nations config set war.grace-period-seconds 600
/nations config list war

Changes are saved immediately and apply on the next relevant action.

---

Compatibility

Supported Minecraft Versions

• Minimum: 1.8
• Maximum: 1.21+ (and future versions)
• The plugin uses only stable Bukkit/Spigot API calls

Supported Platforms

• Spigot
• Paper
• Bukkit
• Paper forks (Purpur, Pufferfish, etc.)

Optional Dependencies

• LuckPerms - For name tag integration

---

Troubleshooting

Common Issues

Q: The plugin won't load!

• Ensure you're running a compatible server version (1.8+)
• Check the console for error messages
• Verify the JAR file isn't corrupted

Q: LuckPerms integration isn't working!

• Ensure LuckPerms is installed and loaded before Nations
• Check that integrations.luckperms-enabled is set to true
• Verify LuckPerms is version 5.0 or higher

Q: Players can't create nations!

• Check nations.player-creation-enabled in config
• Verify players have nations.player.create permission

Q: Wars aren't starting!

• If using admin approval, wars need to be approved first
• Check war.require-admin-approval in config

Q: Scoreboard isn't showing!

• Verify war.scoreboard-enabled is true
• Some scoreboard plugins may conflict

---

FAQ

Q: Can I have multiple nations at once?
A: No, players can only be in one nation at a time.

Q: What happens when a nation is deleted?
A: All members are removed, the nation is disbanded, and if in an alliance, it's removed from there too.

Q: Can wars have multiple nations on each side?
A: Yes! Alliance members can join wars, and non-allied nations can choose a side.

Q: Is there a limit to nation size?
A: No built-in limit. You can implement one via permissions or external plugins.

---

Attribution

Created by Nevmind. All rights reserved to him.