- Tested Minecraft Versions:
- 1.8
- 1.9
- 1.10
- 1.11
- 1.12
- 1.13
- Source Code:
- https://github.com/walrusone/SkyWarsReloaded
- Contributors:
- Walrusone
This version is no longer in development. Please go to THIS page for a continued version of the plugin.One very important point I want to make up front, is that SWR 3.0 and above are a complete rebuild and was designed to be a competitive style skywars plugin. Due to the nature of the changes, old databases will not be compatible with SWR 3.0 and above. You must use a new database, meaning all current player stats from previous SWR versions can not be brought over easily. It adds a ELO points ranking system.
ALL INFORMATION BELOW IS FOR SWR 3.0 and Above. Please do not consult this guide if you are using a earlier version.
While I have tested as much as I could and have had some testers trying things out, with the rebuild there is still a good possibility of bugs. Please report bugs in the discussion page, with the following information if available:
- Spigot Version You Are Running
- SWR Version You Are Running
- A Description of the bug/error
- A pastebin of the error, if it shows up in console.
All the info you need to set up SWR is in the sections below. However, if you are having problem, GCNT has been helping people with support since SWR 3.0 release. So if you are having issues and need help, feel free to contact GCNT on his Discord Server. Please note that his discord server is for plugin setup support. If you have bugs, please report them on the discussion page as listed above. Big thanks to lukas.vdgaag for helping out.
Player Commands
- sw quit: Quits from the current game
- sw join: Join a SkyWars match
- sw spectate [playername/mapname]: Spectates the game that the player is in or the map.
- sw stats [playername]: Shows a players stats
- sw top [stat]: Displays SkyWars leaderboard for the selected stat
- sw options: Opens the options selection menu.
- sw winsound: Opens the win sound selection menu.
- sw killsound: Opens the kill sound selection menu.
- sw glass: Opens the glass color selection menu.
- sw taunt: Opens the taunt selection menu.
- sw particle: Opens the particle effect selection menu.
- sw projectile: Opens the projectile effect selection menu.
Admin Commands
- sw setspawn: Sets the lobby spawn.
- sw stat [playername] [stat] [method] [amount]: Changes a players stat based on the method. For integer stats, method can be "add", "remove", or "set". For non-integer stats, always use "set".
- sw clearstats [playername]: Clears a SkyWars players stats
- sw reload: Reloads SkyWars
- sw chestadd [chesttype] [method] [percentage]: Adds item(s) in hand/inventory to the chesttype with the assigned percentage. Type can be basic, normal, op, or crate.
- sw start: Forces a match to start without having the minimum players listed the maps.yml.
- sw updatetop: Forces an update of the leaderboards.
- sw hologram [stat] [format]: Adds a hologram at your eye location.
- /sw holoremove: Removes the closest hologram leaderboard.
Kit Commands
- swkit create [kitname]: Create a kit using the items in your inventory
- swkit enable [kitname]: Toggles whether the kit is enabled or disabled
- swkit icon [kitname]: Sets the icon for the kit to the itemstack in your hand
- swkit lockicon [kitname]: Sets the locked icon for the kit to the itemstack in your hand
- swkit perm [kitname]: Toggles whether a permission is needed to unlock the kit
- swkit list: Lists all kits
- swkit load [kitname]: Clears your inventory and loads the kit into your inventory
- swkit lore [kitname] [number] [lore]: Used to set up to 16 lines of lore and locked lore. <number> can be between 1 and 16 or the string "locked". Can include color codes.
- swkit name [kitname] [displayname]: Sets the display name for the kit. Can include color codes.
- swkit position [kitname] [position]: Sets the icon position within the kit menu
- swkit update [kitname]: Updates the kit <kitname> with your current inventory
Map Commands
- swmap arenas: Opens a Arena GUI
- swmap create [mapname]: Creates a map named [mapname]
- swmap edit [mapname]: Opens a map named [mapname] for editing
- swmap delete [mapname]: Deletes a map named [mapname]
- swmap list: Lists available maps
- swmap register [mapname]: Registers a map named [mapname]
- swmap unregister [mapname]: Unregisters a map named [mapname]
- swmap save [mapname]: Saves an open map named [mapname]
- swmap minimum [mapname] [number]: Sets the minimum players for [mapname]
- swmap name [mapname] [displayname]: Sets the display name for [mapname]
- swmap creator [mapname] [creator]: Sets the creator name for [mapname]
- swmap refresh [mapname]: Reloads the map.yml data file for the specific map. [mapname] can be set to "all" to reload all map.yml's.
- swmap spawn [type]: Adds a spawn at your location when in edit mode. Type can be "player", "spec" or "death".
- swmap chesttype [mapname]: Toggles between the chest types that can be added.
- /swm legacyload [mapname]: This will run the scanner and you will receive messages stating chests and spawns are added. See further instruction for this command below.
Party Commands
- swparty create [partyname]: Creates a party named [partyname]
- swparty accept: Accepts a party invite
- swparty decline: Declines a party invite
- swparty disband: Disbands your party
- swparty info: Lists your parties info
- swparty invite [player]: Invites a player to your party
- swparty leave: Leaves your current party
- swparty name [partyname]: Changes your parties name
Group Permissions
- sw.admin: Allows a player to use all admin commands.
- sw.maps: Allows a player to use all map commands.
- sw.kits: Allows a player to use all kit commands.
- sw.parties: Allows a player to use all party commands
- sw.player: Allows a player to use all player commands
Player PermissionsThe "Key" for each effect/sound/glasscolor/taunt can be found in their respective ymls. The "Key" in the following code sample is the highlighted value.
- sw.join: Allows a player to use sw join command and to join games.
- sw.stats: Allows a player to view player stats.
- sw.top: Allows a player to view the leaderboard.
- sw.quit: Allows a player to use sw quit command.
- sw.winsound: Allows a player to use sw winsound command.
- sw.killsound: Allows a player to use sw killsound command.
- sw.glass: Allows a player to use sw glass command.
- sw.taunt: Allows a player to use sw taunt command.
- sw.projectile: Allows a player to use sw projectile command.
- sw.particle: Allows a player to use sw particle command.
- sw.spectate: Allows a player to spectate using the spectate menu or the spectate command.
- sw.vip1: Gives the player an experience and voting multiplier that corresponds to vip1.
- sw.vip2: Gives the player an experience and voting multiplier that corresponds to vip2.
- sw.vip3: Gives the player an experience and voting multiplier that corresponds to vip3.
- sw.vip4: Gives the player an experience and voting multiplier that corresponds to vip4.
- sw.vip5: Gives the player an experience and voting multiplier that corresponds to vip5.
- sw.kit.[filename]: Allows the player to unlock voting on a permission required kit. [filename] is the filename of the kit without the “.yml”
- sw.votemenu: Allows a player to open the in game voting menu.
- sw.chestvote: Allow a player to vote on the chest type in pregame menus.
- sw.healthvote: Allow a player to vote on the health amount in pregame menus.
- sw.timevote: Allow a player to vote on the time in pregame menus.
- sw.weathervote: Allows a player to vote on the weather in the pregame menus.
- sw.modifiervote: Allows a player to vote on the modifier in the pregame menus.
- sw.pareffect.[name]: Allows a player you use a particle effect without having the required level. [name] represents the “Key” for the particle effect in the particleeffects.yml.
- sw.proeffect.[name]: Allows a player you use a projectile particle effect without having the required level. [name] represents the “Key” for the projectile particle effect in the projectileeffects.yml.
- sw.glasscolor.[name]: Allows a player you use a glass color without having the required level. [name] represents the “Key” for the glass color in the glasscolors.yml.
- sw.killsound.[name]: Allows a player you use a kill sound without having the required level. [name] represents the “Key” for the kill sound in the killsounds.yml.
- sw.winsound.[name]: Allows a player you use a win sound without having the required level. [name] represents the “Key” for the win sound in the winsounds.yml.
- sw.taunt.[name]: Allows a player you use a taunt without having the required level. [name] represents the “Key” for the taunt in the taunts.yml.
Admin Permissions
- sw.setspawn: Allows a player to set a set the lobby spawn.
- sw.stat: Allows a player to set a players stats.
- sw.clearstats: Allows a player to clear a players stats.
- sw.allowcommands: Allows a player to use commands when spectating or in game.
- sw.reload: Allows a player to use the reload command.
- sw.chestadd: Allows a player to use the chestadd command.
- sw.start: Allows a player to use the start command.
- sw.updatetop: Allows a player to use the updatetop command.
- sw.hologram: Allows a player to use the hologram command.
- sw.holoremove: Allows a player to use the holoremove command
Map Permissions
- sw.map.arenas: Allows a player to use the Arenas GUI.
- sw.map.create: Allows a player to create an arena.
- sw.map.edit: Allows a player to edit an arena.
- sw.map.delete: Allows a player to delete an arena.
- sw.map.list: Allows a player to list the available arenas.
- sw.map.save: Allows a player to save an arena.
- sw.map.register: Allows a player to register an arena.
- sw.map.unregister: Allows a player to unregister an arena.
- sw.map.refresh: Allows a player to reload the map data file.
- sw.map.creator: Allows a player to set the arena creator.
- sw.map.name: Allows a player to set the arena display name.
- sw.map.minimum: Allows a player to set the arena minimum number of players.
- sw.map.spawn: Allows a player to use the spawn command.
- sw.map.chesttype: Allows a player to use the chesttype command.
Kit Permissions
- sw.kit.create: Allows a player to use the create command.
- sw.kit.enable: Allows a player to use the enable command.
- sw.kit.icon: Allows a player to use the icon command.
- sw.kit.lockicon: Allows a player to use the lockicon command.
- sw.kit.perm: Allows a player to use the perm command.
- sw.kit.load: Allows a player to use the load command.
- sw.kit.list: Allows a player to use the list command.
- sw.kit.lore: Allows a player to use the lore command.
- sw.kit.name: Allows a player to use the name command.
- sw.kit.position: Allows a player to use the position command.
- sw.kit.update: Allows a player to use the update command.
Party PermissionsJust drop the SkywarsReloaded Plugin into your plugins folder and start your server. That will install all of the default files and you will be ready to start setting up the chest types, building maps, and adding kits. While adding maps is very similar to SWR 2.8, the chest types and kits will be handled quite differently.
- sw.party.accept: Allows a player to accept a party invite.
- sw.party.create: Allows a player to create a party.
- sw.party.disband: Allows a player to disband a party.
- sw.party.decline: Allows a player to decline a party invite.
- sw.party.info: Allows a player to view their party info.
- sw.party.invite: Allows a player to invite players to their party.
- sw.party.leave: Allows a player to leave a party.
Before you do anything else, you should set your lobby spawn using the command: /sw setspawn. This will set the player spawn for the lobby to your exact location. Many of the commands will not work unless a spawn is set.
If you used SWR 2.8 previously, the map creation has changed slightly. Maps, inlcuding spawns are built within the map editor, no longer using the beacon system. Maps can be created and edited entirely in-game using commands.
To create a new map, simply use the command:
This will load a new blank world where you can design your map from scratch or paste a schematic if you so choose. The [environment] is optional. If nothing is inputted, the map will be a "Normal" overworld map. The other options available are "nether" and "the_end". If you use "the_end" environment, you will have to manual kill the Ender Dragon. Once dead, you can remove the "End Gateway Portal" completely. You can remove a portion of the "End Portal", but you must leave at least one portal block to stop the Ender Dragon from re-spawning every time the map is loaded. I suggest sealing the portal in bedrock and building far away from the portal location.
- /swm create [mapname] [environment]
Spawns are added to the map by using /swm spawn [type] command. The three types are:
To add chests to the map, simply add chests to the map in edit mode. You will get a message in chat confirmed the addition. You can remove chests by simply destroying them. SWR 4.0.4 added a new Center chest option, so that specific chests can be filled with different/higher tier loot. To use these new chest, you can toggle between the chest type you are placing by using the /swm chesttype [mapname] command. This will toggle between "NORMAL" and "CENTER" chests and all chests placed will be set according to the current type that is set.
- player: Sets a player spawn that will appear as a diamond block. The plugin will automatically convert it into a cage when it loads the map. To remove a spawn, just destroy the diamond block.
- deathmatch: Sets a deathmatch spawn that will appear as a emerald block. To remove a spawn, just destroy the emerald block.
- spec: Sets the spawn for spectators.
Once you are finished creating the map, you can save the map using: /swm save [mapname]. A saved or open map can be returned to for editing at any time by using: /swm edit [mapname]. You can get a list of available maps using: /swm lists.
Once a map is created and saved, it can be registered for use. To do this use the command: /swm register [mapname]. As long as the map has more than two spawns, it will be registered and available as a playing SWR map. If for some reason, you want to stop using a map, you can use the command: /swm unregister [mapname] to remove it from play.
Many other features can be set with commands and accessed using the command /swm arenas to access the arena's GUI.
As maps are created, they will create a yml inside the mapData folder.
Here you can edit some basic information for each map. This file will hold some extra data for the map, including a Display Name, the Minimum players for the map, the map creators name, map event details, and the locations of any signs placed for the map as well as spawns and chest locations. The Display name will be used when SWR refers the map and can include color codes. The minimum players is the number of players needed for a match to start. The creator of the map is the name of the designer and it is shown to players along with the map name when players join a match. Map data can be edited in the yml file and can be updated in-game by using the command: /swm refresh [mapname].Code (Text):
displayname: '&5Invaders'
minplayers: 4
creator: '&eColorful'
cage: standard
teamSize: 1
allowFriendlyFire: false
environment: NORMAL
registered: true
events:
DisableRegenEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cNo More Hearts"
subtitle: "&1Health Regeneration Disabled"
startMessage: "&cNo More Hearts &bevent has begun!"
endMessage: "&cNo More Hearts &bevent has ended!"
announceTimer: false
repeatable: false
HealthDecayEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cHealth Decay"
subtitle: "&1Players lose half a heart per second"
startMessage: "&cHealth Decay &bevent has begun!"
endMessage: "&cHealth Decay &bevent has ended!"
announceTimer: false
repeatable: false
EnderDragonEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cEnderDragon"
subtitle: "&1An EnderDragon has Spawned"
startMessage: "&cEnderDragon &bevent has begun!"
endMessage: "&cEnderDragon &bevent has ended!"
announceTimer: false
repeatable: false
WitherEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cWither"
subtitle: "&1A Wither has Spawned"
startMessage: "&cWither &bevent has begun!"
endMessage: "&cWither &bevent has ended!"
announceTimer: false
repeatable: false
MobSpawnEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cMob Rush"
subtitle: "&1They're Coming for You"
startMessage: "&cMob Rush &bevent has begun!"
endMessage: "&cMob Rush &bevent has ended!"
announceTimer: false
repeatable: false
minMobsPerPlayer: 5
maxMobsPerPlayer: 5
mobs:
- CREEPER
- ZOMBIE
- SPIDER
- SKELETON
CrateDropEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cCrate Drop'
subtitle: '&1Is it a bird?'
startMessage: '&cCrate Drop &bevent has begun!'
endMessage: '&cCrate drop &bevent has ended!'
announceTimer: false
repeatable: false
maxItemsPerCrate: 5
maxNumOfCrates: 3
ChestRefillEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: "&cChest Refill"
subtitle: "&1Chests have been refilled"
startMessage: "&cChest refill &bevent has begun!"
endMessage: "&cChest refill &bevent has ended!"
announceTimer: false
repeatable: false
DeathMatchEvent:
enabled: false
minStart: 900
maxStart: 900
length: -1
chance: 100
title: "&cDeathMatch"
subtitle: "&1Time to End This"
startMessage: "&cDeathMatch &bevent has begun!"
endMessage: "&cFIGHT"
announceTimer: false
repeatable: false
ArrowRainEvent:
enabled: false
minStart: 300
maxStart: 600
length: 15
chance: 100
title: "&cArrow Rain"
subtitle: "&1Make it Rain"
startMessage: "&cArrow Rain &bevent has begun!"
endMessage: "&cArrow Rain &bevent has ended!"
announceTimer: false
repeatable: true
spawnPer2Tick: 1
AnvilRainEvent:
enabled: false
minStart: 300
maxStart: 600
length: 15
chance: 100
title: "&cAnvil Rain"
subtitle: "&1Watch your head"
startMessage: "&cAnvil Rain &bevent has begun!"
endMessage: "&cAnvil Rain &bevent has ended!"
announceTimer: false
repeatable: true
spawnPer5Tick: 2
spectateSpawn: 6:115:-5
spawns:
- -49:105:-5
- -33:105:-44
- -33:105:34
- 6:105:-60
- 45:105:-44
- 45:105:34
- 61:105:-5
- 6:107:50
chests:
- -52:96:-2
- -36:96:-41
- -46:96:-8
- -36:96:37
- -30:96:-47
- -23:81:-13
- -20:81:15
LEGACY LOADER INSTUCTIONS:
LegacyLoad Command (Read instructions below): /swm legacyload [mapname] - uses a world chunk scanner to locate chests and beacons in the map and add them to the mapdata file.This command is only meant to be use when you are pasting schematics.
- /swm create [mapname] - will create a world where you can past your schematic
- use world edit to load and paste your schematic (do not place any chests at this time, you can however place beacons)
- /swm save [mapname] - this will save the world, updating any block data.
- /swm edit [mapname] - reload the world
- /swm legacyload [mapname] - this will run the scanner and you will receive messages stating chests and spawns are added.
- /swm save [mapname]
- After this save you can continue to edit the map as desired (adding spectator spawn, center chests, etc).
- Never run the legacyload command on a map more than once.
Signs work a little differently than in SWR 2.8, but they haven’t changed a great deal. Each map can have signs that players can use to join. There is no limit on the number of signs that can be place per map, so that you can have panels setup in different areas if you like (For instance a VIP lobby). As long as the sign is placed in the lobby world, it will activate. To create a SWR sign, simply create a sign and put the text as below:
[SW]
{mapname}
Map name, is the name you used to create the map, not the “Display Name”.
Chests in SWR are completely revamped. For this reason, old chest files will not work. The biggest benefit of this change is that SWR can now use custom items in the chests, including custom items from other plugins that use NBT tags. In SWR chests can be setup using the in-game command, sw chestadd [chesttype] [method] [percentage]. This command will add the item(s) in either your hand or inventory to the “chesttype” selected at the percentage given.
So if you wanted to add a diamond sword to the normal chest file with a rarity of 10 percent, you would put the diamond sword in your hand and use the following command:
- [chesttype] – the chest file you want to modify. Available options are “basic”, "basiccenter", “normal”, "normalcenter", “op”, and "opcenter".
- [method] – whether you want to add the one item in your hand or all items in your inventory. Use “hand” to just add the item in your hand. Use “inv” to add your entire inventory.
- [percentage] – An integer value representing how rare an item will be in chest spawns with 1 being the rarest and 100 meaning it will always spawn in the chest.
If you wanted to add a group of different building blocks (stone, dirt, wood, etc) in the op chest file at a rarity of 35 percent, you would put everything in your inventory and use the following command:
- /sw chestadd normal hand 10
- /sw chestadd op inv 35
Like chest files, Kit Creation has been completely revamped to allow for all custom items and in-game creation and modification. One big change is that kits can now be used in 2 different ways.
To create a kit, all you have to do is setup your inventory exactly as you would like the kit to be given to the player and then run the command: /swk create [kitname]. Everything including item locations and armor will be store when the kit is created. You should then complete the following steps to finalize your kit:
- The default setting is that kits act exactly as they did in previous versions of SWR and are selected individually.
- However if you choose, you can set "kitVotingEnabled" to true in the config. This option will mean that kits are voted on and not chosen individually, so that when the game starts, whatever kit has the highest number of votes gets given to all players.
To edit the items in kit, you can first load the kit by using the command: /swk load [kitmane]. This will clear your inventory and load the kit into your inventory. Once you make your edits, you can save the changes by using the command: /swk update [kitname].
- Choose the item for the icon for your kit. Put it in your hand and use the command: /swk icon [kitname]
- If you would like to require a permission to unlock the kit for voting, use the command: /swk perm [kitname]
- OPTIONAL) When a permission is required, a separate item will be use as the icon for when it is locked. By default this is the Barrier itemstack. To change the icon for when it is locked, use: /swk lockicon [kitname]
- Set the display name for the kit, using the command: /swk name [kitname] [displayname]. [displayname] will be the in-game name of the kit and can included color codes.
- Set the lore for the kit using the command: /swk lore [kitname] [number] [lore].
- [number] can be 1 to 16, representing 16 different possible lines of lore OR it can be “locked”, representing the single line of lore for the kit when it is locked.
- Next set the kit position, which will be the slot it occupies in the kit voting menu. This has to be set and cannot be the same as another kit. Use the command: /swk position [kitname] [position]. Position must be an integer between 0 and 44.
- Once all setting are set, you can not enable the kit by using the command: /swk enable [kitname]. It will now be available for kit voting in matches.
As of SWR 3.3, SkyWars now has an events system. Events are configured with the yml file for each map, so that events can be individually configured for each map.
The following section will now be present in each maps yml file:
- Each event can have it Start time set, by setting a minStart and maxStart time. What this does is create a random range for when the even will start. If you always want an event to happen at a exact time, both of these values should be set to the same number.
- The next setting is length, which just defines how long the event should last in seconds. If you want the event to last until match end, just set it to -1.
- The next setting is chance. This is the chance of a event firing during a match. At the start of the match it will do a random check and decide whether or not the event will fire. 100 means the event will always fire, 0 means it will never fire.
- The next four settings are related to the in game messaging for events. They can be edited as necessary and can use color codes.
- the announceTimer option allows you to have the timing of events announced to players as they get closer.
- Finally the repeatable setting sets whether the event is repeatable within a single game. If set to true, then the event will pick a new random time to fire again based on the minStart and maxStart time settings.
Code (Text):
events:
DisableRegenEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cNo More Hearts'
subtitle: '&1Health Regeneration Disabled'
startMessage: '&cNo More Hearts &bevent has begun!'
endMessage: '&cNo More Hearts &bevent has ended!'
announceTimer: false
repeatable: false
HealthDecayEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cHealth Decay'
subtitle: '&1Players lose half a heart per second'
startMessage: '&cHealth Decay &bevent has begun!'
endMessage: '&cHealth Decay &bevent has ended!'
announceTimer: false
repeatable: false
EnderDragonEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cEnderDragon'
subtitle: '&1An EnderDragon has Spawned'
startMessage: '&cEnderDragon &bevent has begun!'
endMessage: '&cEnderDragon &bevent has ended!'
announceTimer: false
repeatable: false
WitherEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cWither'
subtitle: '&1A Wither has Spawned'
startMessage: '&cWither &bevent has begun!'
endMessage: '&cWither &bevent has ended!'
announceTimer: false
repeatable: false
MobSpawnEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cMob Rush'
subtitle: '&1They''re Coming for You'
startMessage: '&cMob Rush &bevent has begun!'
endMessage: '&cMob Rush &bevent has ended!'
announceTimer: false
repeatable: false
minMobsPerPlayer: 5
maxMobsPerPlayer: 5
mobs:
- CREEPER
- ZOMBIE
- SPIDER
- SKELETON
CrateDropEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cCrate Drop'
subtitle: '&1Is it a bird?'
startMessage: '&cCrate Drop &bevent has begun!'
endMessage: '&cCrate drop &bevent has ended!'
announceTimer: false
repeatable: false
maxItemsPerCrate: 5
maxNumOfCrates: 3
ChestRefillEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cChest Refill'
subtitle: '&1Chests have been refilled'
startMessage: '&cChest refill &bevent has begun!'
endMessage: '&cChest refill &bevent has ended!'
announceTimer: false
repeatable: false
DeathMatchEvent:
enabled: false
minStart: 900
maxStart: 900
length: -1
chance: 100
title: '&cDeathMatch'
subtitle: '&1Time to End This'
startMessage: '&cDeathMatch &bevent has begun!'
endMessage: '&cFIGHT'
announceTimer: false
repeatable: false
ArrowRainEvent:
enabled: false
minStart: 300
maxStart: 600
length: 15
chance: 100
title: '&cArrow Rain'
subtitle: '&1Make it Rain'
startMessage: '&cArrow Rain &bevent has begun!'
endMessage: '&cArrow Rain &bevent has ended!'
announceTimer: false
repeatable: true
spawnPer2Tick: 1
AnvilRainEvent:
enabled: false
minStart: 300
maxStart: 600
length: 15
chance: 100
title: '&cAnvil Rain'
subtitle: '&1Watch your head'
startMessage: '&cAnvil Rain &bevent has begun!'
endMessage: '&cAnvil Rain &bevent has ended!'
announceTimer: false
repeatable: true
spawnPer5Tick: 2
ShrinkingBorderEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cShrinking Border'
subtitle: '&1The walls are closing around you!'
startMessage: '&cShrinking Border &bevent has begun!'
endMessage: '&cShrinking Border &bevent has ended!'
announceTimer: false
repeatable: false
startingBorderSize: 300
shrinkRepeatDelay: 1
ProjectilesOnlyEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cProjectiles Only'
subtitle: '&1No PVP - Projectiles Only!'
startMessage: '&cProjectiles Only &bevent has begun!'
endMessage: '&cProjectiles Only &bevent has ended!'
announceTimer: false
repeatable: false
ProjectileSpleefEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cProjectile Spleef'
subtitle: '&1Projectiles Instantly Break Blocks!'
startMessage: '&cProjectile Spleef &bevent has begun!'
endMessage: '&cProjectile Spleef &bevent has ended!'
announceTimer: false
repeatable: false
eggsAddedToInventory: 64
DoubleDamageEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cDouble Damage'
subtitle: '&1All attacks do Double Damage'
startMessage: '&cDouble Damage &bevent has begun!'
endMessage: '&cDouble Damage &bevent has ended!'
announceTimer: false
repeatable: false
GhastEvent:
enabled: false
minStart: 300
maxStart: 600
length: -1
chance: 100
title: '&cGhasts Everywhere'
subtitle: '&1A Ghasts have Spawned'
startMessage: '&cGhasts Everywhere &bevent has begun!'
endMessage: '&cGhasts Everywhere &bevent has ended!'
announceTimer: false
repeatable: false
Scoreboards are finally configurable in SWR. During the game, there are three different scoreboard options, all configurable in the messages.yml. The first "waitboard" is what is displayed while players are waiting for the game to start. The second "playboard" is what is displayed during the game. The third "endboard" is what is displayed when the game ends and is waiting to restart. All variables can be used across all three boards and can be moved as you like, but some like winner and restart time would be useless in the first 2 boards. The current available variables are:
A blank line can be added by simply using '' as shown in the example below. Lines at the bottom, that you don't want to be used, can be removed by placing 'remove' next to the line in the messages.yml.
- {mapname}
- {players}
- {maxplayers}
- {chestvote}
- {timevote}
- {weathervote}
- {healthvote}
- {modifiervote}
- {winner}
- {restarttime}
Code (Text):scoreboards:
waitboard:
line1: '&e&lSkyWars'
line2: '&5Map:'
line3: '&a{mapname}'
line4: ''
line5: '&5Players:'
line6: '&a{players}/{maxplayers}'
line7: ''
line8: '&5Chest Vote: &a{chestvote}'
line9: ''
line10: '&5Time Vote: &a{timevote}'
line11: ''
line12: '&5Weather Vote: &a{weathervote}'
line13: ''
line14: '&5Modifier Vote: &a{modifiervote}'
line15: ''
line16: '&5Health Vote: &a{healthvote}'
playboard:
line1: '&e&lSkyWars'
line2: '&5Map:'
line3: '&a{mapname}'
line4: ''
line5: '&5Players:'
line6: '&a{players}/{maxplayers}'
line7: ''
line8: '&5Match Time:'
line9: '&a{time}'
line10: 'remove'
line11: 'remove'
line12: 'remove'
line13: 'remove'
line14: 'remove'
line15: 'remove'
line16: 'remove'
endboard:
line1: '&e&lSkyWars'
line2: '&5Map:'
line3: '&a{mapname}'
line4: ''
line5: '&5WINNER:'
line6: '&a{winner}'
line7: ''
line8: '&5Restarting In:'
line9: '&a{restarttime}'
line10: 'remove'
line11: 'remove'
line12: 'remove'
line13: 'remove'
line14: 'remove'
line15: 'remove'
line16: 'remove'
The lobbyboard is a lobby scoreboard that can be enabled in the config to display player stats. It can be edited in the messages.yml and can include the following variables.
- {elo}
- {wins}
- {losses}
- {winloss}
- {kills}
- {deaths}
- {killdeath}
- {xp}
Code (Text):lobbyboard:
line1: '&e&lSkyWars Stats'
line2: ''
line3: '&5ELO:'
line4: '&a{elo}'
line5: ''
line6: '&5WINS/LOSSES:'
line7: '&a{wins} / {losses} --- {winloss}'
line8: ''
line9: '&5KILLS/DEATHS:'
line10: '&a{kills} / {deaths} --- {killdeath}'
line11: ''
line12: '&5XP'
line13: '&a{xp}'
line14: ''
line15: 'remove'
line16: 'remove'
SWR has a multi-array leaderboard system that will track leaderboards for any stat types enabled within the config.yml. Leaderboards will work without SQL Databased, but for any large server I highly recommend using an SQL Database. If you are NOT using a SQL database, I also recommend setting a fairly high update interval in the config.yml. The leaderboards can be used 2 ways:
- By using the /sw top [stat] command. This will display a leaderboard list to the player, sorted by the stat.
- By using SW Leaderboard Signs (Must be enabled in the config.yml)
The text format for each leaderboard type can be updated in the Messages.yml. Each leaderboard can be comprised of the following variables:
- To place a leaderboard sign, create a sign and create the following lines
[swl]
{type}
{position}
- Once the sign is completed, it will be added to the leaderboads and will update with the leaderboard data whenever a leaderboard update is done.
- Player Heads can also be added to sign leaderboards. Simply place a skeleton skull or player head above the sign and it will updated to the players head. (Must be enabled in the config.yml)
- {position}
- {name}
- {type}
- {elo}
- {wins}
- {kills}
- {deaths}
- {losses}
- {xp}
The variables can be arranged on any lines and used in any order. They can also contain multiple stats, but the leaderboard is sorted by the {type} of the leaderboard.Code (Text):leaderboard:
signformats:
elo:
line1: '&L&0{position}'
line2: '&1{name}'
line3: '&c{type}'
line4: '&5{elo}'
Code (Text):
debugMode: false
spawn: null
bungeeMode: false
bungeeLobby: lobby
tauntCooldown: 10
enablePressurePlateJoin: true
teleportToSpawnOnJoin: false
teleportToSpawnOnWorldEnter: true
resourcepack: https://www.dropbox.com/s/8scs6c911y3mqbg/taunts-resource-pack.zip?dl=1
promptForResourcePackOnJoin: false
lobbyBoardEnabled: false
displayPlayerLevelOnXpBar: true
enabledLobbyGuard: false
economyEnabled: false
game:
worldBorder:
enabled: false
borderSize: 400
showHealth: true
snowballDamage: 1
eggDamage: 1
ecoForWin: 5
ecoForKill: 1
xpForWin: 5
winCommands:
xpForKill: 1
killCommands:
vip1Multiplier: 2
vip2Multiplier: 3
vip3Multiplier: 4
vip4Multiplier: 5
vip5Multiplier: 10
timeAfterMatch: 15
waitTimer: 10
kitVotingEnabled: false
spectateEnabled: true
allowFallDamage: false
maxMapSize: 400
tauntsEnabled: true
modifierLevel:
speed:
strength:
jump:
teams:
usePlayerNames: true
usePlayerGlassColors: true
teamCageMaterial: STAINED_GLASS
chat:
enableFormatter: true
limitGameChatToGame: true
limitLobbyChatToLobby: true
limitSpecChatToSpec: true
externalChat:
useExternalChat: false
addPrefix: false
parties:
enabled: true
maxPartySize: 4
holograms:
enabled: false
chests:
maxItemsChest: 26
maxItemsDoubleChest: 53
kit:
menuSize: 45
randPos: 0
randItem: NETHER_STAR
noKitPos: 44
noKitItem: GLASS
titles:
enabled: true
fireworks:
enabled: true
per5Ticks: 1
sounds:
enabled: true
countdown: BLOCK_NOTE_BLOCK_BASS
join: BLOCK_WOODEN_DOOR_OPEN
leave: BLOCK_WOODEN_DOOR_CLOSE
openJoinMenu: BLOCK_FENCE_GATE_OPEN
openSpectateMenu: BLOCK_FENCE_GATE_OPEN
openOptionsMenu: ENTITY_ZOMBIE_VILLAGER_CURE
openGlassMenu: BLOCK_GLASS_BREAK
openWinSoundMenu: ENTITY_FIREWORK_ROCKET_BLAST
openKillSoundMenu: ENTITY_PIG_DEATH
openParticleMenu: BLOCK_GRAVEL_STEP
openProjectileMenu: ENTITY_ARROW_SHOOT
openTauntMenu: ENTITY_ENDER_DRAGON_FLAP
openKitMenu: ENTITY_PLAYER_ATTACK_SWEEP
openChestMenu: BLOCK_CHEST_OPEN
openHealthMenu: ENTITY_SPLASH_POTION_BREAK
openTimeMenu: ITEM_BOTTLE_FILL_DRAGONBREATH
openWeatherMenu: WEATHER_RAIN
openModifierMenu: ENTITY_SPLASH_POTION_BREAK
confirmSelectionSound: ENTITY_VILLAGER_YES
errorSound: ENTITY_VILLAGER_NO
signs:
enabled: true
blockoffline: COAL_BLOCK
blockwaiting: EMERALD_BLOCK
blockplaying: REDSTONE_BLOCK
blockending: LAPIS_BLOCK
almostfull: DIAMOND_HELMET
threefull: GOLDEN_HELMET
halffull: IRON_HELMET
almostempty: LEATHER_HELMET
items:
kitsEnabled: true
kitVotePosition: 0
kitvote: ENDER_EYE
voteEnabled: true
votingPosition: 4
votingItem: COMPASS
exitGameItem: IRON_DOOR
exitPosition: 8
exitMenuItem: BARRIER
prevPageItem: FEATHER
nextPageItem: FEATHER
chestVoteEnabled: true
chestVotePosition: 9
chestvote: SHIELD
chestrandom: NETHER_STAR
chestbasic: STONE_SWORD
chestnormal: IRON_SWORD
chestop: DIAMOND_SWORD
chestscavenger: WOODED_HOE
healthVoteEnabled: true
healthVotePosition: 11
healthvote: EXPERIENCE_BOTTLE
healthrandom: NETHER_STAR
healthfive: REDSTONE
healthten: REDSTONE
healthfifteen: REDSTONE
healthtwenty: REDSTONE
nopermission: BARRIER
timeVoteEnabled: true
timeVotePosition: 13
timevote: CLOCK
timerandom: NETHER_STAR
timedawn: CLOCK
timenoon: CLOCK
timedusk: CLOCK
timemidnight: CLOCK
weatherVoteEnabled: true
weatherVotePosition: 15
weathervote: BLAZE_POWDER
weatherrandom: NETHER_STAR
weathersunny: PRISMARINE_SHARD
weatherrain: PRISMARINE_SHARD
weatherstorm: PRISMARINE_SHARD
weathersnow: PRISMARINE_SHARD
modifierVoteEnabled: true
modifierVotePosition: 17
modifiervote: DRAGON_BREATH
modifierspeed: BOOK
modifierjump: BOOK
modifierstrength: BOOK
modifiernone: BOOK
modifierrandom: NETHER_STAR
joinselect: DIAMOND_HELMET
singleSlot: 11
singlemenu: REDSTONE_TORCH
teamSlot: 15
teammenu: COMPARATOR
spectateselect: LEATHER_HELMET
optionselect: ENDER_EYE
particleselect: BLAZE_POWDER
particleselectslot: 11
projectileselect: ARROW
projectileselectslot: 12
killsoundselect: DIAMOND_SWORD
killsoundselectslot: 14
killsounditem: NOTE_BLOCK
winsoundselect: DRAGON_EGG
winsoundselectslot: 15
glassselect: GLASS
glassselectslot: 9
tauntselect: SHIELD
tauntselectslot: 17
particles:
enabled: true
ticksperupdate: 3
enabledMenus:
join: true
joinSlot: 0
spectate: true
spectateSlot: 4
options: true
optionsSlot: 8
glass: true
particle: true
projectile: true
killsound: true
winsound: true
taunts: true
sqldatabase:
enabled: false
hostname: localhost
port: 3306
database: database
username: username
password: password
leaderboards:
length: 10
leaderboardUpdateInterval: 300
signsEnabled: true
headsEnabled: true
eloLeaderboardEnabled: true
winsLeaderboardEnabled: false
lossesLeaderboardEnabled: false
killsLeaderboardEnabled: false
deathsLeaderboardEnabled: false
xpLeaderboardEnabled: false
disable-commands:
exceptions:
- msg
- r
- sw quit
enabled: true
disable-commands-spectate:
exceptions:
- msg
- r
- sw quit
enabled: true
All yml files have been overhauled in SWR and this includes Particle Effects. I have moved the particle effect out of the PlayerMoveEvent and created a simple repeating task that handles both Projectile and Player particles which should have much greater efficiency. The number of ticks per update can be set in the config.
Each particle effect in the config contains a couple of different values.
Most values are pretty self explanatory. The display name is the name it will be given in the selection inventory. The icon, is the icon that will be used in the selection inventory. The level is the level the player must be to use the particle effect. The cost is only used when "economyEnabled" is set to true in the config. When set to true, the player can purchase the item once they reach the required level.Code (Text):colourful:
displayname: "&bColourful"
icon: NETHER_STAR
level: 97
position: 44
page: 1
cost: 100
particles:
- 'REDSTONE:0:0.5:0:10:3'
- 'SLIME:0.5:1:0:12:6'
- 'LAVA:1:1.5:0:16:4'
Finally, the particles, which is what defines the actual effect, is broken into six parts using “:”. The parts are as follows:
The offset values can allow you to set the vertical location of the particles. So you can have particles spawn by a player feet, body or head. Particle trails can now be multi-effect as well, you can add multiple effects under particles as shown in the example above.
- <ParticleEffect> - as named in the spigot javadocs
- <Y Value Offset Lower Limit> - lowest point that a particle can form from the player.
- <Y Value Offset Upper Limit> - highest point that the particle can form from the player.
- <Data Value> - used to set the speed or color of some particles, can be set to random by using -1 as the value.
- <Amount of Particles Upper Limit> - the most particles that will spawn per update.
- <Amount of Particles Lower Limit> - the least particles that will spawn per update
Glass colors are defined in the glasscolors.yml. Each color is defined and composed of four values.
The displayname and level are as expected, and cost is handled the same as for particle effects. The material value should be set to match a valid material in the version of spigot/bukkit you are using. If the material can have a datavalue (such as Stained Glass or Wool), you can put it in the datavalue section, otherwise datavalue should be set to -1. For 1.13.2 versions and above, the datavalue should always be set to -1 and proper material names used for glass, wool, etc.Code (Text):pink:
displayname: "&bPink"
level: 31
position: 36
page: 1
cost: 100
material: STAINED_GLASS
datavalue: 6
Kill sounds and win sounds are a new addition to the SWR 3.0 plugin. They are each defined in their own yml file.
Each sound effect in the config contains a couple of different parts.
Most values are pretty self explanatory. The display name is the name it will be given in the selection inventory. The icon, is the icon that will be used in the selection inventory. The level is the level the player must be to use the particle effect, and cost is handled the same as for particle effects. The pitch and volume are simply the pitch and volume at which the sound will play. The “sound” and “isCustomSound” values are the most important to the actual effect.Code (Text):pigdeath:
sound: ENTITY_PIG_DEATH
isCustomSound: false
volume: 10
pitch: 1
icon: NOTE_BLOCK
displayName: "&bPig Death"
level: 4
position: 4
page: 1
cost: 100
IMPORTANT POINT: While custom sounds are great, they will only be heard if the player uses your custom resource pack. If the player refuses the custom pack, no sound will be heard by that player.
- In the “sound” value you simple put the name of the sound as found in the Spigot Javadocs or as named in your custom resource pack.
- For the “isCustomSound”, this must be set to true if you are using a sound from your custom resource pack.
Taunts are another new addition to SWR 3.0. They are defined the taunts.yml and comprise of a number of different values. Taunts can be used in SkyWars matches by double tapping the shift key. A cooldown for taunts can be set in the config.yml.
I think most of the values speak for themselves. Name, Icon, and Level are as expected, , and cost is handled the same as for particle effects. Addglow lets you decide if you want the taunt icon to glow in the selection menu. The lore section lets you create the lore for the selection item that describes the taunt. The values from after this point, define the actual taunt effect.Code (Text):dragon:
name: "&4Fear Me!"
icon: DRAGON_EGG
level: 20
position: 40
page: 1
cost: 100
addGlow: true
lore:
- "&b*Plays dragon growl."
- "&6*Surrounds player in fire and lava particles."
message: "&4Sniff....Sniff....I smell fear!!"
sound: ENTITY_ENDERDRAGON_GROWL
useCustomSound: false
volume: 10
pitch: 1
particleSpeed: 0.5
particleDensity: 35
particles:
- DRAGON_BREATH
- SMOKE_NORMAL
- message is the message that will be shown to the other players in the match.
- sound is the sound name as defined in the spigot/bukkit javadocs or in your custom resource pack.
- useCustomSound toggle whether or not you are attempting to use a custom sound.
- Volume and pitch do exactly what you would expect.
- particleSpeed and particleDensity affect the speed and number of particles that spawn around the player.
- particles is a list of particle effects as defined in the spigot/bukkit javadocs.
SWR has support for PlaceHolderAPI and MVdWPlaceholderAPI. Available placeholders are:
If you would like to see additional placeholders, send me a message or comment in the discussion and I'll see what's possible.
- swr_elo
- swr_wins
- swr_losses
- swr_kills
- swr_deaths
- swr_xp
- swr_games_played
- swr_kill_death
- swr_win_loss
Source code for SkyWarsReloaded can be found on GitHub.

SkyWarsReloaded 4.1.3
SkyWars with Sign Join Mode, Leaderboards, and Lots of Options
Recent Updates
- Projectile Spleef Fix for pre 1.11 Mar 1, 2019
- Chest Fix Mar 1, 2019
- Critical Bug Fix Mar 1, 2019