✦ Eggwars/Bedwars X ✦

- You can spawn mobs that target your enemies or protect your base, and you can also equip them with armor and weapons
- Players can not break arena blocks, and can not place blocks next to villagers and spawners.
- A profile gui where you can see all of your stats and your unlocked kits and trails and achievements
- Lobby countdown shortening system! If the arena has a certain number of players the timer will be shortened to begin faster
- You can show the health of the target when hitting it with a bow
- A warning system to prevent spectators from affecting the game
- Join the arenas through a sign or a gui that shows a list of arenas with some information about them
- Armor auto equip
- A customizable limit for how many times a player can kill the same player in the same match to prevent farming kills
- You can spectate active games!
- A team selector tool to join a specific team
- Enderchests are shared between team members
- The plugin contains a broadcaster system that announces certain messages every x seconds
- Set the coins/exp modifier of players to any number you want
- You can shift click in the villager shop to spend all the materials you have (Quick purchase of large quantities)
- You can send messages to party members only by starting your message with an exclamation mark
- Command aliases!
- Players can not break blocks below team mates
- Lightweight cooldown system
- Edit arenas on the fly!
- You can sell kits and trails that you no longer need
- You can create permissions that allow players to have more slots per party
- You can customize the commands executed on players when the arena starts or when players win
- You can have an animated scoreboard title
- API and Events to allow other developers to make addons!
- An update checker to keep you alert inside your game!
- Lightweight on the server
- Smooth, well designed, and created to be able to handle large amount of players
- Im wondering if you are still reading... but im sure you get the point eh? The plugin cotains features upon features!

Config.yml
Customization.yml
Shop.yml
Villager_shop.yml
Kits.yml (Showing only 2 kits)
Cages.yml (Showing only 2 cages)
Trails.yml (Showing only 2 trails)
Achievements.yml (Showing only a few achievements)
Broadcaster.yml
Arena-Settings.yml (Per arena)

You can of course translate the files on your own, but here are some pre-made translations done by the community.
Please note that these translations are made by users and not by me. You should check these files using a yaml parser before installing them on the server as they might have some errors.

https://1drv.ms/u/s!Ar7IHWG_oZWhgRwxLaWbnkeFT_-F?e=0jJlkO

You first want to set the lobby location by doing /ew setlobby
so that when players do /ew join they will be teleported there
now you should create some arenas

Assuming that you do not have multiverse, and your map is not loaded, you could use the command /ew worldmanager import <Map> and then teleport to it with /ew worldmanager tp <Map>

start by using /ew wand and use the tool given to select the 2 corners surrounding your map.
Once you have selected the 2 corners, create the arena using /ew create <name> <team size> <min teams>
This will create a new arena with your defined name.
Team size is the amount of players per team, if it was set to 1 then the arena is basically solo
Min teams is the minimum amount of teams required for the game to start the countdown.

Once the creation process is over, you can now start adding teams, and to do that you have to set the team spawnpoint and egg location. Go to the team island and set the spawnpoint with /ew setteamspawn <Arena> <Team Color>, Team color is the color of the team, and can only be one of the chat colors, such as blue, red, yellow, light_purple, aqua, green....
and to set the team egg, you have to look at the egg and do the command /ew setteamegg <Arena> <Team Color>, once these 2 steps are done, the team will be registered.

Now you need to mark the generators. look at the block that you want to mark as a generator and use the command /ew addspawner <Arena> <Material> <Speed in ticks> <Broken>
The material is the item that will be spawned, such as IRON_INGOT, EMERALD, DIAMOND, and it can be anything really, even GRASS
Speed in ticks is how frequently this generator will spawn an item, 10 ticks is 0.5 seconds, while 40 ticks is 2 seconds (1 second = 20 ticks)
Broken is a true or false value that indicates whether a generator works by default or needs to be fixed by players, if it is false that means it is not broken and works by default

* It is recommended that before you add the generators and set their speeds that you check the villager_shop.yml. The generators should link well with the villager shop, what i mean by this is that for example, if the IRON_INGOT generators are very fast, that means that iron_ingot is a common item and should not award high end items. while a generator that is slow for example 600 ticks, should provide decent items in the villager shop

You also want to add the villagers, which can be done with a simple /ew addvillager <Arena>, these villagers act as shops

* If you have made any changes to the arena blocks after creating it, you should update it with /ew updateregion <Arena> and it will probably ask you to set the 2 corners again.

* You can set the location that spectators teleport to, but this step is not necessary. To set the location you use the command /ew setspectators <Arena>

Lastly, you need to set the lobby location of the arena where players will wait and vote for stuff until the arena starts, this can be easily done with /ew setlobby <Arena>

After you are finished you can use /ew edit <Arena> to enable the arena and change some other settings.

If you want to use FastAsyncWorldEdit rollback (Recommended!) then,
make sure that FAWE is installed on your server and is running correctly, and make sure that Use-FastAsyncWorldEdit-When-Possible is set to true in config.yml in Eggwars X. You should a message that says 'Detected FAWE, it will be used when possible' in console when the Eggwars plugin loads up, if not then try restarting or reloading
Then, for existing arenas, you have to select their region using EW WAND and simply write EW UPDATEREGION <Arena>. This will update the region as usual but if everything is setup correctly, it will also create a schematic of the arena and use it to rollback.
For newly created arenas, this will automatically be done (A schematic will be made if possible and used to rollback)

Bungee mode setup! for this all you have to do is the same steps as before, you should make some maps and when you think that you have enough, go to config.yml and enable bungeemode. This plugin will only be on your game server and NOT in your hub server, if you want to join through signs from your hub server, then you need to have a plugin such as TeleportSigns in your hub.
If you have only 1 arena in the server and enabled bungee mode then players will directly join that arena, but if you have multiple arenas, they will be put into the regular lobby where they can select what arena they want to play!

For the villager shop, if you have Villager-Shop-Type set to Separate-Inventory in config.yml, then use villager_shop.yml to modify the shop
If you set Villager-Shop-Type to Single-Inventory, then use single_villager_shop.yml

If you want to display generator signs or images, you need to put an item frame on top of the generator block or around it. The same thing goes for signs.
Remember, if you add these signs/item frames after your map is created, you have to update the arena region again.

To create Eggwars signs, the first line has to be [EW]

To create join signs for the lobby, second line has to be 'join'

To create join signs for arenas, second line has to be 'join'
while the third line must define the arena name

To create leave signs, second line has to be 'leave'

To create autojoin signs, second line has to be 'autojoin'
In this type of signs, you can leave the third line empty, or you can specify 'Solo' or 'Team'

To create leaderboard signs, second line has to be 'top' while the third line must define the stat that you want the plugin to order players stats by. and fourth line is the rank you are looking for!
Example:
[ew]
top
kills
1

This will display the top killer!
for a list of stats that you can use, simply keep the third line empty and the plugin will show you a list.

You can also add a skull above the sign, and when the leaderboard updates, the skull will display players skins

[img]http://blob:http://imgur.com/a1edce22-7d11-4583-9bc0-cafec3f9fc71.png[/img]



































[img]http://blob:http://imgur.com/a1edce22-7d11-4583-9bc0-cafec3f9fc71[/img]

- Play.Minecraft-Romania.Xyz
- jogar.craftsgp.net
- mc.frostrealms.com
- Fancycraft.cc
- dekolp.net
- play.netronixmc.com
- eggwarsmc.serverminer.com
- jelp7.mcalias.com

For internal lobby scoreboard, you can use these placeholders:
%kills%, %coins%, %deaths%, %wins%, %projectiles_launched%, %projectiles_hit%, %player_exp%, %player_rank%, %blocks_placed%, %blocks_broken%, %eggs_broken%, %arena%, %selected_kit%, %selected_trail%

The placeholders mentioned below are for PlaceholderAPI, if you want to use MVdWPlaceholderAPI placeholders then use the same placeholders below but replace the first % with { and replace the last % with }

Placeholders:

Not player specific placeholders:
%eggwars_player_count% - Gives the total amount of players in eggwars
%eggwars_parties_count% - Gives the total amount of parties created
%eggwars_lobby_players_count% Gives the total amount of players in the lobby
%eggwars_arenas_count% Gives the total amount of arenas created
%eggwars_kits_count% Gives the total amount of kits created
%eggwars_trails_count% Gives the total amount of trails created
%eggwars_arena_status_<arenaName>% which returns the status of the arena name specified
%eggwars_bungee_arena_status% which returns the status of the arena if the server is in bungee mode and there is only 1 arena
%eggwars_arena_players_<arena>% returns the number of players in an arena
%eggwars_arena_max_players_<arena>% returns the max amount of players in an arena

Player specific placeholders:
%eggwars_kills%, %eggwars_coins%, %eggwars_deaths%, %eggwars_wins%, %eggwars_modifier%, %eggwars_projectiles_launched%, %eggwars_projectiles_hit%, %eggwars_player_exp%, %eggwars_player_rank%, %eggwars_blocks_placed%, %eggwars_blocks_broken%, %eggwars_eggs_broken%, %eggwars_arena%, %eggwars_party_leader%, %eggwars_selected_kit%, %eggwars_selected_trail%, %eggwars_team_colorcode%

You can access the api with -> EggwarsAPI class
Methods:
- EggwarsAPI.getPlayerData(Player p); -> returns the player playerdata which holds all of his stats (Everything can be modified)
- EggwarsAPI.isInArena(Player p);
- EggwarsAPI.isSpectating(Player p);
- EggwarsAPI.isPlaying(Player p);
- EggwarsAPI.getTeam(Player p); //Returns a scoreboard team
- EggwarsAPI.getArenaName(Player p);
- EggwarsAPI.getTeams(String arenaName); //Returns a list of all the registered teams
- EggwarsAPI.translateChatColorToColor(ChatColor cc); //Returns a color that hold the rgb values (Which can be used to dye leather armor)
- EggwarsAPI.getItemStack(String itemString, boolean amount, boolean extras); //Used to read the plugin item format which is 'ITEM:DURABILITY : AMOUNT : EXTRAS' if the item string contains an amount then the boolean should be true, if the item string contains enchantments and what not then the extras boolean should be true
- EggwarsAPI.getItemStackString(ItemStack item); //Returns a string that can be read by the getItemStack() method

Now for the methods that are a little more complicated

    //Getting top players
    //First you have to load all players data, this should be Async

try {
    HashMap<String, String> playersData = EggwarsAPI.getAllPlayersData();

//You can now get top players out of the playersData, ordered by a specfic stat
    //If the third argument (int) is bigger than the amount of entries in the playersData hashmap, it will be filled with 'NO_PLAYER'

List<Entry<String, Integer>> top = EggwarsAPI.getTopPlayers(playersData, Stat.KILLS, 10);

//Top now contains the top 10 players, ordered by their kills stat
    //Entry key is the player name, and the entry value is their score

for(int i = 0; i < top.size(); i++){
    Bukkit.broadcastMessage("# " + (i+1) + " is " + top.get(i).getKey() + " with a score of " + top.get(i).getValue());
    }

} catch (SQLException e){
    e.printStackTrace();
    }

//If you want to modify offline players stats, then you have to use a different method, because you can't use the PlayerData class on offline players
    //The following method returns true if the stat was updated, and it returns false if the player name wasn't found or the stat wasn't updated for some reason
    //The boolean at the end 'increment' is whether you want to SET their stat to the give value, or you want to add it up

try {
    boolean updated = EggwarsAPI.modifyOfflinePlayerStat("Wazup92", Stat.COINS, 50, true);
    } catch (SQLException e){
    e.printStackTrace();
    }

}

}

Why is my holographic stats colliding with other players holographic stats?



Signs are being created, yet they are not clickable!



Arenas are not starting on my 1.9+ server!



Monster eggs say Invalid Entity!



Is this plugin a one game per server?


Villagers are not spawning!



HELP! LAG!