六人法令
一个治理与经济框架:六人议会、法令、声望与玩家驱动的法律。
六人法令
一个为议会制角色扮演服务器设计的 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”界面。
安装(服务器管理员)
构建或下载模组 JAR(通常位于
build/libs/)。将 JAR 放入服务器的
mods/文件夹。启动服务器一次以生成默认配置文件。
编辑以下配置文件:
config/decrees_of_the_six/council.json config/decrees_of_the_six/voting_rules.json config/decrees_of_the_six/economy_config.json编辑配置后,在游戏内(以管理员身份)使用
/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 的票必须为赞成。
tiesPasstrue→ 赞成 = 反对 计为 已颁布。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" 下定义。
- 一名玩家最多持有一个席位。
- 指派新席位会清除之前的任何席位。
席位用于:
- 确定谁可以创建/开启/删除法令。
- 确定谁可以投票(每个席位 = 一票)。
- 在
/decrees decree list active中显示“你的投票”。 - 驱动加入提醒和“仅剩一票”提示。
管理席位(仅管理员)
所有席位管理命令均为仅管理员:
/decrees seat list显示所有席位、其显示名称以及当前持有者(玩家名称或<empty>)。/decrees seat set <seat_id> <player>将玩家指派到席位。 如果该玩家已持有不同席位,旧席位会自动清除。/decrees seat clear <seat_id>移除席位的持有者(席位变为空)。
法令生命周期(议会工作流)
议会会议的典型流程:
创建法令(草稿) 一名议会成员运行:
/decrees decree create <title>这会创建一个处于草稿状态的新法令,并关联到其席位。
编辑详情(可选但推荐)
/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>开启投票(投票中)
/decrees decree open <id>- 如果已配置,启动投票计时器(
votingDurationMinutes)。 - 通知议会成员,包括聊天中可点击的
[是] [否] [弃权]按钮。
- 如果已配置,启动投票计时器(
议会投票 每个议会席位持有者使用:
/decrees vote <id> yes /decrees vote <id> no /decrees vote <id> abstain或点击投票按钮以预填投票命令。
自动解决
当:
- 达到法定人数 且
- 所有活跃席位都已投票 或 投票时间已过期,
系统会根据
voting_rules.json中的规则自动将法令设置为已颁布、已否决,或(如果强制)已取消,然后记录变更并通知议会。查看结果 / 历史
/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 获取完整详情。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。