EggWars | The Ultimate Experience
Fully Customizable | BungeeCord & Multi-Arena | Shops, Kits, Voting & More!
Description
EggWars is a highly advanced and fully customizable mini-game plugin designed to provide the ultimate EggWars experience. Whether you want to run a dedicated server or multiple arenas on a single server, EggWars handles it all with ease. With robust features like a completely JSON-configurable shop system, smart generators, voting mechanics, and a rejoin system, this plugin is built for modern servers.
Features
Multi-Mode Support
BungeeCord Mode: Dedicated server support with automatic joining and lobby logic.
Multi-Arena Mode: Run multiple arenas on a single server with sign support.
Advanced Modern Shop
Modern GUI: Sleek category-based shop interface for easy navigation. We have also Classic Shops
Favorites System: Shift+Right Click items to add them to your Quick Access bar for instant purchasing.
Fully Configurable: Edit trades easily via custom/trades.json.
Auto-Equip Logic: Smartly equips armor and items to the best available slot.
Multi-Result Offers: Create trades that give multiple items at once.
Game Mechanics
Emerald Spawn & Discounts: Secure the center to collect emeralds and buy Team Upgrades that give permanent shop discounts! You can also earn emeralds by killing players or breaking eggs (fully configurable).
Rejoin System: Players who disconnect can rejoin their ongoing game (restores inventory, emeralds, and stats!).
Voting System: Players can vote for Item Types (OP, Normal, Hardcore) and Health.
Smart Generators: Customizable generators with images, signs, hologram displays (upgradeable).
Kits & Perks: Create custom kits for players via configuration.
Database & Stats
MySQL & SQLite Support: Flexible database options for sync or local storage.
Stats Tracking: Tracks Kills, Wins, Deaths, Eggs Broken, etc.
Customization
Multi-Language System: Players can select their preferred language (/ew lang).
PlaceholderAPI Support: Full support for placeholders in scoreboards/chat.
Vault Support: Optional economy integration.
Overpowered Plus Mode (Cubecraft Inspired):
This mode brings exclusive features like the Leap Feather and Fireball with fully adjustable limits:
• Leap Feather: Configurable launch power (horizontal/vertical), cooldowns, particles, and sounds.
• Fireball: Adjustable explosion power, knockback, cooldown, and a list of protected blocks (obsidian, etc.).
Configuration Structure
Code:
EggWars/
├── config.yml # Main plugin configuration
├── custom/ # Custom JSON configurations
│ ├── trades.json # Shop items and prices
│ ├── kits.json # Kit definitions and contents
│ ├── generators.json # Generator settings
│ ├── tokens.json # Currency settings
│ └── gen_images/ # Images for generator holograms
└── langs/ # Language files
├── en_us.json # English translation
└── es_es.json # Spanish translation
|
|
Shop GUI | Arena Setup |
|
|
Kit Selector | Voting Menu |
|
|
|
Others |
PlaceholderAPI Variables
Arena Info:
%eggwars_arena_[ArenaID]_display_name% - Display name
%eggwars_arena_[ArenaID]_time_until_start% - Countdown
%eggwars_arena_[ArenaID]_status_id% - Game state
%eggwars_arena_[ArenaID]_current_players% - Player count
%eggwars_arena_[ArenaID]_max_players% - Max players
Player Stats:
%eggwars_points% - Current points
%eggwars_stat_total_kills% - Total kills
%eggwars_stat_total_wins% - Total wins
%eggwars_stat_total_deaths% - Total deaths
%eggwars_stat_ingame_kills% - Kills in current game
Arena Info:
%eggwars_arena_[ArenaID]_display_name% - Display name
%eggwars_arena_[ArenaID]_time_until_start% - Countdown
%eggwars_arena_[ArenaID]_status_id% - Game state
%eggwars_arena_[ArenaID]_current_players% - Player count
%eggwars_arena_[ArenaID]_max_players% - Max players
Player Stats:
%eggwars_points% - Current points
%eggwars_stat_total_kills% - Total kills
%eggwars_stat_total_wins% - Total wins
%eggwars_stat_total_deaths% - Total deaths
%eggwars_stat_ingame_kills% - Kills in current game
Arena Join Sign
Line 1: [EggWars]
Line 2: ArenaName
Generator Sign
Line 1: [EggGen]
Line 2: iron/gold/diamond
Line 3: 1 (Level)
Tip: Use /ews getGuiItem to get setup items!
Line 1: [EggWars]
Line 2: ArenaName
Generator Sign
Line 1: [EggGen]
Line 2: iron/gold/diamond
Line 3: 1 (Level)
Tip: Use /ews getGuiItem to get setup items!
| Command | Description | Permission |
|---|---|---|
| /ew forceStart [arena] | Force start an arena. | eggwars.command.forcestart |
| /ew join [arena] | Join a specific arena. | eggwars.command.join (Default) |
| /ew randomJoin | Join a random available arena. | eggwars.command.join (Default) |
| /ew leave | Leave the current arena. | eggwars.command.leave (Default) |
| /ew lobby | Teleport to the lobby. | eggwars.command.lobby (Default) |
| /ew menu | Open the main menu (kits/shop/settings). | eggwars.command.menu (Default) |
| /ew rejoin | Rejoin your previous match if disconnected. | eggwars.command.rejoin (Default) |
| /ew lang [language] | Change your personal language. | eggwars.command.lang (Default) |
| /ew mapjoin | Open the current map for everyone to join (Broadcast). | eggwars.command.mapjoin |
| /ew pause | Pause/Resume the lobby start countdown. | eggwars.command.pause |
| /ew reload [type] | Reload plugin configurations. | eggwars.command.reload |
Setup Wizard Commands
All commands start with /ews and require eggwars.setup permission.
| Subcommand | Description |
|---|---|
| help | View the help page for setup commands |
| createArena [name] [solo/team] | Create a new arena configuration |
| cloneArena [arena] [newName] | Duplicate an existing arena |
| removeArena [name] | Delete an arena |
| setBounds [pos1/pos2] | Set the arena boundaries (for rollback) |
| setCenter | Set the center point (emerald spawn) |
| setWaitingLobby | Set the lobby where players wait before game |
| setMainLobby | Set the fallback lobby (when leaving game) |
| setBungeeLobby [server] | Set the BungeeCord lobby server name |
| addTeam [name] [color] | Add a new team to the arena |
| removeTeam [name] | Remove a team from the arena |
| moveTeam [team1] [team2] | Swap two team slots/colors |
| setTeamSpawn [team] | Set the spawn location for a team |
| setTeamVillager [team] | Set where the team's shop villager stands |
| setTeamEgg [team] | Set the location of the team's egg |
| setTeamRespawn [team] | Set specific respawn point (if distinct from spawn) |
| addTeamCage [team] | Add blocks to define the team's waiting cage |
| removeTeamCage [team] | Remove blocks from the team's waiting cage |
| setMinPlayers [count] | Set minimum players required to start |
| setMaxPlayers [count] | Set maximum players per team |
| setVoidHeight [y-level] | Set the Y-level where players die instantly |
| setCountdownStart [seconds] | Set timer duration when min players joined |
| setCountdownFull [seconds] | Set timer duration when arena is full |
| setCountdownRelease [seconds] | Set delay before cages open after game start |
| tpArena [arena] | Teleport to the arena's world |
| teamList | List all teams configured in the arena |
| toggleEditMode | Enable/Disable structure editing protections |
| getGuiItem [arena] | Get the setup GUI access item |
Additional Permissions
eggwars.admin - Grants all permissions (OP default)
eggwars.setup - Access to setup commands and signs
eggwars.arenaSign.place - Place arena join signs
eggwars.arenaSign.break - Break arena join signs
eggwars.genSign.place - Place generator signs
eggwars.genSign.break - Break generator signs
eggwars.chatcolor - Allow color codes in chat
eggwars.shop - Access to use the villager shop (Default)
eggwars.kits - Access to select kits (Default)
eggwars.freekits - Get all kits for free
eggwars.multpoints - Permission to receive point multipliers (Default)
eggwars.vote - Access to all voting types
eggwars.vote.items - Vote for item types
eggwars.vote.health - Vote for health types
eggwars.map.* - Bypass per-map join permissions
Installation
Drop EggWars.jar into your plugins folder.
(Optional) Install PlaceholderAPI and Vault for full functionality.
Restart your server.
If u bought premade maps addon, you need to move these files to EggWars/arenas folder and restart server.
Use /ews to start the setup wizard and create your first arena!
Join Our Discord Server
