# Nations

![Nations Banner](https://img.shields.io/badge/Nations-1.1.0-gold?style=for-the-badge) ![Minecraft](https://img.shields.io/badge/Minecraft-1.8--1.21+-gold?style=for-the-badge) ![Platform](https://img.shields.io/badge/Platform-Spigot%20%7C%20Paper%20%7C%20Bukkit-gold?style=for-the-badge) **A comprehensive nations, warfare, and alliance plugin for Minecraft servers.** *Created by **Nevmind**. All rights reserved to him.*

--- ## 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](https://luckperms.net/) 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 [type]` | Create a nation | `nations.player.create` | | `/nations delete` | Delete your nation | Nation Leader | | `/nations join ` | Join a nation | `nations.player.join` | | `/nations leave` | Leave your nation | `nations.player.leave` | | `/nations kick ` | 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 ` | Accept a request | Role permission | | `/nations deny ` | Deny a request | Role permission | | `/nations questions list` | List application questions | Nation Leader | | `/nations questions add ` | Add a question | Nation Leader | | `/nations questions remove <#>` | Remove a question | Nation Leader | ### Role Management | Command | Description | Permission | |---------|-------------|------------| | `/nations role create ` | Create a role | Role permission | | `/nations role delete ` | Delete a role | Role permission | | `/nations role list` | List all roles | Role permission | | `/nations role perms ` | Set role permission | Role permission | | `/nations setrole ` | 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 ` | Add a co-leader | Nation Leader | | `/nations leader remove ` | Remove a co-leader | Nation Leader | | `/nations leader transfer ` | Transfer leadership | Nation Leader | ### War Commands | Command | Description | Permission | |---------|-------------|------------| | `/nations war declare ` | Declare war | Role permission | | `/nations war confirm` | Confirm war declaration | Role permission | | `/nations war list` | List active wars | Everyone | | `/nations war join ` | Join an ongoing war | Role permission | | `/nations war end ` | End a war | `nations.admin.war` | | `/nations war approve ` | Approve pending war | `nations.admin.war` | **War Outcomes:** `attacker`, `defender`, `draw`, `attacker_surrender`, `defender_surrender` ### Alliance Commands | Command | Description | Permission | |---------|-------------|------------| | `/nations alliance create ` | Create an alliance | Nation Leader | | `/nations alliance invite ` | Invite nation to alliance | Alliance Leader | | `/nations alliance join ` | Join an alliance | Nation Leader | | `/nations alliance leave` | Leave your alliance | Nation Leader | | `/nations alliance kick ` | 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 ` | Get config value | `nations.admin.config` | | `/nations config set ` | Set config value | `nations.admin.config` | | `/nations config list [section]` | List config keys | `nations.admin.config` | | `/nations admin create ` | Create nation for player | `nations.admin.create` | | `/nations admin delete ` | Delete any nation | `nations.admin.delete` | | `/nations admin setleader ` | 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 ```yaml messages: prefix: "&8[&6Nations&8] &r" ``` ### Appearance ```yaml appearance: primary-color: "&6" secondary-color: "&e" accent-color: "&7" error-color: "&c" success-color: "&a" ``` ### Nation Settings ```yaml 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 ```yaml 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 ```yaml 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.**

astei

Krypton

LazyDFU

CrossStitch

Badges