VIP ♛ Skywars X ♛ [Solo, Teams, Kits, Cages, Trails, Mystery Box, Parties] 10.2

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

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/f/s!Ar7IHWG_oZWhgSDIbN-tK-EuaKMt?e=E4OK5s

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.

If you want to show the arena in the arena selector that shows when the play item is used, you have to add the arena in arena-selector.yml which is located in /plugins/Skywars folder. Once you add the arena name in there, you have to perform /sw reload to reload the configuration files.

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 make chests in the middle more powerful, 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!

Spanish tutorial by Luisomar0361




Thanks to Hydra666 for this polish tutorial

To create Skywars signs, the first line has to be [SW]

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:
[sw]
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

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

Placeholders:
For the lobby scoreboard customization in (customization.yml) the placeholders are as follows:
%kills%, %deaths%, %games_played%, %accuracy%, %wins%, %modifier%, %projectiles_launched%, %projectiles_hit%, %player_exp%, %player_rank%, %blocks_placed%, %blocks_broken%, %selected_kit%, %selected_trail%, %selected_cage%, %selected_celebration%, %elo%

For the arena scoreboard customization in (customization.yml) the placeholders are as follows:
%arena%, %mode%, %players%, %current_event%, %current_event_time%, %date%

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
%skywars_arena_status_<arena>% %skywars_arena_players_<arena>% %skywars_arena_min_players_<arena>% %skywars_arena_max_players_<arena>%

Player specific placeholders:
%skywars_kills%, %skywars_games_played%, %skywars_deaths%, %skywars_accuracy%, %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_selected_celebration%
%skywars_teamcolor%, %skywars_coins%, %skywars_elo%