SkyWars+

!(https://cdn.modrinth.com/data/cached_images/0a82d5598337b294e0f92339d0ad7ba74393ec1a.png)

Report an issue

## !(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

## !(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: > team-spawn-locations: > - > - > - > - > op-chest-locations: > - > - > 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 > ```

## !(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 format: > > – Runs a command as the console > > – Runs a command as the player > > – Sends a chat message to the player > > Example: > > ``` > actions: > - " &aYou opened the SkyWars menu!" > - " swp join solos" > - " say You joined SkyWa