简介 #

基础命令 #

所有命令以 /island 开头，可简写为 /is。

岛屿操作

团队管理 #

传送与地标 #

功能界面 #

管理员命令 #

权限节点 #

岛屿等级与挑战 #

等级系统

岛屿等级由岛上所有方块的种类和数量计算得出。等级越高，可解锁的升级项越多。

• /island level — 查看当前岛屿等级
• /island top — 查看等级排行榜
• 升级岛屿可增加：成员上限、岛屿范围、合作人数等

挑战系统

完成挑战任务获取奖励，分为每日挑战和一次性挑战。

• 挑战类型：收集材料、击杀生物、建造特定结构等
• 奖励：游戏币、特殊物品、经验值

岛屿标志 #

通过 /island flag 设置你岛屿上的行为规则：

PlaceholderAPI 占位符 #

%bskyblock_island_level%            # 岛屿等级
%bskyblock_island_owner%            # 岛主名称
%bskyblock_island_members%          # 成员数量
%bskyblock_island_coop%             # 合作玩家数量
%bskyblock_island_trustees%         # 信任玩家数量
%bskyblock_island_bans%             # 封禁玩家数量
%bskyblock_island_biome%            # 岛屿生物群系
%bskyblock_island_locked%           # 岛屿是否锁定
%bskyblock_island_protection_range% # 保护范围
%bskyblock_island_coop_limit%       # 合作上限
%bskyblock_top_name_1%              # 排行榜第一名玩家名
%bskyblock_top_level_1%             # 排行榜第一名等级
%bskyblock_world_name%              # 空岛世界名称

快速示例 #

① 创建你的第一个空岛

# 创建你的空岛（会自动传送到岛上）
/island create

# 以后回岛用这个
/island go

# 查看你的岛屿等级
/island level

② 邀请朋友一起玩

# 邀请玩家（对方在线才有效）
/island invite [玩家]

# 被邀请者输入以下命令接受
/island accept

# 查看你的队伍
/island team

③ 设置岛屿权限

# 允许所有玩家在你的岛上使用工作台
/island flag

# 设置家位置（方便传送）
/island sethome

# 设置公开地标
/island setwarp

④ 管理员常用

# 查看某玩家的岛屿情况
/island admin info [玩家]

# 传送到某玩家岛上
/island admin tp [玩家]

# 强制重置玩家岛屿
/island admin reset [玩家]

# 重载配置
/island admin reload

简介 #

命令与权限

权限：mingmenu.[菜单ID] — 控制玩家是否有权限打开某个菜单。

编辑器教程

1. 输入 /menu editor 打开编辑器
2. 点击 + 新建菜单，输入菜单 ID（如 shop）
3. 配置菜单属性：标题、行数（1-6）、权限节点、打开条件等
4. 点击格子添加物品，设置物品的图标、名称、Lore
5. 保存菜单——退回到列表再点一下 保存 按钮

动作类型

菜单物品可以绑定以下动作（点击时执行）：

点击方式

每个物品可以为不同点击方式设置不同的动作：

物品配置

菜单物品支持以下属性：

条件与变量

在菜单或物品的 条件 字段中，可以设置玩家满足条件才能点击或打开：

支持 %player_name% %player_health% %vault_eco_balance% 等 PlaceholderAPI 变量。

实用技巧

• 用 空位填充 功能快速给菜单加背景玻璃板
• 给物品设置 刷新间隔 可以实现动态更新（如显示在线人数）
• 使用 可拖动物品 让玩家把物品放到菜单里（如提交物品兑换）
• 多层菜单：用 open 动作把菜单串联起来，像翻页一样
• 别忘了给每个菜单一个合理的 行数，3 行适合小菜单，6 行适合商店类

简介 #

命令用法与别名 #

直接输入 /lp 会显示当前玩家有权限执行的所有命令。若只返回版本消息，则你没有权限使用本插件的任何命令。

平台别名

参数说明

<必须> — 必须填写的参数   [可选] — 可选参数，留空则使用默认值

若参数中含空格，需用引号 " " 包裹。

通用命令 #

操作 LuckPerms 功能的通用命令。

玩家命令 #

格式：/lp user <玩家> <子命令>

权限组命令 #

格式：/lp group <组名> <子命令>

权限命令 #

用于管理玩家或组的权限。格式：/lp user/group <目标> permission <子命令>

继承命令 #

管理玩家或组的继承关系。格式：/lp user/group <目标> parent <子命令>

元数据命令 #

管理玩家或组的元数据（前后缀等）。格式：/lp user/group <目标> meta <子命令>

路线命令 #

管理晋升路线。格式：/lp track <路线名> <子命令>

日志命令 #

查询 LuckPerms 操作日志。

高级功能 #

快速示例 #

① 第一步：创建你的第一个权限组

所有玩家都应该有一个默认组。然后创建 VIP 组给赞助玩家。

# 创建默认组（所有新人自动拥有）
/lp creategroup default

# 给默认组基础权限
/lp group default permission set minecraft.command.spawn true
/lp group default permission set minecraft.command.me true

# 创建 VIP 组（权重 10，比默认组高）
/lp creategroup vip 10

# 让 VIP 继承 default 的所有权限
/lp group vip parent add default

# 给 VIP 组额外权限
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.feed true
/lp group vip permission set essentials.heal true

② 给玩家分组

# 把 [玩家] 加入 VIP 组（永久有效）
/lp user [玩家] parent add vip

# 给 [玩家] 一个人单独加飞行权限（不通过组）
/lp user [玩家] permission set essentials.fly true

# 查看 [玩家] 的权限和组
/lp user [玩家] info

# 把 [玩家] 从 VIP 组移除
/lp user [玩家] parent remove vip

③ 给玩家临时 VIP（30 天到期自动掉）

# 30 天后 VIP 自动消失，省心省力
/lp user [玩家] parent addtemp vip 30d

# 也可以按小时/分钟：30d=30天, 24h=24小时, 60m=60分钟
/lp user [玩家] parent addtemp vip 7d

④ 设置漂亮的前后缀

# 给 VIP 组加前缀 [VIP]（颜色代码 &6 = 金色）
/lp group vip meta addprefix 100 "&6[VIP] &f"

# 给管理员组加前缀 [Admin]
/lp group admin meta addprefix 200 "&c[Admin] &f"

# 权重数字越大越靠前，所以 Admin 的 200 优先于 VIP 的 100
# 如果玩家同时在 VIP 和 Admin 组，只会显示 Admin 前缀

⑤ 创建晋升路线（从入门到精通）

# 先建好需要的组
/lp creategroup helper
/lp creategroup mod
/lp creategroup admin

# 创建一条叫 staff 的晋升路线
/lp createtrack staff

# 按顺序把组加进去（从低到高）
/lp track staff append helper
/lp track staff append mod
/lp track staff append admin

# 给 [玩家] 晋升一级（从 helper -> mod）
/lp user [玩家] promote staff

# 或者直接设定他在路线中的位置
/lp user [玩家] parent settrack staff mod

⑥ 权限排错（为什么玩家没权限？）

# 检查玩家有什么权限和组
/lp user [玩家] info

# 检查某个具体权限是否 true/false
/lp user [玩家] permission check essentials.fly

# 打开调试模式，然后让玩家操作，看哪个权限被检测
/lp verbose on record
# 操作完后：
/lp verbose upload

# 查看权限树（所有权限一目了然）
/lp tree

⑦ 条件权限（不同世界不同权限）

# 只在生存世界禁用飞行
/lp group default permission set essentials.fly false world=survival

# 只在 pvp 世界允许使用 /kill
/lp group default permission set minecraft.command.kill true server=pvp

# 同时指定多个条件
/lp group vip permission set essentials.fly true world=survival server=生存服

⑧ 实用小技巧

# 直接复制一个组的所有设置（快速创建类似组）
/lp group vip clone vip+

# 清空某个玩家所有权限重新来
/lp user [玩家] clear

# 把某个玩家的权限全部复制给另一个玩家
/lp user [玩家] clone [玩家]

# 批量操作：把所有 essentials.fly 改为 false
/lp bulkupdate permission unset essentials.fly

文件结构与占位符 #

文件结构

plugins/LuckPerms/
  config.yml              # 主配置
  luckperms-h2.db         # H2 数据库（默认）
  yaml-storage/           # YAML 存储模式
    users/                # 玩家数据
    groups/               # 组数据
    tracks/               # 路线数据
  lp-config.yml           # 扩展配置

PlaceholderAPI 占位符

%luckperms_prefix%                    # 玩家前缀
%luckperms_suffix%                    # 玩家后缀
%luckperms_group_name%               # 主组名
%luckperms_groups%                   # 所有组名
%luckperms_meta_<key>%              # 自定义元数据
%luckperms_highest_group_by_weight%  # 权重最高组

简介 #

命令与权限 #

Tab 列表配置 #

顶栏和底栏

# config.yml
header:
  - "&6&l我的服务器 &7| &f%online_players%&7/&f%max_players%"
footer:
  - "&7延迟: &f%ping% &7| 余额: &f%vault_eco_balance%"

玩家格式（按组）

# config.yml
groups:
  owner:  { tabprefix: "&4[主人] &f", tagprefix: "&4[主人] &f" }
  admin:  { tabprefix: "&c[管理] &f", tagprefix: "&c[管理] &f" }
  vip:    { tabprefix: "&6[VIP] &f", tagprefix: "&6[VIP] &f" }
  default:{ tabprefix: "&7[玩家] &f", tagprefix: "&7[玩家] &f" }

计分板 #

# scoreboards.yml
scoreboards:
  main:
    title: "&6&l我的服务器"
    lines:
      - "&7-----------"
      - "&f玩家: &e%online_players%"
      - "&f余额: &e%vault_eco_balance%"
      - "&7-----------"
      - "&f延迟: &e%ping% ms"
    world: "world,world_nether"

名称标签 #

修改玩家头顶名字的前后缀和颜色。

# config.yml 组配置
  admin:
    tagprefix: "&c[管理] "
    tagcolor: "&c"
  vip:
    tagprefix: "&6"
    tagcolor: "&e"

占位符 #

权限节点 #

简介 #

基础帮助与插件管理 #

世界创建与管理 #

传送与锚点 #

世界属性修改 /mvm #

用 /mvm set <属性> <值> 修改当前或指定世界的属性。

游戏规则与生物控制 #

生物生成控制 /mvg

分世界游戏规则 /mvgamerule

附属插件 #

Multiverse-Portals（传送门 /mvp）

Multiverse-NetherPortals（独立下界末地门 /mvnp）

Multiverse-Inventories（独立背包 /mvi）

简介 #

命令与权限 #

附魔列表 #

剑 / 斧 近战附魔

远程附魔（弓 / 十字弩 / 三叉戟）

采集工具附魔（镐 / 锹 / 剪刀）

护甲附魔

盾牌 & 钓鱼竿 & 诅咒

附魔机制 #

• 附魔台 — 30 级可附出所有自定义附魔
• 附魔书 — 用 /ecoenchants giverandombook 随机获取
• GUI — /ecoenchants gui 打开可视化附魔界面
• 悬浮描述 — /ecoenchants toggledescriptions 开关附魔描述弹窗

占位符 #

稀有度系统 #

每个附魔都有稀有度等级，影响获取难度：

简介 #

命令总览 #

播放功能 #

使用 /zm help play 查看完整播放帮助。

搜索与点歌 #

搜索音乐

使用 /zm help search 查看完整搜索帮助。

点歌

使用 /zm help music 查看完整点歌帮助。

歌单 #

使用 /zm help playlist 查看完整歌单帮助。

管理员命令 #

使用 /zm help admin 查看完整管理员帮助。