🎁 SkyWars

On this page, you will learn more about the SkyWars rule.

#Information

The SkyWars add-on fills every chest and trapped chest placed inside your arena with random loot when a round starts. Each container type draws from its own loot pool, so the chests around a team's island and the ones in the middle of the map can hold completely different gear. This add-on requires PhoenixDuels Premium.

#Installation

To install this add-on, simply drag and drop the jar file into the PhoenixDuels/addons folder, or include the add-on while using the bundle download option to download the plugin.

This add-on adds SkyWars as a gamemode rule to the plugin, and generates the following files:

PhoenixDuels/skywars/chests.yml - The loot pools of both chest types.
PhoenixDuels/translations/skywars.translations.en.yml - The translation file for the add-on.

#Create a Gamemode

Create a gamemode, or open an existing one, that you want the loot chests applied to.

#Select Rule

Select the Generated rule SkyWars alongside your other rules.

#Place Chests

Place chests and trapped chests inside the arena's battle region. Only containers inside that region are picked up — anything outside of it is ignored.

#Create a Map

Create a map dedicated for this ruleset, and make sure Regeneration is enabled so the arena resets between matches.

#Chest Types

The container you place decides which pool it is filled from. This is not configurable — it is how the add-on tells the two pools apart.

Block	Pool	Notes
Chest	Team Chests	Always enabled. Meant for the chests around each spawn island.
Trapped Chest	Middle Chests	Can be switched off, and is capped to 4 chests by default.

#Match Settings

The SkyWars rule's settings hold three entries:

Team Chests - opens the loot pool of every normal chest in the arena.
Middle Chests - opens the loot pool of every trapped chest in the arena.
Action Bar - toggles an action bar showing every team's remaining player count.

Both chest entries show a summary of their chest limit and how many loot entries they hold before you open them.

The two loot pools live in skywars/chests.yml and are shared by every mode that uses the SkyWars rule. Editing them from one mode changes them everywhere. Only the Action Bar toggle is stored per mode.

#Loot Items

Opening either chest entry takes you to that pool's Loot Items menu, where you can add, edit and remove entries.

Chest Limit - caps how many containers of that type the pool may claim in the arena. Chests closest to the center of the battle region are claimed first, so a limit of 4 on the middle pool fills the four most central trapped chests and leaves the rest empty. Set to -1 for no cap. Clicking past -1 skips 0 and lands on 1.
Enabled - only shown for the middle chests, and stops them from being filled at all.

Each loot entry has its own settings:

Item - the item or block that gets placed. Any item works, including custom models, potions and named gear.
Weight - how likely this entry is to be drawn. The menu shows the resulting chance, which is this weight divided by the sum of every weight in the pool.
Minimum Amount / Maximum Amount - the stack size range the entry is drawn with.
Guaranteed - places this entry in every chest of that pool instead of leaving it to chance.
Delete Item - removes the entry from the pool.

#How a Chest is Filled

When a round starts, every container inside the battle region is scanned, claimed by its matching pool, emptied and refilled once. There is no refill during the match.

Every Guaranteed entry is placed first.
A target amount of items is rolled between the pool's minimum and maximum item count.
The rest of the slots are drawn at random, weighted, until the target is reached.
An entry can never be drawn twice in the same chest, and only one item of each gear category is placed per chest — so a chest will not hold two swords, two chestplates or two bows.

The gear categories are swords (including tridents), pickaxes, axes, helmets, chestplates (including elytras), leggings, boots and bows (including crossbows). Everything else — blocks, food, pearls, potions — is not categorised, and is limited only by the one-draw-per-entry rule.

The minimum and maximum item count per chest is not in the editor. Both live under team-chest and middle-chest in skywars/chests.yml as min-items and max-items.

#Action Bar

While a round is in progress, the rule can show an action bar listing how many players each team has left, refreshed every second. The toggle sits in the rule's settings, and the format is editable in the add-on's translation file under skywars.action-bar, using %team_color%, %team_prefix% and %team_remaining%.

#Placeholders

The SkyWars add-on adds the following placeholders that you can use on the Scoreboard:

%skywars_team1_remaining% through %skywars_team4_remaining% - Returns the number of players still alive on that team slot.

#PlaceholderAPI Placeholders

The following is the list of the available placeholders that SkyWars has.

Placeholders	Description
%phoenixduels_skywars_team1_remaining%	Returns the players remaining on team 1.
%phoenixduels_skywars_team2_remaining%	Returns the players remaining on team 2.
%phoenixduels_skywars_team3_remaining%	Returns the players remaining on team 3.
%phoenixduels_skywars_team4_remaining%	Returns the players remaining on team 4.

Last updated 15 days ago