config.yml
customization.yml
kits.yml
trails.yml
cages.yml
Powerups.yml
achievements.yml
broadcaster.yml
arena-settings.yml (Per arena)

If you want to use a premade setup, then go ahead and download the zip file from this link and then extract it.

< MC 1.13 - SuperSmashX Old Free Setup.rar
>= MC 1.13 - SuperSmashX New Free Setup.rar

You will find 2 folders inside, one is named 'SuperSmashX plugin folder', and the other one is named 'SuperSmashX world folder'.

Rename the folder 'SuperSmashX plugin folder' to 'SuperSmashX' and put it in your plugins folder, next to the SuperSmashX.jar file and your other plugins.

Next, rename the folder 'SuperSmashX world folder' to 'SuperSmashX' and add it to the server folder next to other worlds

That's it! you can now start the server and let the plugin generate additional files for later customization while you enjoy the plugin using /ss join

If you face issues in the console regarding the arenas, try updating them by doing /ss updateregion <Arena>

You first want to set the global lobby location by doing '/ss setlobby'
so that when players do '/ss 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 '/ss worldmanager import <Map>' and then teleport to it with '/ss worldmanager tp <Map>'

Start by using '/ss 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 '/ss create <Name> <Team size> <Min teams> <Max teams> <Kills/Lives>'
This will create a new arena with your defined name.
<Team size> is the size of each team in the arena. 1 for solo, and any number above for teams.
<Min teams> is the minimum amount of teams required for the arena to start.
<Max teams> is the maximum amount of teams that the arena can handle at a time.
<Kills/Lives> is the game mode of the arena. Kills means that the team that reaches a certain amount of kills first is the winner. Lives means that each player has a certain amount of lives, running out of lives eliminates the player.

if you have FastAsyncWorldEdit installed, the create command will also create a schematic that will be used for rollback. (Optional, Better option)

You can now start adding some spawnpoints for players . To do so, use the command '/ss addspawn <Arena>', which will add a new spawn point at your location. You can add as many as you want. You need to have a number of spawn points at least equal to the maximum amount of teams permitted in the arena. The more spawn points you have, the better spread the players will be. Keep in mind that cages spawn at the spawn points, so they should be floating.

You can now set the lobby location of the arena using the command '/ss setlobby <Arena>'. This is where players will teleport when they join this specific arena.

* In this lobby, you can create kit NPCs using the command '/ss kitnpc add <Kit> <EntityType>'. This step is completely optional.

You can also add powerup spawnpoints, go to the desired powerup spawn locations and use /ss addpowerup <Arena>

* If you have made any changes to the arena blocks after creating it, you should update it with '/de 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 '/ss setspectators <Arena>'

After you are finished you can use '/ss edit <Arena>' to enable the arena and change some other settings. Don't forget to click the save and apply button if you modified anything inside the edit GUI.

--- Bungee mode setup! for this all you have to do is the same steps as before, you should make some arenas 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, the plugin will make players enter the 1 arena directly (No lobby) and also restart when the arena ends.
If you have 2+ arenas, then the plugin will make players enter the lobby first (Same as '/de join') and then they will be able to select the arena they want, and no restart will occur upon end.

- To create signs, the first line must be [SS]

- To create a lobby join sign, the second line should be 'join'
- To create an arena join sign, the second line join be 'join' and the third line should be the arena name
- To create a leave sign the second line should be 'leave'
- To create an autojoin sign the second line should be 'autojoin'

- To create leaderboard signs the second line should be 'top' and the third line should be the stat name, example 'wins', 'games_played' etc...
and the fourth line should be the rank you are looking for! If you want to display the TOP player (rank 1) then write in the fourth line '1'

The API can be simply accessed using the class named SuperSmashXAPI.

Methods:

• getTopPlayers (Should run async)

- First argument is the players data which you can get from SuperSmashXAPI.getAllPlayersData()
- Second argument is the stat, for example Stat.WINS
- Third argument is the amount of top players you are looking for

Example:

• SuperSmashXAPI.modifyOfflinePlayerStat (Should run async)

- First argument is the player name
- Second argument is the Stat that you want to modify, for example Stat.COINS
- Third argument is the value
- Fourth argument is a boolean which indicates whether the value (3rd argument) should be 'added' to the existing score or the stat should be just overwritten to the value.

Example:
You can also access lots of methods using class instances.
The main class instance can be retrieved using SuperSmashX.getInstance()
You can access the customization class with Customization.getInstance() and the config class with Config.getInstance() and many other classes. But you are not really supposed to use those and they won't be documented. So ask me for help before using methods in those classes.

SSArenaStartEvent
SSArenaStopEvent
SSPlayerJoinArenaEvent
SSPlayerLeaveArenaEvent
SSPlayerDeathEvent

For internal lobby scoreboard, you can use these placeholders:
%kills%, %deaths%, %games_played%, %coins%, %wins%, %player_exp%, %player_rank%, %selected_kit%, %selected_trail%, %selected_cage%

Internal arena scoreboard can use these placeholders:
%arena%, %players%, %max_players%, %timer%, %mode%, %date%

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 }

Not player specific placeholders:
%supersmashx_players_count%, %supersmashx_parties_count%, %supersmashx_lobby_players_count%, %supersmashx_arenas_count%, %supersmashx_kits_count%, %supersmashx_trails_count%, %supersmashx_cages_count%, %supersmashx_arena_status_<arena>%, %supersmashx_bungee_arena_status%, %supersmashx_arena_players_<arena>%, %supersmashx_arena_max_players_<arena>%, %supersmashx_arena_viewers_<arena>%

Player specific placeholders:
%supersmashx_arena%, %supersmashx_modifier%, %supersmashx_party_leader%, %supersmashx_kills%, %supersmashx_deaths%, %supersmashx_games_played%, %supersmashx_coins%, %supersmashx_wins%, %supersmashx_player_exp%, %supersmashx_player_rank%, %supersmashx_selected_trail%, %supersmashx_selected_kit%, %supersmashx_selected_cage%