
报告问题

-
地图系统 – 只需将世界文件夹放入 /plugins/SkyWarsPlus/maps 并轻松配置
-
自定义游戏配置 – 设置不同的模式(单人、双人等)
-
战利品编辑器 – 在游戏中添加和自定义战利品
-
自动箱子检测 – 无需手动添加岛屿箱子(需手动添加 OP 箱子位置)
-
箱子补货 - 为每个游戏配置添加自定义的箱子补货时间
-
地图 ID - 选择所需的地图,只需在配置中提供地图 ID 即可

第 1 步:添加地图
将您的世界文件夹放置在:
plugins/SkyWarsPlus/maps/
每个世界的文件夹名将作为地图名称。
接下来,在 map_data.yml 中定义地图数据,如下所示:
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
说明:
waiting-area-location:玩家在比赛开始前等待的位置。
team-spawn-locations:每支队伍在比赛开始时生成的位置。
chest-locations:仅中间岛屿的箱子。这些箱子包含更好的战利品。
必须是整数(无小数点)。
普通箱子的位置会自动检测——您无需添加它们。
第 2 步:创建游戏配置
使用以下命令创建游戏配置:
/swp create_config <name> <min_teams> <max_teams> <team_size> <max_armor_normal_chest> <max_armor_op_chest> <refill_cooldown> <map_ids>
name:游戏设置的名称(例如,“Solos”、“Duos”)。
min_teams:开始所需的最少队伍数量。
max_teams:允许的最大队伍数量。
team_size:每支队伍的队员数量。
refill_cooldown:箱子补货之间的时间间隔(秒)。
map_ids:与此设置配合使用的地图 ID(例如,waterfallSolos)。
第 3 步:配置战利品
将物品放入任何箱子(普通)或中间箱子中。
直接看向该箱子。
运行以下任一命令:
/swp setloot <normal/op>
或者
/swp addloot <normal/op>
您可以在 loot-items.yml 中进一步自定义战利品:
chance:物品出现的概率。
min-amount / max-amount
自定义名称等。
第 4 步:加入游戏
要加入游戏:
/swp join <id | config name>

SkyWars+ 允许您完全自定义其菜单,以提供独特的服务器体验。
重要提示:
菜单自定义需要正确的 YAML 格式。错误的缩进或语法会导致菜单失效。
菜单文件
skywars_menu.yml – 玩家可打开的主 SkyWars 菜单
join_menu.yml – 不同模式/配置的游戏中选器菜单
skywars_menu.yml 指南
布局
示例:
# 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:菜单有多少行(值:ONE, TWO, THREE, FOUR, FIVE, SIX)。
buttons:每个编号键代表菜单中的一个槽位。
name:按钮的显示名称(支持颜色代码)。
material:用于按钮的 Minecraft 物品。
glint:true/false – 按钮是否应具有附魔光泽。
lore:鼠标悬停在按钮上时显示的文本行列表。
actions:玩家点击按钮时发生的事件。
动作
动作以 [TYPE] <value> 格式添加:
[CONSOLE] <command> – 以控制台身份运行命令
[COMMAND] <command> – 以玩家身份运行命令
[MESSAGE] <message> – 向玩家发送聊天消息
示例:
actions:
- "[MESSAGE] &aYou opened the SkyWars menu!"
- "[COMMAND] swp join solos"
- "[CONSOLE] say You joined SkyWars!"
join_menu.yml 指南
布局
示例:
# 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:菜单中的行数(与 skywars-menu.yml 中使用的值相同)
join-on-click:true/false – 点击按钮是否应立即加入游戏。
config:游戏配置名称(当 join-on-click 为 true 或使用 %config_player_count% 时使用)。
lore:按钮的描述文本行。
actions:点击按钮时可运行的可选额外动作。
使用 %config_player_count%
在 join_menu.yml 中,你可以在物品的描述(lore)或名称(name)中使用 %config_player_count% 来显示该配置下游戏中的玩家数量。
示例:
lore:
- "&7Players: %config_player_count%"
如果 join-on-click 为 true 或者想要使用 %config_player_count%,则必须提供一个有效的配置名称。
如果你不想设置配置,可以将 config 留为 null 或空值,然后改为添加一个命令动作来加入游戏。
stats-menu.yml 指南
布局
示例:
# 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: 菜单的行数(可选值:ONE, TWO, THREE, FOUR, FIVE, SIX)。
buttons: 每个数字键代表菜单中的一个槽位。
name: 按钮的显示名称(支持颜色代码)。
material: 用于按钮的 Minecraft 物品。
glint: true/false – 按钮是否应带有附魔光泽。
config: 游戏配置名称(例如 Mini, 1v1)。
用于获取该游戏模式下玩家的统计数据。
lore: 鼠标悬停在按钮上时显示的文本行列表。
你可以使用占位符:
[KILLS] → 玩家在该配置中的总击杀数
[WINS] → 玩家在该配置中的总胜利数
[LOSSES] → 玩家在该配置中的总失败数
[DEATHS] → 玩家在该配置中的总死亡数
[WINSTREAK] → 玩家在该配置中的当前连胜数
actions: 玩家点击按钮时执行的操作。
动作(Actions)
动作遵循与本文档前面菜单自定义教程中相同的 [TYPE] <value> 格式。

Report an issue

-
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

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> <min_teams> <max_teams> <team_size> <max_armor_normal_chest> <max_armor_op_chest> <refill_cooldown> <map_ids>
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 <normal/op>
or
/swp addloot <normal/op>
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 <id | config name>

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] <value> format:
[CONSOLE] <command> – Runs a command as the console
[COMMAND] <command> – Runs a command as the player
[MESSAGE] <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:
# 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] <value> format shown in earlier menu customization tutorials in this description.
评论 0
登录后参与评分
还没有评论,来抢沙发吧