✓ FREE ♛ Skywars X ♛ [Solo, Teams, Kits, Cages, Trails, Mystery Box, Parties] 9.9.1

Please read the FULL page before purchasing.
This is so that you don't purchase the plugin, and regret doing so because of a missing feature, or because you misunderstood what the plugin has to offer

• The reviews section is not the place to be asking for help in. When you are in need of help, please use the discussion area, or send me a private message.
• Purchasing this plugin means that you agree to the plugin agreement found at the bottom of the page!
• This plugin is VERY customizable, but NOT FULLY, so if you need to translate every single text or letter, you either have to purchase the source, or look else where.
• Not all of your suggestions will be taken into consideration. If I feel only you would benefit out of your suggestion it will probably not be added. so some suggestions will straight up be denied and probably never added. and customization requests WILL most likely be rejected. So view what you can change and what you can not CAREFULLY.

customization.yml
config.yml
chests.yml
shop.yml
kits.yml (Not all of them, but a sample)

cages.yml (Not all of them, but a sample)
trails.yml (Not all of them, but a sample)
achievements.yml (Not all of them, but a sample)
broadcaster.yml
arena.yml

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

start by using /sw 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 /sw create <name> <team size> <min teams> <max 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. and Max teams on the other hand is the maximum amount of teams the arena can handle at a time

Once the creation process is over, you can now start adding spawnpoints using /sw addspawn <arena>
Keep in mind that the plugin will generate the cage, so you shouldn't have built in cages in the arena
after you have added your spawnpoints, you can use /sw edit <arena> to enable the arena and change some other settings.

The arena is now ready to be used, but you can also add a join sign for example, or make chests in the middle more powerful.
To do that, you should create a new Chest type, using the command /sw chestmanager create normal <Name>
this will create new chest type and open up a gui for you, you can add your items in that gui, and don't forget to click 'Save & Apply'
After you create your custom chest type, you have to specify which chests are gonna use that chest type, you can do so by doing /sw chestmanager tool <Name>, this will give you a tool that allows you to set specific chests to that chest type, but what if there are too many chests in the middle and you are just lazy? you can select the whole middle area using the wand, and then you can do /sw chestmanager updateregion <Name>, this will set all chests within your selection to the chest type that you specified.

If you want to create a new chest category that people can vote for, then use the same command that you used to create a chest type, but this time don't say the category is 'normal' and instead name it your self (/sw chestmanager create <Name>). This will create a new chest category that has a 'default' chest type where you can put items.

When you add a chest type such as 'Tier2' to a category such as 'Normal' you must add a chest type named 'Tier2' for the other categories. So that no matter which category got the most votes, the chests labeled 'Tier2' will have a location to take items from.

You can also set the location where spectators will be teleported to, but this is optional because if it's not set they will teleport to a random location inside the arena region. To set a specific location for spectators use /sw setspectators <Arena>

You could also use the worldmanager to backup your worlds just incase anything went wrong

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 Skywars X. You should a message that says 'Detected FAWE, it will be used when possible' in console when the Skywars plugin loads up, if not then try restarting or reloading
Then, for existing arenas, you have to select their region using SW WAND and simply write SW 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)

If you want to make all players automatically join skywars when they join your server you need to enable bungee mode in config.yml! If you have a bungee cord and a lobby system, 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

- Using bungee mode, if you have 1 arena setup then players will automatically join that arena once they join the server and when the arena finishes the server will close! If you had multiple arenas in the server then the plugin will simply run the command /pg join to put all players in the lobby where they can select an arena! This also prevents them from leaving the lobby and there is no restarting done here!

Code (Text):
package me.wazup.addon;
import java.sql.SQLException;
import java.util.HashMap;
import java.util.List;
import java.util.Map.Entry;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;
import me.wazup.skywars.Enums.Stat;
import me.wazup.skywars.PlayerData;
import me.wazup.skywars.Skywars;
import me.wazup.skywars.SkywarsAPI;

public class Addon extends JavaPlugin {

public void example(){
SkywarsAPI api = Skywars.api;

//Get a player playerdata
Player p = Bukkit.getPlayer("Wazup92");
PlayerData data = api.getPlayerData(p);

//Modifying some of their stats
data.addCoins(p, 50);
data.kills += 10;

//Some booleans
api.isInArena(p);
api.isSpectating(p);
api.isPlaying(p);

//Getting top players
//First you have to load all players data, this should be Async
try {
HashMap<String, String> playersData = api.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 = api.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 = api.modifyOfflinePlayerStat("Wazup92", Stat.COINS, 50, true);
} catch (SQLException e){
e.printStackTrace();
}

}

}


Events:
- SWArenaStartEvent
- SWArenaFinishEvent
- SWArenaStopEvent
- SWPlayerJoinArenaEvent
- SWPlayerLeaveArenaEvent

Placeholders:
The placeholders mentioned below are for PlaceholderAPI by clip, if you wanted to use placeholders for MVdWPlaceholderAPI by maximvdw use the same ones below but replace the first % with { and the last % with }

Not player specific placeholders:
%skywars_players_count% - Gives the total amount of players in skywars
%skywars_parties_count% - Gives the total amount of parties created
%skywars_lobby_players_count% Gives the total amount of players in the lobby
%skywars_arenas_count% Gives the total amount of arenas created
%skywars_kits_count% Gives the total amount of kits created
%skywars_trails_count% Gives the total amount of trails created
%skywars_cages_count% Gives the total amount of cages created

Player specific placeholders:
%skywars_kills%, %skywars_deaths%, %skywars_wins%, %skywars_modifier%, %skywars_projectiles_launched%, %skywars_projectiles_hit%, %skywars_player_exp%, %skywars_player_rank%, %skywars_blocks_placed%, %skywars_blocks_broken%, %skywars_arena%, %skywars_party_leader%, %skywars_selected_kit%, %skywars_selected_trail%, %skywars_selected_cage%
%skywars_teamcolor%, %skywars_coins%