![skywars+](https://cdn.modrinth.com/data/cached_images/0a82d5598337b294e0f92339d0ad7ba74393ec1a.png)

Report an issue

## ![features](https://cdn.modrinth.com/data/cached_images/e09d765bd682c03628713435253da407d385f80d.png) - Map System – Just drop world folders into /plugins/SkyWarsPlus/maps and configure them easily - Custom Game Configs – Set up different modes (Solos, Duos, etc.) - Loot Editor – Add and customize loot in-game - Auto Chest Detection – No need to manually add island chests (need to manually add op chest locations) - Chest Refills - Add custom chest refill time for each game config - Map IDs - Choose which maps you need, just provide the map id for the config ## ![setup guide](https://cdn.modrinth.com/data/cached_images/238fc50b5b6e423aff48276c4afa13b21b3d4aaa.png) ### Step 1: Adding Maps > > Place your world folders inside: > plugins/SkyWarsPlus/maps/ > > The folder name of each world will be treated as the map name. > > Next, define the map data in map_data.yml like this: > > > ``` > Map Name: > spectator-teleport-location: [564.5, 55.5, 70.5] > team-spawn-locations: > - [525.5, 58.0, 67.5] > - [559.5, 58.0, 108.5] > - [559.5, 58.0, 108.5] > - [559.5, 58.0, 108.5] > op-chest-locations: > - [561, 58, 65] > - [567, 58, 75] > id: mapid > ``` > > Explanation: > > waiting-area-location: Location where players wait before the game starts. > > team-spawn-locations: Locations where each team will spawn at the start of the match. > > chest-locations: Middle island chests only. These chests contain better loot. > Must be integers (no decimal points). > > Normal chest locations are detected automatically — you don't need to add them. ### Step 2: Creating Game Configurations > > Use this command to create a game configuration: > > ``` > /swp create_config > ``` > > name: Name of the game setting (e.g., "Solos", "Duos"). > > min_teams: Minimum number of teams required to start. > > max_teams: Maximum number of teams allowed. > > team_size: Number of players per team. > > refill_cooldown: Time in seconds between chest refills. > > map_ids: IDs of maps to be used with this setting (e.g., waterfallSolos). ### Step 3: Configuring Loot > > Place items into any chest (for normal) or middle chest. > > Look directly at the chest. > > Run either: > > ``` > /swp setloot > ``` > > or > > ``` > /swp addloot > ``` > > You can customize the loot further in loot-items.yml: > > chance: The probability of an item appearing. > > min-amount / max-amount > > custom name, etc. ### Step 4: Joining a Game > > To join a game: > > ``` > /swp join > ``` ## ![customizing menus](https://cdn.modrinth.com/data/cached_images/64d73bfa67ebe6978e9231bd1e6e8df7f88064d1.png) > **SkyWars+ lets you fully customize its menus for a unique server experience.** ### IMPORTANT: **Menu customization requires correct YAML formatting. Incorrect spacing or syntax will break the menu.** ## Menu Files > > skywars_menu.yml – Main SkyWars menu players can open > > join_menu.yml – Game join selector menu for different modes/configs # skywars_menu.yml Guide ### Layout > > Example: > > ``` > # ONE, TWO, THREE..., SIX > rows: FIVE > > buttons: > 0: > name: "&b&lSkyWars+" > material: BOOK > glint: true > lore: > - "&7Welcome to &bSkyWars+&7!" > - "&7Fast-paced PvP minigame with" > - "&7custom maps and modes." > - "" > - "&eFight, loot & &ebe the last one standing!" > actions: [] > ``` > > **rows**: How many rows the menu has (values: ONE, TWO, THREE, FOUR, FIVE, SIX). > > **buttons**: Each numbered key represents a slot in the menu. > > **name**: The display name of the button (supports color codes). > > **material**: The Minecraft item used for the button. > > **glint**: true/false – whether the button should have an enchantment glow. > > **lore**: List of text lines shown when hovering over the button. > > **actions**: What happens when the player clicks the button. ### Actions > > Actions are added in **[TYPE] ** format: > > [CONSOLE] – Runs a command as the console > > [COMMAND] – Runs a command as the player > > [MESSAGE] – Sends a chat message to the player > > Example: > > ``` > actions: > - "[MESSAGE] &aYou opened the SkyWars menu!" > - "[COMMAND] swp join solos" > - "[CONSOLE] say You joined SkyWars!" > ``` # join_menu.yml Guide ### Layout > > Example: > > ``` > # ONE, TWO, THREE..., SIX > rows: THREE > > buttons: > 10: > name: "&7&lSkywars Solos" > material: IRON_SWORD > glint: false > join-on-click: false > config: null > lore: > - "&7Coming Soon!" > - "&aGet ready for epic battles." > actions: > - "[MESSAGE] &cThis mode is coming soon!" > ``` > > **rows**: Number of rows in the menu(same values used in skywars-menu.yml) > > **join-on-click**: true/false – Whether clicking the button should instantly join the game. > > **config**: The game configuration name (used if join-on-click is true or when %config_player_count% is used). > > **lore**: Lines of description text for the button. > > **actions**: Optional extra actions to run when the button is clicked. ### Using %config_player_count% > > In **join_menu.yml**, you can use `%config_player_count%` in the lore or name to show the number of players in that config’s games. > > Example: > > ``` > lore: > - "&7Players: %config_player_count%" > ``` > > If `join-on-click` is **true** or want to use `%config_player_count%`, you must provide a valid config name. > If you don’t want to set a config, you can leave `config: null` or empty and instead add a command action to join. --- # stats-menu.yml Guide ### Layout > > Example: > > ```yaml > # ONE, TWO, THREE..., SIX > rows: THREE > > buttons: > 11: > name: "&b&lMini Stats" > material: DIAMOND_SWORD > glint: true > config: Mini > lore: > - "&7Kills: &f[KILLS]" > - "&7Wins: &f[WINS]" > - "&7Losses: &f[LOSSES]" > - "&7Deaths: &f[DEATHS]" > - "&7Winstreak: &f[WINSTREAK]" > actions: > - "[MESSAGE] &aYou opened Mini stats!" > - "[COMMAND] stats mini" > > 15: > name: "&a&l1v1 Stats" > material: IRON_SWORD > glint: false > config: 1v1 > lore: > - "&7Kills: &f[KILLS]" > - "&7Wins: &f[WINS]" > - "&7Losses: &f[LOSSES]" > - "&7Deaths: &f[DEATHS]" > - "&7Winstreak: &f[WINSTREAK]" > actions: > - "[MESSAGE] &aYou opened 1v1 stats!" > - "[COMMAND] stats 1v1" > ``` > > **rows**: How many rows the menu has (values: ONE, TWO, THREE, FOUR, FIVE, SIX). > > **buttons**: Each numbered key represents a slot in the menu. > > **name**: The display name of the button (supports color codes). > > **material**: The Minecraft item used for the button. > > **glint**: true/false – whether the button should have an enchantment glow. > > **config**: The game configuration name (e.g., `Mini`, `1v1`). > Used to pull the player’s stats for that game mode. > > **lore**: List of text lines shown when hovering over the button. > You can use placeholders: > - `[KILLS]` → Player’s total kills in this config > - `[WINS]` → Player’s total wins in this config > - `[LOSSES]` → Player’s total losses in this config > - `[DEATHS]` → Player’s total deaths in this config > - `[WINSTREAK]` → Player’s current winstreak in this config > > **actions**: What happens when the player clicks the button. --- ### Actions > > Actions follow the same `[TYPE] ` format shown in earlier menu customization tutorials in this description.

Tomqnto

More Villages Datapack