跳到主要内容

故障排查

症状：/nsp 或 /nustarparty 提示“未知命令”​

排查：

  1. 确认插件已加载：控制台执行 /plugins，NuStarParty 是否为绿色？
  2. 确认硬依赖已安装：minecraft-next 是否已安装并启用？
  3. 查看后台日志：是否有依赖缺失/类找不到（ClassNotFound）等报错？

解决：

  • 缺 minecraft-next：先安装该前置插件再启动
  • 插件未启用：确认 jar 放在 plugins/，且文件名未损坏；必要时重新下载/重新构建

症状：打开菜单报错 / 菜单物品显示异常​

排查：

  1. 检查 plugins/NuStarParty/*.yml 中的 material 是否是你服务端版本支持的材质名
  2. 查看后台日志是否出现 Material 相关报错

解决：

  • 还原默认菜单：删除对应菜单文件（例如 plugins/NuStarParty/party-menu.yml），重启让插件重新释放默认文件
  • 或手动把 material 改成正确的材质名后 /nsp reload

症状：点击按钮无反应 / 提示没有权限​

排查：

  1. 你是否给玩家授予 NuStarPartyPlayerPerm？
  2. 你是否给管理员授予 NuStarPartyAdminPerm（用于 help/reload）？
  3. 某些操作还要求你是队长（例如踢人/解散/处理申请/转让队长）

解决：

  • 使用 LuckPerms 授权（示例见《命令与权限》）
  • 先用 OP 测试，确认功能正常后再细分权限

症状：重启后队伍没了​

原因：

  • NuStarParty 当前版本队伍/邀请/申请都是 内存数据，不会写入磁盘。

解决：

  • 属于设计行为；如你需要持久化，请评估二开或外置存储方案。

症状：DungeonPlus / MythicDungeons 开本时队友没被带进副本​

排查：

  1. 开本的玩家必须是队伍队长（否则会被阻止）
  2. DungeonPlus：如果有队员“正在地牢世界中”，可能会阻止开本（防止状态冲突）

解决：

  • 让队伍队长发起开本
  • 确认队员没有卡在地牢世界/副本中（必要时先让其退出副本）

症状：地牢里无法解散队伍​

原因：

  • 安装 DungeonPlus 时，NuStarParty 会在地牢中禁止解散队伍（避免联动状态异常）。

解决：

  • 先退出地牢/副本，再解散队伍。