常见问题 (FAQ)

本章节收集了 lhrp 插件用户在使用过程中可能遇到的一些常见问题及其解决方案。

1. 插件未加载或无法正常工作怎么办？

• 检查插件文件：确保 lhrp-2.0.jar 文件已正确放置在服务器的 plugins 文件夹中。
• 检查服务器日志：查看服务器启动日志，寻找任何与 lhrp 插件相关的错误信息。错误日志通常会提供问题原因的线索。
• 检查服务器版本兼容性：确保您的 Minecraft 服务器核心（如 Spigot, Paper）版本与插件兼容。通常插件会注明支持的服务器版本范围。
• Java 版本：确保您的服务器运行的是 Java 17 或更高版本。
• 依赖插件：确保已安装 PlaceholderAPI。
• 重载插件：尝试使用 /lhrp reload 命令重载插件。如果插件未加载，您可能需要重启服务器。

2. 为什么我无法使用某些警察命令？

• 权限不足：大多数警察命令都需要特定的权限。请检查您是否拥有执行该命令所需的权限节点（例如 police.handcuff）。您可以使用权限管理插件（如 LuckPerms）来查看和分配权限。
• 命令拼写错误：请仔细检查您输入的命令是否正确，包括子命令和参数。
• 插件未加载：如果插件未成功加载，所有命令都将无法使用。请参考问题 1 进行排查。

3. 逮捕功能为什么无效？

• 未设置监狱和释放点：逮捕功能依赖于监狱 (/police setjail) 和释放点 (/police setreleaseloc) 的设置。请确保您已使用这两个命令设置了有效的位置。
• 距离过远：逮捕玩家时，您必须在监狱点附近（默认 10 格内）。如果距离过远，逮捕将失败。
• 玩家未在线或未被通缉：您只能逮捕在线且被通缉的玩家。

4. 被手铐的玩家为什么还能移动/攻击/使用命令？

• 插件版本过旧：请确保您使用的是最新版本的 lhrp 插件，旧版本可能没有实现这些限制。
• 配置问题：检查 config.yml 文件中是否有相关设置可以禁用这些限制。如果存在，请确保它们已启用。
• 其他插件冲突：极少数情况下，其他插件可能会与 lhrp 插件冲突，导致手铐限制失效。尝试禁用其他插件进行测试。

5. 如何修改插件的提示信息？

• 插件的提示信息存储在 lang 文件夹中的语言文件（例如 lang_zh.yml）中。您可以通过编辑这些文件来修改插件的提示信息。修改后，使用 /lhrp reload 命令重载插件以使更改生效。

6. 如何获取插件的最新版本或寻求帮助？

• 请访问插件的官方发布页面或社区论坛，以获取最新版本、更新日志和寻求帮助。您也可以在相关社区中提问。

---

7. 市长模块相关问题

7.1 金库余额显示 -1 怎么办？

• 这表示经济系统未正确连接。请检查：
  • 是否已安装 Vault 插件
  • 是否已安装经济插件（如 EssentialsX Economy、CMI 等）
  • 经济插件是否正常工作

7.2 工资没有按时发放？

• 请检查以下几点：
  • 城市金库是否有足够资金
  • 玩家是否有有效职位
  • 控制台是否有错误信息
  • 插件是否已正确加载

7.3 如何修改默认时薪？

• 有两种方式：
  1. 编辑 plugins/lhrp/config.yml 中的 mayor.position_salaries 配置，然后执行 /lhrp reload
  2. 使用 /mayor salary <职位> <金额> 命令直接修改

7.4 可以自定义金库账户名称吗？

• 可以。在 plugins/lhrp/config.yml 中修改 mayor.treasury_account 配置项。
• 注意：修改后请重启服务器以确保更改生效。

7.5 充值后金库余额没有变化？

• 请确认：
  • 您的个人账户有足够余额
  • 使用的命令格式正确：/mayor add <金额>
  • 控制台没有报错信息

7.6 自动薪资多久发放一次？

• 默认每 60 分钟（1 小时）发放一次。
• 服务器重启后计时会重置。

7.7 资金不足时会怎样？

• 如果金库资金不足以支付某玩家的工资，该玩家本次将无法领取工资。
• 系统会发送"城市金库资金不足"的提示消息。
• 这不会影响其他玩家的工资发放。

7.8 市长模块需要安装什么插件？

• Vault（必需）- 经济系统 API
• 经济插件（必需）- 如 EssentialsX Economy、CMI、Gringotts 等

---

8. 职位权限相关问题

8.1 为什么设置了职位却没有权限？

• 确保玩家已正确设置职位：/police setposition <玩家> <职位>
• 检查职位配置中是否包含所需权限
• 执行 /police reload 重载配置

8.2 如何添加新职位？

• 使用命令：/police addposition <职位名称> <权限 1> <权限 2> ...
• 或在 config.yml 的 positions 部分手动添加

8.3 所有职位都会自动获得什么权限？

• 所有职位都会自动获得 lhrp.police 核心权限
• 这是警察身份识别和警察聊天频道的必需权限