Note: This plugin was originally created by "gaelitoelquesito", but it later went discontinued and removed. His last version, 4.6.1, is posted as "*EggWars* | SpigotMC - High Performance Minecraft" by user "bemvindo". The old plugin supported versions from 1.8 to 1.11.2.

However, I updated the plugin giving major changes to the code so now it works in versions from 1.16 to 1.21.4; a lot of bug fixes, improved customization, added items & health voting...

Features:
- Arenas:
Arenas (or Maps) are where the game takes place. Every arena has two minecraft worlds, one is stored on the arena folder (used for regenerating the arena world when game re-starts) and the other is stored at the root folder (this is the accessible world used by the game).

- Teams and Solo:
Teams are very important for the game, and is required to have at least 2 on setup.
Actual teams are Red, Dark Blue, Green, Yellow, Purple, Orange, Dark Green, Light Blue, Pink, Gray, Cyan, Black and White, making a total for 13 teams.
On setup you can select the maximum number of players per team (at least one per team)
When waiting in arena, players can select their team.
When a player picks up or buys a colorable item such as Terracotta, Glass or Armor (and more), said item will turn into the player's team color (if the case is Rainbow team, it will be randomly colored)
On gameplay, teammate players' tags are displayed in bold format, also the scoreboard displays your team name in bold.

- Kits:
When you are waiting in arena, you can select or buy kits to use them in game.
They have a configurable delay between deaths, or you can choose it to be obtainable at once per game, auto equippable armor, with infinite possibilities (no kit cap).
To-do: Kit Customization

- Items & Health voting:
Players can vote when waiting for game the tier of items and max health:
Items have three tiers: "Hardcore", "Normal" and "Overpowered". If hardcore is selected players will not be able to regenerate health naturally.
Four types of max health: "Half", "Normal", "Double" and "Triple".

- Item Generators & Tokens:
Generators that generate different types of tokens across the arena.

Spoiler: Generator Customization

Item generators are stored at "/root/plugins/EggWars/custom/generators.json", here's a guide if you want to make your own:

- Villager Shop:
Each team has a villager where players trade tokens for gear.
To-do: Trades Customization
To-do: Map Specific Trades Customization

- Tokens:
Tokens are the currencies used on villagers and generators on eggwars, such as Iron, Gold, Diamonds and Emeralds.

Spoiler: Token Customization

Token types are stored at "/root/plugins/EggWars/custom/tokens.json", here's a guide if you want to add your own:

Basic Commands:
/ew join <arena_name> - Join an existing arena
/ew lobby (also /leave or /eggwars:leave) - Leave the arena you are in and return to the lobby.
/ew forceStart <arena_name> - Forces the start of the specified arena (if no value provided, it will default to the arena you are in)
/ew randomJoin - Join a random arena (or map)

Advanced Commands:
/ew reload <all:config:languages:kits:generators:trades> - Reloads the specified plugin feature configuration. In other words, it reloads the "custom" configuration.
- Trades have a special case when arenas are ingame, these will not be affected by the reload until the game finishes.
- Tokens will be reloaded along generators and trades, this is because just reloading them would not affect anything else. In other words, if you reload trades, tokens will also be reloaded and will NOT affect generators and vice-versa.

/ews createArena <arena_name> - Creates an arena. From this point you will receive the instructions you need to follow to create this arena. Note that if you have a world which i'ts name collides with the arena's, it will use said world as the arena (but don't worry, it just will be copied to the arena folder!).

/ews toggleEd itMode <arena_name> - You will be teleported to the specified arena and be able to make changes (like the createArena command).

Customization:
You can customize a lot of features: kits, generators, tokens, trades (even arena specific trades!), languages (you can make your own), arenas... They all use the .json format, except config.yml. If you're not familiarized with it, I highly recommend to use Visual Studio.
I plan to add the documentation section so you will see more clear what fields you can customize.

Placeholders:
Arena (non-player) placeholders:
- %eggwars_arena_<name>_display_name%, display name of the given arena (could be different if you changed the arena config files)
- %eggwars_arena_<name>_time_until_start%, remaining time in seconds until the game starts (in lobby and when in cages, separately)
- %eggwars_arena_<name>_status_id%, id name of the current status of the arena
- %eggwars_arena_<name>_current_players%, number of players present in the arena. When in-game, only shows alive players
- %eggwars_arena_<name>_min_players%, minimum players required for the arena to start
- %eggwars_arena_<name>_max_players%, player cap of the arena

Translation (non-player) placeholders:
- %eggwars_translate_&lang:<language>&key:<key>%, translates the given key to given language. Language can be empty but '&lang:' must remain
- %eggwars_translate_&lang:<language>&key:<key>&args:<arguments>%, arguments must be separated using string #AND#
- %eggwars_translate_&lang:<language>&time:<seconds>%, translates time from seconds to Years, Days, Hours, Minutes and Seconds (All units if necessary).
- %eggwars_translate_&lang:<language>&time:<seconds>&full:<true/false>%, With "full" true works the same as above. If false, return value will be capped to two time units.

Player placeholders:
- %eggwars_id_arena%, the name of the arena the player is in, returns empty string if none
- %eggwars_id_team%, namespaced id of the eggwars team the player is in, returns empty string if none
- %eggwars_<type*>_kills%, number of kills that the player made
- %eggwars_<type*>_wins%,number of games won by the player
- %eggwars_<type*>_deaths%, number of times that the player died
- %eggwars_<type*>_eggs_broken%, number of eggs broken by the player
- %eggwars_<type*>_eliminations%, number of final kills the player has performed
- %eggwars_<type*>_games_played%, number of games that the player played (every time is released from cage)
- %eggwars_<type*>_time_played%, time in seconds the player has spent on games. To translate it into a full time string, use translation placeholders
- %eggwars_<type*>_games_played%, number of games that the player played (every time is released from cage)
- There are also extra stats for blocks
- %eggwars_<type*>_blocks_placed%
- %eggwars_<type*>_blocks_broken%
- %eggwars_<type*>_blocks_walked%

* Type means that it can be these stat types: stat_<team;solo> (if it's a stat from solo or team arenas), or stat_ingame (if it's a stat gathered from the current game the player is playing), or stat_total (if it's a stat wich is the sum of solo and team)

Bugs & Feedback:
You can report bugs or suggest new features on the GitHub page or the discussion of the plugin as well (but NOT in reviews, please), and I will (try to) fix them for future updates.

Updates:
The game is now in phase v6 of the plan, which I will be fixing bugs and rework some internal aspects of the code, but also adding smaller things. However, the plugin will always receive new updates to support new minecraft versions when they come.
This plugin currently supports only the latest minecraft versions, and I do not plan to add support for <1.16, even 1.8 or 1.12.