六人法令

一个治理与经济框架:六人议会、法令、声望与玩家驱动的法律。

经济

六人法令

一个为议会制角色扮演服务器设计的 Fabric 服务端治理、投票、轻量经济与公会系统。 六人执政团(或你定义的任何议会)可以在游戏内创建、辩论并对法令进行投票,系统会自动处理法定人数/多数票、季节性历史日志、可选的多级货币(默认为金/银/铜)以及拥有共享金库的玩家公会。

当前版本: 0.2.1(Minecraft 1.21.1,Fabric)


功能特性

  • 通过 JSON(council.json)定义议会席位。
  • 具名议会,通过可配置的 councilName 用于法令相关消息。
  • 议会仪式命令,可召开或重新召开议会,并伴随全服广播、可配置的钟声与烟花。
  • 通过 council.json 中的 ceremonySound 配置议会仪式音效(例如 decrees_of_the_six:council_chime)。
  • 法令生命周期:草稿 → 投票中 → 已颁布/已否决/已取消。
  • 可配置的投票规则(法定人数、时长、多数票模式、平票处理)。
  • 全局开关:启用/禁用整个法令系统,或将其限制为仅管理员可用。
  • 用于指派议会成员的席位工具。
  • 对有未投票项的法令的议会成员提供加入提醒。
  • 当某个法令仅剩一个席位未投票时发出仅剩一票提示。
  • 通过 /decrees decree list [page] 和 /decrees history [page] 实现分页法令列表与游戏内历史。
  • 通过 /decrees decree list status <draft|voting|enacted|rejected|cancelled> [page] 实现按状态筛选的法令列表。
  • 通过 /decrees decree list my [page] 和 /decrees decree list active [page] 实现**“我的法令”与活跃列表(分页)**。
  • 通过 /decrees stats ... 和 /decrees status [id] 实现席位统计与状态辅助。
  • 针对法令 ID、席位 ID 和分类的清晰聊天格式与制表符补全。
  • 当法令开启投票时,为议会成员提供可点击的投票提示(按钮 [是] [否] [弃权])。
  • 用于季节历史的最终法令文本日志。
  • 可选公会系统:
    • 玩家创建的公会,拥有等级(会长 / 官员 / 老兵 / 成员 / 新兵),
    • 每个公会可自定义等级头衔,
    • 每个公会在同一经济系统中拥有自己的金库账户,
    • Vox Imperion 工具用于检查和治理公会。
  • 可选的六人执政团面板 UI(G 键)(若客户端也加载了该模组):
    • 账本标签页,显示玩家余额与交易记录,
    • 公会标签页,显示公会名称、等级、成员数量、公会金库余额,以及快捷操作(存款 / 离开 / 接受邀请)。
  • 所有交互均在游戏内通过 /decrees、/money、/economy、/guild 和 /vox guild 命令完成。

经济 / 货币系统

  • 可选的单一货币,包含三种面额(默认:金、银、铜鳞)。
  • 通过 economy_config.json 配置名称与兑换比率。
  • 基于 JSON 的持久化账户与交易存储(每玩家账户 + 全局金库账户 + 公会金库)。
  • 玩家命令(/money)用于查询余额、向其他玩家付款以及查看自己的交易日志。
  • 管理员命令(/moneyadmin)用于发放 / 没收货币以及管理金库。
  • 经济元命令(/economy)用于帮助以及热重载经济配置。
  • 金额始终以 G/S/C 形式显示(例如 2G 4S 30C Scales)。
  • G 键“Hexarchate Panel”UI(客户端可选):
    • 账本标签页:
      • 玩家名称与 G/S/C 余额,
      • 以 G/S/C 格式显示的近期交易。
    • 公会标签页:
      • 公会名称以及你的公会等级/头衔,
      • 会长与各等级成员数量,
      • 以 G/S/C 显示的公会金库余额,
      • 待处理邀请数量,
      • 存款、离开或接受邀请的快捷按钮(作为 /guild 命令的前端)。

公会与 Vox Imperion

公会系统完全在服务端运行,并使用同一经济后端。公会持久化存储在由模组管理的世界数据文件中(不应手动编辑)。

公会基础

  • 一名玩家同一时间最多只能加入一个公会。
  • 每个公会拥有:
    • 唯一的内部 ID 和一个名称,
    • 一名会长(玩家 UUID),
    • 拥有以下 5 个等级之一的成员:
      • 会长、官员、老兵、成员、新兵,
    • 经济系统中的一个金库账户,
    • 可选设置:MOTD/描述、开放加入标志以及最大成员数。
  • 每个公会可以自定义各等级的显示头衔:
    • 例如 会长 = "High Chancellor"、官员 = "First Blade" 等。

公会等级与头衔

内部权限角色:

  • 会长 – 完全控制权。
  • 官员 – 较强的管理权限。
  • 老兵 – 少量管理权限。
  • 成员 – 普通访问权限,无管理权。
  • 新兵 – 试用期 / 新成员。

每个角色都可以拥有一个公会专属头衔,由公会会长设置,用于风味/角色扮演。内部权限基于角色;头衔仅用于显示。


需求

  • Minecraft:1.21.1(如果你为不同版本构建,请相应调整)。
  • Fabric Loader(与你的服务器版本匹配)。
  • Fabric API。

这主要是一个服务端模组。客户端不需要安装它即可使用 /decrees、/money 或 /guild 命令。 在客户端安装该模组是可选的,但会启用 G 键“Hexarchate Panel”界面。


安装(服务器管理员)

  1. 构建或下载模组 JAR(通常位于 build/libs/)。

  2. 将 JAR 放入服务器的 mods/ 文件夹。

  3. 启动服务器一次以生成默认配置文件。

  4. 编辑以下配置文件:

    config/decrees_of_the_six/council.json
    config/decrees_of_the_six/voting_rules.json
    config/decrees_of_the_six/economy_config.json
    
  5. 编辑配置后,在游戏内(以管理员身份)使用 /decrees reload 和 /economy reload,或重启服务器。

公会与经济数据存储(账户、交易、公会)由模组自动管理,并在服务器关闭时保存。不应手动编辑。


配置

1. council.json

定义全局标志、议会名称、仪式音效以及议会席位。

示例:

{
  "councilName": "Hexarchate of Salmon",
  "decreesEnabled": true,
  "opsOnly": false,
  "ceremonySound": "decrees_of_the_six:council_chime",
  "seats": [
    {
      "id": "overseer_regent",
      "displayName": "Overseer-Regent"
    }
  ]
}

字段:

  • councilName(字符串,可选)

    • 你的议会的友好显示名称(例如 "Hexarchate of Salmon")。
    • 用于法令相关消息和风味文本。
    • 可手动设置,或通过 /decrees council create <name> 设置。
  • decreesEnabled(布尔值)

    • true → 所有法令功能正常工作。
    • false → 法令创建、开启、投票等被禁用(玩家会收到消息)。
  • opsOnly(布尔值)

    • false → 仅议会席位可以创建/开启/投票(普通模式)。
    • true → 仅管理员可以创建/开启/删除/投票法令(安全模式 / 紧急覆盖)。
  • ceremonySound(字符串,可选)

    • 用于议会仪式广播的音效事件资源位置。
    • 示例:"decrees_of_the_six:council_chime",对应你在 sounds.json 中定义的声音。
    • 如果缺失或无效,模组会回退到原版提示音。
  • seats(数组)– 每个席位:

    • id – 内部 ID(例如 "overseer_regent")。用于存档与日志。
    • displayName – 聊天中显示的漂亮名称(例如 "Overseer-Regent")。
    • holderUuid(可选)– 当前持有该席位的玩家 UUID。

通常应在游戏内使用 /decrees seat set 指派席位持有者,而不是手动编辑 holderUuid。

/decrees council create <name> 将:

  • 将 councilName 设置为 <name>,
  • 强制 decreesEnabled = true,
  • 强制 opsOnly = false。

2. voting_rules.json

控制投票的评估方式。

示例:

{
  "minQuorumPercent": 60,
  "votingDurationMinutes": 30,
  "majorityMode": "SIMPLE",
  "tiesPass": false
}

字段:

  • minQuorumPercent 法令有效所需的最低活跃席位投票百分比。 示例:60,有 5 个活跃席位 → 至少需要 3 票。

  • votingDurationMinutes 法令开启后投票保持开放的时间。 0 或更小 → 无时间限制(当所有人投票或通过强制方式解决时结束)。

  • majorityMode

    • "SIMPLE" → 赞成票多于反对票,且至少为票数的一半 + 1。
    • "TWO_THIRDS" → 至少 2/3 的票必须为赞成。
  • tiesPass

    • true → 赞成 = 反对 计为 已颁布。
    • false → 赞成 = 反对 计为 已否决。

3. 法令历史日志

已最终确定的法令(状态变为 已颁布、已否决 或 已取消)会追加到历史日志中,例如:

config/decrees_of_the_six/decrees_history.log

日志通常包含:

  • 时间戳
  • 法令 ID 与标题
  • 最终状态
  • 强制操作者(如果通过 /decrees decree force 完成)
  • 投票的简要摘要

这用于季节记录 / 背景故事。


4. economy_config.json

控制货币行为以及金额显示方式。

示例:

{
  "enabled": true,
  "currencyName": "Scales",
  "goldName": "Gold",
  "silverName": "Silver",
  "copperName": "Copper",
  "copperPerSilver": 10,
  "copperPerGold": 100
}

字段(高层):

  • enabled(布尔值)

    • 如果为 false,货币系统实际上被禁用(命令将拒绝运行)。
  • currencyName(字符串)

    • 基础显示名称,例如 "Scales"、"Crowns"、"Marks"。
  • goldName、silverName、copperName(字符串)

    • 各面额的显示名称。
    • 用于聊天和 UI。
  • copperPerSilver、copperPerGold(整数)

    • 到最小单位(铜)的兑换率。
    • 上述示例 → 1 银 = 10 铜,1 金 = 100 铜。

经济数据(账户 + 交易 + 公会金库)存储在与其他 Decrees 配置相邻的单独 JSON 文件(例如 economy_store.json)中。不应手动编辑。


议会席位如何运作

席位在 council.json 的 "seats" 下定义。

  • 一名玩家最多持有一个席位。
  • 指派新席位会清除之前的任何席位。

席位用于:

  1. 确定谁可以创建/开启/删除法令。
  2. 确定谁可以投票(每个席位 = 一票)。
  3. 在 /decrees decree list active 中显示“你的投票”。
  4. 驱动加入提醒和“仅剩一票”提示。

管理席位(仅管理员)

所有席位管理命令均为仅管理员:

  • /decrees seat list 显示所有席位、其显示名称以及当前持有者(玩家名称或 <empty>)。

  • /decrees seat set <seat_id> <player> 将玩家指派到席位。 如果该玩家已持有不同席位,旧席位会自动清除。

  • /decrees seat clear <seat_id> 移除席位的持有者(席位变为空)。


法令生命周期(议会工作流)

议会会议的典型流程:

  1. 创建法令(草稿) 一名议会成员运行:

    /decrees decree create <title>
    

    这会创建一个处于草稿状态的新法令,并关联到其席位。

  2. 编辑详情(可选但推荐)

    /decrees decree edit title <id> <new_title>
    /decrees decree edit description <id> <text>
    /decrees decree edit category <id> <category>
    /decrees decree edit expiry <id> none
    /decrees decree edit expiry <id> <days>
    
  3. 开启投票(投票中)

    /decrees decree open <id>
    
    • 如果已配置,启动投票计时器(votingDurationMinutes)。
    • 通知议会成员,包括聊天中可点击的 [是] [否] [弃权] 按钮。
  4. 议会投票 每个议会席位持有者使用:

    /decrees vote <id> yes
    /decrees vote <id> no
    /decrees vote <id> abstain
    

    或点击投票按钮以预填投票命令。

  5. 自动解决

    当:

    • 达到法定人数 且
    • 所有活跃席位都已投票 或 投票时间已过期,

    系统会根据 voting_rules.json 中的规则自动将法令设置为已颁布、已否决,或(如果强制)已取消,然后记录变更并通知议会。

  6. 查看结果 / 历史

    • /decrees decree results <id> – 详细计数、法定人数信息、计时器状态。
    • decrees_history.log 中的历史日志作为永久记录。
    • /decrees history [page] 用于游戏内分页历史视图。

议会仪式与提醒

议会仪式

  • /decrees council create <name>(仅管理员)

此命令:

  • 将议会名称(councilName)设置为 <name>。
  • 启用法令系统(decreesEnabled = true)。
  • 切换回议会模式(opsOnly = false)。
  • 广播一条全局消息,宣布议会已召开或重新召开。
  • 向所有在线玩家播放配置的仪式音效(council.json 中的 ceremonySound)。
  • 在执行者位置发射多个烟花。

每个季节在议会成立时使用一次,或在变更后想以仪式方式“重新召开”时再次使用。

加入提醒与仅剩一票提示

  • 当议会成员加入时,如果他们有未投票项,会收到提醒:

    • 显示有多少处于投票中的法令仍缺少他们的投票。
    • 最多列出 5 个法令 ID(例如 #3, #7, #12...)。
  • 当某个法令仅剩一个活跃席位未投票时,服务器会广播一条消息,指明哪个席位仍未投票。


命令概览

1. 根命令

  • /decrees help 显示简短命令概览。

  • /decrees reload(仅管理员) 从磁盘重新加载 council.json 和 voting_rules.json。

  • /decrees status 显示所有当前处于投票中的法令的投票状态。

  • /decrees status <id> 显示特定法令的详细投票状态。

  • /decrees history [page] 已完成法令的分页历史。

  • /decrees config decreesEnabled on|off(仅管理员) 全局启用或禁用法令系统。

  • /decrees config opsOnly on|off(仅管理员) 切换仅管理员模式。

  • /decrees config show(仅管理员) 显示当前系统状态,包括议会名称和你的席位(如果有)。

  • /decrees stats seats 显示每个席位的创建法令与投票统计。

  • /decrees stats me 显示你自己席位的统计。

  • /decrees stats seat <seat_id> 显示特定席位的统计。


2. 议会仪式

  • /decrees council create <name>(仅管理员) 召开或重新召开议会,设置议会名称,启用法令,并触发仪式广播 + 可配置音效 + 烟花。

3. 席位(仅管理员)

  • /decrees seat list
  • /decrees seat set <seat_id> <player>
  • /decrees seat clear <seat_id>

4. 法令管理

  • /decrees decree list [page] 列出所有法令(分页)。

  • /decrees decree list my [page] 列出由你的席位创建的法令(仅议会成员),分页。

  • /decrees decree list active [page] 列出所有当前处于投票中的法令,如果你持有席位则包括你自己的投票,分页。

  • /decrees decree list status <draft|voting|enacted|rejected|cancelled> [page] 按状态筛选列出法令,分页。

  • /decrees decree list category <category> 列出给定分类中的法令。

  • /decrees decree info <id> 显示完整信息(标题、描述、分类、过期时间、创建者、投票)。

  • /decrees decree results <id> 显示详细投票结果、法定人数状态、多数票模式以及计时器状态。

  • /decrees decree create <title> 创建一个处于草稿状态的新法令(仅议会,或如果 opsOnly 为 true 则为管理员)。

  • /decrees decree open <id> 开启一个草稿法令进行投票。

  • /decrees decree edit title <id> <new_title>

  • /decrees decree edit description <id> <new_description>

  • /decrees decree edit category <id> <new_category>

  • /decrees decree edit expiry <id> none

  • /decrees decree edit expiry <id> <days>

  • /decrees decree delete <id> 删除法令(仅议会 / 取决于配置的管理员)。

  • /decrees decree force <id> enacted|rejected|cancelled(仅管理员) 强制设置法令的最终状态(当规则异常或卡住时的应急出口)。


5. 投票

  • /decrees vote <id> yes|no|abstain 对当前处于投票中的法令投出你席位的票。 (也可以通过可点击的 [是] [否] [弃权] 提示填入。)

6. 经济与货币

面向玩家的命令:

  • /money 以 G/S/C 形式显示你自己的余额。

  • /money balance <player> 显示另一名玩家的余额。

  • /money pay <player> <amount> 向另一名玩家付款。

    • <amount> 支持:
      • 原始铜整数(例如 150)
      • 带面额的字符串,如 1G 5S 20C、2g、10s、50c(不区分大小写)。
  • /money log 显示你的近期交易。

管理员 / 金库命令:

  • /moneyadmin grant <player> <amount> 直接向玩家铸造货币。

  • /moneyadmin seize <player> <amount> 从玩家处移除货币。

  • /moneyadmin treasury deposit <amount> 将货币从执行者转移到全局金库。

  • /moneyadmin treasury withdraw <amount> 将货币从全局金库转移到执行者。

  • /moneyadmin log 显示整个系统的近期交易(用于审计)。

经济元命令:

  • /economy help 所有货币与金库命令的概览,以及面额的简短说明。

  • /economy reload(仅管理员) 从磁盘重新加载 economy_config.json。


7. 公会与 Vox Imperion

玩家公会命令:

  • /guild create <name> 创建一个新公会(每名玩家一个公会)。 你成为会长,并创建一个公会金库账户。

  • /guild invite <player>

  • /guild accept

  • /guild deny 邀请其他玩家加入你的公会,并让他们接受或拒绝。

  • /guild leave 离开你当前的公会。

    • 会长必须转让会长身份或解散公会,而不能直接离开。
  • /guild kick <player> 将玩家从公会中移除。

    • 会长和官员可以根据等级规则踢出较低等级的成员。
  • /guild promote <player>

  • /guild demote <player> 在 会长 / 官员 / 老兵 / 成员 / 新兵 范围内更改成员等级。 (会长可以调整所有非会长等级;官员可以调整老兵/成员/新兵。)

  • /guild setmotd <text> 为信息界面设置公会描述 / MOTD。

  • /guild setopen <true|false> 将公会标记为开放或关闭,用于未来的开放加入功能(现在存储,后续使用)。

  • /guild setmax <number> 可选的成员上限(现在存储,后续使用)。

  • /guild settitle <leader|officer|veteran|member|recruit> <title> 为等级设置公会专属显示头衔(例如 "High Chancellor"、"First Blade")。

  • /guild balance 以 G/S/C 显示公会金库余额。

  • /guild deposit <G> <S> <C> 将你个人账户中的货币存入公会金库。

  • /guild withdraw <G> <S> <C> 仅会长:从公会金库中提取货币到你的个人账户。

管理员 / Vox Imperion 命令:

  • /vox guild info <name> 检查任何公会:

    • 会长,
    • 各等级成员数量,
    • 金库余额,
    • 创建日期(如果已跟踪)。
  • /vox guild setleader <guild> <player> 强制将会长身份转让给另一名玩家。

  • /vox guild disband <guild> 强制解散公会。 剩余公会资金将转入议会金库(代码中可配置模式)。

  • /vox guild rename <guild> <newName> 针对捣乱 / 违规行为的紧急重命名。

Vox 命令通过议会权限系统绑定到 Vox Imperion 议会席位(并有管理员回退)。


权限摘要

管理员:

  • 始终允许使用:
    • /decrees reload
    • /decrees council create <name>
    • /decrees seat ...
    • /decrees decree force ...
    • /decrees config ...
    • /economy reload
    • 所有 /moneyadmin ... 命令
    • 所有 /vox guild ... 命令
  • 当 opsOnly = true 时,管理员即使没有席位也可以创建/开启/删除/投票法令。

议会成员(持有席位的玩家):

  • 可以创建、编辑、开启、删除他们的法令 (假设 decreesEnabled = true 且 opsOnly = false)。
  • 可以对任何处于投票中的法令投票。

公会成员:

  • 可以根据其等级使用 /guild 命令:
    • 所有人:/guild balance、/guild deposit、/guild leave、基本信息。
    • 老兵/官员:额外的邀请权限。
    • 会长:完全管理 + /guild withdraw。

普通玩家:

  • 通常可以查看法令列表和信息(如果你保持这些命令开放)。
  • 如果经济已启用,可以使用 /money、/money balance、/money pay、/money log。
  • 可以通过 /guild 命令创建和加入公会(受你的服务器规则约束)。
  • 不能创建、开启、删除或投票法令,除非:
    • 他们被授予席位,或
    • 你切换到 opsOnly 并让他们成为管理员(不推荐)。

如果 decreesEnabled 为 false,即使对管理员,变更性法令命令也会被阻止 (除了 /decrees reload 和 /decrees decree force)。 如果 economy_config.enabled 为 false,所有货币和公会金库命令将拒绝运行。


版本管理与更新日志

本模组使用语义化版本。 请参阅 CHANGELOG.md 获取每个版本的详细变更列表。


许可证

Decrees of the Six 在 MIT 许可证 下授权。 请参阅 LICENSE 获取完整详情。