LunaGuerra
A Spigot plugin that brings clan war functionality integrated with SimpleClans. It allows clans to battle in custom arenas with configurable kits.

Dependencies

• SimpleClans (2.19.2 or higher)
  
• PlaceholderAPI (2.11.6 or higher) (Required for placeholders)
  
• Spigot 1.21+ (native version)

⚔️ Commands
/guerra
Main command to interact with LunaGuerra. All subcommands are accessed through /guerra.


Subcommands

1. /guerra entrar [arena]
   • Description: Join an ongoing war. The optional arena parameter specifies which arena to join.
     
   • Permission: lunaguerra.join
2. /guerra sair
   • Description: Leave the current war and teleport to the exit.
     
   • Permission: lunaguerra.join
3. /guerra camarote <arena>
   • Description: Spectate a war in the specified arena.
     
   • Permission: lunaguerra.spectate
4. /guerra vencedores [amount]
   • Description: Shows the last winners of wars. The optional amount defines how many results to display.
     
   • Permission: Available to all players.
5. /guerra info <arena>
   • Description: Displays information about the specified arena.
     
   • Permission: lunaguerra.info
6. /guerra start <arena>
   • Description: Starts a war in the specified arena.
     
   • Permission: lunaguerra.admin
7. /guerra stop <arena>
   • Description: Stops the ongoing war in the specified arena.
     
   • Permission: lunaguerra.admin
8. /guerra forcestart <arena>
   • Description: Forces a war to start immediately, skipping the countdown.
     
   • Permission: lunaguerra.admin
9. /guerra create <arena>
   • Description: Creates a new arena for wars.
     
   • Permission: lunaguerra.admin
10. /guerra delete <arena>
    • Description: Removes the specified arena.
      
    • Permission: lunaguerra.admin
11. /guerra reload
    • Description: Reloads the plugin configuration.
      
    • Permission: lunaguerra.admin
12. /guerra displayname <arena> <name>
    • Description: Sets a display name for the arena (names with spaces must be in quotes " ").
      
    • Permission: lunaguerra.admin
13. /guerra limit <arena> <number>
    • Description: Sets a player limit per clan for the arena.
      
    • Permission: lunaguerra.admin
14. /guerra kit <arena>
    • Description: Saves your inventory and equipment as the default kit for a specific arena.
      
    • Note: Player inventories are cleared before receiving the kit during wars. Remind players to empty their inventory before joining events.
      
    • Permission: lunaguerra.admin
15. /guerra top
    • Description: Displays the top 10 players (by kills) and top 10 clans (by victories).
      
    • Permission: Available to all players.
16. Ban System
    • /guerra banclan <name> [reason] – Ban a clan
    • /guerra banplayer <name> [reason] – Ban a player
    • /guerra unbanclan <name> – Unban a clan
    • /guerra unbanplayer <name> – Unban a player
    • /guerra baninfo <name> – Show ban information
      
    • Note: Banned clans and players are immediately removed from ongoing wars and cannot participate in new ones. They are also removed from /clan top automatically.

️ Tutorial: Configuring LunaGuerra

1. After restarting, the plugin will generate configuration files in plugins/LunaGuerra.
   
2. Edit config.yml and messages.yml as needed.
   
3. Use /guerra reload to apply changes.

Creating an Arena

1. Create a new arena with /guerra create <arena>.
   
2. Configure its properties:
   • /guerra displayname <arena> <name> → set a display name.
     
   • /guerra limit <arena> <number> → set the clan player limit.
     
   • /guerra set <arena> <camarote|espera|saida|inicio>
     • Camarote: Spectator area.
       
     • Espera: Waiting area until the countdown ends.
       
     • Saida: Exit location for players after the war ends.
       
     • Inicio: Spawn point for players (with kit) once the countdown ends.

Managing Kits

1. Save your current inventory as the default arena kit with /guerra kit <arena>.
   • Note: Inventories are wiped before applying kits.

Starting a War

1. Start with /guerra start <arena>.
   
2. Players can join via /guerra entrar <arena> or simply /guerra entrar.
   
3. Stop a war with /guerra stop <arena>, teleporting all participants to the exit.
   
4. Use /guerra forcestart <arena> to skip the countdown and begin instantly.

Placeholders

• %lunaguerra_top_name_<rank>% – Clan name at position <rank>
• %lunaguerra_top_value_<rank>% – Clan victories at position <rank>
• %lunaguerra_player_top_name_<rank>% – Player name at position <rank>
• %lunaguerra_player_top_value_<rank>% – Player kills at position <rank>

Discord Webhook
The plugin supports notifications via Discord Webhook for war events (start and end).

1. Enabling Webhook

1. Open config.yml inside plugins/LunaGuerra.
2. Find the key webhook_url and add your Discord webhook URL:
   
   Code (YAML):

   webhook_url : "YOUR_WEBHOOK_URL_HERE"

2. Embed Configuration

1. On first startup, a folder plugins/LunaGuerra/discord will be created.
2. Inside it, you will find:
   • war_started.json – Embed for war start
   • war_winner.json – Embed for war end
3. Customize these files as you want. After editing, use /guerra reload to apply changes.

3. Available Placeholders

• War Start (war_started.json)
  • {event} – Arena name where the war started
  • {timestamp} – Time when the war started
• War End (war_winner.json)
  • {event} – Arena name of the war
  • {timestamp} – Time when the war ended
  • {top} – Ranking generated as in /guerra top
  • {winner_name} – Name of the winning clan
  • {winner_value} – Total kills of the winning clan