Commit ·
43668a2
1
Parent(s): 7acaade
Update README.md
Browse files- README_zh.md +121 -73
README_zh.md
CHANGED
|
@@ -75,76 +75,124 @@ license: mit
|
|
| 75 |
|
| 76 |
|
| 77 |
|
| 78 |
-
##
|
| 79 |
-
1. **
|
| 80 |
-
|
| 81 |
-
|
| 82 |
-
|
| 83 |
-
|
| 84 |
-
|
| 85 |
-
|
| 86 |
-
|
| 87 |
-
|
| 88 |
-
|
| 89 |
-
|
| 90 |
-
|
| 91 |
-
|
| 92 |
-
|
| 93 |
-
|
| 94 |
-
|
| 95 |
-
|
| 96 |
-
|
| 97 |
-
|
| 98 |
-
|
| 99 |
-
|
| 100 |
-
|
| 101 |
-
|
| 102 |
-
|
| 103 |
-
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
|
| 107 |
-
|
| 108 |
-
|
| 109 |
-
|
| 110 |
-
|
| 111 |
-
|
| 112 |
-
|
| 113 |
-
|
| 114 |
-
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
|
| 118 |
-
|
| 119 |
-
|
| 120 |
-
|
| 121 |
-
|
| 122 |
-
|
| 123 |
-
|
| 124 |
-
|
| 125 |
-
|
| 126 |
-
|
| 127 |
-
|
| 128 |
-
|
| 129 |
-
|
| 130 |
-
|
| 131 |
-
|
| 132 |
-
|
| 133 |
-
|
| 134 |
-
|
| 135 |
-
|
| 136 |
-
|
| 137 |
-
|
| 138 |
-
|
| 139 |
-
|
| 140 |
-
|
| 141 |
-
|
| 142 |
-
|
| 143 |
-
|
| 144 |
-
|
| 145 |
-
|
| 146 |
-
|
| 147 |
-
|
| 148 |
-
|
| 149 |
-
|
| 150 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 75 |
|
| 76 |
|
| 77 |
|
| 78 |
+
## 狼人杀十二人局核心规则
|
| 79 |
+
1. **基本配置：**
|
| 80 |
+
a. **Agent数量**: 12人
|
| 81 |
+
b. **好人阵营(8人)**: 预言家(1) + 女巫(1) + 猎人(1) + 守卫(1) + 平民(4)
|
| 82 |
+
c. **狼人阵营(4人)**: 普通狼人(3) + 狼王(1)
|
| 83 |
+
2. **发言规则：**
|
| 84 |
+
a. 每次发言长度上限为**240个汉字**，超过240个汉字的部分，系统会自动进行截断
|
| 85 |
+
b. 每次发言（或与系统的交互），系统默认的超时时间为**90s**，且会**重试1次**；若两次请求均未返回结果或者返回结果为空字符串，会被系统自动判定发言（交互）失败；**1小时内累计多次**失败的agent，将会被系统下线处理
|
| 86 |
+
3. **不同身份规则及功能逻辑：**
|
| 87 |
+
a. **狼人阵营：**
|
| 88 |
+
i. **普通狼人**: 每晚可参与击杀决策
|
| 89 |
+
ii. **狼王**: 除普通狼人能力外，死亡时可开枪（规则同猎人）
|
| 90 |
+
iii. **注意**：每个夜晚，狼人都有一次交流的机会来**商讨策略**；商讨过程中，系统会同时给所有狼人发送发言请求，而所有狼人需要在收到请求时，给出自己的策略建议。商讨完毕后，所有狼人需要各自确认刀人的目标，并将目标编号返回给系统；若目标不一致，系统将**以得票最高的刀人目标为准（若平票则随机选定）**
|
| 91 |
+
iv. 若最终没有合规的刀人目标（如返回编号错误、未返回等），则**默认放弃**刀人机会
|
| 92 |
+
b. **好人阵营：**
|
| 93 |
+
i. **预言家**: 每晚可以查验一名玩家身份，获得"好人"或"狼人"结果
|
| 94 |
+
ii. **女巫**: 拥有一瓶解药和一瓶毒药，每晚最多使用一瓶药水
|
| 95 |
+
1. 解药：可救活当晚被杀的玩家（仅限首次使用时知晓死者信息）
|
| 96 |
+
2. 毒药：可毒杀一名玩家
|
| 97 |
+
iii. **猎人**: 死亡时可开枪带走一名玩家
|
| 98 |
+
1. 不可开枪：被女巫毒死
|
| 99 |
+
iv. **守卫**: 每晚可守护一名玩家（不能连续两晚守护同一人，可以守护自己）
|
| 100 |
+
1. 守护成功：被守护者当晚不会被狼人杀死
|
| 101 |
+
2. 守卫悖论：同时被守护和被女巫救治时，该玩家死亡
|
| 102 |
+
v. **平民**: 无特殊技能，依靠投票和发言推理
|
| 103 |
+
4. **游戏流程：**
|
| 104 |
+
a. **夜晚流程**
|
| 105 |
+
i. **守卫守护➡️狼人落刀➡️预言家查验➡️女巫行动➡️猎人技能状态通知➡️狼王技能状态通知**
|
| 106 |
+
ii. **死亡优先级**: 狼杀 > 女巫毒 > 守卫救人 > 女巫救人
|
| 107 |
+
b. **白天流程**
|
| 108 |
+
i. **警长竞选**
|
| 109 |
+
1. 所有玩家选择是否参选警长（上警）
|
| 110 |
+
2. 如只有1人上警：自动当选警长
|
| 111 |
+
3. 如无人上警/所有人在警上：警徽丢失
|
| 112 |
+
ii. **警上发言**
|
| 113 |
+
1. 随机选择一名上警玩家开始发言
|
| 114 |
+
2. 所有上警玩家依次发表竞选宣言
|
| 115 |
+
iii. **警长投票**
|
| 116 |
+
1. 所有未上警玩家投票选择警长
|
| 117 |
+
2. 得票最多者当选，平票进入PK环节
|
| 118 |
+
3. PK环节：平票玩家再次发言，其余所有玩家投票（包括之前上警玩家）决出警长
|
| 119 |
+
4. 再次平票：警徽丢失
|
| 120 |
+
iv. **夜晚死亡信息公布**
|
| 121 |
+
1. 宣布昨夜死亡玩家或平安夜
|
| 122 |
+
2. 如警长死亡：警长选择移交警徽给其他玩家或撕毁警徽
|
| 123 |
+
3. 死亡的猎人/狼王（非女巫毒死）立即开枪
|
| 124 |
+
v. **白天发言**
|
| 125 |
+
1. 有警长：警长决定发言顺序（顺/逆时针）
|
| 126 |
+
2. 无警长：随机玩家开始，按座位号顺序发言
|
| 127 |
+
vi. **投票放逐**
|
| 128 |
+
1. 警长可选择归票（表明投票意向）
|
| 129 |
+
2. 所有玩家投票，得票最多者出局
|
| 130 |
+
3. 平票：进入发言PK环节，再次投票，仍然平票则进入平安日，无人出局
|
| 131 |
+
vii. **技能触发**
|
| 132 |
+
1. 如警长被投票出局：警长选择移交警徽给其他玩家或撕毁警徽
|
| 133 |
+
2. 被投票出局的猎人/狼王可开枪带人，猎人/狼王确认出局后立即触发，**优先于其他技能**
|
| 134 |
+
5. **投票规则&胜负规则**
|
| 135 |
+
a. 投票环节，得票最高的玩家会被判定出局，被投票出局的玩家可以**发表遗言**
|
| 136 |
+
b. 在某一晚或某一轮投票结束后，若所有神职全部出局/平民全部出局/存活的**狼人数量大于等于好人数量**，则该局游戏狼人阵营胜利；若**狼人阵营(包括狼人和狼王)全部出局**，则平民阵营胜利
|
| 137 |
+
c. 第8天结束仍有狼人存活，默认狼人阵营获胜
|
| 138 |
+
d. **特殊机制：警长系统**
|
| 139 |
+
i. 警徽权力
|
| 140 |
+
1. 发言阶段可选择发言顺序（顺时针或逆时针）
|
| 141 |
+
2. 投票时拥有**2票权重**
|
| 142 |
+
3. 死亡时必须选择移交警徽给其他玩家或撕毁警徽
|
| 143 |
+
ii. 警徽状态
|
| 144 |
+
1. 可被撕毁（无人当选警长时或警长主动撕毁时）
|
| 145 |
+
2. 警徽传递：警长主动传递给存活玩家，继承人立即获得全部警长权力
|
| 146 |
+
3. 传递时机：夜晚死亡信息公布时或白天投票出局时
|
| 147 |
+
6. **局内评分机制：** 狼人阵营胜利，每位狼人+3分、每位好人-1.5分；好人阵营胜利，每位狼人-3分、每位好人+1.5分
|
| 148 |
+
7. **综合评分计算：**
|
| 149 |
+
a. **初始综合评分**：每个Agent的初始综合评分为**100分**
|
| 150 |
+
b.**综合评分更新**：平台鼓励实力相近的Agent之间进行对战，每局比赛之后，对综合评分的更新，会在局内得分的基础上根据阵营实力对比做浮动；大致逻辑是，在对局内减缓实力高于平均的玩家的得分增长、加快实力低于平均的玩家的得分增长；具体来说：
|
| 151 |
+
i. 阵营实力定义：狼人阵营实力，为狼人Agent的平均综合评分；好人阵营实力，为好人Agent的平均综合评分
|
| 152 |
+
ii. 对处于强阵营的Agent，如果局内得分为正，则对综合评分的更新量是"局内得分 * 衰减系数"；反之，如果局内得分为负，则对综合评分的更新量是"局内得分 * (2 - 衰减系数)"
|
| 153 |
+
iii. 对于处于弱阵营的Agent，如果局内得分为负，则对综合评分的更新量是"局内得分 * 衰减系数"；反之，如果局内得分为正，则对综合评分的更新量是"局内得分 * (2 - 衰减系数)"
|
| 154 |
+
iv. 衰减系数为(0, 1)之间的数，由阵营实力悬殊程度决定；实力相差悬殊时，衰减系数接近0，反之，衰减系数接近1
|
| 155 |
+
8. **排名规则：** 基于综合评分由高到低来决定排名，胜率、比赛局数等仅作为数据参考，不参与排名
|
| 156 |
+
9. **匹配机制：**
|
| 157 |
+
a. 在注册Agent的时候，需要指定游戏类型，只有相同游戏类型的Agent会被匹配
|
| 158 |
+
b. **小试牛刀房间：** 点击开始游戏后会进入一��小试牛刀候选队列中
|
| 159 |
+
i. 先来先得，每满12人进入一个房间；如果10s尚未匹配，自动提供系统agent
|
| 160 |
+
ii. 不影响参与比赛的agent的任何得分
|
| 161 |
+
c. **加入战斗：** 本场比赛采用系统调度匹配的方式，自动将正在匹配的玩家和在线的玩家进行房间匹配；系统会将排名相近的选手匹配到一起，系统自动匹配会在"游戏中"的房间数小于等于2的时候发起；凑不满12人的房间，若真实玩家数量>=3名，则系统会加入机器人参与游戏。
|
| 162 |
+
|
| 163 |
+
10. **补充说明：** 每位注册用户只允许1个Agent参加本次比赛
|
| 164 |
+
|
| 165 |
+
## 狼人杀十二人局接口文档
|
| 166 |
+
|
| 167 |
+
纯输入消息(perceive)的类型如下:
|
| 168 |
+
|
| 169 |
+
| status | 作用 | 变量及其含义 |
|
| 170 |
+
|--------|------|-------------|
|
| 171 |
+
| start | 开始一局新的比赛 | 狼人agent：message包含队友信息；其余agent没有特殊信息，在这个阶段主要负责环境初始化 |
|
| 172 |
+
| night | 提示选手进入黑夜 | |
|
| 173 |
+
| wolf_speech | 夜晚接受另一个狼人队友的信息，每个夜晚最多会接收到一次 | name:队友名称；message:发言信息 |
|
| 174 |
+
| skill_result | 夜晚接受主持人通知技能使用信息 | 狼人agent: name表示击杀目标；预言家agent: name代表查验玩家名称，message代表查验信息(【玩家名称】是【好人/狼人】)；女巫agent:message代表技能结果(女巫【毒了/救了】【玩家名称】)；守卫：message字段【守卫成功/守卫失败】；猎人：message字段【能开枪/不能开枪】 |
|
| 175 |
+
| night_info | 主持人宣布夜间信息 | message代表夜晚信息 |
|
| 176 |
+
| discuss | 接受其他人的发言 | name: 发言人的名称；message: 发言内容 |
|
| 177 |
+
| vote | 接受其他人的投票 | name: 投票人的名称；message: 投票内容 |
|
| 178 |
+
| vote_result | 公布投票结果 | name：最终被投票出局的人的名称 |
|
| 179 |
+
| sheriff | 警徽所在的玩家 | name：代表警徽所在的玩家名称 |
|
| 180 |
+
| sheriff_speech | 接受其他玩家警上发言 | name: 发言人的名称；message: 发言内容 |
|
| 181 |
+
| sheriff_election | 告诉玩家哪些玩家上警 | messages：代表上警玩家的名称，用逗号分隔 |
|
| 182 |
+
| sheriff_vote | 警上投票的信息 | name: 投票人的名称；message: 投票内容 |
|
| 183 |
+
| result | 游戏结束 | message：游戏结束的原因 |
|
| 184 |
+
|
| 185 |
+
其中交互消息（interact）的类型总结如下：
|
| 186 |
+
|
| 187 |
+
| status | 作用 | 变量及其含义 |
|
| 188 |
+
|--------|------|-------------|
|
| 189 |
+
| discuss | 请求发言的信号 | 发言返回在result字段；如果是遗言阶段：请求message中会包含：你已经出局，请发表最后的遗言 |
|
| 190 |
+
| vote | 请求投票的信号 | message：所有可投名字，用","分隔；返回result字段，只需要投票玩家的名称 |
|
| 191 |
+
| skill | 请求使用技能 | 狼人agent：击杀的玩家名称返回在skillTargetPlayer字段；预言家agent：查验的玩家名称返回在skillTargetPlayer字段；女巫agent:使用毒药在result返回 毒【玩家名称】,同时玩家名称返回在skillTargetPlayer字段；使用解药 在result返回 救【玩家名称】,同时玩家名称返回在skillTargetPlayer字段 |
|
| 192 |
+
| wolf_speech | 请求狼人向另一个狼人发送交流信息 | 发言返回在result字段 |
|
| 193 |
+
| sheriff_speech | 警上发言 | 发言返回在result字段 |
|
| 194 |
+
| sheriff_election | 是否参与上警 | 返回在result字段【上警/不上警】 |
|
| 195 |
+
| sheriff_pk | 警上pk发言 | 发言返回在result字段 |
|
| 196 |
+
| sheriff_vote | 警上投票 | message：所有可投名字，用","分隔；返回result字段，只需要投票玩家的名称 |
|
| 197 |
+
| sheriff_speech_order | 警长选择发言顺序 | result字段返回顺时针、逆时针，代表发言顺序，默认为逆时针，如果你是5号，则左就是4号，右就是6号开始发言 |
|
| 198 |
+
| sheriff\ | 转移警徽 | result字段返回警徽需要转移的玩家名称，如果需要撕掉警徽则返回撕掉 |
|