Rules Agreement - 规则协议 - 阅读同意后升级玩家

RulesAgreement 是一款专为满足特定需求而设计的简单实用插件。我决定将其公开发布，因为它似乎填补了一个空白。希望你会喜欢它。我将继续努力扩展其功能。请务必完整阅读本页内容。谢谢！

💡功能简介

RulesAgreement 允许玩家在阅读并同意服务器规则后提升自己的等级。它依赖于 Vault 及与 Vault 兼容的权限系统。

当玩家完成阅读规则并同意后，你可以启用广播消息向全服宣布此事。一旦玩家被提升等级（假设你已正确设置权限），他们将无法再访问规则页面。

由于 Essentials 插件也有 /rules 命令，本插件将覆盖它。我提供了一个变通方案：当已提升等级的玩家输入 /rules 时，他们会收到一条包含你规则页面链接的消息（例如，指向你的网站论坛）。

🔧使用示例

• 让用户在阅读并同意服务器规则后提升等级。
• 玩家完成规则阅读并接受后，可启用广播消息。
• 玩家晋升后（假设权限设置正确），将无法再访问规则页面。

🎮权限节点

• rules.use

- 允许玩家执行等级提升流程。

• rules.reload

- 使用 `/rules reload` 命令的权限。

- （如果你在使用权限继承[你应该这样做]，你可能需要为非访客等级设置此节点的负权限）。

✨配置说明 (`config.yml`)

以下是配置文件的主要选项，你可以根据需要进行调整。

基本设置

• Debug: false

- 开发者调试模式，用于插件开发。

• No Rank Up: false

- 如果不想使用插件的等级提升部分，只想将其作为显示 `/rules` 的华丽方式，请设置为 true。完成 `/rules` 后，玩家仍会收到所有奖励，但会被标记为“已阅读规则”且不会再次收到。

• Send Welcome: false

- 是否在新玩家加入时发送欢迎消息？这将清空玩家的屏幕。你可以在此添加任何消息，但建议类似告知他们输入 `/rules` 来提升等级。

• Freeze Player: true

- 是否在玩家接受 `/rules` 前冻结其行动？

• Freeze Message: "&f[&6Rules&f] You must accept the rules first %player%."

- 当玩家试图移动时发送的消息。支持颜色代码。使用 `%player%` 插入玩家名称。

• Freeze Anti-Spam: 10

- 防刷屏的冻结消息发送间隔时间（秒）。

• Welcome Delay: 2

- 发送欢迎消息前的等待时间（秒）。建议不超过5秒。

欢迎消息与标题

• Welcome Message: "Welcome to &6FiberOptic.xyz&f, %player%! Before we begin, you need to rank yourself up to &bMember &fstatus. You can do that by typing /rules. If you need any help, feel free to ask in chat, someone will be happy to assist you!"

- 发送给玩家的欢迎消息。支持颜色代码。使用 `%player%` 插入玩家名称。请保持在350个字符以内。

• Send Welcome Title: true

- 是否也将欢迎消息作为标题发送？启用后需要下面两条消息：主标题和副标题。

• Title Float: 60

- 欢迎标题在屏幕上停留的时间（秒）。

• Welcome Title Main: "&fWelcome &b%player% to &6FiberOptic.xyz"

- 欢迎标题主行。支持颜色代码。使用 `%player%` 插入玩家名称。

• Welcome Title Sub: "&fYou can &bRank Up &fby typing &6/rules"

- 欢迎标题副行。支持颜色代码。

规则流程消息

• Introduction: "Thank you for reviewing our rules! Once you finish reviewing these rules you will be asked if you agree to follow the rules. Should you choose to decline, you will remain your current rank and you may miss out rewards. Use the \"Back\" and \"Next\" button to read through the rules. Thank you!"

- 介绍文本。可编辑，支持颜色代码。

• Agree Message: "By clicking Agree below, you agree to follow our servers rules at all times while connected to our server."

- 玩家完成所有规则阅读后发送的同意消息。支持颜色代码。

• Decline Message: "&f[&6Rules&f] I'm sorry you feel that way %player%."

- 玩家拒绝接受规则时发送的消息。支持颜色代码。使用 `%player%` 插入玩家名称。

• Kick on Decline: false

- 是否在玩家拒绝规则时将其踢出服务器？如果启用，将使用上面的“Decline Message”作为踢出消息。

提醒设置

• Player Nagging: true

- 是否定期提醒玩家查看规则？

• Title Nagging: false

- 是否使用 TitleManager 发送浮动消息进行提醒？这需要安装 TitleManager 插件。

• Nagging Title Main: "&fHey there, %player%!"

- 提醒标题主行。支持颜色代码。使用 `%player%` 插入玩家名称。

• Nagging Title Sub: "&fDid you know you can &bRank Up &fby typing &6/rules&f?"

- 提醒标题副行。支持颜色代码。

• Nagging Delay: 300

- 提醒间隔时间（秒）。

• Nagging Message: "&f[&6Rules&f] Hi %player%, did you know you can rank up by typing /rules?"

- 发送给玩家的提醒消息。支持颜色代码。使用 `%player%` 插入玩家名称。要使用欢迎消息，请在下面输入“none”或留空。

等级与经济设置

• Old Rank: "Guest"

- 玩家将被提升**前**的等级名称。

• New Rank: "Member"

- 玩家将被提升**后**的等级名称。

• Give Money: false

- 是否给予玩家金钱？需要经济插件和 Vault！

• Money Amount: 100.00

- 如果上面设置为 true，则给予的金钱数量（必须为双精度数字）。

广播与命令

• Broadcast: true

- 是否广播新玩家接受规则的消息？

• Broadcast Message: "%player% has accepted the rules and is now a %newrank%!"

- 玩家接受规则时发送的广播消息。支持颜色代码。可使用 `%player%`、`%oldrank%`、`%newrank%` 变量。

• Rules Link: "http://www.google.com/"

- 服务器规则的链接。本插件覆盖了 essentials 的 `/rules` 命令，这是替代方案。

• Console Commands:

- 完成规则协议后以控制台身份运行的命令列表。例如：`- "give %player% 260 1"`。使用 `%player%` 变量。

• Player Commands:

- 完成规则协议后以玩家身份运行的命令列表。例如：`- "kit starter"`。使用 `%player%` 变量。

服务器规则

在 Rules: 部分列出你的所有规则。每条规则需要少于350个字符（颜色代码不计入）。格式如下：

Rules:
  规则名称1: "规则内容1，请确保字符数限制。"
  规则名称2: "规则内容2，请确保字符数限制。"

❓依赖与要求

• 需要 Vault 及与 Vault 兼容的权限系统。
• 若启用 Title Nagging，则需要 TitleManager 插件。
• 若启用 Give Money，则需要经济插件和 Vault。

⭐计划新增功能

• “测验”选项。创建问题并提供答案供选择。
• 完成规则/测验的奖励，例如：

- 货币奖励，向玩家支付。

- 给予物品。

• 其他建议？请到讨论区发帖。

---

喜欢我的内容？想看到更多？请考虑在下面的 Patreon 页面支持我。每一分钱都有帮助，能确保我继续编写代码！

https://www.patreon.com/FiberDev

请注意：不会在‘评论’部分提供支持。如需帮助，请前往讨论页面。

我的所有插件都有非常详细的注释。在联系我寻求支持之前，请仔细阅读。