Structs Guild

核心用法

Structs Guild 技能是专为 Structs 链上游戏设计的公会管理工具集，支持从创建到运营的全流程操作。核心场景包括：

公会创建与配置：通过 guild-create 创建公会，需具备反应堆权限（PermReactorGuildCreate）和入口变电站连接权限（PermSubstationConnection）。公会采用数字等级制（1-101），等级越低权限越高，创建者为 rank 1。

成员管理：支持三种入会流程——直接加入（需满足最低质押要求）、邀请制（公会发起→玩家批准）、申请制（玩家申请→公会批准）。特殊功能包括代理加入（Proxy Join）可为新玩家直接链上初始化 UGC 字段（名称、头像）。踢出成员使用 guild-membership-kick。

权限与治理：等级权威系统规定，操作者只能管理等级严格低于自己的成员。player-update-guild-rank 调整成员等级，guild-update-entry-rank 设置新成员默认等级（不得低于操作者自身等级）。

中央银行代币：公会可铸造自定义代币（guild-bank-mint），以 Alpha Matter 为抵押；支持赎回（guild-bank-redeem）和没收销毁（guild-bank-confiscate-and-burn）。抵押储备可链上查询验证。

去中心化内容审核：Structs 无全局审核，各公会自主制定 UGC（名称、头像）政策。通过 PermGuildUGCUpdate（16777216）权限授予等级或特定玩家审核权，操作链上可审计（ugc_moderated 事件）。支持修改玩家、星球、变电站的名称/头像。

服务商访问控制：通过 permission-guild-rank-set 限制特定服务商仅对某公会指定等级以上成员开放，实现基于公会身份的细粒度授权。

显著优点

• 链上原生 UGC：公会名称、头像、成员身份均为链上一等公民，非链下元数据
• 灵活治理模型：等级制 + 权限位图支持从独裁到民主的多种治理结构
• 可审计审核：所有非所有者修改 UGC 的操作强制链上事件记录
• 经济自主权：公会自主发币，抵押透明可查
• CLI 安全设计：所有交易命令统一使用 -- 分隔符，防止含横线 ID 被误解析为 flags

潜在局限

• 技术门槛高：需理解 25-bit 权限系统、等级权威规则、质押机制等概念
• 无内置模板：公会需从零设计自己的审核政策和等级结构
• 依赖链状态：成员操作、代币铸造等受链上抵押物和权限实时状态约束
• CLI 专精：命令复杂，flag 顺序敏感，需严格遵循 [TX_FLAGS] -- [args] 格式

适合人群

• Structs 游戏公会创建者和管理员
• 需要实施自定义内容审核策略的社区运营者
• 希望发行公会代币并管理抵押储备的 DAO 组织者
• 开发 Structs 自动化管理工具的集成工程师

常规风险

• 权限配置错误：错误授予 PermGuildUGCUpdate 或高等级权限可能导致治理失控
• 经济风险：代币铸造过度或抵押物管理不当可能导致公会银行挤兑
• CLI 误操作：忘记 -- 分隔符或错误 ID 格式可能导致意外交易或失败
• 审核争议：去中心化模式下，公会审核标准不一可能引发成员纠纷，需依赖链上事件追溯

核心用法

Structs Guild 技能是一个专为链上游戏公会管理设计的命令参考工具，涵盖四大核心场景：

1. 公会生命周期管理

• 创建公会需反应堆权限 PermReactorGuildCreate 和变电站连接权限
• 使用 guild-create 命令指定反应堆 ID、服务端点及入口变电站
• 支持通过邀请、申请、代理等多种方式加入公会

2. 成员与权限体系

• 采用数值化等级制度（1=最高权限，101=默认加入等级，0=未设置）
• 权限遵循「严格优于」原则：操作者等级必须严格高于目标成员
• 支持邀请制、申请制、踢除成员等完整成员管理流程

3. 中央银行代币操作

• 铸造：guild-bank-mint 使用签名者所属公会，将 Alpha Matter 抵押品转换为公会代币
• 赎回：guild-bank-redeem 将代币兑换回抵押品
• 罚没销毁：guild-bank-confiscate-and-burn 用于治理违规资产

4. 去中心化内容审核

• 公会自主设定名称、头像审核标准，无全局审查
• 通过 PermGuildUGCUpdate 权限分配审核权力（按等级或按玩家）
• 所有审核操作生成链上 ugc_moderated 事件供审计

显著优点

权威性与完整性：内容直接来源于 structs.ai 官方知识库，覆盖 25+ 条 CLI 命令，包含完整的权限位（25-bit）系统说明和错误处理指南。

安全设计亮点：

• 独特的 -- 前缀机制解决带横杠 ID 被误解析为标志的问题
• 等级权限系统避免单一管理员垄断，支持分层治理
• 中央银行抵押透明可查，支持 guild-bank-collateral-address 验证储备

灵活性：

• 支持代理加入（Proxy Join）为新玩家直接播种链上 UGC 字段
• 公会可自定义入会抵押门槛，区分邀请/申请/直接加入的不同要求
• 提供商访问控制可通过公会等级批量授权，简化权限管理

潜在缺点与局限性

技术门槛较高：命令行操作需要熟悉 Cosmos SDK 风格的 CLI 语法，对非技术用户不友好。所有金额参数需使用「原始整数」而非格式化数值，易因精度错误导致损失。

依赖外部基础设施：公会功能依赖 Structs 游戏链的运行状态，若链上拥堵或升级，命令可能失败。抵押品价格波动可能影响代币经济稳定性。

权限误配置风险：等级权限系统虽灵活，但 guild-update-entry-rank 要求新等级必须≥调用者自身等级，配置不当可能导致权限固化或无法招募新成员。

无全局仲裁：去中心化审核意味着争议解决完全依赖公会内部，对于跨公会纠纷或严重违规行为缺乏链上申诉机制。

适合的目标群体

链游公会管理者：需要批量管理成员、设置准入门槛、执行代币激励的 DAO 或游戏公会运营者。

Structs 游戏玩家：深度参与游戏经济系统，需要操作抵押、铸币、Provider 接入等高级功能的玩家。

区块链开发者：研究 Cosmos SDK 游戏链权限模型、探索链上 UGC 治理方案的开发者。

GameFi 研究员：分析链游公会经济结构、中央银行机制、去中心化审核模式的学术或行业研究人员。

使用风险

操作不可逆性：链上交易一旦确认无法回滚，guild-bank-mint 错误抵押比例或 guild-membership-kick 误操作可能导致资产损失。

CLI 解析陷阱：忘记在含横杠的 ID 前加 -- 会导致命令参数解析错误，建议在复杂操作前先查询验证。

智能合约风险：尽管本 Skill 为纯文档，但实际执行的链上交易依赖 Structs 游戏合约安全，需关注官方审计报告。

权限委托风险：使用 permission-guild-rank-set 批量授权时，建议遵循最小权限原则，定期审计 guild-rank-permission-by-object-and-guild 查询结果。