球纪元h5 游戏详细说明

版本：V0.9.2-beta

本文档详细说明游戏的所有内容、机制和数值设定。

1. 游戏简介

Farming Defense（球纪元）是一款基于 HTML5 Canvas 的多人联机塔防/农场游戏。最多20名玩家在一张 20×20 的网格地图上同时进行游戏，核心玩法包括：

经济发展：建造农田产出金币，拾取地图上刷新的金币积累财富。
防御建设：用石墙和木墙构建防线，保护自己的建筑和领地。
生存对抗：躲避地图上不断弹跳的白球，白球会摧毁墙壁、农田和主城，击杀玩家。
升级成长：消耗金币升级移速、金币收益、收获范围等属性，提升综合实力。
成就排行：服务器自动记录成就、积分、游戏时间、人类财富/现金和白球财富历史最佳值。

运行方式

访问 farming.junwanghechu.online，登录账号后进入游戏。在指令输入框中输入 A 并回车加入游戏；输入 A+ 会消耗 10 积分并额外获得 500 初始金币。也可以输入 Q 控制白球，或输入 Q+ 消耗 10 积分并携带 500 白球初始金币。游戏昵称使用登录账号的昵称。

人类和白球互斥：只能在未加入人类、未控制白球时选择 A/A+ 或 Q/Q+ 其中一种加入；已经在人类或白球中游玩时，A 和 Q 系列指令都会被忽略。

胜负条件

当玩家被白球击杀且没有主城时，该玩家出局。
拥有主城的玩家死亡后可以复活，继续游戏。
初始纪元以外，如果曾有玩家参与且所有玩家与主城全部清零，游戏结束并在 5 秒后自动重置。
重置前仍存活或保有主城的一方视为胜出。

2. 地图与界面

地图尺寸

网格大小：20×20（共 400 个格子）
每格像素尺寸：40×40 像素（unitLength = 40）
地图总像素：800×800（加上边框为 880×880）

地图外观

格子交替使用深绿色和浅绿色绘制棋盘状底色。
地图四周边框为深灰色，边框上显示坐标标识（0-9, A-F, H, I, L, P）。

出生区

位于地图中心，网格坐标 (7, 7) 到 (12, 12) 的 6×6 区域。
外观为半透明白色覆盖。
出生区内禁止建造墙壁。
玩家初始位置在出生区内随机选取一格。

三画布布局

游戏界面由左、中、右三个区域组成：

区域	尺寸	内容
左侧边栏	320×880	游戏计时、玩家金币数量、复活倒计时
中间主画布	880×880	游戏地图（20×20 网格 + 坐标边框）
右侧边栏	320×880	上半部：操作手册；下半部：指令终端

左侧边栏显示内容

年代信息：顶部显示"球元XX年"和当前纪元名称。
人类列表（最大20行）：按持有金币排名，显示排名、颜色球、昵称、金币数。未加入的位置显示灰色"闲置中"。
白球状态：白球信息（偏大白色球、控制者昵称），能量槽进度条，转向技能冷却条。
版本信息：底部显示"球纪元h5"+ 版本号，以及"原作者：@谜之老六"。

右侧边栏

上半部：操作手册速查表，包含所有指令及费用。
下半部：指令终端区域，包括指令延迟显示、指令显示区（最近 100 条）、指令输入框（上下键浏览最近 5 条历史输入）。

坐标系统

游戏中使用三种坐标：

坐标类型	范围	用途
像素坐标 (x, y)	[40, 840]	渲染和碰撞检测
网格坐标 (pointX, pointY)	[0, 19]	建造放置、寻路
指令坐标 (两位字符)	0-9 / A-F / H / I / L / P	玩家指令输入

网格坐标 → 像素坐标转换：格子中心 x = 40 × (pointX + 1.5)，y = 40 × (pointY + 1.5)

指令坐标编码：两位字符，第1位=X列，第2位=Y行。字符集为 0123456789ABCDEFHILP，按序映射到 0-19（不区分大小写）。示例：55 = (5,5)，A6 = (10,6)，PP = (19,19)

3. 玩家

基本属性

属性	值	说明
半径	10 像素	圆形玩家的碰撞和绘制半径
初始金币	0（默认）	由 `FARMING_INITIAL_MONEY` 控制；A+ 加入额外 +500；可叠加「我是超人」buff
初始位置	出生区随机	加入时在 (7,7)~(12,12) 区域内随机选一格
初始无敌	10 秒	加入游戏后的无敌保护时间

玩家颜色与操作方式

所有玩家均通过指令输入（在右下角终端输入文本指令）操作角色，无键盘按键操作模式。
玩家颜色由服务器从颜色池中分配（红、橙、黄、绿、青、蓝、紫等 20 种），同一连接断线重连后保持原色。

等级外观

玩家的外观会随着升级变化：

总等级 = U1 + U2 + U3 + U4 的等级之和（最高 30 级）。
每 5 级一个档次（共 0-6 档），逐层叠加光环效果。
光环颜色依次为：5级浅蓝、10级绿、15级黄、20级橙、25级粉、30级金。
15 级以上，头顶等级文字变为金色。
拥有护盾（U9）时，玩家描边为金色；否则为黑色。

4. 移动系统

移动方式

玩家通过指令进行移动：

M + 坐标：自动寻路移动。服务器计算从当前位置到目标格的路径，沿路径航点逐步移动。
T + 坐标：传送。1 秒延迟后瞬间移动到目标格，传送期间有动画效果。费用 100 金币。
R / R + 坐标：传送回第一座主城，或传送到指定坐标的主城（1 秒延迟，免费）。

移动速度

基础速度：1 像素/帧（60fps 下约 60 像素/秒）
实际速度：基础速度 × (1 + U1等级 × 0.2)
U1 满级（10 级）时速度为基础的 3 倍

自动寻路细节

M 指令使用 A* 搜索与物理模拟验证：

真实停点节点：每格按 3×3 共 9 个采样点扩展，节点位置为模拟后真正能停住的坐标，不再固定为格中心，半格通道与贴墙位置也能被识别。
候选扩展：从当前节点向 1 邻格扩展（8 邻格），同时对终点做"切比雪夫距离 ≤ 3 时尝试一步直达"的快速通道；避开边界、黑球障碍物、墙和主城。
物理验证：每段路径都用玩家碰撞半径模拟直线移动（含轴向滑行 → 切向滑行 → 合力推出），失败的段不会进入路径。
路径代价：按实际模拟帧数 × 基础速度计入，擦墙和绕障路径会被正确计为更慢；启发式估价采用到目标格的矩形 Chebyshev 距离 / 速度。
路径平滑：回溯后尝试跳过少量冗余航点，减少不必要的中转。
到达判定：进入航点 1/3 格边长矩形且当前位置可站即算到达；最终航点若被墙占住则不强行钻入，由 50 tick 卡住检测兜底。

被动滑行

当玩家被另一个玩家推飞后，会沿推飞方向被动滑行：

推飞速度与推人者的速度相关。
滑行过程中遇到障碍物会反弹（速度衰减至 80%，反弹力为速度的 30%）。
合力为零时立即停止。

5. 建造系统

玩家可以在网格上建造以下建筑：

建筑类型	说明
木墙	轻型防御，1 点生命值
石墙	重型防御，初始 3 点生命值（可被 buff 提升）
农田	经济建筑，周期性产出金币
主城	核心建筑，自动收取金币，提供复活点

建造限制

出生区禁建：网格坐标 (7,7) 到 (12,12) 的 6×6 区域内不可建造墙壁。
不可重叠：墙不能与已有墙重叠放置。
障碍物阻挡：不能在黑球障碍物位置建造。

6. 墙

墙是游戏的核心防御手段，用于阻挡白球、保护建筑。

石墙

属性	值
生命值	初始 3，可被「石墙升级」buff 累积提升（紫色 +1，金色 +2）
宽度	30 像素
高度	16 像素
颜色	深灰色 rgb(41, 41, 41)

石墙受到白球撞击后生命值 -1，按当前血量与上限的比例显示外观：

HP > 2/3 上限：完整外观，无裂痕。
HP ≤ 2/3 上限：出现 1-2 条浅色裂痕。
HP ≤ 1/3 上限：出现 3-4 条明显裂痕。
HP = 0：墙被摧毁。

木墙

属性	值
生命值	1
宽度	30 像素
高度	16 像素
颜色	棕色栅格样式

木墙被白球撞击一次即摧毁。

墙的朝向

类型编号	朝向	说明
0	横墙 (—)	宽 = 32px，高 = 16px
1	竖墙 (\|)	宽 = 16px，高 = 32px
2	正斜墙 (/)	45 度旋转
3	反斜墙 (\)	-45 度旋转

方向与墙类型的映射

输入方向	对应墙类型
上(0)、下(4)	横墙 (—)
右(2)、左(6)	竖墙 (\|)
右上(1)、左下(5)	反斜墙 (\)
右下(3)、左上(7)	正斜墙 (/)

单墙建造

操作	指令	费用
单木墙	B1 + 方向	10g
单石墙	B3 + 方向	20g

三连墙建造

在指定方向上一次放置 3 堵墙（中间一堵 + 两侧各一堵），三堵墙与放置方向垂直排列：

操作	指令	费用
三连木墙	B2 + 方向	30g
三连石墙	B4 + 方向	80g

三连墙的碰撞检测：中间墙使用 16 像素检测距离，两侧墙使用 8 像素（石墙）或 16 像素（木墙）。中间墙不可放置时整体建造失败。两侧如果放置失败，会查找最近的同类型墙并修复至满血。

7. 农田

农田是游戏的核心经济建筑，提供稳定的金币收入。

建造

操作	指令	费用	说明
单格农田	B0	50g	在当前格建造
3×3 农田	B8	600g	在周围 9 格全部建造农田（固定3×3）
主城周围农田	F	400g / 3,000g	第一主城周围建农田（U5升级后扩为5×5）
指定主城周围农田	F + 坐标	400g / 3,000g	指定主城周围建农田（U5升级后扩为5×5）

外观

农田在每个格子内绘制 4 个绿色小方块（2×2 布局），每个小方块约占格子面积的 47.5%。

建造限制

已有农田的格子不可重复建造。
不可在主城所在格建造农田。
主城可以建在农田上（农田被覆盖消失）。

产出机制

产出周期：每 20 秒一次。
产出条件：每块农田同一时刻最多只存在 1 枚由它产出的金币，若上一周期产出的金币尚未被拾取/收取，本周期该农田跳过产出。
产出方式：满足条件的农田在自身格中心生成一枚小金币（价值 10g）。
主城收取：产金 1 秒后，主城按建造顺序自动收取范围内的金币。
收取范围：2.5 格（U5 升级后扩大到 3 格）。
收取加成：受 U2（金币收益）升级影响，收取量 × (1 + U2等级 × 0.1)。

被摧毁

白球碰到农田时，农田被摧毁，白球不会反弹，会穿过继续移动。

8. 主城

主城是游戏最重要的建筑，提供金币自动收取和复活功能。

建造

操作	指令
建造主城	B9

费用（递增）

主城序号	费用
第 1 座	300g
第 2 座	30,000g
第 3 座	60,000g
第 4 座	90,000g
第 n 座 (n ≥ 2)	n × 30,000g（n 为建造时已有主城数）

建造限制

不能与现有墙重叠。
不能在他人主城周围 5×5 范围内建造；自己的多个主城之间不限制距离。
黑球障碍物附近的格子永远不能建造主城。

外观

主体：玩家颜色的矩形，占格子高度的 80%。
城垛：普通状态 3 个城垛；U5 升级后 5 个城垛 + 金色边框。
门洞：深色半透明方块，位于底部中央。
旗帜：仅第一座主城顶部显示旗帜（玩家颜色）。
护盾光效：拥有城堡护盾时显示金色脉冲发光边框。

功能

自动收取金币：每 20 秒农田产金后，1 秒后主城按建造顺序收取范围内金币。默认收取范围 2.5 格，U5 升级后 3 格。
复活点：玩家死亡后在随机主城位置复活。
防御白球：白球碰到主城会被反弹。

被摧毁

白球撞击（无城堡护盾）：主城被摧毁，主人金钱减半，其中 10% 掉落为金币。
白球撞击（有城堡护盾）：消耗护盾，白球被反弹，主城不被摧毁，同时驱赶附近敌人。
主动拆除（C9 指令）：发起者支付 1,000g，城主金钱减半，其中 10% 掉落为金币。可拆除他人主城。

9. 拆除与修复

拆除

操作	指令	费用
拆除方向墙（石墙）	C + 方向	200g
拆除方向墙（木墙）	C + 方向	100g
拆除脚下农田	C9	500g
拆除脚下主城	C9	1,000g（发起者）+ 城主金钱减半（10%掉落）

拆除范围：1.5 格（拆除方向上最近的墙）。
拆除主城的机制：发起者支付 1,000g，城主（可以是他人）金钱减半，减半部分的 10% 掉落为金币。

修复

操作	指令	费用
修复附近石墙	X	200g

修复范围：2 格（基础）+ U4 每级 +0.2 格。
效果：将范围内所有石墙恢复至当前上限（基础 3，含「石墙升级」buff 加成），同时将范围内白球技能物品随机转向。
修复时会显示范围闪烁动画。

10. 升级系统

玩家可以通过消耗金币升级各项属性。

升级列表

编号	名称	最大等级	费用公式	效果
U1	移速	10 级	500 + 当前等级 × 500	每级 +20% 基础速度
U2	金币收益	10 级	1,000 + 当前等级 × 1,000	每级 +10% 金币拾取/收取量
U3	收获范围	5 级	1,000 + 当前等级 × 1,000	基础 1.5 格，每级 +0.2 格
U4	修理范围	5 级	1,000 + 当前等级 × 1,000	基础 2 格，每级 +0.2 格
U5	城堡范围	1 级	20,000	主城收金币范围 2.5→3 格，5 城垛 + 金边；F 指令范围扩为 5×5（费用 3,000g）
U9	护盾	1 次性	10,000	免疫一次白球致死，消耗后 10 秒无敌

U1 移速升级费用

升级到等级	费用	累计花费	速度倍率
1 级	500	500	1.2×
2 级	1,000	1,500	1.4×
3 级	1,500	3,000	1.6×
4 级	2,000	5,000	1.8×
5 级	2,500	7,500	2.0×
6 级	3,000	10,500	2.2×
7 级	3,500	14,000	2.4×
8 级	4,000	18,000	2.6×
9 级	4,500	22,500	2.8×
10 级	5,000	27,500	3.0×

U2 金币收益升级费用

升级到等级	费用	累计花费	收益倍率
1 级	1,000	1,000	1.1×
2 级	2,000	3,000	1.2×
3 级	3,000	6,000	1.3×
4 级	4,000	10,000	1.4×
5 级	5,000	15,000	1.5×
6 级	6,000	21,000	1.6×
7 级	7,000	28,000	1.7×
8 级	8,000	36,000	1.8×
9 级	9,000	45,000	1.9×
10 级	10,000	55,000	2.0×

U3 收获范围升级费用

升级到等级	费用	累计花费	收获范围
1 级	1,000	1,000	1.7 格
2 级	2,000	3,000	1.9 格
3 级	3,000	6,000	2.1 格
4 级	4,000	10,000	2.3 格
5 级	5,000	15,000	2.5 格

U4 修理范围升级费用

升级到等级	费用	累计花费	修理范围
1 级	1,000	1,000	2.2 格
2 级	2,000	3,000	2.4 格
3 级	3,000	6,000	2.6 格
4 级	4,000	10,000	2.8 格
5 级	5,000	15,000	3.0 格

输入 U 指令可查看所有技能的当前等级。

11. 金币系统

金币类型

类型	半径	价值	颜色
小金币	6 像素	10g	黄色
大金币	12 像素	500g	黄色

金币生成

来源	周期	数量	条件
农田产出	20 秒	每个农田 1 个小金币	—
自动生成小金币	10 秒	20 个（随机位置）	场上小金币 < 120 个
自动生成大金币	60 秒	1 个（随机位置）	场上大金币 < 1 个

金币拾取

直接拾取：玩家与金币的距离 ≤ 10 像素时直接拾取。
吸引飞行：在吸引范围内的金币会自动飞向玩家。吸引范围 = 40 × (1.5 + U3等级 × 0.2) 像素，飞行速度 = 20 像素/帧。
主城收取：农田产金 1 秒后，主城按建造顺序自动收取范围内金币。
U2 加成：所有拾取和收取的金额 × (1 + U2等级 × 0.1)。

金币掉落

触发事件	损失金额	掉落量	掉落位置
玩家死亡	失去 20% 金钱	损失的 25%（= 总金钱的 5%）	死亡位置周围 1.5 格半径
主城被白球摧毁	金钱减半	损失的 10%	主城位置周围 1.5 格半径
主城被拆除	城主金钱减半	损失的 10%	主城位置周围 1.5 格半径

掉落金币的分配：先尽量转化为大金币（500g），余额转化为小金币（10g）。

12. 白球

白球是游戏中的核心威胁，在地图上不断弹跳移动，摧毁一切碰到的东西。

基本属性

属性	值
半径	16 像素（unitLength × 0.4，V0.6.2-alpha 起，原 15px）
初始速度	2 像素/帧（unitLength × 0.05）
最高速度	8 像素/帧（unitLength × 0.2，最后一次纪元过渡后达到）
拖尾长度	15 帧
数量	1 个
能量槽	最大 10 点，碰撞时+1

初始状态

初始位置：在网格 (0-5, 0-5) 范围内随机选取一个格子中心。
初始方向：0.4π 弧度（约 72°，大致向右下方）。

速度升级

白球速度等级由「纪元过渡」一次性提升：每次纪元过渡时速度等级 +3，初始纪元之后共 5 次过渡，最终达到 15 级（速度 unitLength × 0.2）。
每级速度增量为 unitLength × 0.01；公式：speed = unitLength × (0.05 + 等级 × 0.01)。
若该次过渡命中「白球速度弱化」buff，对应阶跃被取消（保持原等级）。
杀戮纪元下白球速度固定为 unitLength × 0.5。

碰撞优先级

白球每帧只处理一次碰撞，按以下优先级判定：

优先级	碰撞对象	效果
1	地图边界	X 或 Y 速度分量反转
2	黑球障碍物	圆-圆法线反射
3	石墙	反弹 + 石墙 HP-1（0 HP 时摧毁）
4	木墙	反弹 + 摧毁木墙（1 HP）
5	主城	反弹；无护盾则摧毁主城 + 主人金钱减半；有护盾则消耗护盾 + 驱赶敌人
6	农田	摧毁农田，白球不反弹，继续移动
7	玩家	玩家死亡（无敌状态跳过，护盾消耗 + 10 秒无敌）

反弹规则

所有反弹都会加入 ±0.05 弧度的随机偏移，使白球路径不完全可预测。
边界反弹：碰到的那个轴的速度分量取反。
圆形物体（障碍物）：基于法线的镜面反射。
墙面：基于墙面法线的镜面反射。
墙角：使用固定出射角。

白球碰撞时会在碰撞点产生视觉冲击波动画效果。

13. 黑球障碍物

基本属性

属性	值
数量	16 个（固定位置）
半径	17.4 像素（unitLength × 0.435，V0.6.2-alpha 起，原 20px）
颜色	深灰色 rgb(41, 41, 41)

固定位置

边缘 8 个（位于地图边界格点上）：

(0,7)  (0,13)  (7,0)  (13,0)
(20,7) (20,13) (7,20) (13,20)

内部 8 个（位于地图中间区域）：

(8,5)  (5,8)  (12,5)  (5,12)
(8,15) (15,8) (12,15) (15,12)

作用

阻挡玩家移动：玩家碰到黑球会被推出。
阻挡建造：黑球附近的格子不能建造主城。
反弹白球：白球碰到黑球进行圆-圆法线反射。
寻路障碍：玩家的移动寻路会绕开黑球。

14. 碰撞系统

游戏中有两套不同的碰撞推出机制。

移动碰撞推出

当玩家移动后与障碍物（边界、黑球、墙、主城）发生碰撞时：

检测碰撞并收集所有碰撞物的力向量。
每个碰撞物贡献一个从物体中心指向玩家中心的方向力向量。
所有向量求和后归一化，得到推出方向。
沿推出方向以玩家速度为步长移动，最多 10 次迭代。
如果合力为零（被完全包围），玩家回到移动前的位置，显示"无法移动"。

建墙碰撞推出

当在玩家所在位置建造新墙时：

新墙与玩家重叠，先沿墙的法向方向推出。
检测是否与其他障碍物碰撞。
如果无额外碰撞，推出完成。
如果有额外碰撞，计算所有碰撞物的合力。
合力非零：沿合力方向以 1 像素为步长推出，最多 10,000 次迭代。
合力为零：将玩家居中放置到所有碰撞物的几何中心。

合力法

每个碰撞物体贡献一个方向力向量（物体中心 → 玩家中心）。
横纵方向力大小 = 1，斜向力大小 = √2。
所有向量求和后归一化得到最终推出方向。

玩家推玩家

当一个玩家移动时碰到另一个玩家，会将对方推飞。
被推飞的玩家进入被动滑行状态。
推飞速度与推人者的当前速度相关。
滑行中碰到障碍物会反弹，速度逐渐衰减。

15. 死亡与复活

死亡条件

玩家被白球碰到时会死亡（非无敌状态且无护盾）。

如果玩家处于无敌状态，白球碰到不会造成任何效果。
如果玩家拥有护盾（U9），白球碰到会消耗护盾并获得 10 秒无敌，不会死亡。

死亡惩罚

失去 20% 的当前金钱。
损失金额的 25%（即总金钱的 5%）在死亡位置掉落为金币。

复活流程

有主城的情况：

进入 10 秒复活倒计时（左侧边栏显示倒计时）。
倒计时结束后，在随机一座主城的位置复活。
复活费用 = 主城数量 × 1,000g。
- 金钱足够：扣费后复活。
- 金钱不足：免费复活，但摧毁用于复活的那座主城。
复活后获得 10 秒无敌。

无主城的情况：玩家直接出局，不可复活。

16. 防御技能

护盾（U9）

费用：10,000g（一次性消耗品）。
效果：免疫一次白球致死打击。
触发时：护盾被消耗，玩家获得 10 秒无敌。
外观：拥有护盾时玩家描边为金色。

城堡护盾（Y 指令）

费用：每座主城 10,000g。
效果：为主城提供一次白球撞击保护。
触发时：消耗城堡护盾，白球正常反弹，主城不被摧毁，自动驱赶主城附近的敌人。
外观：受保护的主城显示金色脉冲发光边框（周期 400ms）。

驱赶（P 指令）

指令	说明
P	驱赶第一座主城附近的敌方玩家
P + 坐标	驱赶指定主城附近的敌方玩家
P0	驱赶所有主城附近的敌方玩家

驱赶范围：主城周围 2.5 格半径的圆形区域。
驱赶效果：将范围内的敌方玩家传送回出生区（随机位置）。
延迟：1 秒后执行（执行前显示范围闪烁动画）。
冷却：每个玩家独立 2 秒冷却时间。
费用：免费。

17. 指令系统

所有玩家通过右下角的指令终端输入文字指令进行操作。指令由服务器验证并执行。

指令延迟

每条指令有一个执行延迟，在 500ms ~ 5000ms 之间随机。
每 60 秒重新随机一次延迟值。
当前延迟值显示在指令终端上方。

指令终端

指令显示区：显示最近 100 条已输入的指令。
指令输入框：输入指令后按回车执行。按上/下方向键浏览最近 5 条历史输入。

刷屏禁言

系统会检测异常输入频率并自动禁言：

触发条件	当前条	禁言时长	提示
1 秒内连续输入 3 条完全相同的指令	第 3 条正常执行	3 秒	头顶显示"刷屏禁言3秒"
3 秒内输入超过 10 条任意指令	当前条被拦截	10 秒	头顶显示"刷屏禁言10秒"

禁言期间所有指令无效，不执行、不显示在历史记录。

AFK 挂机（/afk）

/afk 是账号级挂机回放器。客户端只负责提交设置、开始、暂停和查看状态；脚本、运行状态、计时、扣分和回放由服务端按账号统一管理，同账号两个 session 操作互通。它不会改变服务器权威规则，每条回放指令仍会经过当前全局指令延迟、指令展示广播和服务端校验。

语法

指令	格式	说明
查看状态	`/afk`	在指令栏输出已设置脚本、运行/暂停状态、已用时间、剩余时间和暂停时间。
设置指令	`/afk set 指令1 [延迟1] 指令2 [延迟2] ...`	设置最多 10 条循环指令。延迟单位为毫秒，表示该条指令发出后等待多久再发下一条；省略时默认 500ms，允许范围 500~5000ms。
开始挂机	`/afk start [分钟数]`	开始或继续挂机。首次分钟数默认 10，范围 1~9999；暂停后不带数字会沿用上次总时长并继续剩余时间，带数字会重设本轮挂机时长和计时。启动时要求已连接服务器、已加入人类玩家、角色存活、未复活中且未出局。
暂停挂机	`/afk stop`	暂停当前挂机。暂停保留已设置指令、已用时和已扣分次数，再次 `start` 会继续本次剩余时长。

示例

/afk set M55 1000 B30 500 X
/afk start 30
/afk stop

上述配置会循环执行：移动到 55，等待 1000ms；建上方石墙 B30，等待 500ms；修复石墙 X，等待默认 500ms，然后回到第一条继续。

可回放指令

挂机只允许语法明确的人类玩家常规指令：M/T + 坐标、B0/B8/B9、B1~B4 + 方向、C + 方向、C9、F/R/Y/P + 可选坐标、P0、U/U1~U5/U9、X。不允许 A/A+、Q/Q+、G、J、B9C、聊天文本和白球控制指令进入挂机序列。

费用与生命周期

费用：2 积分/分钟。/afk start 会立即扣第一分钟，之后每跨入下一分钟再扣 2 积分；设置 N 分钟最多扣 2 × N 积分。
服务端校验：扣分由服务端按账号执行，金额固定为 2。积分不足、账号缺失或积分服务异常时，服务端会自动停止并向同账号所有连接推送状态。
暂停与继续：/afk stop 只暂停，不清空配置和本次计时。暂停后再次 /afk start 会沿用上次总时长并按已有已用时继续，不会重复扣已经扣过的分钟；若写 /afk start 数字，则重设本轮挂机时长和计时。例：首次 /afk start 10 挂机 3 分 30 秒后 /afk stop，再次 /afk start 会继续剩余 6 分 30 秒；若改为 /afk start 8 则重设为 8 分钟新计时。
自动停止：达到设定时长后自动停止并清空本次计时；游戏重置时清空全部挂机配置、计时与扣分次数；刷新单个页面不会丢失账号级配置，最后一个同账号连接断开时会暂停，重连后可继续。
过场处理：纪元过渡期间挂机不会继续推送指令，过渡结束后恢复。

基本操作

指令	格式	说明	费用
A	`A`	加入游戏	—
A+	`A+`	消耗积分加入，额外获得 500 初始金币	10积分
Q	`Q`	登录账号控制白球（未加入也可用）	—
Q+	`Q+`	消耗积分控制白球，额外获得 500 白球初始金币	10积分
J	`J`	查询球纪元积分和剩余可用积分（未加入也可用）	—
/afk	`/afk set/start/stop`	设置、开始/继续、暂停挂机回放（详见上方 AFK 挂机）	2积分/分钟
M	`M` + 坐标	自动寻路移动到目标格	—
T	`T` + 坐标	传送到目标格（1 秒延迟，完成后 2 秒冷却）	100g
R	`R` / `R` + 坐标	传送回第一座主城 / 传送到指定坐标的主城	—
(其他)	任意无法匹配的文字	说话（头顶气泡显示 2 秒）	—

白球控制

指令	格式	说明	费用
R	`R`	随机转向（转向冷却满）	—
R4	`R` + 方向	指定方向转向（转向冷却满）	100白球金币
Z/X/C/V	`Z`/`X`/`C`/`V`	按当前方向放下冲刺/散射/速射/爆炸技能物品	—
Z0 / X3 / C方向 / V方向	`Z0` / `X3` / `C0` / `V0`	按指定方向放下对应技能物品	100白球金币
W	`W`	隐身 60 秒；控制账号可见 0.5 透明度白球和小白球，其他人不可见	500白球金币
G	`G`	提前结算并释放白球控制权	—

建造操作

指令	格式	说明	费用
B0	`B0`	当前格建造农田	50g
B8	`B8`	周围 3×3 建造农田	600g
B9	`B9`	当前格建造主城	300g 起（递增）
B9C	`B9C` + 原主城坐标	移动主城至玩家当前格（任意可建位置，仅受他人主城 5×5 限制）	300g
B1	`B1` + 方向	建造单木墙	10g
B2	`B2` + 方向	建造三连木墙	30g
B3	`B3` + 方向	建造单石墙	20g
B4	`B4` + 方向	建造三连石墙	80g
F	`F`	第一主城周围建农田（U5前3×3，U5后5×5）	400g / 3,000g
F	`F` + 坐标	指定主城周围建农田（U5前3×3，U5后5×5）	400g / 3,000g

拆除与修复

指令	格式	说明	费用
C	`C` + 方向	拆除指定方向最近的墙	石墙 200g / 木墙 100g
C9	`C9`	拆除脚下农田或主城（可拆他人）	农田 500g / 主城 1,000g
X	`X`	修复附近所有石墙至满血，转向技能物品	200g

升级

指令	格式	说明	费用
U	`U`	查看所有技能等级	—
U1	`U1`	升级移速	500 ~ 5,000g
U2	`U2`	升级金币收益	1,000 ~ 10,000g
U3	`U3`	升级收获范围	2,000 ~ 10,000g
U4	`U4`	升级修理范围	2,000 ~ 10,000g
U5	`U5`	升级城堡范围	20,000g
U9	`U9`	购买护盾	10,000g

防御

指令	格式	说明	费用
Y	`Y`	给第一座主城购买城堡护盾	10,000g
Y	`Y` + 坐标	给指定主城购买城堡护盾	10,000g
P	`P`	驱赶第一座主城附近敌人（1 秒延迟）	—
P	`P` + 坐标	驱赶指定主城附近敌人	—
P0	`P0`	驱赶所有主城附近敌人	—

方向编号

7=左上  0=上   1=右上
6=左           2=右
5=左下  4=下   3=右下

18. 联机系统

V0.4.1-alpha 版本将游戏改为多人联机模式，基于 WebSocket 实现实时同步。

账号登录

访问游戏页面时自动检测登录状态，未登录则跳转至统一认证中心。
登录成功后自动使用账号昵称作为游戏内昵称。
可在首页 www.junwanghechu.com 修改昵称。

成就与排行榜

V0.6.1-alpha 接入统一成就与排行榜中心，游戏服向 usercenter 上报解锁、最佳值、游戏时间和排行记录。
成就条件由服务端权威判定，覆盖击杀、生存、财富、现金、满级、特殊击杀、首个/最早玩家、和平年代与逃亡年代等场景。
排行榜包括积分榜、游戏时间榜、成就榜，以及球纪元专属的人类财富榜和人类现金榜。
达成成就或打破全局最高记录时，游戏内会通过系统消息广播；首页的「成就」「排行榜」页面可查看完整记录。

加入与连接

进入游戏页面后自动连接服务器（ws://farming.junwanghechu.online/ws）。
输入 A 指令加入游戏，或输入 A+ 消耗 10 积分换取额外 500 初始金币；服务器分配唯一玩家 ID 和不重复的颜色。
最多支持 20 名玩家同时在线。
加入后自动从服务器同步完整游戏状态（地图、白球、所有玩家、纪元等）。

服务器权威

所有游戏状态由服务器统一管理：墙/农田/主城/白球/金币/玩家属性。
指令经服务器验证后执行并广播结果。
纪元过场由服务器控制，客户端同步显示。

状态同步

同步类型	频率	内容
高频 tick	10Hz	玩家坐标、白球位置/速度、碰撞事件
低频 slow_tick	2Hz	玩家金币、升级、复活倒计时、气泡
小白球同步	2Hz	小白球位置和状态
完整状态	按需	加入游戏或重连时同步全部数据

断线重连

断线后自动重连，指数退避间隔（500ms → 10s）。
重连成功后请求完整状态同步。

客户端插值

白球：速度外推 + LERP 修正（系数 0.15），平滑 10Hz 同步到 60fps 渲染。
玩家：线性插值向目标位置靠近（系数 0.3），防止位置跳变。

19. 年代/纪元系统

游戏引入年代概念，随着时间推移进入不同纪元，白球逐渐变强。

年份

初始为球元1年，每分钟+1年。
年份显示在左侧边栏顶部。

纪元划分

年份范围	纪元名称
1 ~ 30 年	初始纪元
31 ~ 60 年	渐盈纪元
61 ~ 90 年	破晓纪元
91 ~ 120 年	悬日纪元
121 ~ 150 年	长歌纪元
151 年后	终末纪元

纪元过场（Buff 投票）

纪元变化时，游戏暂停 44 秒进行积分展示和 buff 投票：2s 淡入 → 10s 积分展示 → 30s 投票 → 2s 结算揭晓。初始纪元进入游戏时不触发。
积分展示阶段按剩余金币前 5 名发放 20 / 16 / 12 / 8 / 4 积分，并将排行从画面中央动画展示到左上角。
投票期间画面展示 3 张 buff 候选卡，品质以颜色区分（白/蓝/紫/金/红）。
已加入玩家在指令栏输入 1/2/3 即可投票，投票立即上传、可改票。
卡片下方以彩色圆点实时展示各玩家投票分布。
最高票数获胜；平票时在最大票数候选中随机选取。
候选抽取规则：按 display_name 聚合分组，先按组权重无放回抽 3 组，组内按颜色权重抽具体 buff；标记为 is_unique 的 buff 本局只抽一次。
过场结束后自动补偿所有计时器，确保游戏连贯。
本局已生效 buff 展示在左栏历史 buff 列表中，鼠标悬停/点击可查看详情。

Buff 列表

名称	品质	效果	备注
白球速度弱化	蓝	抑制本次纪元过渡的白球速度阶跃
白球技能弱化	蓝	抑制本次纪元过渡的白球技能阶跃
我全都要	蓝/紫/金	按概率同时获得另外两张候选的 buff 效果	概率：蓝 20%/紫 35%/金 60%
x 指令增强	金	x 指令可消除范围内白球技能物品（原为转向）	3纪元起，本局唯一
普天同庆	蓝/紫/金	所有在线玩家增加 10000 / 20000 / 30000 金币
我是超人	紫	新加入玩家初始金币 +1000	本局持续，唯一
均富卡	紫	所有玩家金币对齐到场上最高	3纪元起
均贫卡	紫	所有玩家金币对齐到场上最低	3纪元起
石墙升级	紫/金	石墙血量 +1/+2、冲刺抵抗 +1/+2	可叠加
农耕时代	蓝/紫/金	农田产出金币 +5 / +10 / ×2	可叠加
木墙升级	金	木墙冲刺抵抗 +20
和平年代	金	本局中 C9 指令不再生效	仅渐盈纪元，唯一
逃亡年代	金	本局中 B9 指令不再生效	仅渐盈纪元，唯一
天使卡	金	所有玩家 U1~U5 技能等级 +1
恶魔卡	紫	所有玩家 U1~U5 技能等级 -1
信号满格	蓝	本局指令延迟固定 0ms	本局唯一
理财大师	金	每 10 年发放现金 10% 利息	本局唯一，11/21/31…年结算
零元购	蓝/紫/金	本局金币消耗降低 20% / 30% / 50%	可叠加累乘
人为财死	紫	死亡/主城被破坏时金币 100% 掉出	1~2纪元，唯一
Jackpot	红	全员满级 + 护盾 + 30000g，主城全护盾	权重极低（出现概率约万分之一）

杀戮纪元（彩蛋）

触发条件：初始纪元期间，全部玩家拆除他人主城次数总计达到 5 次。
效果：白球速度固定为 unitLength × 0.5（20px/帧），极其危险。

20. 白球技能系统

白球拥有能量槽和技能系统，能够释放多种攻击性技能。

能量槽

最大 10 点能量（debug模式下为5点）。
白球每次发生碰撞（任意类型）+1能量。
能量满后 2秒，白球在当前位置自动放下一个随机类型的技能物品。
放下技能物品后能量清零。

白球技能物品

属性	值
形状	圆形
半径	10 像素
朝向	360°任意角度（放下时与白球前进方向相同）
触发距离	白球圆心距 < 25 像素
激活延迟	出现后 1 秒才能被触发

技能物品不阻挡玩家移动。
技能物品阻挡建墙、建城堡和 T 传送（不阻挡 R 回城传送）。
白球同一时间只执行一个技能，技能结束后才能拾取下一个。
白球被吸引至技能物品圆心后，停留 1 秒再释放技能。

技能类型

冲刺 (W)

白球速度提升至 2倍，向技能物品朝向方向冲刺。
冲刺值按纪元：初始5 / 渐盈10 / 破晓15 / 悬日20 / 长歌25 / 终末30 / 杀戮50。
冲刺消耗：撞石墙 -3，撞木墙 -20，撞主城 -100，撞黑球/边界 -100，撞玩家不消耗。
冲刺破坏被撞的墙壁和主城（有护盾的主城/玩家免疫一次）。
冲刺值≤0时立即结束冲刺并反弹，冲刺期间不触发其他技能。

散射 (E)

白球朝向改为技能物品朝向并继续移动。
同时生成小白球，均匀分布在朝向方向正负60°扇形内。
数量按纪元：初始2 / 渐盈4 / 破晓6 / 悬日8 / 长歌10 / 终末12 / 杀戮20。

速射 (T)

白球朝向改为技能物品朝向，暂停移动。
1.5秒内依次向朝向正负5°随机方向发射小白球。
发射完毕后等待 0.5 秒恢复移动。
数量按纪元：同散射。

爆炸 (Y)

白球朝向改为技能物品朝向并继续移动。
同时生成小白球，均匀分布在 360° 方向上。
数量按纪元：初始6 / 渐盈8 / 破晓10 / 悬日12 / 长歌14 / 终末16 / 杀戮32。

转向 (R)

白球立即随机转向任意方向。
10秒冷却，冷却好就自动使用。
这不是技能物品，是白球自带的能力。

白球控制

Q 获取白球控制权；Q+ 消耗 10 积分并携带 500 白球初始金币。同一时间只有一个账号可以控制白球，首次加入白球时立即获得“2 不做人啦”成就（描述“首次加入白球”）。
有人控制白球后，自动放技能物品和自动转向暂停；白球能量仍会因碰撞累积。
R 和 R4 等指定方向转向使用白球转向冷却，不消耗技能能量；指定方向转向额外消耗 100 白球金币。
W 消耗 500 白球金币隐身 60 秒，进入隐身时发送系统提示；控制账号可见 0.5 透明度白球和小白球，其他人不可见。碰撞特效和技能物品所有人仍可见。
控制者 60 秒没有下一条白球控制指令会失去控制权并结算，也可以输入 G 提前结算；控制开始 60 秒后每 10 秒自动消耗白球金币，金币耗尽也会结算。
白球撞墙每扣 1 点墙血奖励 20 白球金币；尝试摧毁主城或击杀玩家奖励 500 基础金币，护盾抵挡也给基础奖励。
结算时按白球总财富每 1000 金币增加 1 积分，并记录白球财富榜最高值。

小白球

属性	值
半径	5 像素
速度	与白球相同

碰撞效果等同白球（可摧毁墙壁、农田、主城，击杀玩家）。
碰撞玩家后不消失，继续移动。
碰撞石墙、木墙、黑球、边界、主城后消失。
不能拾取白球技能物品。
采用分步移动机制（每步不超过半径长度），防止高速穿墙。

21. 费用总表

项目	费用
移动
A+ 出生加成	10积分
Q+ 白球初始金币	10积分
AFK 挂机（/afk start）	2积分/分钟（启动即扣第一分钟）
空投 d+数字（1~50）	2 × N 积分（发起 N 个空投，N ≥ 2 时按 0.2 秒间隔依次落下）
传送 (T)	100g
回城 (R)	免费
白球指定方向控制	100白球金币
白球隐身 (W)	500白球金币
建造
单木墙 (B1)	10g
三连木墙 (B2)	30g
单石墙 (B3)	20g
三连石墙 (B4)	80g
单格农田 (B0)	50g
3×3 农田 (B8)	600g
主城周围农田 (F)	400g（U5后5×5 / 3,000g）
第 1 座主城	300g
第 2 座主城	30,000g
第 3 座主城	60,000g
第 n 座主城 (n≥2)	n × 30,000g
拆除
拆木墙	100g
拆石墙	200g
拆农田	500g
拆主城	1,000g（发起者）+ 城主金钱减半
升级
U1 移速 (1-10级)	500 ~ 5,000g
U2 金币收益 (1-10级)	1,000 ~ 10,000g
U3 收获范围 (1-5级)	2,000 ~ 10,000g
U4 修理范围 (1-5级)	2,000 ~ 10,000g
U5 城堡范围 (1级)	20,000g
U9 护盾	10,000g
防御
城堡护盾 (Y)	10,000g
驱赶 (P)	免费（2秒冷却）
修复石墙 (X)	200g
复活
复活费用	主城数量 × 1,000g

22. 数值参数总表

速度

参数	值	说明
玩家基础速度	1 像素/帧	U1 每级 +20%
白球初始速度	2 像素/帧	每次纪元过渡阶跃 +3 级（+0.4px/级），最高 8px/帧（5 次过渡后达 15 级）
金币飞行速度	20 像素/帧	被吸引时飞向玩家的速度

范围

参数	基础值	升级后
金币贴近拾取	10 像素	—
金币吸引范围	1.5 格	+U3 每级 0.2 格（最大 2.5 格）
修复范围 (X)	2 格	+U4 每级 0.2 格（最大 3 格）
主城收金币范围	2.5 格	U5 升级后 3 格
拆除范围 (C)	1.5 格	—
驱赶范围 (P)	2.5 格	—

时间

参数	值
无敌时间	10 秒
复活倒计时	10 秒
传送延迟	1 秒
驱赶延迟 (P)	1 秒
农田产出周期	20 秒
小金币自动生成周期	10 秒（20 个，场上上限 120）
大金币自动生成周期	60 秒（1 个，场上上限 1）
指令延迟	500 ~ 5,000ms（每 60 秒随机）
说话气泡显示	2 秒

尺寸

参数	值
网格单元	40×40 像素
玩家半径	10 像素
白球半径	16 像素（V0.6.2-alpha 起，原 15px）
黑球半径	17.4 像素（V0.6.2-alpha 起，原 20px）
墙宽度	32 像素（V0.6.2-alpha 起，原 30px）
墙高度	16 像素
小金币半径	6 像素
大金币半径	12 像素

回到顶部

23. 空投系统

登录账号可输入 d+数字（1~50）消耗球纪元积分发起空投，扣分 2 × N 积分；数量 ≥ 2 时由服务端排队按 0.2 秒间隔依次落下。例如 d1 扣 2 积分发起 1 个空投，d50 扣 100 积分发起 50 个空投。扣分由服务端同步校验，扣分失败不会创建空投。

生命周期

预告中（5 秒）：地图上闪烁红色虚线方框提示落点，显示倒计时；玩家可提前躲避。
下落中：预告最后约 0.5 秒，箱体从屏幕上方快速下落到落点。
已落地（最长 60 秒）：落地瞬间触发落地冲击；箱体作为实体障碍阻挡玩家移动、寻路与建造。最后 20 秒进入红色闪烁预警。
开启中（1 秒）：任意玩家中心进入半径 0.9 格的圆形触发区，立即进入开启动画；不可被其他玩家重复触发。
已打开：开启 1 秒后开奖、生成奖励并移除空投。
爆炸：60 秒无人开启时，落地后爆炸并移除。

范围与杀伤

落地冲击：以落点为中心、边长 0.8 格的正方形。摧毁范围内石墙和木墙；击杀范围内玩家（成就「天降正义」ball_era_068）。
爆炸：以空投中心为圆心、半径 1.3 格的圆形。摧毁范围内石墙和木墙；击杀范围内玩家（成就「瞬间爆炸」ball_era_069）。
护盾抵挡一次后玩家进入 10 秒无敌；无敌期间被空投波及不会死亡（与白球击杀链路一致）。

奖励（开启后只开奖一次，概率合计 100%）

概率	奖励
30%	散落 2 ~ 4 个小金币
30%	散落 1 ~ 2 个大金币
10%	方向随机的白球技能物品：冲刺
10%	方向随机的白球技能物品：速射
10%	方向随机的白球技能物品：散射
10%	方向随机的白球技能物品：爆炸

金币和技能物品复用现有逻辑，散落点在空投中心附近随机偏移。技能物品方向从现有 8 个方向中随机选取。空投奖励的金币与技能物品 0.5 秒内不可被拾取，避免开启瞬间被附近玩家或白球直接收入；非空投生成的技能物品保持原 1 秒保护时间。

落点与白球冲突保护

落点在地图有效区域随机：距地图边界 ≥ 0.65 格、距黑球圆心 ≥ 1 格、与同波雨内相邻空投中心 ≥ 1 格。
落地切换前若主白球或小白球与落地箱阻挡正方形重叠，服务端会先尝试把白球沿"短轴 → 长轴 → 对角"挤到合法位置（不出地图、不与黑球重叠）。
任意一个白球找不到合法位置时，本次空投跳过落地阶段直接开奖消失，立即掉落奖励。
已落地空投在 60 秒等待开启期间，若主白球或小白球持续与阻挡正方形重叠 ≥ 1 秒，空投自动开奖移除。

白球碰撞反弹

白球与空投阻挡正方形的反弹机制与石墙完全一致：先判定四个角点（命中后按角点反弹角直接转向），再判定四条边线（命中后按边法线镜像反射），并使用 reboundRange 入射角度过滤反方向擦角的误触发，避免擦角 / 擦边时循环重撞震动。

与寻路 / 建造的交互

空投在「已落地」「开启中」状态是 0.8 格正方形障碍：阻挡玩家移动、A* 寻路、传送目标格检查、建墙 / 建主城放置。
开启或爆炸移除后阻挡立即解除，路径恢复。
开启触发半径（0.9 格）是触发区，不是碰撞体；玩家接近碰撞体外侧即可触发开启。

与积分的关系

d+数字（1~50）必须登录账号；扣分失败（积分不足或服务异常）不会创建空投。
多发空投是一次整体扣分（2 × N），扣分成功后由服务端排队按 0.2 秒间隔创建，避免中途部分扣分。
挂机 /afk 不允许设置 d 系列空投指令，避免挂机自动消耗积分。
成就「天动万象」ball_era_066 在成功发起一次 d1~d50 任一数量时归属发起者；「舔包」ball_era_067 归属触发开启的玩家。

回到顶部