三国争霸 · 游戏介绍

一款跑在浏览器里的三国题材即时战略游戏。采金伐木、筑城练兵、招募名将，在官渡、赤壁、街亭这些战场上一决胜负； 也可以守虎牢关、走千里单骑、打完一整部战役，或者用自带的编辑器做一张自己的地图。

所有画面和声音都由代码生成，没有一张图片、一个模型文件、一段录音。游戏本体是一个 350 KB 的网页文件，双击就能玩。

目录

• 一分钟了解
• 怎么开始
• 对战
• 三个阵营与十一位英雄
• 英雄养成：装备、背包、天赋
• 十四张地图
• 战役「汉末风云」
• 两种画面：2D 与 3D
• 地形高度
• 上万单位同屏
• 地图编辑器与触发器
• 联机对战
• 触屏
• 操作速查
• 现状与局限

一分钟了解

怎么开始

npm install
npm run build        # 产出 dist/index.html 和 dist/r3d.js

• 直接玩：双击 dist/index.html。只拷这一个文件也能玩，只是没有 3D 画面。
• 要 3D 画面：让 r3d.js 和 index.html 待在同一个目录里。
• 联机：npm run server，把终端里显示的地址发给朋友。
• 开发：npm run dev，改完代码刷新页面即可。

对战

开局只有一座县城和五个民夫。接下来的事和你熟悉的即时战略一样：

1. 采集。民夫采黄金（每座金矿同时最多 5 人）和木材。
2. 建造。修民居提高人口上限；兵营出步兵和弓手；铁匠铺研究兵器铠甲；点将台招募英雄。
3. 升级主城。县城升郡城，解锁马厩、工坊、太学；再升都城，解锁最强的兵种。
4. 扩张。主矿会采空，要去开分矿——野外的金矿多半有山贼或猛虎守着。
5. 决战。摧毁敌人的全部建筑即获胜。

攻防克制决定了兵种怎么搭配：

地图上还有中立市集：让英雄走到旁边就能买装备和丹药。

市集	一场混战（2D）

三个阵营与十一位英雄

三家共用民夫、刀盾兵、弓箭手、长枪兵、轻骑兵、投石车、军医、方士这八种兵，各自多一个特色兵种：

每位英雄有三个技能，分别在 1、3、6 级解锁，最高 10 级。第一位英雄免费，一方最多三位；阵亡后可以在点将台复活，装备和等级都保留。

张飞和赵云不在对战的点将台里，他们出现在战役和「汉中英烈」里。

英雄养成：装备、背包、天赋

• 装备栏有五格：武器、铠甲、坐骑、两件饰品。只有穿在身上的才加属性；买到装备时有空位会自动穿上。
• 背包有六格，放丹药和暂时不穿的装备。左键穿上或使用，右键在市集旁半价卖掉。
• 天赋每升一级得一点，六项各三级：武力、体魄、坚甲、身法、韬略、调息。按 N 打开。
• 市集卖环首刀、鱼鳞甲、黄骠马、玉佩、孙子兵法、青釭剑、明光铠、虎符，以及金创药、清心丹、回城令、太平要术。

装备栏与背包	天赋

在 3D 画面里，身上的装备看得见：换了铠甲肩上多一副肩甲，装备了坐骑就真的骑在马上。

十四张地图

对战（10 张）

塔防：虎牢关

董卓军分 15 波沿着蛇形的道路冲关，最后一波是吕布。指挥工匠在路边修塔：箭塔、弩炮台、投石台、火油楼、战鼓台、法坛，每种都能升到三级。

RPG（3 张）

这三张图没有基地运营，整张图的玩法完全由触发器搭出来——可以在编辑器里打开看它们是怎么做的。

千里走单骑　操控关羽一个人过五关、斩六将，直抵黄河渡口。沿途的驿站可以休整和复活，杀敌的赏金用来买装备。

沙场点兵　对线防守。在大道两侧修兵舍，每一波开战时每座兵舍点出一名士兵，打完收兵。 攒下的钱可以拿去升级兵舍，也可以在军令台派兵冲击隔山的对手——每派一次，自己此后每一波的军饷都增加。 是把钱花在自己的防线上，还是花在让对手难受上，是这张图的全部乐趣。守满 12 波，或者攻破对手的大帐，都算赢。

汉中英烈　英雄防守。招募最多三位英雄，死守高台上的阳平关。曹军分 15 波从四座城门杀来，第 5、10、15 波各有一员大将压阵。 两波之间可以去买装备、招乡勇，或者带着英雄去城外三个角落闯试炼——击败守护者能得到一件宝物。

2D	3D

战役「汉末风云」

八关，一条主线，从桃园结义打到赤壁。按顺序解锁，英雄的等级、装备、天赋跨关继承；可以中途存档。

每一关都有开场演出：收起界面、上下黑边、镜头推近环绕、人物走位、一句一句的对话。每关除了主线目标还有一个支线目标。

选关与英雄档案	过场演出

两种画面：2D 与 3D

同一局游戏有两种看法。对局中按 F6，或者在暂停菜单里切换；镜头、选中的单位、战局都不受影响。操作方式完全一样。

2D	3D

3D 画面里的一切同样是代码生成的：

• 角色是 Q 版的，大头短身。手肘、膝盖、腰是平滑弯曲的；会眨眼，出手时张嘴皱眉；披风在跑动时往后扬。
• 衣甲有花纹：布纹、鱼鳞甲、发丝、屋瓦、砖墙。这些花纹是显卡现算出来的，不是贴图。
• 33 个技能各有自己的动作：有的抡圆了转一圈，有的整个人扑出去，有的跃起震地。
• 五种骨架：人、骑兵（马加骑手）、猛虎、投石车、冲车与车仗。
• 特效是粒子和光环；箭矢朝着飞行方向，火矢拖着尾迹，受损的建筑着火冒烟。
• 场景里水面在流动，有松树和阔叶树，地上有草丛、碎石和小花；建筑施工时搭着脚手架一层层升起。

衣甲的花纹	技能动作

各种兵种	建筑

技能特效	野外的一场遭遇战

画质有高、中、低三档，默认按设备自动选。地图作者可以给地图指定默认的画面，玩家自己的设置优先。

地形高度

地图可以有高低。高处与低处之间只能走坡道，而且：

• 低处看不到高处的东西；
• 从低处往高处射箭，四分之一会落空；
• 从高处往下射，射程更远——但开火之后会暴露自己。

「街亭」正中是一座两级的孤山，山顶有一座富金矿：是上山据守，还是当道扎营？电脑对手懂这个道理——它会抢山顶的矿，把队伍拉到高处集结，让弓手先爬上去再放箭。

3D	2D

上万单位同屏

正常对局受人口上限约束，一方不过百来个单位。但引擎本身撑得住大得多的场面，自制地图用触发器刷兵时用得上。

下面两张图里各有一万个单位在混战，全部在镜头之内：

3D	2D

在一台装了 RTX 4090 的电脑上，这两个场面都是 55 帧（测量工具的上限），游戏逻辑保持每秒 20 帧不掉。 集成显卡和手机上的表现没有测过。

地图编辑器与触发器

内置的每一张地图都是用同一套工具做出来的，你也可以用。

• 地形：十种地形的笔刷，种树砍树，0–3 级的台地。
• 物体：摆放单位、建筑、金矿、市集。
• 区域：在地图上拖出矩形，给触发器当“出兵点”“终点”“路径点”。
• 玩家：阵营、队伍、由人还是电脑控制、出生点、初始资源。
• 触发器：事件 → 条件 → 动作。例如“游戏进行到 30 秒 → 在出兵点创建 10 个西凉兵并沿路径行进”。
• 2D / 3D 视图：工具栏上一键切换，所有工具在两种视图下都能用。
• 一键测试；保存在浏览器里；可以导出、导入 JSON 文件。

触发器有 6 种事件、6 种条件、30 多种动作：刷兵、下命令、变量与倒计时、任务目标、对话、镜头、给物品、复活英雄、点兵与收兵…… 塔防、RPG、战役的过场演出全是用它们搭的。想学怎么做，在选图界面点“在编辑器中打开”，看看虎牢关的 20 个触发器是怎么写的。

触发器面板	在编辑器里打开虎牢关

联机对战

npm run server 启动一个小服务器，它既提供游戏页面，也负责在玩家之间转发指令。朋友用浏览器打开你的地址，进“联机对战”：

• 建房、选图、选位置和阵营，空着的位置由电脑补上；
• 房间里可以聊天；
• 自制地图也能拿来联机；
• 有人掉线时其余的人继续；各端的战局一旦出现分歧会立刻提示。

每个人可以用不同的画面（你用 3D，他用 2D），互不影响。

房间	联机对局

触屏

在手机和平板上不需要鼠标键盘：

小屏幕上界面会自动缩小；竖着拿手机时会提示横过来。

2D	3D

操作速查

现状与局限

这个游戏是由 AI（Claude）在一个会话里分阶段写出来的，下面这些情况应当如实说明：

• 没有真人完整玩过。 每张地图、每一关都由脚本玩家或电脑对手打通过，数值据此调过；但“脚本能通关”不等于“人玩着舒服”，难度和节奏都没有经过真人检验。
• 画面全是代码生成的。 角色有模有样，但离手工制作的美术有明显差距；动作偏生硬。
• 性能只在一台高配电脑上测过。 集成显卡和手机上的帧率是未知数。触屏操作只在模拟的手机环境里验证过，没有上过真机。
• 联机只在本机测过（两个浏览器窗口连同一个服务器），没有经过真实网络的考验。
• 电脑对手的强弱在不同地图上有波动；它会利用高地，但不会刻意“守高地”。
• 「沙场点兵」里的对手是按固定剧本行动的；它和「汉中英烈」都是按单人设计的。

更细的技术说明见 SUMMARY.md（开发过程与数据）、3D.md（3D 与性能）、CAMPAIGN.md（战役）。