公会

公会

有了公会，你可以创建、管理并保护你的公会领地，这套强大的系统已完全融入游戏之中。

杂项

🛡️ 公会：Hytale 终极公会系统

🌟 概述

欢迎使用公会——Hytale 服务器的完整公会管理插件。

公会现在采用现代领地模型，其中：

  • 区域是主要公会领地。
  • 地块是区域内部的细分地块，用于详细的拥有权和规则管理。

它还包括私密公会聊天、全局公会标签支持、经济集成、占位符、本地化文档及基于等级的权限管理。

✨ 包含内容（已更新）

  • 完整的公会生命周期：创建、邀请、接受/拒绝、离开、踢出、晋升/降职、转移领导权、解散。
  • 区域 + 地块 领地系统（取代旧的仅认领概念）。
  • 世界地图上的区域/地块可视化（v1.2 已完全推出）、地块定位工具及可配置的保护规则。
  • 公会聊天频道 + 切换模式 + 可选的全局聊天公会标签前缀。
  • 经济模块：包含公会银行、地块出售/租赁及地块市场设置。
  • 占位符模块：支持 %guild_*% 占位符。
  • 多语言支持 + 本地化的 Guilds-README 文档（docs/<语言>/Guilds-README.md）。

🗺️ 领地模型：区域 vs 地块

区域

区域是核心公会领地（宏观控制）：

  • 认领/放弃领地。
  • 区域的全局保护规则。
  • 公会持有权及地图可视化。

地块

地块是区域内部的细分地块（微观控制）：

  • 分配/撤销地块持有权。
  • 基于 lotsProtection 策略覆盖每个地块的行为。
  • 在启用经济模块时支持地块出售/租赁流程。

与将所有内容视为单一“认领”概念相比，这种划分提供了更好的可扩展性和组织结构。

💰 经济模块（含兼容桥梁）

当 economy.enabled=true 且存在受支持的桥梁时，经济模块生效。

受支持的经济桥梁

  • VaultUnlocked（vaultunlocked）
  • EcoAPI（ecoapi）
  • Ledger（ledger）

如果 economy.bridge=auto，公会会按顺序尝试：vaultunlocked → ecoapi → ledger。

经济功能

  • 公会银行：余额、存款、取款、日志。
  • 取款保护（若提供方支付失败则回退）。
  • 每日取款限制（economy.bank.dailyWithdrawDefault）。
  • 地块经济操作：出售、购买、租赁报价、接受、支付、取消。
  • 地块市场控制：税收、过期时间、上架限额、税收去向。

🧩 占位符模块

公会集成了类似 PlaceholderAPI 的占位符（基于反射，无硬依赖），包括：

  • %guild_name%
  • %guild_tag%
  • %guild_rank%
  • %guild_leader%
  • %guild_member_count%
  • %guild_online_count%
  • %guild_claims%
  • %guild_lots%
  • %guild_bank_balance%
  • %guild_provider%
  • %guild_preferred_economy%

📚 文档与本地化

公会附带本地化语言文件和本地化文档，以改善入门体验：

  • mods/Guilds/lang/*.lang
  • mods/Guilds/docs/<语言>/Guilds-README.md

可用的文档/语言覆盖范围包括：pt-BR、en-US、es-ES、fr-FR、it-IT、ja-JP、zh-CN、de-DE。

🆕 v1.3 亮点

  • 引入了外交模块的第一个公开迭代版本。
  • 新增了盟友/敌人/中立关系的流程和关系概览命令。
  • 新增了联盟聊天频道支持，用于联盟通信。
  • 新增了冲突状态集成，作为未来战争进展改进的基础。
  • 进行了全局稳定性优化，包括微调和错误修复。

外交模块（详细范围）

当前外交发布包括：

  • /guild ally 发送/接受联盟请求。
  • /guild enemy 宣战。
  • /guild neutral 重置外交状态。
  • /guild relations 查看活跃关系和战争状态上下文。
  • /guild allychat 和 /guild allytoggle 用于联盟频道通信。

这是初始里程碑，仍在发展中。随着我们继续扩展和平衡外交系统，仍可能出现小错误或边缘情况不一致。

⚠️ 版本兼容性政策（Hytale）

Hytale 现在要求模组兼容性必须与游戏版本精确匹配。

公会政策：

  • 始终以最新的稳定版本为目标。
  • 默认不针对预发布游戏版本。
  • 未来可能会发布带有明确名称的替代构建（例如 1.3-pre-release），如有需要。

⚔️ 命令（完整版）

默认根命令为 /guild（别名可包括 /guilds 和 /g）。

基础命令

  • /guild help [页码]
  • /guild create <名称> <标签>
  • /guild disband
  • /guild info [公会]
  • /guild list
  • /guild spawn
  • /guild setspawn

成员与等级

  • /guild invite <玩家>
  • /guild accept <公会>
  • /guild decline <公会>
  • /guild invites
  • /guild leave
  • /guild kick <玩家>
  • /guild promote <玩家>
  • /guild demote <玩家>
  • /guild transfer <玩家>
  • /guild members
  • /guild chat <消息>
  • /guild gc <消息>
  • /guild toggle
  • /guild radar <on|off>

领地（区域）

  • /guild region 或 /guild claim
  • /guild unregion 或 /guild unclaim
  • /guild region info 或 /guild claim info
  • /guild region list 或 /guild claim list
  • /guild region ui 或 /guild region visual

领地（地块）

  • /guild lot enable
  • /guild lot disable
  • /guild lot info
  • /guild lot assign <玩家>
  • /guild lot revoke
  • /guild lot locate [off]

经济（银行）

  • /guild bank
  • /guild bank deposit <金额>
  • /guild bank withdraw <金额> [玩家]
  • /guild bank log [页码]

经济（地块市场/租赁）

  • /guild lot sell <价格>
  • /guild lot buy
  • /guild lot rent offer <价格> <天数> [宽限期]
  • /guild lot rent accept
  • /guild lot rent pay
  • /guild lot rent cancel

地块规则控制

  • /guild lot rules
  • /guild lot set <规则> <继承|允许|拒绝>

管理员/员工

  • /guild admin set <设置> <on|off>
  • /guild admin list

⚙️ 权限节点（模式）

公会使用以下格式的权限节点：

guilds.command.<子命令>

示例：

  • guilds.command.create
  • guilds.command.invite
  • guilds.command.claim
  • guilds.command.region
  • guilds.command.lote
  • guilds.command.bank
  • guilds.command.admin
  • guilds.command.spawn
  • guilds.command.setspawn

以更强的控制力、更好的进展和更清晰的领地管理，建立你的公会社区。

由 CrystalOcean 开发