跳到主要内容

快速开始（5 分钟跑通）

目标：完成一次“创建队伍 → 邀请 → 接受邀请 → 队伍管理”的闭环。

前置条件​

  • 运行端：Bukkit / Spigot / Paper
  • 硬依赖：minecraft-next（plugin.yml 的 depend）
  • 权限系统：可选（推荐 LuckPerms；没有也可以先用 OP 测试）
  • （可选）NuStarCoreBridge：如果你需要使用龙核/萌芽/云拾等客户端 UI 发包调用 NuStarParty

1) 安装插件​

  1. 将 minecraft-next 与 NuStarParty 的 jar 放入服务端 plugins/
  2. 重启服务端（推荐重启，不建议热插拔）
  3. 首次启动后确认生成目录 plugins/NuStarParty/，并包含：
    • config.yml
    • language.yml
    • party-menu.yml
    • my-party-menu.yml
    • party-join-application-menu.yml
    • invite-menu.yml
    • player-list-menu.yml

验证：

  • 控制台执行 /plugins 能看到 minecraft-next 与 NuStarParty 为绿色
  • 或确认 plugins/NuStarParty/ 下已生成上述文件

2) 赋权限（推荐）​

NuStarParty 只使用两个权限节点：

  • 玩家：NuStarPartyPlayerPerm
  • 管理员：NuStarPartyAdminPerm（含 help/reload）

LuckPerms 示例：

/lp group default permission set NuStarPartyPlayerPerm true
/lp group admin permission set NuStarPartyAdminPerm true

3) 打开菜单并完成一次组队​

命令入口：

  • 主命令：/nustarparty
  • 别名：/nsp

常用打开菜单命令：

  • /nsp openPartyMenu：队伍列表
  • /nsp openMyPartyMenu：我的队伍
  • /nsp openInviteMenu：邀请列表
  • /nsp openJoinApplicationMenu：申请列表（队长专用）
  • /nsp openPlayerListMenu：玩家列表（快速邀请）

最小跑通流程：

  1. 玩家 A：/nsp openPartyMenu → 点击“创建一个队伍”
  2. 玩家 A：打开“玩家列表” → 左键邀请玩家 B
  3. 玩家 B：/nsp openInviteMenu → 左键接受邀请
  4. 玩家 A：/nsp openMyPartyMenu → 查看成员列表

成功标志：

  • 玩家 B 收到加入/接受邀请的提示
  • “我的队伍”菜单里能看到队长与成员

4) 验证队长转让 / 自动退队​

  • 队员离线：自动退队
  • 队长离线：优先自动转让给在线队员；若无在线队员则自动解散队伍

手动转让队长：

  • 命令：/nsp transferLeader <成员名>
  • GUI：在“我的队伍”里对成员按钮 Shift + 右键

踢出成员：

  • GUI：在“我的队伍”里对成员按钮 Shift + 左键

注意：插件内置 help 文案可能显示 /nsparty ...，但实际命令以 plugin.yml 为准（即 /nustarparty//nsp）。