UncivCN 文档

简体中文

English

简体中文

English

主题

UncivCN 更新日志 ​

版本号规则：上游版本 + CN 子版本号（.1、.2、.3…，同一上游版本可发多个 CN 子版本，如 4.20.8.1 → 4.20.8.4；跟进新上游后从 .1 重新开始，如 4.21.5 → 4.21.5.1）。

每个版本按受众分组：玩家可感知列玩家在游戏中能直接察觉的变化，模组作者可感知列模组与 Lua 脚本所依赖的行为。纯内部改动不列入；更早的版本尚未采用此分组。

上游更新日志

上游（原版）版本记录见 Unciv 官方更新日志（GitHub）。

未发布 ​

玩家可感知 ​

  • 修复：同步回合的结算提示现在会显示有多少项操作未能生效，并把这每一项操作及其原因放在一个可展开／折叠的区域里逐条列出
  • 修复：同步回合无法应用某条单位指令时，提示现在会写明是哪一项（「移动单位」「攻击」「交换单位」，或「警戒」这类单位动作），而不再显示内部的操作类型
  • 修复：同步回合中「目标已被占用」的提示不再依赖服务器（服务器如今只中转消息）——各客户端从指令本身自行判断占用，因此任何服务器上都会出现该提示与地图标记
  • 修复：同步回合无法应用某条指令时，提示现在还会说明被拒绝的原因（单位已不在、结算时世界已经变化，或这条操作无法读取）
  • 新增：本回合某目标已被其他玩家占用时，该地块上的移动按钮会置灰并注明占用者，指令在发布前就会被拒绝
  • 新增：同步回合中，其他玩家本回合已占用的目标会在地图上标记出来，让你在发布指令前就能看到会被拒绝的目标
  • 修复：同步回合无法应用某条指令时，提示现在会写明是哪一项操作（例如「贸易」），而不再显示内部的操作类型，且每项丢失的操作各自一条提示
  • 修复：同步回合的指令无法上传时，现在会告知玩家并可重试，而不再静默丢失
  • 修复：同步回合无法应用某条指令时，现在会通知发出该指令的玩家本人，而不只是结算该回合的玩家
  • 修复：同步回合中被护送单位的交换现在按记录的结果结算，不再重新推导，因此不会再变成另一种移动
  • 修复：同步回合无法记录你本回合的部分改动时，现在会明确提示，而不再静默绕过
  • 修复：同步回合中攻击本回合已被其他玩家占用的目标时，现在也会直接拦住并提示
  • 修复：同步回合中若目标本回合已被其他玩家占用，现在会直接拦住这条指令并提示，而不是等到结算时才静默丢弃
  • 修复：同步回合不会再被两个客户端同时结算而多推进一回合
  • 修复：同步回合现在只上传变化的数据，不再上传整个文明
  • 变更：启用同步回合后会禁用与之冲突的设置
  • 修复：同步回合中发送、撤回或拒绝交易提案不再有丢失风险
  • 修复：同步回合中锁定地块、占领地块、自动锁定不再有丢失风险
  • 修复：同步回合结算未能生效的操作会列出来，不再悄悄丢失
  • 修复：有人掉线时同步回合不再永久卡住，等待时长由房主设置
  • 变更：键盘绑定教程的链接改为 UncivCN 仓库
  • 修复：同时回合上传内容过大时不再静默丢失操作
  • 修复：同步回合结算不再重掷随机事件，单位移动不再被丢弃
  • 修复：同步回合暂不支持的操作会明确提示，不再悄悄丢失

模组作者可感知 ​

  • 变更：多图集校验警告的链接改为 UncivCN 文档

4.22.4.4（build 1266） ​

玩家可感知 ​

  • 修复：同时回合首位玩家推进回合后，其余玩家不再永久卡在等待结算
  • 修复：同时回合同步更多单位与城市操作，并禁用「回退」以避免进度不一致
  • 修复：同时回合重放不再残留重复单位
  • 修复：同时回合结算不再丢弃单位移动与攻击
  • 调整：重新开放「同时回合」选项，并标注为测试版
  • 修复：同时回合现在也会重放攻城，并捕获任何未被记录的状态变更
  • 修复：同时回合结算耗时较长时会持续续期结算锁，不再被中途接管
  • 修复：移动单位并同时改变其他状态的动作现已完整重放
  • 修复：同时回合重放时离开地块的单位不再残留原地
  • 修复：同时回合中两名玩家在同一处冲突时不再连带丢失其他改动
  • 修复：重载后继续同时回合时，不再丢失之后记录的操作
  • 修复：同时回合中途重载后会恢复你此前已执行的操作
  • 修复：同时回合中被摧毁的改良在结算后不再复活
  • 修复：同时回合中停止单位自动化后不再自动恢复
  • 修复：同时回合中探索新地块不再改动其他客户端的状态并导致其操作被丢弃
  • 修复：记录同时回合的状态变更时不再因读取前一状态而崩溃
  • 修复：同时回合不再每回合记录一份多余的兜底状态快照

4.22.4.3（build 1265） ​

玩家可感知 ​

  • 修复：安卓局内更新点击「安装」按钮崩溃
  • 修复：联机回合结算锁残留不再导致对局永久卡死
  • 修复：镜像地图不再丢失区域生成的地块资源
  • 修复：同一同时回合内两名玩家修改世界状态不再导致回合中断
  • 修复：地图便签仅在对应显示选项开启时可打开，自定义便签内容不再被翻译
  • 修复：顶栏变量总量不再显示永远达不到的数值，也不会被单位变量挤掉
  • 修复：CSV 导出不再截断回合，并正确转义换行
  • 修复：损坏的存档不再被误报为「版本不兼容」
  • 修复：「有新版本可用」标签不再因重复检查而叠加

模组作者可感知 ​

  • 修复：重载的 Lua 模组不再能卡死游戏，函数不再跨模组串用，错误也会重新上报
  • 修复：字段级模组合并现支持科技、胜利方式与城邦类型；非法条件直接报错，被移除的字段真正恢复默认
  • 修复：叠加在他人之上的模组现在保留自己的来源标记，不可变字段也能正常合并
  • 修复：Lua 现在能正确判断山脉，不再留下幽灵资源数量，也不再因极端随机范围报错
  • 修复：1.2 与 1.2.0 这类模组版本号现比较一致，非法版本号不再假性满足依赖
  • 修复：Lua 脚本不再能通过拼接超大字符串耗尽内存

4.22.4.2（build 1264） ​

  • 新增首次启动的社区服务同意弹窗，明示仅面向成年人
  • 用户协议与隐私政策补充未成年人条款
  • 隐私政策补充：访问境外站点/镜像属玩家自主行为
  • 用户协议明确：社区服务为公益设施，非游戏发行运营

4.22.4.1（build 1263） ​

  • 联机服务器迁至新地址并启用 HTTPS，需更新客户端
  • 新增用户协议并重写隐私政策，说明社区服务由志愿者维护、并非官方服务
  • 社区联机服务器支持审核制注册，聊天功能可以单独关闭
  • 联机服务器：空间紧张时把冷存档加密归档，打开时提示正在恢复
  • 游戏内更新检查与安装包下载改用社区镜像直链，速度更快
  • 合并上游 4.22.4（262 个提交）
  • 隐形单位对本国不再隐形
  • 新增「已知文明数量」计数
  • 胜利条件现在可携带 unique
  • 渲染卡顿与切换界面卡死明显改善
  • 修复多处观战与界面崩溃
  • CN 特有功能不受影响，照旧可用
  • 补齐 4.22 新增内容的中文翻译与中文模组文档
  • 多人联机：服务器存档上限提升至 32MB

4.21.10.7（build 1262） ​

  • 回退：单位经验不再是变量——恢复引擎管理，模组读取 Experience 将得到 0（详见 Variables.json）
  • 回退：传教士损耗恢复引擎判定——ReligiousStrengthLost 变量及其摧毁组合已移除（详见 Variables.json）
  • 修复：局内更新后点击按钮不再崩溃（安装引导与浏览器链接已加防护）
  • 新增：常驻更新下载进度条——关闭弹窗后仍显示，可手动关闭且不中断下载

4.21.10.6（build 1261） ​

  • 发布：同步生成的 Lua API 文档
  • 多人联机：同步回合提交兼容省略的默认字段
  • 多人联机：修复操作上传成功后错误回退的问题
  • 多人联机：WebSocket 信号丢失时自动轮询推进回合
  • 修复：更新检查现会确认国内下载服务器已同步
  • 多人联机：同步回合现会在所有玩家提交后推进
  • 多人联机：同步回合提交现使用独立的原子操作存储

4.21.10.3（build 1258） ​

  • 多人联机：新增实验性的同步回合操作协议
  • 多人联机：同步回合操作按玩家与序号去重
  • 多人联机：同步回合重放单位操作时不会重新随机战斗
  • 多人联机：同步回合支持驻防、休眠与跳过单位操作
  • 多人联机：同步回合结算现使用服务端原子锁
  • 多人联机：同步回合快照现覆盖外交弹窗、事件与特殊单位界面
  • 多人联机：自动化、Lua 与触发单位效果现按结果快照重放
  • 多人联机：同步回合现会记录城市生产、科技与政策选择
  • 多人联机：同步回合现可重放复杂单位操作的模组状态变更
  • 模组支持：单位级变量，可为每个单位附加数值计数器（详见 Variables.json）
  • 模组支持：单位经验改为变量实现，模组可读写，旧存档自动兼容（详见 Variables.json）
  • 模组支持：变量支持城市、文明、全局作用域（详见 Variables.json）
  • 模组支持：变量可设上下限、每回合产出、百分比加成（详见 Variables.json）
  • 模组支持：变量可购买、可生产转换、可显示在界面（详见 Variables.json）
  • 模组注意：文明级变量需显式声明作用域，旧模组需更新
  • 修复：变量购买按原值扣、读档后保留、AI 不崩溃
  • 模组支持：变量可用于所有数量条件与设定触发（详见 Variables.json）
  • 合并上游：修复被掠夺道路无法修复、打开百科卡死
  • 合并上游：CN 特色功能适配上游重构，行为不变
  • 文档站：CoeHarMod 更新日志移至模组板块（详见 changelog）
  • 文档站：上游更新日志改为顶部链接查看
  • 文档站：更新日志条目限 30 字内，重要改动可拆分多条

4.21.10.2（build 1257） ​

  • 更新：更新检查与下载按地区分流，大陆玩家走 CN 服务器（详见 server-ts/README.md）
  • 更新：首次启动询问所在地区，可在「选项 - 高级」修改
  • 合并上游：修复观战与城市操作的多处崩溃

4.21.10.1（build 1256） ​

  • 模组支持：新增文明级全局变量，可配条件、触发与 Lua（详见 Variables.json）
  • 模组支持：变量显示位置可配置（顶栏与资源概览）（详见 Variables.json）
  • 模组支持：条件类 [amount]（如 when above [amount] ...、血量/移动力/人口阈值）现支持 Countable 表达式（如 [Cities]），详见 Unique parameters
  • 合并上游：多项界面与崩溃修复、晋升通知合并
  • 修复：环形与镜像地图的对称生成异常（详见 分支特色）

4.21.8.3（build 1255） ​

  • 联机：新游戏选项「禁止读档」，退出重进无法重来
  • 模组支持：新增产能溢出即时转移 unique（详见 uniques）

4.21.8.2（build 1254） ​

  • 修复：地图钉预览不再提前显示未揭示的资源
  • 模组支持：文明6式单位维护费（unique 启用），维护费可见于百科（详见 Units.json 与 uniques）
  • 模组支持：数量类参数全面支持 Countable 表达式（详见 Unique parameters）
  • 模组支持：新增战斗触发、驻防登船等 unique（详见 uniques）
  • 模组/Lua：Lua 可改地块产出、接管战斗公式（详见 Lua Modding）
  • 模组支持：ModOptions.json 新增版本字段（recommendedGameVersion、依赖的 recommendedVersion），游戏版本不符时给出非阻塞警告，详见 ModOptions.json
  • 模组支持：修复 REMOVE_FIELD 合并对 float 字段的崩溃，详见 MergeActions

4.21.8.1（build 1253） ​

  • 合并上游：修复多处崩溃，新增「已探索地块」排名
  • 难度：国王及以上难度的 AI 不满修正改为 100/90/85/75（原 90/85/75/60）
  • 模组支持：单位血量上限可模组化（详见 Units.json）
  • 主菜单按钮：Discord 换 QQ 群，新增贴吧入口
  • 文档站链接按客户端语言自适应（中文客户端跳 /zh/ 区）
  • 游戏内 wiki 链接改为 CN 文档站
  • 全项目代码清理与审查修复（删除死代码、修复城市/过滤器等 bug）

4.21.7.2（build 1252） ​

  • Android：更新弹窗内直接下载并安装 APK
  • Android：下载支持断点续传与一键重装
  • 主菜单「下载最新版本」改为列出当前平台安装包并直接下载所选包

4.21.7.1（build 1251） ​

  • 合并上游：AI 战争逻辑、轰炸机闪避等多项修复
  • Lua API：新增 unit.getEraNumber()、civ.discoverTech()，详见 Lua API 参考
  • 模组：CoeHarMod 改为独立仓库的 git 子模块，规则经 Lua 精简

4.21.6.6（build 1250） ​

  • 主菜单自动更新检测（镜像源回退）；「模组下载源」更名为「下载源」
  • 修复自定义 Lua API 函数参数含函数调用表达式时的运行时崩溃
  • Lua API 大扩展（约 100 个新方法）、ConditionalLuaCheck unique、TriggerUponTradeMade 钩子，详见 Lua Modding
  • Lua 地图脚本：模组可在 scripts/ 提供地图生成器，新增「Lua Generated」地图类型
  • Lua 沙箱加固；模组检查器覆盖地图脚本 API

4.21.6.5（build 1249） ​

  • Lua 错误弹窗带行号；堵住 package.loaded 沙箱逃逸；指令预算阻止死循环卡死
  • 新增：联机重开投票（房主开启、全员投票、超时默认同意、自动重开）

4.21.6.4（build 1248） ​

  • 新增「模组下载源」设置，支持国内镜像加速
  • 开图界面：配置可保存到命名槽位

4.21.6.3（build 1247） ​

  • 修复 Docker 构建复制旧名 Unciv.jar；修复 Release 缺少 MSI 安装包

4.21.6.2（build 1246） ​

  • 补齐 CN 自研功能缺失的简体中文翻译（47 个缺失 + 10 个空词条）

4.21.6.1（build 1245） ​

  • 笔记改为按 gameId 存储，不再跨存档泄漏
  • 地图钉/单位钉：长按/Alt+点击编辑、备注气泡、崩溃修复、中文词条补齐
  • 修复开图界面自定义尺寸重复行；内置规则集与上游对齐
  • 合并上游 4.21.6（CPU 性能、AI 工人相邻加成、多人上传失败提示）

4.21.5.3（build 1244） ​

  • 修复 CI 测试失败（翻译模板缺空格、测试模组纳入版本库）；部署通知清理

4.21.5.2（build 1243） ​

  • 官方 VitePress 文档站上线（中文全文搜索、中英一键切换）
  • unique 说明文档中文化
  • APK 签名本地化，产物统一命名 UncivCN

4.21.5.1（build 1242） ​

  • 合并上游 4.21.5（AI 金币/战争逻辑修复、CPU 性能优化）
  • 撤销自带 UCCC 模组；开图设置可剪贴板导出

4.21.0.2（2026.8.1） ​

  • 修复 UCCC 模组部分 bug

4.21.0.1（2026.8.1） ​

  • 跟进上游近期更新（对称/镜像地图、统计面板）；补全中文本地化
  • 联机默认服务器改为 sp.unciv.cn:30123；新增人口自动锁定按钮；自带 UCCC 模组
  • 联机不再支持读档改变随机数

4.20.17.2（2026.7.12） ​

  • 新增单位钉/地图钉；训练移民不再饿死市民

4.20.17.1（2026.7.4） ​

  • 跟进上游一个多月的更新

4.20.8.4（2026.5.26） ​

  • 模组检查器可筛查 Lua 错误；轮询联机显示在线状态

4.20.8.3（2026.5.23） ​

  • 增强 Lua 系统；event 可挂载 Lua

4.20.8.2（2026.5.22） ​

  • 模组支持 Lua 脚本
  • 修复「众神与国王」精英教育不送伟人；修复 TRY_INJECT 造价覆盖 bug
  • Amount 参数兼容 Countables

4.20.8.1（2026.5.21） ​

4.20.7.4（2026.5.19） ​

  • 中心对称地图资源数量对称分布

4.20.7.3（2026.5.19） ​

4.20.7.2 ​

发布日期：2026.5.19

  • 安卓端安装包不再自带 CoeHarMod 模组
  • 新增三种镜像地图模式（两瓣/三瓣/六瓣中心对称）

4.20.6.3 ​

发布日期：2026.5.17

  • 新增模组特性：
英文原文中文释义
Hidden from city screen不再显示在城市面板中
Can be built [amount] times in each city可以在单个城市中重复建造[amount]次

4.20.6.1 ​

发布日期：2026.5.16

  • 同步两个月来上游更新
  • 随机结果可变性收束为设置开关

4.19.16.2 ​

发布日期：2026.3.2

  • 远古遗迹随机结果可通过读档重载改变

4.19.16.1 ​

发布日期：2026.3.1

  • 城邦任务随机结果可通过读档重载改变

4.19.15-cn2 ​

发布日期：2026.2.28

  • 新增范围攻击类模组特性（多目标、伤害随距离递减、自身/反击伤害）
  • 统计面板数据导出 CSV

4.19.15 ​

发布日期：2026.2.26

  • 安卓端内置 CoeHarMod/和合共生
  • 相邻城市可交换地块（需在 ModOptions.json 声明 "Allow cities to claim tiles"）