RustCraft - 部落战争与建筑生成

RustCraft 是一款灵感来源于游戏《Rust》的插件，玩家可以组建团队、发起突袭……或者独自潜行于树林之间，体验生存与竞争的乐趣。

💡核心特性

部落系统

• 创建部落，认领领地，设立部落首领，玩法类似《Rust》。
• 放置部落箱子作为领地中心，领地随之生成。部落箱子无法被任何方式破坏。
• 领地保护会保护玩家放置的所有箱子（自然生成的箱子除外），敌对部落的玩家无法打开。
• 被保护的箱子无法被敌对玩家炸毁。但此保护仅在部落无任何成员在线时生效。只要有一名成员在线，敌对玩家即可打开箱子。
• 敌对玩家可以在其他部落领地内破坏方块和放置TNT。TNT放置后即被点燃。
• 若领地处于保护状态，敌对玩家在其中的挖掘速度会变得极低。

领地维护与价值

• 领地保护并非免费。插件会根据领地内箱子中的物品计算领地价值，物品越稀有，价值越高。
• 每个 Minecraft 日，部落成员必须向部落箱子内填充特定资源，以确保次日能获得保护。
• 注意：保护重置仅在前一日有部落成员登录过的情况下才会进行。
• 获得龙蛋的部落会得到奖励。将龙蛋放置在领地内y轴高度大于78格的位置，即可获得无限期保护（只要龙蛋保持在原位）。
• 此机制鼓励敌对玩家窃取龙蛋。最低高度限制迫使持有龙蛋的部落将其置于“易受攻击” 的位置（无法直接埋在地下）。

等级与战争系统

• 部落领地半径随部落等级变化。
• 玩家可以向其他部落宣战。双方在限定时间内尽可能多地击杀对方成员。
• 击杀数更高的一方获胜。获胜部落提升一个等级，失败部落降低一个等级（最低为1级）。

结构生成与战利品

• 结构在区块被加载时生成，而非世界创建时。
• 共有6种不同的结构，生成概率各不相同。
• 结构中包含两种战利品箱：

- **RustCraft 箱子**

- **RustCraft 高级箱子**（更稀有，战利品更好）

🎮指令列表

大多数指令以 /clan 开头，部落邀请管理指令除外。

通用指令

• /rustcraft info - 显示插件信息。
• /clan create - 给予玩家一个部落箱子。放置后，部落即被创建。
• /clan list - 列出服务器中的所有部落。
• /clan join <部落名称> - 加入一个隐私设置为“公开”的部落。
• /accept - 接受玩家的部落邀请。
• /decline - 拒绝玩家的部落邀请。

部落成员指令

• /clan leave - 离开部落。如果部落无人留下，则部落将被删除。
• /clan tp - 直接传送至部落箱子的位置。
• /clan needs - 显示获得保护所需的新资源配额。
• /clan info - 显示关于您部落的所有信息（保护状态、等级、描述等）。
• /clan chat <消息> - 与部落成员进行私密聊天。
• /clan members - 列出部落的所有成员。

首领指令

• /clan name <名称> <颜色> - 更改部落名称（默认名称为“Clan”+数字）。
• /clan lead <玩家名> - 转移部落所有权。
• /clan invite <玩家名> - 邀请玩家加入部落。
• /clan kick <玩家名> - 踢出一名部落成员。
• /clan change - 移动您的部落箱子。
• /clan war <部落名称> - 向其他部落宣战。（服务器重载或停止时，所有战争记录将被清除）
• /clan <private/public> - 切换部落的隐私设置。
• /clan description - 设置部落描述。

管理员指令

• /clan reset - 仅限OP或拥有 clan.reset 权限的玩家使用！重置所有部落并摧毁所有部落箱子。
• /clan delete <部落名称> - 仅限OP或拥有 clan.delete 权限的玩家使用！删除指定部落。
• /rustcraft reload - 仅限OP玩家使用！重载插件的配置文件。

🔧安装指南

• 首先，你需要 World Edit 的最新版本 (https://dev.bukkit.org/projects/worldedit/files)。这非常重要：它使插件能够生成结构（否则在加载插件时会出现大量错误信息）。
• 如果你希望API正常工作，还需要 Dynmap (https://www.spigotmc.org/resources/dynmap®.274/update?update=517958)。
• 点击 Download Now 按钮并解压文件夹。将插件文件（.jar文件）放入服务器的 plugins 文件夹。
• 启动/加载服务器一次，以创建 RustCraft 文件夹。该文件夹将位于你的 plugins 文件夹内 (~/plugins/RustCraft)。
• 插件使用包含在 .ZIP 文件夹中的 6个 SCHEM 文件。如果 Spigot 没有提供 .zip 文件，你可以从此处下载。将这6个文件放入 RustCraft 文件夹 (~/plugins/RustCraft)。
• 大功告成！开始享受吧！

✨配置说明

插件配置文件 (config.yml) 允许你修改大量参数，包括：

• 用于计算领地价值的特定物品价值。
• 部落箱子内特定资源的价值。
• RustCraft 箱子和 RustCraft 高级箱子中战利品的生成概率。
• 自定义结构的生成概率。
• 龙蛋提供保护所需的最低高度（方块数）。
• 每次“清空”部落箱子资源的时间间隔（秒）。
• 每个等级对应的部落领地半径（方块数）。
• 宣战时，双方部落可允许的最大玩家数量差。
• 战争的持续时间（秒）。
• 允许创建部落及生成结构的世界名称。
• 插件聊天功能的开关。
• 是否允许敌人在你的领地内建造。

首次启动后，还会生成一个 languages.yml 文件。

• 如果你想翻译成自己的语言，可以替换文件内的所有文本，或者（如果你想保留‘english’语言）复制原始文本，将键名‘english’改为你的语言名并翻译所有值。
• 之后，你必须在 config.yml 中将 language 的值改为你的语言名称即可。

你还可以在插件的语言文件中使用占位符系统：

• {CLAN}：显示玩家的部落名称。
• {PLAYER}：显示玩家名称。
• {WAR STATUS}：如果玩家的部落处于战争中则显示“IN WAR”，否则显示“PEACEFUL”。

配置示例 (`config.yml` 部分内容)

# 领地内箱子中所有物品的价值
values:
  diamond: 5
  netherite: 20
  iron: 1
  copper: 1
  ...
# 部落箱子内资源的价值
chest_values:
  cake: 50
  netherite: 40
  emerald: 20
  ...
# 每个等级对应的领地半径
radius_per_level:
  lvl_1: 30
  lvl_2: 35
  lvl_3: 40
  ...
# 龙蛋保护所需的最低高度
dragon_egg_height: 78
# 语言设置
language: english

❓重要提示与建议

• 建议不要过多修改结构的生成概率，否则可能影响服务器占用的RAM。
• 战利品生成概率不应高于50%。物品数量是通过将生成概率翻倍来计算的。因此，50/100的概率将总是导致生成 >1 个该物品。
• 当更改用于部落箱子的资源价值时，你必须确保至少有一种资源的值为 “1”。

- 例如，如果你需要向部落箱子填充价值为“11”的资源，你放入3个钻石（每个资源价值为5），总价值为15。那么其中2个钻石（价值10）将被消耗，**留下1点价值**。这剩余的1点价值将导致领地**无法获得保护**。

• 最大玩家数量差会在宣战时检查目标部落是否有足够的玩家，以确保战斗公平。

- 例如，如果设置为2，目标部落有3名玩家，而你的部落有6名玩家，则战争不会发生，因为 6 - 3 = 3，大于2。

• 最后，请不要对配置进行过于疯狂的修改，例如将龙蛋的最低高度设为“1000”，或将RustCraft箱子中的物品最大数量设为“100”。

⭐开发者的话

这是我创建的第一个插件，花费了大约 75小时 的开发时间，但它远非完美。代码并未完全优化，而且很可能存在一些我尚未发现的错误。

因此，我恳请你通过 Spigot 或 Discord (https://discord.gg/fvv8NHx) 提供关于插件的反馈，以便我能改进它，并可能添加更多功能。反馈对我非常重要，因为没有它，插件将慢慢失去活力……如果你喜欢这个插件，请不要忘记分享它！

我是法国人，我知道我的翻译水平不高。所以对于本帖和插件中可能存在的错误，我表示歉意。非常感谢 BingoRufus (https://www.spigotmc.org/members/bingorufus.611165/) 在这方面给予我的巨大帮助！