From 13224f9483d94f65089e289ff2be63f50a69b1cb Mon Sep 17 00:00:00 2001 From: sganggs Date: Mon, 5 Oct 2026 16:13:25 +0800 Subject: [PATCH] =?UTF-8?q?feedback5=20R3:=20Battle.js=20=E2=86=92=20serve?= =?UTF-8?q?r/sim/battle/*.js,=20a=20pure=20move=20=E2=80=94=20the=20131=20?= =?UTF-8?q?methods,=20verbatim=20with=20their=20comments,=20go=20to=2014?= =?UTF-8?q?=20per-concern=20method=20containers=20(players,=20lifecycle,?= =?UTF-8?q?=20hooks,=20spawns,=20deploy,=20blocking,=20status,=20combat,?= =?UTF-8?q?=20queries,=20summons,=20tiles,=20displacement,=20economy,=20ev?= =?UTF-8?q?ents;=20fin=20/=20clone=20in=20util.js)=20that=20Battle.js=20in?= =?UTF-8?q?stalls=20on=20Battle.prototype=20in=20a=20fixed=20order=20with?= =?UTF-8?q?=20class-method=20descriptors;=20Battle.js=20keeps=20the=20head?= =?UTF-8?q?er,=20the=20constructor=20and=20the=20class,=20and=20re-exports?= =?UTF-8?q?=20pushTiles.=20docs-consistency=20reads=20the=20method=20modul?= =?UTF-8?q?es=20(battleText)=20and=20pins=20layerGainRoom=20in=20battle/ec?= =?UTF-8?q?onomy.js?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- server/sim/Battle.js | 2374 +---------------------------- server/sim/battle/blocking.js | 120 ++ server/sim/battle/combat.js | 59 + server/sim/battle/deploy.js | 255 ++++ server/sim/battle/displacement.js | 147 ++ server/sim/battle/economy.js | 58 + server/sim/battle/events.js | 83 + server/sim/battle/hooks.js | 188 +++ server/sim/battle/lifecycle.js | 240 +++ server/sim/battle/players.js | 178 +++ server/sim/battle/queries.js | 247 +++ server/sim/battle/spawns.js | 202 +++ server/sim/battle/status.js | 294 ++++ server/sim/battle/summons.js | 139 ++ server/sim/battle/tiles.js | 210 +++ server/sim/battle/util.js | 12 + test/docs-consistency.test.js | 10 +- 17 files changed, 2488 insertions(+), 2328 deletions(-) create mode 100644 server/sim/battle/blocking.js create mode 100644 server/sim/battle/combat.js create mode 100644 server/sim/battle/deploy.js create mode 100644 server/sim/battle/displacement.js create mode 100644 server/sim/battle/economy.js create mode 100644 server/sim/battle/events.js create mode 100644 server/sim/battle/hooks.js create mode 100644 server/sim/battle/lifecycle.js create mode 100644 server/sim/battle/players.js create mode 100644 server/sim/battle/queries.js create mode 100644 server/sim/battle/spawns.js create mode 100644 server/sim/battle/status.js create mode 100644 server/sim/battle/summons.js create mode 100644 server/sim/battle/tiles.js create mode 100644 server/sim/battle/util.js diff --git a/server/sim/Battle.js b/server/sim/Battle.js index fc232337..ba54c1cf 100644 --- a/server/sim/Battle.js +++ b/server/sim/Battle.js @@ -24,56 +24,52 @@ // `abs: true` on a unit (or player `coords: 'field'`) = field tiles (and field directions). // Robustness: every content callback and every step phase is wrapped; errors are logged once per key and the // battle continues. After MAX_INTERNAL_ERRORS the battle force-ends as a timeout. +// +// Code layout: this file keeps the constructor (fields, players, spawn queue, content install); the methods live in +// server/sim/battle/, one module per concern, and are installed on Battle.prototype below in a fixed order, with the +// descriptors of class methods (non-enumerable; `this` is the battle, subclasses and `super` calls work as before): +// players.js board → field tiles / directions, ally creation, kit / profile / skill setup +// lifecycle.js start (the battle-start deployment), step (the tick order above), end checks, BattleResult +// hooks.js hook bus (on / off / emit), timers (after / every), content-callback isolation and errors +// spawns.js spawn queue, routes, spawnEnemy; hidden enemies, boss pool sync, field clamp, list compaction +// deploy.js deploy, kill, retreat, removal bookkeeping, redeploys, leaks +// blocking.js contact blocking, block release, the 隐匿 switch-off after a block +// status.js buffs, catalogue statuses (抵抗, 寒冷 → 冻结, 诱导, 恐惧 …), "同名效果取最高", the buff tick +// combat.js damage / heal / HP loss (damage.js pipeline), projectiles, forced attacks +// queries.js enemy tile index, unit queries (tiles, grid, radius, selectability), players, range rebuilds +// summons.js tokens (summons), devices, stage devices +// tiles.js obstacles, relocation / 【移动】, knocked-out bodies, reserved tiles, tactical points, ground paths +// displacement.js push / pull / displace (受力等级 = force − weight); pushTiles +// economy.js DP, IN_BATTLE bond layers, bounty coins +// events.js client events, snapshot, field meta, fx, the sim log +// util.js fin / clone -import { TICK, ROWS, COLS, BLOCK_RADIUS_SQ, DP_DEFAULTS, DOWN_STATE, FORCED_EXIT, MAX_BATTLE_TIME, MAX_INTERNAL_ERRORS, COLD_FREEZE_DURATION, OBSTACLE_DEVICES, EVENT_BUFFER_CAP, BOSS_ROW_OFFSET, MAX_HOOK_DEPTH, MAX_ALIVE_ENEMIES, LEVITATE_HALF_WEIGHT, RESIST_DEFAULT, RESIST_PALSY_DECAY, PUSH_TILES, PUSH_TILES_EFFECT, PULL_WEAK_SHARE, PULL_CRAWL, PULL_ORIGIN, PULL_STOP_RADIUS, PUSH_DIRECTIONAL_MIN_DIST, AUTO_OP_COOLDOWN, STEALTH_RESTORE } from './constants.js'; -import { GEO, layerGainRoom } from '../../shared/constants.js'; +import { TICK, ROWS, COLS, DP_DEFAULTS, MAX_HOOK_DEPTH, AUTO_OP_COOLDOWN } from './constants.js'; +import { GEO } from '../../shared/constants.js'; import { createRng } from './rng.js'; import { Grid } from './grid.js'; -import { Unit } from './units.js'; -import { makeBuff, STATUS, RESIST_STATUSES } from './buffs.js'; -import { dealDamage as pipeDamage, heal as pipeHeal, applyHpLoss, makeDamageInfo, reduceElement, palsyBuff, elementView, leaderHitCancelled } from './damage.js'; -import { absoluteRangeKeys, canTargetEnemy, extendedGrid, evadesGround, enemyStealthed, stealthOffKey } from './targeting.js'; -import { bodyKeys, bodyInKeys, bodyInRadius } from './body.js'; -import { normDir, mirrorDir, localOrder, localBefore } from './dir.js'; import { ProjectileSystem } from './projectiles.js'; -import { stampFear } from './fear.js'; -import { SkillRuntime } from './skills.js'; -import { updateAlly, updateEnemy, compileRoute, remainingDistance, effectiveProfile, performAttack, acquireTargets } from './ai.js'; -import { resolveProfile } from './professions.js'; -import { unitInfo, snapshotUnits } from './snapshot.js'; -import { toDataSource, normalizeRoute, normalizeStage, normalizeToken, normalizeEnemy } from './simdata.js'; -import { installContent, setupUnitKit } from './content/index.js'; +import { remainingDistance } from './ai.js'; +import { toDataSource, normalizeRoute, normalizeStage } from './simdata.js'; +import { installContent } from './content/index.js'; +import { BattlePlayers } from './battle/players.js'; +import { BattleLifecycle } from './battle/lifecycle.js'; +import { BattleHooks } from './battle/hooks.js'; +import { BattleSpawns } from './battle/spawns.js'; +import { BattleDeploy } from './battle/deploy.js'; +import { BattleBlocking } from './battle/blocking.js'; +import { BattleStatus } from './battle/status.js'; +import { BattleCombat } from './battle/combat.js'; +import { BattleQueries } from './battle/queries.js'; +import { BattleSummons } from './battle/summons.js'; +import { BattleTiles } from './battle/tiles.js'; +import { BattleDisplacement } from './battle/displacement.js'; +import { BattleEconomy } from './battle/economy.js'; +import { BattleEvents } from './battle/events.js'; + +export { pushTiles } from './battle/displacement.js'; const DEFAULT_RECTS = { normal: GEO.NORMAL_RECT, unite: GEO.UNITE_RECT, boss: GEO.BOSS_RECT, hidden: GEO.BOSS_RECT }; -let hookSeq = 0; -let schedSeq = 0; - -/** Finite number or the default (content may pass undefined/NaN/Infinity/strings to helpers). */ -const fin = (v, d) => { const n = typeof v === 'number' ? v : (v == null || v === '' ? NaN : Number(v)); return Number.isFinite(n) ? n : d; }; -/** - * Official push distance (tiles) of a 受力等级 (constants.js PUSH_TILES: ≤ −3 → 0, ≥ 3 → the 3 value); `effect` = a 特效 - * push (PRTS 推与拉's 特效 column, PUSH_TILES_EFFECT: 见行者), else the 弹道 column. - */ -export function pushTiles(level, effect = false) { - const l = Math.round(fin(level, -99)); - if (l <= -3) return 0; - return (effect ? PUSH_TILES_EFFECT : PUSH_TILES)[Math.min(3, l)]; -} - -function clone(v) { - if (v == null || typeof v !== 'object') return v; - if (Array.isArray(v)) return v.map(clone); - const o = {}; - for (const k of Object.keys(v)) o[k] = clone(v[k]); - return o; -} - -const FALLBACK_ENEMY = Object.freeze({ - type: 'enemy', id: 'enemy_unknown', key: 'enemy_unknown', name: '未知敌人', rank: 'NORMAL', maxHp: 2000, atk: 200, def: 100, res: 0, - aspd: 100, bat: 2, rangeRadius: 0, moveSpeed: 1, massLevel: 1, lpr: 1, motion: 'WALK', applyWay: 'MELEE', dmgType: 'phys', - immune: new Set(), tauntLevel: 0, blockCnt: 1, epResistance: 0, epDamageResistance: 0, hpRecoveryPerSec: 0, notCountInTotal: false, - tags: [], abilities: [], skills: [], talent: {}, spine: 'unknown', avatar: 'unknown', raw: {}, -}); export class Battle { constructor(opts = {}) { @@ -125,11 +121,11 @@ export class Battle { this.reason = null; this.started = false; this._startDeploying = false; - /** @type {Unit[]} every unit ever created */ + /** @type {import('./units.js').Unit[]} every unit ever created */ this.units = []; - /** @type {Unit[]} alive enemies (compacted each tick) */ + /** @type {import('./units.js').Unit[]} alive enemies (compacted each tick) */ this.enemies = []; - /** @type {Unit[]} every ally unit (ops, tokens, devices; dead included) */ + /** @type {import('./units.js').Unit[]} every ally unit (ops, tokens, devices; dead included) */ this.allyUnits = []; this._hooks = Object.create(null); this._emitDepth = 0; @@ -176,2287 +172,17 @@ export class Battle { if (typeof opts.setup === 'function') this._safe(() => opts.setup(this), 'opts.setup'); } - // ============================================================================================================= - // players & units - - _addPlayer(p) { - const bossLike = this.kind === 'boss' || this.kind === 'hidden'; - const side = p.side === 'R' ? 'R' : 'L'; - const mirror = bossLike && side === 'R'; - const ps = { - playerId: p.playerId, - seat: p.seat ?? this.players.length, - side, - colOffset: Number(p.colOffset) || 0, - rowOffset: p.rowOffset, - coords: p.coords ?? 'board', - mirror, - facing: mirror ? -1 : 1, - // default direction of this player's units on this field (the FA right side is mirrored: RIGHT ↔ LEFT) - dir: mirror ? 'LEFT' : 'RIGHT', - half: mirror || (Number(p.colOffset) || 0) >= 8 ? 'R' : 'L', - bonds: clone(p.bonds ?? {}), - bandId: p.bandId ?? null, - playerEffects: clone(p.playerEffects ?? []), - lpForBoss: p.lpForBoss ?? null, - dp: this.flags.dpInit, - units: [], - input: p, - }; - this.players.push(ps); - this._perPlayer[ps.playerId] = { - killed: 0, total: 0, leaked: [], perfect: true, layerGains: {}, coins: 0, - damageDealt: 0, bossDamage: 0, healingDone: 0, deaths: 0, unitsEnd: [], unitStats: [], - }; - const late = []; - for (const u of p.units ?? []) { - try { - const unit = this._createAllyFromInput(ps, u); - if (unit && unit.kind === 'token' && !unit.ownerUnit && u.ownerUid != null) late.push([unit, u]); - } catch (e) { this._internalError('createUnit', e); } - } - // a token piece listed before its owner (board order is top→bottom) is linked once every unit exists, and takes - // the owner-level variant (elite owners: `_b` stats) of the owner's loadout (DESIGN §16) - for (const [t, inp] of late) { - const owner = ps.units.find((x) => x.kind === 'op' && x.uid === inp.ownerUid); - if (!owner) continue; - t.ownerUnit = owner; - const def = inp.def ? null : this._tokenDef(inp.tokenId ?? inp.chessId, owner, null); - if (!def || def === t.def) continue; - const st = def.stats; - t.def = def; t.defId = def.id; t.name = def.name; t.rangeGrid = def.rangeGrid; - Object.assign(t.base, { - maxHp: st.maxHp, atk: st.atk, def: st.def, res: st.res, aspd: st.aspd, bat: st.bat, blockCnt: st.blockCnt, spRecovery: st.spRecovery, - tauntLevel: st.tauntLevel, massLevel: st.massLevel, hpRecoveryPerSec: st.hpRecoveryPerSec, cost: st.cost, respawnTime: st.respawnTime, - }); - t.markDirty(); - t.hp = t.s.maxHp; - } - } - - /** Board → field tile for a player (see header). */ - mapTile(ps, row, col, abs = false) { - if (abs || ps.coords === 'field') return [row, col]; - const bossLike = this.kind === 'boss' || this.kind === 'hidden'; - let r = row; - if (ps.rowOffset != null) r = row + ps.rowOffset; - else if (bossLike && row >= 7) r = row + BOSS_ROW_OFFSET; - const c = ps.mirror ? (col <= 10 ? COLS - 1 - col : col) : col + ps.colOffset; - return [r, c]; - } - - /** - * Board direction → field direction for a player (DESIGN §3): as given (default RIGHT) except on the mirrored Final - * Assault right side, where RIGHT ↔ LEFT (UP / DOWN unchanged). `abs` / field coordinates are taken as they are. - */ - mapDir(ps, dir, abs = false) { - const d = normDir(dir); - return ps && ps.mirror && !abs && ps.coords !== 'field' ? mirrorDir(d) : d; - } - - _createAllyFromInput(ps, inp) { - // coerce (a string row would otherwise concatenate: "10" + -7 → "10-7"); non-integers never deploy - const row = Number(inp.row), col = Number(inp.col); - if (!Number.isInteger(row) || !Number.isInteger(col)) { this.log(`bad tile ${inp.row},${inp.col} for ${inp.chessId ?? inp.tokenId}`); return null; } - const [r, c] = this.mapTile(ps, row, col, !!inp.abs); - const dir = this.mapDir(ps, inp.dir, !!inp.abs); - if (inp.kind === 'token') { - const owner = inp.ownerUid != null ? ps.units.find((x) => x.uid === inp.ownerUid) : null; - const def = this._tokenDef(inp.tokenId ?? inp.chessId, owner, inp.def); - if (!def) { this.log(`unknown token ${inp.tokenId}`); return null; } - const u = this._makeAlly(ps, def, 'token', r, c, { uid: inp.uid, ownerUnit: owner, dir }); - u.carry = inp.carryState ?? null; - return u; - } - // the unit's own loadout (DESIGN §16): an entry without loadout fields is the DEFAULT — never another player's - // choice for the same chess id in a multi-player field (the per-battle data view maps id-only lookups) - const def = this.data.getChess(inp.chessId, { skillIndex: inp.skillIndex ?? null, moduleId: inp.moduleId ?? null }); - if (!def) { this.log(`unknown chess ${inp.chessId}`); return null; } - const u = this._makeAlly(ps, def, 'op', r, c, { uid: inp.uid, dir }); - u.items = [...(inp.items ?? [])]; - u.carry = inp.carryState ?? null; - return u; - } - - /** - * Token def: an inline def (PlayerBattleInput `def`, spawnToken `opts.def`) as given, else the data record's variant - * for the owner — `owner` = the owning ally unit (its chess and its selected skill / module: getToken(id, - * owner.defId, owner.def.loadout), DESIGN §16), a chess id, or null. - */ - _tokenDef(tokenId, owner, inline) { - if (inline) return normalizeToken(tokenId, inline); - if (!this.data.getToken) return null; - if (owner && typeof owner === 'object') return this.data.getToken(tokenId, owner.defId ?? null, owner.def?.loadout ?? null); - return this.data.getToken(tokenId, owner ?? null); - } - - _makeAlly(ps, def, kind, r, c, extra = {}) { - const st = def.stats; - const u = new Unit({ - id: ++this._idSeq, side: 'ally', kind, def, defId: def.id, name: def.name, ownerId: ps ? ps.playerId : null, - uid: extra.uid ?? null, ownerUnit: extra.ownerUnit ?? null, x: c, y: r, tileR: r, tileC: c, - dir: extra.dir != null ? normDir(extra.dir) : extra.facing != null ? normDir(extra.facing) : ps ? ps.dir : 'RIGHT', - base: { - maxHp: st.maxHp, atk: st.atk, def: st.def, res: st.res, aspd: st.aspd, bat: st.bat, blockCnt: st.blockCnt, - moveSpeed: 0, spRecovery: st.spRecovery, tauntLevel: st.tauntLevel, massLevel: st.massLevel, - hpRecoveryPerSec: st.hpRecoveryPerSec, cost: st.cost, respawnTime: st.respawnTime, - }, - }); - u.alive = false; - u.deployed = false; - u.items = []; - u.rangeGrid = def.rangeGrid; - u.player = ps; - this.units.push(u); - this.allyUnits.push(u); - if (ps) ps.units.push(u); - return u; - } - - /** Resolve kit/profile/skill for a unit (called by content/index.js; safe to call again). */ - _setupUnit(u, kit = null) { - if (!kit) { - try { kit = setupUnitKit(this, u, this.contentMode); } catch (e) { this._internalError('setupUnitKit', e); kit = null; } - } - u.kit = kit || {}; - u.profile = resolveProfile(u.def, u.kit.trait || null); - if (u.def.untargetable) this.addBuff(u, { key: 'trait:untargetable', flags: { untargetable: true }, persist: true, allowDead: true }); - // abnormal effects a summon holds (tokens.json `abnormal`, PRTS; user playtest #6 item 18): 禁疗 — no heal reaches it; - // 孤立 ("无法被同阵营选中") — no ally heal or ally selection (auras over a range) reaches it - const ab = u.def.abnormal; - if (Array.isArray(ab) && ab.length) { - const flags = {}; - if (ab.includes('healFree')) flags.noHeal = true; - if (ab.includes('isolated')) { flags.isolated = true; flags.noHeal = true; } - if (Object.keys(flags).length) this.addBuff(u, { key: 'trait:abnormal', flags, persist: true, allowDead: true }); - } - const spec = u.kit.skill || null; - u.skill = new SkillRuntime(this, u, u.def.skill, spec, u.def.skill?.bb ?? {}); - if (u.profile.install && !u._profInstalled) { - u._profInstalled = true; - this._safe(() => u.profile.install(this, u), 'profile.install', u); - } - for (const t of u.kit.talents || []) { - if (t && typeof t.install === 'function') this._safe(() => t.install(this, u), 'talent.install', u); - } - if (typeof u.kit.install === 'function') this._safe(() => u.kit.install(this, u), 'kit.install', u); - return u.kit; - } - - // ============================================================================================================= - // lifecycle - - start() { - if (this.started) return; - this.started = true; - this._safe(() => this._spawnStageDevices(), 'stageDevices'); - // PRTS 卫戍协议/帮助 §作战阶段: "按从上到下>从左到右的顺序部署。优先部署干员，随后为召唤物（如果有）", noted "自卫戍协议： - // 盟约 下半（2026/3/14）起，部署顺序由“从左到右>从下到上”更改为“从上到下>从左到右”" — a scanning order: down each column - // (top first), the columns from left to right; act 1's along each row, the rows from the bottom. It is the order PRTS - // gives the 阿戈尔 devour ("从最先部署（更靠左和靠上的）的【阿戈尔】干员开始", content/bonds/core.js egirOrder) and the one - // act-2 videos show. Per player the operators, left column first, top to bottom within a column (the mirrored right - // boss side from its own left, i.e. the highest field column — PRTS "部署顺序…左右镜像", research 01 §4.3), then the - // summon pieces in the same order. Until 0.1.3 the top row came first (row-major). [ASSUMED] On a shared field (联防, - // boss) the players' fields deploy at the same time (PRTS: one unit after another with a fixed delay, from the battle - // start), so the i-th operators of all players come in together (in `players` order), then the summons likewise - const seq0 = this._deploySeq; - const lists = this.players.map((ps) => ps.units.filter((u) => u.kind === 'op' || u.kind === 'token').slice().sort((a, b) => - (ps.mirror ? b.homeC - a.homeC : a.homeC - b.homeC) || b.homeR - a.homeR || a.id - b.id)); - // a summon piece flagged `deferDeploy` by content (one its owner's loadout does not make — 赫默 on S1 with a drone - // piece —, or a skill's summon when shared/constants.js SKILL_SUMMON_START_DEPLOY is off: content/tokens.js - // dockSkillSummons) stays off the field, its tile reserved (isReservedTile), until content deploys it - // (_startDeploying: a board piece content brings in during this deployment — a tactician's 流形 / 狼群 comes with - // its owner's deploy — takes its 联防 carry on that first deployment too) - this._startDeploying = true; - for (const kind of ['op', 'token']) { - const per = lists.map((l) => l.filter((u) => u.kind === kind && !u.deferDeploy)); - const n = Math.max(0, ...per.map((l) => l.length)); - for (let i = 0; i < n; i++) for (const l of per) if (l[i]) this._safe(() => this._deploy(l[i], { initial: true }), 'initialDeploy', l[i]); - } - this._startDeploying = false; - // 仇恨 (targeting.js sortAllyTargets: the later deployed is attacked first): every summon that came in during the - // initial deployment — also one an operator's deploy brought along (a tactician's 援军, a start-of-battle summon) - // — ranks after all the operators (of every player on the field [ASSUMED]), in the order it came - const summons = this.allyUnits.filter((u) => u.kind === 'token' && u.alive && u.deployed && u.deploySeq > seq0).sort((a, b) => a.deploySeq - b.deploySeq); - for (const t of summons) t.aggroSeq = ++this._deploySeq; - // 联防 (PRTS 卫戍协议/帮助 "部署完成后…上一阶段为退场状态的干员强制退场"): an operator knocked out at the end of its - // own combat is withdrawn right after the deployment — down on its tile, its redeploy timer starting now (re-read - // after battleStart below; DESIGN §5.5). Its HP ratio is the end-of-phase one (0, as after kill()) until it - // redeploys at full HP. - for (const u of this.allyUnits) { - if (u.kind === 'op' && u.alive && u.carry && u.carry.down === true) { - this._safe(() => { u.hp = 0; this.retreat(u, { reason: FORCED_EXIT }); }, 'forcedExit', u); - } - } - this.emit('battleStart', {}); - // redeploy-time effects that start with the battle (机变 征召 "所有干员的再部署时间-50%", added by a battleStart - // handler) cover the operators forced out above too: their timer is re-read with them, as a later knock-out's is - for (const u of this.allyUnits) { - if (u.kind !== 'op' || u.alive || u.removed || u.removeReason !== FORCED_EXIT) continue; - u.respawnAt = u.deathAt + Math.max(0, u.base.respawnTime * u.persist.redeployMul * u.s.redeployMul); - } - } - - step() { - if (this.finished || this._stepping) return; // re-entrant step() from a hook is a no-op - // forceEnd() requested while stepping (content hook, repeated engine errors) is deferred to the end of the - // current phase: the remaining phases are skipped and the result is built once, so nothing mutates it later. - this._stepping = true; - try { - if (!this.started) this._phase('start', () => this.start()); - const dt = this.dt; - this._phase('scheduled', () => this._runScheduled()); - this._phase('spawns', () => this._processSpawns()); - this._phase('dp', () => { - for (const ps of this.players) ps.dp = Math.min(this.flags.dpMax, ps.dp + this.flags.dpPerSec * dt); - }); - this._phase('buffs', () => this._tickBuffs(dt)); - this._phase('enemies', () => { - // enemies spawned by hooks during this loop start moving next tick (a leak hook that spawns an enemy which - // leaks at once would otherwise loop forever inside a single tick) - const list = this.enemies; - for (let i = 0, n = list.length; i < n && !this._endReq; i++) { - const e = list[i]; - if (!e.alive) continue; - try { updateEnemy(this, e, dt); } catch (err) { this._internalError('updateEnemy', err); } - this._clampPos(e); - } - }); - this._compactEnemies(); - this._phase('enemyIndex', () => this._buildEnemyIndex()); - this._phase('allies', () => { - const list = this.allyUnits; - for (let i = 0; i < list.length && !this._endReq; i++) { - const u = list[i]; - if (!u.alive || !u.deployed) continue; - try { - if (u.skill) u.skill.tick(dt); - if (u.alive && u.kind !== 'device') updateAlly(this, u, dt); - } catch (err) { this._internalError('updateAlly', err); } - } - }); - this._phase('projectiles', () => this.projectiles.update(dt)); - this._phase('redeploy', () => this._checkRedeploys()); - this._phase('boss', () => this._bossSync()); - if (this._hooks.tick) this._phase('tickHook', () => this.emit('tick', { dt })); - this._compactEnemies(); - if (this._toRelease.length) this._releaseRemoved(); - if (!this._endReq && !this.finished) { - this.tickCount++; - this.time = this.tickCount * dt; // no floating drift over long battles - this._phase('endCheck', () => this._checkEnd()); - } - } finally { - this._stepping = false; - } - if (this._endReq && !this.finished) { - try { this.forceEnd(this._endReq); } catch (e) { this._handlerError('internal:forceEnd', null, e); this._hardFinish(this._endReq); } - } - } - - /** Last-resort finish when building the normal result threw (never throws itself). */ - _hardFinish(reason) { - if (this.finished) return; - this.finished = true; - this.reason = reason === 'timeout' ? 'timeout' : 'forced'; - this._endReq = null; - try { this._result = this._buildResult(); } catch { this._result = { time: this.time, reason: this.reason, perPlayer: {}, killed: this.killed, total: this.total, errors: this.errorCount }; } - this.projectiles.clear(); - } - - /** Run until finished or `maxSeconds` of game time elapsed. Returns the result when finished. */ - runToEnd(maxSeconds = MAX_BATTLE_TIME) { - const limit = this.time + maxSeconds; - while (!this.finished && this.time < limit) this.step(); - return this.finished ? this.result() : null; - } - - _phase(name, fn) { - if (this.finished || this._endReq) return; - try { fn(); } catch (e) { this._internalError(name, e); } - } - - _checkEnd() { - if (this.finished) return; - if (this.sharedBoss && this.sharedBoss.hp <= 0) { this._finish('cleared'); return; } - // A boss / hidden field with a shared pool ends only when the pool is empty or the match forces an end (DESIGN - // §5.5) — never merely because it emptied: the h07_04 pair leader (official route: no wait) can walk into the - // objective, and the field then idles while another field may still empty the pool or the overtime drain ends it. - const poolHolds = !!this.sharedBoss && (this.kind === 'boss' || this.kind === 'hidden'); - if (this.autoFinish && !poolHolds && !this._pending.length && !this.enemies.some((e) => e.alive) && this.started) { - if (!this._hasPendingEnemySchedules()) { this._finish('cleared'); return; } - } - if (this.time >= this.timeLimit - 1e-9) { this._timeout(); return; } - if (this.time >= MAX_BATTLE_TIME) { this._timeout(); return; } - } - - _hasPendingEnemySchedules() { - for (const s of this._sched) if (!s.cancelled && s.holdsBattle) return true; - return false; - } - - _timeout() { - // Remaining non-boss enemies on the field count as leaked (DESIGN §5.5). Spawns that never happened before the - // limit are dropped: they are removed from `total` and reported in `result().unspawned` (not leaks). A content-made - // neutral (`mem.noLeak`: 隐德来希's 心烛, which follows its original) is never a leak — it is in no spawn schedule, so - // a client result listing it would be rejected (fields.js validateClientResult 'leak key'). - for (const e of this.enemies) { - if (!e.alive || e.isBoss || e.mem.noLeak) continue; - this._recordLeak(e, true); - } - this.unspawned = []; - for (const p of this._pending) { - if (p.precounted) { - this.total--; - const pp = this._pp(p.ownerPlayerId ?? this._ownerForTile(p.pos ?? this._routeFor(p.routeIndex, p.route)?.start)); - if (pp) pp.total--; - } - this.unspawned.push({ enemyKey: p.enemyKey, time: p.time, tag: p.tag ?? null, sourcePlayerId: p.sourcePlayerId ?? null }); - } - this._pending = []; - this._finish('timeout'); - } - - forceEnd(reason = 'forced') { - if (this.finished) return; - if (this._stepping) { if (!this._endReq) this._endReq = reason; return; } // finalised when step() unwinds - this._endReq = null; - if (!this.started) this.start(); - if (this.finished) return; - if (reason === 'timeout') this._timeout(); - else this._finish('forced'); - } - - _finish(reason) { - if (this.finished) return; - this.finished = true; - this.reason = reason; - this._endReq = null; - const res = this._buildResult(); - this._result = res; - this.emit('battleEnd', { result: res }); - // re-sync fields that battleEnd handlers may have changed (layer gains / coins live in perPlayer objects) - for (const pid of Object.keys(res.perPlayer)) { - const pp = res.perPlayer[pid]; - pp.perfect = !pp.leaked.some((l) => l.counted !== false); - } - this.projectiles.clear(); - } - - _buildResult() { - const perPlayer = {}; - for (const ps of this.players) { - const pp = this._perPlayer[ps.playerId]; - pp.perfect = !pp.leaked.some((l) => l.counted !== false); - // the operators and the board's summon pieces (a board uid): 联防 carries an operator's HP ratio and SP, a summon's - // SP only (match/unite.js). `sp` is the official 技力 — stored charges included (PRTS 技能 "可充能X次…当前技力上限等于该 - // 技能技力需求的X倍"); a running skill spent its SP at activation, so it reports what was left (0 for one charge). - // `skillActive` is reported, never carried. - pp.unitsEnd = ps.units.filter((u) => u.kind === 'op' || (u.kind === 'token' && u.uid != null)).map((u) => ({ - uid: u.uid, id: u.id, defId: u.defId, - hpPct: u.alive ? Math.max(0, Math.min(1, u.hp / u.s.maxHp)) : 0, - sp: u.skill && !u.skill.noSkill ? Math.round(u.skill.spTotal * 100) / 100 : 0, - skillActive: !!(u.skill && u.skill.active && u.skill.kind !== 'passive'), - alive: !!u.alive, - })); - pp.unitStats = ps.units.map((u) => ({ - id: u.id, uid: u.uid, defId: u.defId, name: u.name, kind: u.kind, - dmg: Math.round(u.stats.dmg), kills: u.stats.kills, heal: Math.round(u.stats.heal), taken: Math.round(u.stats.taken), attacks: u.stats.attacks, - })); - perPlayer[ps.playerId] = pp; - } - const res = { time: Math.round(this.time * 1000) / 1000, reason: this.reason, perPlayer, killed: this.killed, total: this.total, errors: this.errorCount }; - if (this.unspawned && this.unspawned.length) res.unspawned = this.unspawned; - if (this.sharedBoss) res.bossHpLeft = Math.max(0, this.sharedBoss.hp); - return res; - } - - /** BattleResult (valid once finished; a provisional result before). */ - result() { - if (this._result) return this._result; - return this._buildResult(); - } - - // ============================================================================================================= - // hook bus - - on(name, fn, opts = {}) { - if (typeof fn !== 'function') return null; - const h = { name, fn, priority: Number(opts.priority) || 0, owner: opts.owner ?? null, seq: ++hookSeq, removed: false, once: !!opts.once }; - const list = this._hooks[name] ?? (this._hooks[name] = []); - let i = list.length; - while (i > 0 && list[i - 1].priority < h.priority) i--; - list.splice(i, 0, h); - return h; - } - - off(nameOrHandle, fn) { - if (nameOrHandle && typeof nameOrHandle === 'object') { - const h = nameOrHandle; - h.removed = true; - const list = this._hooks[h.name]; - if (list) { - const i = list.indexOf(h); - if (i >= 0) list.splice(i, 1); - if (!list.length) delete this._hooks[h.name]; - } - return; - } - const list = this._hooks[nameOrHandle]; - if (!list) return; - for (let i = list.length - 1; i >= 0; i--) if (!fn || list[i].fn === fn) { list[i].removed = true; list.splice(i, 1); } - if (!list.length) delete this._hooks[nameOrHandle]; - } - - /** Remove every hook and scheduled callback registered with `owner`. */ - offOwner(owner) { - for (const name of Object.keys(this._hooks)) { - const list = this._hooks[name]; - for (let i = list.length - 1; i >= 0; i--) if (list[i].owner === owner) { list[i].removed = true; list.splice(i, 1); } - if (!list.length) delete this._hooks[name]; - } - for (const s of this._sched) if (s.owner === owner) s.cancelled = true; - } - - hasHook(name) { return !!this._hooks[name]; } - - emit(name, ctx) { - const list = this._hooks[name]; - if (!list) return ctx; - // Recursion guard: handlers that re-trigger their own event (damaged → dealDamage → damaged …) would otherwise - // recurse until a stack overflow, whose depth (and thus the outcome) depends on the machine — not deterministic. - if (this._emitDepth >= MAX_HOOK_DEPTH) { - this._handlerError(`hookDepth:${name}`, null, new Error(`hook nesting deeper than ${MAX_HOOK_DEPTH}; handlers skipped — ${this._chain(name)}`)); - return ctx; - } - const arr = list.length === 1 ? [list[0]] : list.slice(); - const d = this._emitDepth++; - this._frameCtx[d] = ctx; - try { - for (const h of arr) { - if (h.removed) continue; - this._frameName[d] = name; - this._frameOwner[d] = h.owner; - try { h.fn(ctx, this); } catch (e) { this._handlerError(`hook:${name}`, h.owner, e); } - if (h.once) this.off(h); - if (ctx && ctx.stopPropagation) break; - } - } finally { - this._emitDepth--; - } - return ctx; - } - - /** - * The open hook/callback frames (outermost first) — names the loop when the nesting guard trips, e.g. - * "chain: hit(enemy_1430_lrrook) > damaged(chess_char_3_18_a) > hit(enemy_1430_lrrook) > … > damaged". - */ - _chain(last) { - const id = (u) => (u && typeof u === 'object' ? (u.defId ?? u.name ?? '?') : u == null ? '' : String(u)); - const lab = (i) => { - const o = this._frameOwner[i]; - let who = id(o); - const c = this._frameCtx[i]; - if (!who && c && typeof c === 'object') { // global handler: show the units of the event instead - const a = c.source ?? c.attacker ?? c.killer ?? null, t = c.target ?? c.unit ?? c.victim ?? c.enemy ?? null; - who = a || t ? `${id(a)}→${id(t)}` : ''; - } - return `${this._frameName[i]}${who ? `(${who})` : ''}`; - }; - const n = this._emitDepth; - const parts = []; - for (let i = 0; i < Math.min(n, 4); i++) parts.push(lab(i)); - if (n > 12) parts.push('…'); - for (let i = Math.max(4, n - 8); i < n; i++) parts.push(lab(i)); - parts.push(last); - return `chain: ${parts.join(' > ')}`; - } - - // ============================================================================================================= - // scheduling - - after(seconds, fn, opts = {}) { - const s = { due: this.time + Math.max(0, Number(seconds) || 0), fn, owner: opts.owner ?? null, interval: 0, seq: ++schedSeq, cancelled: false, holdsBattle: !!opts.holdsBattle }; - s.cancel = () => { s.cancelled = true; }; - this._sched.push(s); - return s; - } - - every(seconds, fn, opts = {}) { - const iv = Math.max(TICK, Number(seconds) || TICK); - const s = { due: this.time + (opts.immediate ? 0 : iv), fn, owner: opts.owner ?? null, interval: iv, seq: ++schedSeq, cancelled: false, count: 0, holdsBattle: false }; - s.cancel = () => { s.cancelled = true; }; - this._sched.push(s); - return s; - } - - _runScheduled() { - if (!this._sched.length) return; - const now = this.time + 1e-9; - let due = this._sched.filter((s) => !s.cancelled && s.due <= now); - if (!due.length) { if (this._sched.some((s) => s.cancelled)) this._sched = this._sched.filter((s) => !s.cancelled); return; } - due.sort((a, b) => a.due - b.due || a.seq - b.seq); - for (const s of due) { - if (s.cancelled) continue; - if (s.interval > 0) { - let n = 0; - while (s.due <= now && !s.cancelled && n++ < 8) { - s.count++; - this._safe(() => s.fn(this, s), 'every', s.owner); - s.due += s.interval; - } - if (s.due <= now) s.due = this.time + s.interval; - } else { - s.cancelled = true; - this._safe(() => s.fn(this, s), 'after', s.owner); - } - } - this._sched = this._sched.filter((s) => !s.cancelled); - } - - // ============================================================================================================= - // spawns - - _queueSpawn(s, precount) { - if (Number(s.time) === Infinity) return; // "never" — not scheduled, not counted - // capped: a bogus count (Infinity, 1e9) would otherwise hang the constructor / exhaust memory - const count = Math.min(MAX_ALIVE_ENEMIES, Math.max(1, Math.floor(fin(s.count ?? 1, 1)) || 1)); - const interval = Math.max(0, fin(s.interval, 0)); - const def = this.data.getEnemy(s.enemyKey); - for (let i = 0; i < count; i++) { - const p = { - time: Math.max(0, fin(s.time, 0)) + i * interval, enemyKey: s.enemyKey, routeIndex: s.routeIndex ?? 0, route: s.route ?? null, - mods: s.mods ?? null, sourcePlayerId: s.sourcePlayerId ?? null, bounty: s.bounty ?? null, tag: s.tag ?? null, - ownerPlayerId: s.ownerPlayerId ?? null, pos: s.pos ?? null, seq: ++this._spawnSeq, countInTotal: s.countInTotal, - }; - p.counted = p.countInTotal ?? (!(def && def.notCountInTotal) && p.tag !== 'boss' && p.tag !== 'part'); - if (precount && p.counted) { - this.total++; - const owner = p.ownerPlayerId ?? this._ownerForTile(p.pos ?? this._routeFor(p.routeIndex, p.route)?.start); - const pp = this._pp(owner); - if (pp) pp.total++; - p.precounted = true; - } - this._pending.push(p); - } - } - - _processSpawns() { - const now = this.time + 1e-9; - while (this._pending.length && this._pending[0].time <= now) { - const p = this._pending.shift(); - this._safe(() => this.spawnEnemy(p.enemyKey, { ...p, _precounted: p.precounted }), 'spawnEnemy'); - } - } - - _routeFor(idx, explicit = null) { - if (explicit) return normalizeRoute(explicit); - return this.routes[idx] ?? this.routes[0] ?? this._defaultRoute(); - } - - _defaultRoute() { - if (this._defRoute !== undefined) return this._defRoute; - const starts = this.grid.specialTiles('start'); - const ends = this.grid.specialTiles('end'); - this._defRoute = starts.length && ends.length ? { motion: 'WALK', start: starts[0], end: ends[0], checkpoints: [] } : null; - return this._defRoute; - } - - _ownerForTile(tile) { - if (!this.players.length) return null; - if (this.players.length === 1 || !tile) return this.players[0].playerId; - const c = Array.isArray(tile) ? tile[1] : tile.c; - const half = c >= 11 ? 'R' : 'L'; - return (this.players.find((p) => p.half === half) ?? this.players[0]).playerId; - } - - /** - * Spawn an enemy now. opts: { routeIndex, route, pos:[r,c], mods:{hpMul,atkMul,defMul,resMul,speedMul}, tag, - * sourcePlayerId, ownerPlayerId, bounty:{coins,ownerPlayerId}, countInTotal } - */ - spawnEnemy(enemyKey, opts = {}) { - if (this.enemies.length >= MAX_ALIVE_ENEMIES && this.aliveEnemies().length >= MAX_ALIVE_ENEMIES) { - this._handlerError('spawnEnemy', null, new Error(`more than ${MAX_ALIVE_ENEMIES} living enemies; spawn of ${enemyKey} refused`)); - return null; - } - // opts.def: an inline record (data/enemies.json shape, or an already normalised EnemyDef) for keys absent from data - let def = null; - if (opts.def && typeof opts.def === 'object') { - try { def = opts.def.type === 'enemy' && opts.def.immune instanceof Set ? opts.def : normalizeEnemy(enemyKey, opts.def); } catch (e) { this._handlerError('spawnEnemy.def', null, e); } - } - if (!def) def = this.data.getEnemy(enemyKey); - if (!def) { this.log(`unknown enemy ${enemyKey}`); def = { ...FALLBACK_ENEMY, id: enemyKey, key: enemyKey }; } - const ov = this.enemyOverrides[def.key] ?? this.enemyOverrides[enemyKey]; - if (ov && ov.stats) { - const st = ov.stats; - def = { ...def, - maxHp: Math.max(1, fin(st.maxHp ?? st.hp, def.maxHp)), atk: Math.max(0, fin(st.atk, def.atk)), def: Math.max(0, fin(st.def, def.def)), - res: Math.max(0, fin(st.res, def.res)), moveSpeed: Math.max(0, fin(st.moveSpeed, def.moveSpeed)), - bat: Math.max(0.1, fin(st.bat, def.bat)), aspd: fin(st.aspd, def.aspd) || def.aspd, - rangeRadius: Math.max(0, fin(st.rangeRadius, def.rangeRadius)), massLevel: fin(st.massLevel, def.massLevel), - lpr: fin(st.lpr, def.lpr), blockCnt: Math.max(1, fin(st.blockCnt, def.blockCnt)) }; - } - const route = opts.route ? normalizeRoute(opts.route) : this._routeFor(opts.routeIndex ?? 0); - let start = opts.pos ?? route?.start ?? [this.rect.r0, this.rect.c1]; - if (!Array.isArray(start) || !Number.isFinite(start[0]) || !Number.isFinite(start[1])) start = route?.start ?? [this.rect.r0, this.rect.c1]; - const R = this.rect; // spawn inside the field (same bounds as _clampPos) - start = [Math.max(R.r0 - 0.5, Math.min(R.r1 + 0.5, start[0])), Math.max(R.c0 - 0.5, Math.min(R.c1 + 0.5, start[1]))]; - // multipliers: finite and ≥ 0 (hp > 0), anything else counts as 1 - const mm = (v, pos = false) => { const n = fin(v, 1); return n < 0 || (pos && n <= 0) ? 1 : n; }; - const m0 = opts.mods || {}; - const m = { hpMul: mm(m0.hpMul, true), atkMul: mm(m0.atkMul), defMul: mm(m0.defMul), resMul: mm(m0.resMul), speedMul: mm(m0.speedMul) }; - const e = new Unit({ - id: ++this._idSeq, side: 'enemy', kind: 'enemy', def, defId: def.key ?? enemyKey, name: def.name, - x: start[1], y: start[0], motion: def.motion, - base: { - maxHp: def.maxHp * (m.hpMul ?? 1), atk: def.atk * (m.atkMul ?? 1), def: def.def * (m.defMul ?? 1), res: def.res * (m.resMul ?? 1), - aspd: def.aspd, bat: def.bat, blockCnt: 0, moveSpeed: def.moveSpeed * (m.speedMul ?? 1), spRecovery: 0, - tauntLevel: def.tauntLevel, massLevel: def.massLevel, hpRecoveryPerSec: def.hpRecoveryPerSec, rangeRadius: def.rangeRadius, - }, - }); - e.alive = true; - e.deployed = true; - e.blockWeight = def.blockCnt ?? 1; - e.hitArea = def.hitArea ?? null; // 巨型单位 hit rectangle (body.js); null = a point - e.lpr = def.lpr; - e.mods = opts.mods ?? null; - e.tag = opts.tag ?? null; - e.bounty = opts.bounty ?? null; - e.sourcePlayerId = opts.sourcePlayerId ?? null; - e.ownerId = opts.ownerPlayerId ?? this._ownerForTile(start); - e.spawnX = e.x; e.spawnY = e.y; - e.spawnSeq = ++this._spawnSeq; - e.deploySeq = ++this._deploySeq; - e.deployedAt = this.time; - e.atkCd = 0; - e.pauseUntil = -Infinity; // content holds (暴鸰's drop) - e.atkStandUntil = -Infinity; // standing for its attack clip (ai.js attackStand) - // every enemy profile starts with the same fields (stable object shapes keep the hot loop's property reads fast); - // `dmgType` null = the data's (content may arm a data-unarmed enemy: ai.js enemyAttack) - e.profile = { noAttack: def.dmgType === 'none', maxTargets: 1, atkScale: 1, dmgType: null }; - e.route = { legs: route ? compileRoute(route, this.rect) : [], legIdx: 0, pts: null, ptIdx: 0, suffix: null, version: -1, waitLeft: null }; - if (!e.route.legs.length) { - const end = this.grid.specialTiles('end')[0]; - if (end) e.route.legs.push({ t: 'move', r: end[0], c: end[1], final: true }); - } - e.counted = opts.countInTotal ?? (!def.notCountInTotal && e.tag !== 'boss' && e.tag !== 'part'); - if (e.counted && !opts._precounted) { - this.total++; - const pp = this._pp(e.ownerId); - if (pp) pp.total++; - } - if (e.tag === 'boss') { - e.isBoss = true; - if (this.sharedBoss) { e.bossPool = this.sharedBoss; this._syncBossHp(e); } - } - e.hp = e.bossPool ? e.hp : e.s.maxHp; - this.units.push(e); - this.enemies.push(e); - this._ev(['spawn', unitInfo(e)]); - if (this._hooks.deploy) this.emit('deploy', { unit: e, initial: false }); - if (this._hooks.enemySpawn) this.emit('enemySpawn', { enemy: e }); - return e; - } - - // ============================================================================================================= - // deployment / death / redeploy - - /** - * Deploy `u` on its home tile, or on `tile` ([r, c]: a one-off landing tile — the home stays the board tile; an - * operator that left the field comes back on its body tile, restTile). `keepSp` = { sp, charges } - * restored right after the skill reset, before the `deploy` hook fires. - */ - _deploy(u, { initial = false, carry = null, tile = null, keepSp = null } = {}) { - if ((u.alive && u.deployed) || u._removing) return false; - const R0 = tile ? tile[0] : u.homeR, C0 = tile ? tile[1] : u.homeC; - if (!this.grid.inRect(R0, C0)) { - this.log(`${u} at ${R0},${C0} is outside the field rect; not deployed`); - if (!tile) u.removed = true; - return false; - } - const k = R0 * COLS + C0; - const occ = this._occ[k]; - if (occ && occ !== u && occ.alive && occ.deployed) { this.log(`tile ${R0},${C0} occupied; ${u} not deployed`); return false; } - // "倒地干员所在地块视为可部署，但所有我方单位在此处的部署行为将被阻止" (PRTS 卫戍协议/帮助 §作战阶段 单位部署) - if (this.downOn(R0, C0, u)) { this.log(`a knocked-out operator lies on ${R0},${C0}; ${u} not deployed`); return false; } - const first = u.deploySeq === 0; - u.alive = true; - u.deployed = true; - u.removed = false; - u.hidden = false; - u.body = null; - u.x = C0; u.y = R0; u.tileR = R0; u.tileC = C0; - u.blocking = []; - u.deploySeq = ++this._deploySeq; - u.aggroSeq = u.deploySeq; - u.deployedAt = this.time; - u.atkCd = 0; - u.lastAttackAt = -Infinity; - u.elem.burn = u.elem.neural = u.elem.necrosis = u.elem.apoptosis = u.elem.erosion = 0; - u.ground = this.grid.isLow(R0, C0) && !this._elevated?.has(k); - u.markDirty(); - u.hp = u.s.maxHp; - // 联防 carry (PRTS 卫戍协议/帮助 §联防阶段 "将对应单位的生命比例、技力修改至与上一阶段结束时相同（召唤物仅修改技力…）"): - // an operator's HP ratio here, the SP in skill.reset and again after the `deploy` hook (below) — a summon's SP only - const cs = initial || (first && this._startDeploying) ? (carry ?? u.carry) : null; - if (cs && u.kind === 'op' && Number.isFinite(cs.hpPct)) u.hp = Math.max(1, u.s.maxHp * Math.max(0.01, Math.min(1, cs.hpPct))); - this._occ[k] = u; - this._refreshRange(u); // also rebuilds baseRangeKeys (initial range incl. permanent rangeExtend) - if (!u.skill) this._setupUnit(u); - u.skill.reset(cs); - const sk = u.skill; - // "自动操作具有3s冷却，在完成一次操作或作战开始时部署的单位将进入冷却" (PRTS 卫戍协议/帮助; skills.js) - if (initial) sk.opReadyAt = this.time + this.flags.startOpCooldown; - if (keepSp && !sk.noSkill && sk.kind !== 'passive' && !sk.active) { - sk.charges = Math.max(0, Math.min(sk.maxCharges, Math.floor(fin(keepSp.charges, 0)))); - sk.sp = Math.max(0, Math.min(sk.spCost, fin(keepSp.sp, 0))); - if (sk.charges >= sk.maxCharges) sk.sp = sk.spCost; - } - if (first) this._ev(['spawn', unitInfo(u)]); - this._ev(['deploy', u.id]); - if (this._hooks.deploy) this.emit('deploy', { unit: u, initial }); - // 联防: "部署完成后，将对应单位的…技力修改至与上一阶段结束时相同" — the carried SP is set again once the deployment is - // done, so a deploy-time SP gift (独行, 黄沙罗盘 …) does not come on top of it; later redeploys keep those gifts - if (cs && Number.isFinite(cs.sp) && u.alive && u.skill) u.skill.setSpTotal(cs.sp); - return true; - } - - /** Mark `unit` dead (hp reached 0). Fires `kill` then `death`. */ - kill(unit, killer = null) { - if (!unit || !unit.alive) return; - unit.hp = 0; - if (this._hooks.kill) this.emit('kill', { killer, victim: unit }); - // a nested kill/retreat inside the handlers already removed it: a later handler's hp write must not stick - if (!unit.alive) { if (!unit.bossPool) unit.hp = 0; return; } - if (unit.hp > 0 && !unit.bossPool) { // revived by a kill handler (clamped: a handler may write any number) - unit.hp = Math.min(unit.hp, unit.s.maxHp); - return; - } - unit.hp = 0; // NaN / negative writes from handlers - this._remove(unit, 'killed', killer); - } - - /** - * Withdraw an ally without a kill (it may redeploy after its respawn time): an operator lies down where it stood and - * comes back there (isDown, GitHub #60) — unless `permanent`, or the 突袭 retreat ('raid') that redeploys it at once. - */ - retreat(unit, { reason = 'retreat', permanent = false } = {}) { - if (!unit || !unit.alive || unit.side !== 'ally') return; - this._remove(unit, reason, null, permanent); - } - - _remove(unit, reason, killer = null, permanent = false) { - unit.alive = false; - unit.removeReason = reason; - unit.deployed = false; - unit.deathAt = this.time; - // while the removal bookkeeping runs, a skill onEnd handler must not redeploy the unit (it would come back - // alive but without its tile in _occ, its buffs wiped and a respawn timer pending) — redeploy from `death` instead - unit._removing = true; - if (unit.skill && unit.skill.active) { - this._safe(() => unit.skill.end('death'), 'skill.end', unit); - unit.skill.active = false; - } - unit._removing = false; - if (unit.side === 'ally') { - this.releaseBlocked(unit); - const k = unit.tileR * COLS + unit.tileC; - if (this._occ[k] === unit) this._occ[k] = null; - // keep persistent buffs only - const kept = []; - for (const b of unit.buffs) { - if (b.persist) kept.push(b); - else if (b.visible || b.status) this._ev(['status', unit.id, b.status ?? b.key, 0]); - } - unit.buffs = kept; - unit.markDirty(); - if (unit.kind === 'op' && !permanent) { - if (reason === 'killed') { const pp = this._pp(unit.ownerId); if (pp) pp.deaths++; } - const mul = unit.persist.redeployMul * unit.s.redeployMul; - unit.respawnAt = this.time + Math.max(0, unit.base.respawnTime * mul); - if (this.isDown(unit)) this._layBody(unit); // before `die` / `death`: the body's tile is final for them - } else { - unit.removed = true; - } - if (unit.kind === 'device' && unit.obstacle) this.grid.setObstacle(unit.tileR, unit.tileC, false, unit.obstacleKind); - } else { - unit.removed = true; - this._unblock(unit); - this._enemiesDirty = true; - if (reason === 'killed') { - if (unit.counted) { - this.killed++; - const pp = this._pp(unit.ownerId); - if (pp) pp.killed++; - } - if (killer) killer.stats.kills++; - if (unit.bounty && unit.bounty.coins > 0) { - const payee = killer && killer.side === 'ally' && killer.ownerId != null ? killer.ownerId : (unit.bounty.ownerPlayerId ?? unit.ownerId); - this.addCoins(payee, unit.bounty.coins); - } - } - } - // the reason ('killed' | 'retreat' | 'expired' | …) lets the client keep the knock-down sound for real knock-outs - if (reason !== 'leak') this._ev(['die', unit.id, reason]); - if (this._hooks.death) this.emit('death', { unit, reason, killer }); - if (unit.removed) this._toRelease.push(unit); - } - - /** - * Drop hooks and periodic timers (`every`) owned by permanently removed units (killed/leaked enemies, expired - * tokens, destroyed devices). Runs at the end of the step, so the unit's own death/leak handlers still fire; - * one-shot `after` callbacks are kept (they run once and are gone). Without this, per-enemy content hooks pile up - * and every emit walks the handlers of every enemy that ever spawned. - */ - _releaseRemoved() { - const set = new Set(); - for (const u of this._toRelease) if (u.removed && !u.alive) set.add(u); - this._toRelease = []; - if (!set.size) return; - for (const name of Object.keys(this._hooks)) { - const list = this._hooks[name]; - let w = 0; - for (let i = 0; i < list.length; i++) { - const h = list[i]; - if (h.owner != null && set.has(h.owner)) h.removed = true; - else list[w++] = h; - } - list.length = w; - if (!w) delete this._hooks[name]; - } - for (const sc of this._sched) if (sc.interval > 0 && sc.owner != null && set.has(sc.owner)) sc.cancelled = true; - } - - /** - * Immediately redeploy a dead (or retreated) ally on its rest tile (restTile: where an operator that left the field - * lies, else its home tile). opts: - * free=true no DP cost (false: pays `base.cost`, refused when the player lacks the DP) - * tile=[r,c] land on this in-rect tile instead (the home stays the board tile); refused (false) when the tile is - * outside the rect, a living unit stands there or another knocked-out operator lies there — no fallback - * keepSp keep the SP / charges the unit had (保留技力): restored before the `deploy` hook fires - * Returns true when the unit was deployed (full HP, `deploy {initial:false}` fires). - */ - redeploy(unit, { free = true, tile = null, keepSp = false } = {}) { - if (!unit || unit.side !== 'ally' || unit.alive || unit.removed) return false; - let at = null; - if (tile != null) { - if (!Array.isArray(tile) || !Number.isInteger(tile[0]) || !Number.isInteger(tile[1]) || !this.grid.inRect(tile[0], tile[1])) return false; - at = [tile[0], tile[1]]; - } else { - const rest = this.restTile(unit); - if (rest[0] !== unit.homeR || rest[1] !== unit.homeC) at = rest; - } - const k = at ? at[0] * COLS + at[1] : unit.homeR * COLS + unit.homeC; - const occ = this._occ[k]; - if (occ && occ.alive && occ !== unit) return false; - if (at && this.downOn(at[0], at[1], unit)) return false; - const ps = this.getPlayer(unit.ownerId); - const cost = unit.base.cost; - let paid = 0; - if (!free) { - if (!ps || ps.dp + 1e-9 < cost) return false; - paid = Math.min(ps.dp, cost); - ps.dp = Math.max(0, ps.dp - cost); // paid before `deploy` fires (handlers see the new DP) - } - const sk = unit.skill; - const keep = keepSp && sk && !sk.noSkill && sk.kind !== 'passive' ? { sp: sk.sp, charges: sk.charges } : null; - if (this._deploy(unit, { initial: false, tile: at, keepSp: keep })) return true; - if (paid > 0 && ps) ps.dp = Math.min(this.flags.dpMax, ps.dp + paid); - return false; - } - - /** - * Automatic redeploys (DESIGN §5.5): an operator that left the field and whose timer is done comes back on its rest - * tile — where it lies ("满足再部署条件时，移除场上的该倒地干员并自动部署至该位置", PRTS 卫戍协议/帮助) — when that tile - * is free and its player has the DP. - */ - _checkRedeploys() { - for (const u of this.allyUnits) { - if (u.alive || u.removed || u.kind !== 'op') continue; - if (this.time + 1e-9 < u.respawnAt) continue; - // the DP first: an operator past its timer mostly waits for DP, and the tile checks scan every ally - const ps = this.getPlayer(u.ownerId); - const cost = u.base.cost; - if (!ps || ps.dp + 1e-9 < cost) continue; - const [r, c] = this.restTile(u); - const occ = this._occ[r * COLS + c]; - if (occ && occ.alive && occ !== u) continue; - if (this.downOn(r, c, u)) continue; - ps.dp = Math.max(0, ps.dp - cost); - this._deploy(u, { initial: false, tile: r === u.homeR && c === u.homeC ? null : [r, c] }); - } - } - - /** Leak: an enemy reached its goal. */ - leak(e) { - if (!e || !e.alive || e.side !== 'enemy') return; - this._recordLeak(e, false); - this._remove(e, 'leak'); - this._ev(['leak', e.id]); - if (this._hooks.enemyLeak) this.emit('enemyLeak', { enemy: e }); - } - - _recordLeak(e, timeout) { - const owner = timeout ? e.ownerId : this._ownerForTile([Math.round(e.y), Math.round(e.x)]) ?? e.ownerId; - const pp = this._pp(owner) ?? this._pp(e.ownerId); - if (pp) { - pp.leaked.push({ enemyKey: e.defId, mods: e.mods ?? null, lpr: e.lpr ?? 1, sourcePlayerId: e.sourcePlayerId ?? e.ownerId, tag: e.tag ?? null, counted: !!e.counted || e.isBoss, boss: e.isBoss || undefined, spawned: true }); - if (e.counted || e.isBoss) pp.perfect = false; - } - if (e.counted) this.leakedCount++; - } - - // ============================================================================================================= - // blocking - - /** - * Try to block enemy `e` where it stands. Returns true if it is (now) blocked. Official contact rule (constants.js - * BLOCK_RADIUS, PRTS 游戏数据基础 §阻挡半径): the enemy's position within the blocker's block radius of the blocker's - * centre (ground 0.7071 — the tile's circumscribed circle, reaching 0.21 tile into the side neighbours; air 0.8944; - * devices 0.4472), and the blocker has free capacity for the enemy's block weight (and may block it at all: a unit on - * a fenced tile blocks no ground enemy, _blockerFor). Checked every tick for every - * unblocked enemy, moving or not, so an enemy overlapping an operator is taken over as soon as its blocker is gone or - * the operator's capacity frees up (user playtest #5 item 4). Several blockers in contact → the nearest [ASSUMED], - * ties → the first in row-then-column scan order. - */ - _checkBlock(e) { - if (e.blockedBy || e.hidden || !e.alive) return !!e.blockedBy; - const f = e.s.flags; - if (f.unblockable || f.levitate || f.fear) return false; - const r0 = Math.round(e.y), c0 = Math.round(e.x); - const w = e.blockWeight ?? 1; - let u = null, bd = Infinity; - const fly = e.isFlying; - for (let r = r0 - 1; r <= r0 + 1; r++) { - if (r < 0 || r >= ROWS) continue; - for (let c = c0 - 1; c <= c0 + 1; c++) { - // a diagonal neighbour's centre is ≥ √0.5 away: out of reach of the ground (and device) radius - if (c < 0 || c >= COLS || (!fly && r !== r0 && c !== c0)) continue; - const o = this._occ[r * COLS + c]; - if (!o || !this._blockerFor(o, e, w)) continue; - const d2 = (e.x - c) * (e.x - c) + (e.y - r) * (e.y - r); - const r2 = o.kind === 'device' ? BLOCK_RADIUS_SQ.device : fly ? BLOCK_RADIUS_SQ.fly : BLOCK_RADIUS_SQ.ground; - if (d2 < r2 && d2 < bd) { u = o; bd = d2; } - } - } - if (!u) return false; - e.blockedBy = u; - u.blocking.push(e); - e.moving = false; - if (this._hooks.blocked) this.emit('blocked', { blocker: u, enemy: e }); - return true; - } - - /** - * The enemies ally `u` blocks that it may target with `profile` — always selectable by their blocker, inside its range - * or not, whatever its facing ("可以选择且优先选择阻挡单位", PRTS 选择器; ai.js acquireTargets, the skills' DEFAULT - * trigger). That holds for a ranged operator on a melee tile too: the user's rule after playtest #6, "阻挡了就一定要能 - * 打到" — officially the collision pushes a blocked enemy to its blocker's front, so whatever blocks an enemy can hit - * it (DESIGN §20; it replaces the playtest #5 QA's melee-only restriction). Only for attacks that hit enemies: a heal - * attack never asks — it keeps selecting injured allies while its unit blocks (PRTS 卫戍协议/帮助 "对于医疗干员 - * （咒愈师分支除外），攻击目标为需要治疗的单位"; PRTS 选择器 adds only the blocked units its side can pick). - */ - blockedTargets(u, profile) { - const out = []; - if (!u || !u.blocking || !u.blocking.length) return out; - for (const e of u.blocking) if (e.blockedBy === u && canTargetEnemy(u, e, profile)) out.push(e); - return out; - } - - /** - * Can ally/device `u` block enemy `e` (block weight `w`) right now — everything but the contact distance. A unit on a - * tile ground units cannot pass blocks no ground enemy: the fenced tiles (围墙 tile_fence_bound / 围栏 tile_fence — - * low ground, deployable, passable to flyers only) — PRTS 围墙 / 围栏 地形机制 "部署在其中的单位，若当前阻挡类型为'地面 - * 阻挡'则无法阻挡敌人". The gate reads the tile's ground passability; on the stages the fenced tiles are the only low - * tiles ground units cannot pass. Air blocking (blockFly against flyers) stays [ASSUMED: PRTS restricts the rule to - * 地面阻挡]. Nothing walks onto such a tile, so it matters for an enemy pushed or pulled against the fence - * (Battle.displace stops it at the tile edge, 0.5 from the fenced unit — inside the ground block radius). An airborne - * unit (起飞, flag `liftoff`: "不阻挡地面敌人…可以阻挡飞行敌人") blocks flyers only. - */ - _blockerFor(u, e, w) { - if (!u.alive || !u.deployed || u.hidden || u.s.flags.noBlock || u.s.flags.sleep) return false; - if (e.isFlying && !(u.s.flags.blockFly || (u.profile && u.profile.blockFly))) return false; - // ground enemies: only a ground unit that has not taken off (起飞 "不阻挡地面敌人": flag `liftoff`), standing on a tile - // ground units can pass (not a fenced 围墙 / 围栏 tile) - if (!e.isFlying && (!u.ground || u.s.flags.liftoff || this.grid.tile(u.tileR, u.tileC).pass !== 'ALL')) return false; - const cap = u.s.blockCnt; - if (cap <= 0) return false; - let used = 0; - for (const x of u.blocking) used += x.blockWeight ?? 1; - return used + w <= cap; - } - - _unblock(e) { - const bl = e.blockedBy; - if (!bl) return; - const i = bl.blocking.indexOf(e); - if (i >= 0) bl.blocking.splice(i, 1); - e.blockedBy = null; - this._stealthSwitch(e); - } - - /** Release every enemy blocked by ally `u` (death, retreat, block count drop, substitution…). */ - releaseBlocked(u) { - if (!u || !u.blocking || !u.blocking.length) return; - const was = u.blocking; - u.blocking = []; - for (const e of was) if (e.blockedBy === u) { e.blockedBy = null; this._stealthSwitch(e); } - } - - /** - * A block on enemy `e` just ended (every release goes through here: `_unblock`, `releaseBlocked`, ai.js - * enforceBlockCapacity). Each 隐匿 source it holds stays switched off for its restore time — PRTS 作战机制 §隐匿 "对于 - * 绝大部分可隐匿的敌人而言，在被我方单位阻挡后会解除隐匿，不被阻挡的3秒后重新进入隐匿" (STEALTH_RESTORE), or the source's - * own "（解除阻挡N秒后恢复）" (buff `data.stealthRestore`, content/enemies.js: 0 s / 1 s on some enemy pages) — as a - * `stealthOff` buff per source; meanwhile it is targetable, operator splash reaches it and it is drawn solid - * (targeting.js enemyStealthed). A new block inside the window lifts it again and its end restarts the window. Our - * operators' 隐匿 / 迷彩 are never lifted by blocking (only enemies get here). - */ - _stealthSwitch(e) { - if (!e || e.side !== 'enemy' || !e.alive || !e.s.flags.stealth) return; - for (const b of e.buffs.slice()) { - if (!b.flags || !b.flags.stealth) continue; - const t = Number.isFinite(b.data?.stealthRestore) ? b.data.stealthRestore : STEALTH_RESTORE; - if (t > 0) this.addBuff(e, { key: stealthOffKey(b.key), duration: t, flags: { stealthOff: true } }); - } - } - - // ============================================================================================================= - // buffs & statuses - - addBuff(unit, b) { - if (!unit || (!unit.alive && !b.allowDead)) return null; - const buff = makeBuff(b); - const list = unit.buffs; - let idx = -1; - for (let i = 0; i < list.length; i++) if (list[i].key === buff.key) { idx = i; break; } - if (idx >= 0 && buff.refresh !== 'independent') { - const old = list[idx]; - switch (buff.refresh) { - case 'keep': - return old; - case 'stack': - old.stacks = Math.min(old.stacks + buff.stacks, Math.max(old.maxStacks, buff.maxStacks)); - old.maxStacks = Math.max(old.maxStacks, buff.maxStacks); - old.timeLeft = buff.duration; - old.duration = buff.duration; - if (buff.mods) old.mods = buff.mods; - if (buff.flags) old.flags = buff.flags; - unit.markDirty(); - return old; - case 'extend': - old.timeLeft = Math.max(old.timeLeft, buff.duration); - old.duration = Math.max(old.duration, buff.duration); - if (buff.mods) old.mods = buff.mods; - if (buff.flags) old.flags = buff.flags; - if (buff.shield > old.shield) old.shield = buff.shield; - if (buff.shieldHits > old.shieldHits) old.shieldHits = buff.shieldHits; - unit.markDirty(); - return old; - default: - list[idx] = buff; - unit.markDirty(); - return buff; - } - } - if (buff.refresh === 'independent') { - const same = list.filter((x) => x.key === buff.key); - if (same.length >= buff.maxStacks) { - const oldest = same.reduce((a, c) => (a.seq < c.seq ? a : c)); - this._removeBuffAt(unit, list.indexOf(oldest), true); - } - } - list.push(buff); - unit.markDirty(); - if (buff.visible || buff.status) { - const key = buff.status ?? buff.key; - if (list.filter((x) => (x.status ?? x.key) === key).length === 1) this._ev(['status', unit.id, key, 1]); - } - return buff; - } - - removeBuff(unit, keyOrBuff) { - if (!unit) return 0; - let n = 0; - for (let i = unit.buffs.length - 1; i >= 0; i--) { - const b = unit.buffs[i]; - if (b === keyOrBuff || b.key === keyOrBuff) { this._removeBuffAt(unit, i, true); n++; } - } - return n; - } - - _removeBuffAt(unit, i, callRemove = true) { - const b = unit.buffs[i]; - if (!b) return; - unit.buffs.splice(i, 1); - unit.markDirty(); - if ((b.visible || b.status)) { - const key = b.status ?? b.key; - if (!unit.buffs.some((x) => (x.status ?? x.key) === key)) this._ev(['status', unit.id, key, 0]); - } - if (callRemove && b.onRemove) this._safe(() => b.onRemove({ battle: this, unit, buff: b }), 'buff.onRemove', unit); - } - - _tickBuffs(dt) { - const units = this.units; - for (let i = 0, n = units.length; i < n; i++) { // units created by onTick handlers start ticking next tick - const u = units[i]; - if (!u.alive || u.removed) continue; - if (u.buffs.length) { - const arr = u.buffs.slice(); - for (const b of arr) { - if (!u.alive) break; - if (u.buffs.indexOf(b) < 0) continue; - if (b.onTick) { - if (b.interval > 0) { - b._acc += dt; - let n = 0; - while (b._acc >= b.interval - 1e-9 && n++ < 8) { - b._acc -= b.interval; - this._safe(() => b.onTick({ battle: this, unit: u, buff: b, dt: b.interval }), 'buff.onTick', u); - } - } else this._safe(() => b.onTick({ battle: this, unit: u, buff: b, dt }), 'buff.onTick', u); - } - if (b.timeLeft !== Infinity) { - b.timeLeft -= dt; - if (b.timeLeft <= 1e-9) { - const i = u.buffs.indexOf(b); - if (i >= 0) { - this._removeBuffAt(u, i, false); - if (b.onExpire) this._safe(() => b.onExpire({ battle: this, unit: u, buff: b }), 'buff.onExpire', u); - } - } - } - } - } - // natural HP regeneration - if (u.alive && u.deployed && !u.bossPool) { - const regen = u.s.hpRegen; - if (regen > 0 && u.hp < u.s.maxHp) { - u._regenAcc = (u._regenAcc ?? 0) + regen * dt; - if (u._regenAcc >= 1 || u.hp + u._regenAcc >= u.s.maxHp) { - this.heal(u, u, u._regenAcc, { self: true, silent: true, regen: true }); - u._regenAcc = 0; - } - } - } - } - } - - /** - * Apply a catalogue status. opts: { duration, source, value, force, refresh, point, resistApplied } — returns true - * when applied. Honours enemy immunities (stun/silence/sleep/frozen/levitate/feared) unless `force`. `beforeStatus` - * handlers may cancel it or change `duration` / `value`. Official rules (buffs.js STATUS): 抵抗 (the `resist` status) - * shortens the RESIST_STATUSES by its value (default half; applied after `beforeStatus`; `resistApplied` skips that - * pass — the cold-on-cold 冻结 below already used post-抵抗 lengths). A second 寒冷 while 寒冷 remains applies 冻结 for - * max(remaining, this cold after 抵抗) (PRTS 术语释义 寒冷 「持续时间取双方之中最高」). 浮空 lasts half as long on units heavier - * than LEVITATE_HALF_WEIGHT (current massLevel); 冻结's RES cut hits enemies only; 麻痹 adds stacks; "同名效果取最高" - * statuses (`valued`) keep the strongest value — a weaker application only extends past the stronger one's end (it - * then resumes); other statuses refresh to the longer duration. 诱导 (`attract`) walks the enemy to `point` - * ([r, c] or {x, y}; default the source's tile — a new application moves the point); 恐惧 (`fear`) stamps where it - * was applied and from where (fear.js stampFear: the fan of 恐惧可达地块 its movement uses). A stunned/sleeping operator - * releases the enemies it blocks; a feared/levitated/unblockable/attracted enemy is released by its blocker. - * `statusApplied` reports the final duration and `entered` (the target did not carry the status before). - * A unit that is 无敌 and 无法选中 at once (a 重生 in progress, a hovering or 永久无敌 leader part) takes no status from - * the other side, `force` included — PRTS 无敌 "无法被不同阵营选中": so a status carried by the very hit that knocked an - * enemy out does not land after its 重生's cleanse (DESIGN §21.4). A ground enemy's status never lands on an airborne - * 起飞 ally (对地规避: targeting.js evadesGround) unless `opts.ignoreSelect`. - */ - applyStatus(target, key, opts = {}) { - if (!target || !target.alive) return false; - const src = opts.source; - if (src && src.side && src.side !== target.side && target.s.flags.invulnerable && target.s.flags.untargetable) return false; - if (!opts.ignoreSelect && target.s.flags.liftoff && evadesGround(src, target)) return false; - const tpl = STATUS[key] || { flags: { [key]: true } }; - let duration = opts.duration == null ? Infinity : Number(opts.duration); - let value = opts.value; - if (!(duration > 0)) return false; - const immune = target.def && target.def.immune; - if (!opts.force && tpl.immune && immune && immune.has(tpl.immune)) return false; - // 浮空 Buff (PRTS 异常效果: "若单位数据上为飞行单位且不持有缚地异常或是持有浮空异常则Buff取消"; 行动方式 "行动类型（数据）为 - // 飞行的单位、以及已持有浮空异常的单位无法被施加浮空Buff"): refused on data flyers (`motion` FLY) and units already - // levitated — a hovering 近地悬浮 enemy is WALK in its data, so it can be levitated (no 缚地 / 浮空强化 in this mode) - if (key === 'levitate' && (target.motion === 'FLY' || target.s.flags.levitate)) return false; - if (this._hooks.beforeStatus) { - const c = this.emit('beforeStatus', { source: opts.source ?? null, target, status: key, duration, value, cancel: false }); - if (c.cancel || !target.alive) return false; - const d = Number(c.duration); - if (d === Infinity || (Number.isFinite(d) && d > 0)) duration = d; - else if (Number.isFinite(d) && d <= 0) return false; - value = c.value; - } - if (RESIST_STATUSES.has(key) && !opts.resistApplied) { - const rv = this.resistOf(target); - if (rv > 0) duration *= 1 - rv; - } - if (key === 'levitate' && target.s.massLevel > LEVITATE_HALF_WEIGHT) duration /= 2; - if (!(duration > 0)) return false; - if (key === 'cold' && target.findBuff('cold') && !(immune && immune.has('frozen'))) { - // PRTS 术语释义 寒冷: 友方寒冷 pairs into 冻结, 「持续时间取双方之中最高」. `duration` is this cold after 抵抗; - // the cold already on the target keeps timeLeft. addBuff refresh 'extend' below sets that cold to the same max. - // COLD_FREEZE_DURATION is only the fallback when neither side has a duration. resistApplied: that max is already - // post-抵抗, so the freeze must not be halved again. - // [ASSUMED] one catalogue cold, so an enemy-applied second cold uses this max too. PRTS states it on the 友方 - // line only (敌方 cold becomes 冻结 when the target already has 敌方 cold or 敌方 冻结). - const prev = target.findBuff('cold'); - const spans = [prev.timeLeft, duration].filter((t) => t === Infinity || (Number.isFinite(t) && t > 0)); - const freezeFor = spans.length ? Math.max(...spans) : COLD_FREEZE_DURATION; - this.applyStatus(target, 'freeze', { - duration: freezeFor, source: opts.source, force: opts.force, - ...(spans.length ? { resistApplied: true } : {}), - }); - if (!target.alive) return false; - } - const source = opts.source ?? null; - let entered = true; - for (const b of target.buffs) if ((b.status ?? b.key) === key) { entered = false; break; } - if (tpl.palsy) { - this.addBuff(target, { ...palsyBuff(value ?? 1), duration, source }); - } else if (tpl.valued != null && typeof tpl.mods === 'function' && opts.refresh == null) { - this._applyValuedStatus(target, key, tpl, duration, value ?? tpl.valued, source); - } else { - const mods = tpl.enemyOnlyMods && target.side !== 'enemy' ? null : typeof tpl.mods === 'function' ? tpl.mods(value) : (tpl.mods || null); - const b = this.addBuff(target, { key, duration, refresh: opts.refresh ?? 'extend', mods, flags: tpl.flags || null, status: key, visible: true, source }); - if (tpl.attract && b) this._setAttractPoint(target, b, opts.point ?? value, source); - // 恐惧: the hit position and the source's position of every application (fear.js — the fan of reachable tiles) - if (key === 'fear' && b && target.side === 'enemy') stampFear(this, target, b, source); - } - const f = tpl.flags; - if (f && target.side === 'enemy' && (f.levitate || f.unblockable || f.fear)) this._unblock(target); - if (f && target.side === 'ally' && f.noBlock) this.releaseBlocked(target); - if (this._hooks.statusApplied) this.emit('statusApplied', { source, target, status: key, duration, value, entered }); - return true; - } - - /** 抵抗 of a unit: share of a resisted status's duration removed (0 = none; the `resist` status value, ≤ 0.95). */ - resistOf(unit) { - if (!unit || !unit.buffs.length) return 0; - let r = 0; - for (const b of unit.buffs) { - if (b.status !== 'resist') continue; - const v = Number.isFinite(b.data?.value) ? b.data.value : RESIST_DEFAULT; - if (v > r) r = v; - } - return Math.min(0.95, r); - } - - /** 诱导 target point of an `attract` status buff (enemy walks there; see ai.js moveAttracted). */ - _setAttractPoint(target, buff, point, source) { - let r = null, c = null; - if (Array.isArray(point) && Number.isFinite(point[0]) && Number.isFinite(point[1])) { r = point[0]; c = point[1]; } - else if (point && typeof point === 'object' && Number.isFinite(point.x) && Number.isFinite(point.y)) { r = point.y; c = point.x; } - else if (source && Number.isFinite(source.x) && Number.isFinite(source.y)) { r = source.y; c = source.x; } - if (r == null) { if (!buff.data.attract) buff.data = { ...buff.data, attract: null }; return; } - const R = this.rect; - r = Math.max(R.r0, Math.min(R.r1, Math.round(r))); - c = Math.max(R.c0, Math.min(R.c1, Math.round(c))); - buff.data = { ...buff.data, attract: { r, c, pts: null, i: 0, ver: -1 } }; - } - - /** - * "同名效果取最高" for a content effect that is not a catalogue status (no immunities, 抵抗, `beforeStatus` / - * `statusApplied` hooks or status icon): ONE instance of `key` per target whatever the number of sources — the - * strongest `value` applies, a weaker application only extends past the stronger one's end (it then resumes), an - * equal one refreshes to the longer duration. `mods(value)` builds the buff's mods. The engine's default for two - * same-named buffs (PRTS 作战机制 "同名buff的默认叠加策略buff只能表现出一个"). Returns true when applied. - * @param {object} target - * @param {string} key - * @param {{ duration: number, value: number, mods: (v: number) => object, source?: object|null }} opts - */ - applyStrongest(target, key, { duration, value, mods, source = null } = {}) { - if (!target || !target.alive || !(Number(duration) > 0) || !Number.isFinite(value) || typeof mods !== 'function') return false; - this._applyValuedStatus(target, key, { mods, valued: value, plain: true }, Number(duration), value, source); - return true; - } - - /** - * "同名效果取最高": keep the strongest value; a weaker one that outlasts it resumes afterwards (buff.data.tail). A - * `plain` template (applyStrongest) is an ordinary invisible buff, not a status. - */ - _applyValuedStatus(target, key, tpl, duration, value, source) { - const strength = (v) => Math.abs(Number.isFinite(v) ? v : tpl.valued); - const make = (v, dur, tail) => ({ - ...(tpl.buff || null), // extra buff fields of the status (抵抗: the 麻痹 decay tick) - key, duration: dur, refresh: 'replace', mods: tpl.mods(v), flags: tpl.flags || null, status: tpl.plain ? null : key, - visible: !tpl.plain, source, - data: { value: v, tail }, - onExpire: ({ battle, unit, buff }) => { - const t = buff.data.tail; - if (t && t.until - battle.time > 1e-6 && unit.alive) battle.addBuff(unit, make(t.value, t.until - battle.time, null)); - }, - }); - const old = target.buffs.find((b) => b.key === key && (tpl.plain || b.status === key)); - if (!old) { this.addBuff(target, make(value, duration, null)); return; } - const oldV = old.data && Number.isFinite(old.data.value) ? old.data.value : tpl.valued; - const oldEnd = this.time + old.timeLeft, newEnd = this.time + duration; - const oldTail = old.data && old.data.tail; - const longerTail = (a, b) => (!a ? b : !b ? a : (b.until > a.until ? b : a)); - if (strength(value) > strength(oldV) + 1e-12) { - // stronger: takes over now; the weaker old one (or its tail) resumes if it lasts longer - const tail = longerTail(oldEnd > newEnd ? { value: oldV, until: oldEnd } : null, oldTail && oldTail.until > newEnd ? oldTail : null); - this.addBuff(target, make(value, duration, tail)); - } else if (strength(value) < strength(oldV) - 1e-12) { - // weaker: never overrides; remembered as the tail when it outlasts the running one - if (newEnd > oldEnd && (!oldTail || newEnd > oldTail.until)) old.data = { ...old.data, value: oldV, tail: { value, until: newEnd } }; - } else if (duration > old.timeLeft) { - old.timeLeft = duration; - old.duration = Math.max(old.duration, duration); - } - } - - removeStatus(target, key) { return this.removeBuff(target, key); } - - // ============================================================================================================= - // damage / heal - - dealDamage(source, target, dmg) { - try { return pipeDamage(this, source, target, dmg); } catch (e) { this._internalError('dealDamage', e); return 0; } - } - - heal(source, target, amount, opts = {}) { - try { return pipeHeal(this, source, target, amount, opts); } catch (e) { this._internalError('heal', e); return 0; } - } - - /** - * HP loss that ignores DEF/RES, dodge and shields (流失). May kill. opts: { source, silent, tags, from } — `from` = the - * DamageInfo this loss derives from (damage passed on to a leader, split, shared…): its tags are inherited and it is - * kept as `dmg.origin`, so `damaged` handlers that skip their own tagged damage also skip what it turned into; a loss - * derived from 无来源 damage (`from.sourceless`, element bursts) is 无来源 too (hooks see no source, `source` is credited). - * `sourceless: true` makes the loss itself 无来源 ("受到等量的无来源生命流失": hooks see no source; `source` keeps the - * credit — the stats and the per-player shared-pool tally). - * On a leader in a boss / hidden battle a loss of ≥ BOSS_HIT_LIMIT is cancelled like a hit (damage.js leaderHitCancelled). - */ - loseHp(target, amount, { source = null, silent = false, tags = null, from = null, sourceless = false } = {}) { - if (!target || !target.alive || !(amount > 0)) return 0; - // 限伤 (shared/constants.js BOSS_HIT_LIMIT): a loss passed on to a leader (parts' 传递, 无人机) is one hit too - if (leaderHitCancelled(this, target, amount)) return 0; - const t = ['hpLoss']; - for (const list of [from && from.tags, tags]) if (Array.isArray(list)) for (const x of list) if (!t.includes(x)) t.push(x); - return applyHpLoss(this, source, target, amount, { type: 'true', tags: t, noSp: true, silent, origin: from ?? null, sourceless: !!sourceless || !!(from && from.sourceless) }); - } - - reduceElement(target, amount, element = null) { return reduceElement(target, amount, element); } - - makeDamage(d) { return makeDamageInfo(d); } - - // ============================================================================================================= - // queries - - /** - * Tile buckets of the living enemies: a regular enemy on the tile of its position, a huge one (body.js) on every tile - * it occupies. - */ - _buildEnemyIndex() { - for (const k of this._ebUsed) this._eb[k].length = 0; - this._ebUsed.length = 0; - for (const e of this.enemies) { - if (!e.alive || e.hidden) continue; - if (e.hitArea) { - for (const k of bodyKeys(e)) { const b = this._eb[k]; if (!b.length) this._ebUsed.push(k); b.push(e); } - continue; - } - const r = Math.round(e.y), c = Math.round(e.x); - if (r < 0 || r >= ROWS || c < 0 || c >= COLS) continue; - const k = r * COLS + c; - const b = this._eb[k]; - if (!b.length) this._ebUsed.push(k); - b.push(e); - } - } - - /** Targetable enemies whose body is on any of `keys` (absolute tile keys; a huge enemy is listed once). */ - enemiesInKeys(keys, attacker, profile) { - const out = []; - if (!keys) return out; - for (let i = 0; i < keys.length; i++) { - const b = this._eb[keys[i]]; - if (!b || !b.length) continue; - for (const e of b) if (e.alive && (!e.hitArea || !out.includes(e)) && canTargetEnemy(attacker, e, profile)) out.push(e); - } - return out; - } - - /** - * A living enemy whose body is on any of `keys` — targetable or not (stealthed, untargetable, asleep, flying): the - * 技能范围 trigger "技能范围内存在敌人（无视其不可选中）" (skills.js SKILL_RANGE). - */ - anyEnemyInKeys(keys) { - if (!keys) return false; - for (let i = 0; i < keys.length; i++) { - const b = this._eb[keys[i]]; - if (b && b.length) for (const e of b) if (e.alive && e.deployed) return true; - } - return false; - } - - /** Allies (not devices) within tiles `keys`, sorted by HP ratio (lowest first) that need healing. */ - injuredAlliesInKeys(keys, healer, includeElement = false) { - const out = []; - if (!keys) return out; - const set = keys instanceof Set ? keys : (healer && healer.rangeKeys === keys && healer.rangeKeySet ? healer.rangeKeySet : new Set(keys)); - for (const a of this.allyUnits) { - if (!a.alive || !a.deployed || a.hidden || a.kind === 'device') continue; - if (!set.has(a.tileR * COLS + a.tileC)) continue; - if (a !== healer && (a.s.flags.noHeal || (a.profile && a.profile.noHeal))) continue; - const injured = a.hp < a.s.maxHp - 1e-6; - const elem = includeElement && (a.elem.burn + a.elem.neural + a.elem.necrosis + a.elem.apoptosis + a.elem.erosion) > 0; - if (injured || elem) out.push(a); - } - out.sort((a, b) => a.hpRatio - b.hpRatio || a.deploySeq - b.deploySeq); - return out; - } - - lowestHpAllyInRange(unit) { - const l = this.injuredAlliesInKeys(unit.rangeKeys, unit); - return l[0] ?? null; - } - - /** Units of the opposite side (or `side`) whose tile is inside `grid` offsets relative to `unit`. */ - unitsInGrid(unit, grid, { side = null, extend = 0 } = {}) { - const keys = absoluteRangeKeys(grid || unit.rangeGrid || [[0, 0]], Math.round(unit.y), Math.round(unit.x), unit.dir, extend); - const want = side ?? (unit.side === 'ally' ? 'enemy' : 'ally'); - const set = new Set(keys); - const out = []; - const list = want === 'enemy' ? this.enemies : this.allyUnits; - for (const x of list) { - if (!x.alive || !x.deployed || x.hidden) continue; - if (bodyInKeys(x, set)) out.push(x); - } - return out; - } - - /** Allies inside `unit`'s current range (for auras) — not the 孤立 ones ("无法被同阵营选中": 炎佑), `unit` aside. */ - alliesInGrid(unit) { - const set = unit.rangeKeySet || new Set(unit.rangeKeys || []); - return this.allyUnits.filter((a) => a.alive && a.deployed && !a.hidden && a.kind !== 'device' && set.has(a.tileR * COLS + a.tileC) && this.allySelectable(a, unit)); - } - - /** - * May an ability of ally `by` select ally `a`? Never a 孤立 unit (炎佑, 从不混淆的方向; flag `isolated`) other than `by` - * itself — PRTS 选择器: selectors decide "天赋是否能给予某个干员Buff" and every heal / buff / aura target, and their 可选判定 - * rejects a 孤立 target of a friendly selector ("若掩码中孤立为1，且选择器的阵营与目标为友好关系，则不可选中"; user playtest #6 - * item 18). Enemies still target it (a hostile selector). 禁疗 only keeps heals off (heal pipeline, injuredAlliesInKeys). - */ - allySelectable(a, by = null) { - return !!a && (a === by || !a.s.flags.isolated); - } - - /** Deployed allies (no devices) an ability of ally `by` may select: allies(ownerId) without the 孤立 ones. */ - alliesFor(by, ownerId = null) { - return this.allies(ownerId).filter((a) => this.allySelectable(a, by)); - } - - /** - * Living enemies whose body (body.js: a huge enemy's hit rectangle, else its position) is within `r` of (x, y). - * `centre` = a 中点判定 radius — splash around a struck / marked target (PRTS 作战机制: "中点判定…案例：阻挡，酒神1天赋的1.3 - * 溅射半径"): every enemy counts by its position (判定中心), a huge one too. - */ - enemiesInRadius(x, y, r, centre = false) { - const out = []; - const r2 = r * r + 1e-9; - for (const e of this.enemies) { - if (!e.alive || e.hidden) continue; - if (e.hitArea && !centre) { if (bodyInRadius(e, x, y, r)) out.push(e); continue; } - const dx = e.x - x, dy = e.y - y; - if (dx * dx + dy * dy <= r2) out.push(e); - } - return out; - } - - /** - * The enemies within `r` (as enemiesInRadius) an ally-side area effect can select — PRTS 作战机制 §AOE伤害判定 "AOE的判定是 - * 对攻击范围内的每个可以被选中的敌人进行判定", 隐匿 "隐匿状态下的单位一般无法被敌方的索敌机制和Buff选择器选中为目标": no - * untargetable enemy and no 隐匿 one unless revealed, blocked or not hidden again yet after a block (targeting.js - * enemyStealthed; tile selectors — enemiesInKeys / canTargetEnemy — already skip them). Flying and asleep enemies stay - * the caller's choice. Enemy-side effects on other enemies (auras, heals) and physical collisions keep enemiesInRadius. - * Player report #8 after 0.1.0 (the 逐火 余烬): until 0.1.1 profession splash and skill circles still reached an - * unblocked 隐匿 enemy. - */ - foesInRadius(x, y, r, centre = false) { - const out = this.enemiesInRadius(x, y, r, centre); - let n = 0; - for (const e of out) { - const f = e.s.flags; - if (f.untargetable || (f.stealth && enemyStealthed(e))) continue; - out[n++] = e; - } - out.length = n; - return out; - } - - /** - * Every deployed ally within `r` of (x, y) — no selection rule: an enemy's area effect selects among them with - * targeting.js areaSelectable (content/enemies.js areaAllies: no 隐匿 ally, the blocker included, GitHub #97; DESIGN §22.12). - */ - alliesInRadius(x, y, r, ownerId = null, { includeDevices = false } = {}) { - const out = []; - const r2 = r * r + 1e-9; - for (const a of this.allyUnits) { - if (!a.alive || !a.deployed || a.hidden) continue; - if (!includeDevices && a.kind === 'device') continue; - if (ownerId != null && a.ownerId !== ownerId) continue; - const dx = a.x - x, dy = a.y - y; - if (dx * dx + dy * dy <= r2) out.push(a); - } - return out; - } - - /** Alive deployed allies (ops + tokens), optionally of one player. */ - allies(ownerId = null) { - return this.allyUnits.filter((a) => a.alive && a.deployed && a.kind !== 'device' && (ownerId == null || a.ownerId === ownerId)); - } - - aliveEnemies() { return this.enemies.filter((e) => e.alive); } - - unitAt(r, c) { const u = this._occ[r * COLS + c]; return u && u.alive ? u : null; } - unitById(id) { return this.units.find((u) => u.id === id) ?? null; } - tileInfo(r, c) { return this.grid.tile(r, c); } - - getPlayer(playerId) { return this.players.find((p) => p.playerId === playerId) ?? null; } - _pp(playerId) { return playerId == null ? null : this._perPlayer[playerId] ?? null; } - - /** - * Recompute a unit's absolute range tile keys: `rangeKeys` / `rangeKeySet` = current range (skill range override + - * rangeExtend — the unit's own 攻击距离 unless the running skill's range ignores it, `targeting.noRangeExtend`: 信仰搅拌机 - * S3, PRTS 备注 "此技能的攻击范围不受'攻击距离'属性影响" — plus the skill's own `targeting.rangeExtend`) ∪ - * `unit.extraRangeKeys` (content extra targets — setExtraRange); `baseRangeKeys` = the INITIAL range of the DEFAULT - * skill trigger: the unit's own grid + its permanent rangeExtend (`s.baseRangeExtend`: persistent, never-expiring - * buffs — talents, modules, bonds), no skill range, no temporary extend, no extra keys; `liveRangeGrid` = the - * relative grid (facing RIGHT) of the 攻击范围 the detail card shows (shared/protocol.js unitStatsEntry `range`; - * community report E1 after 0.1.0: the card kept the base grid while 烛煌 S3 attacked with 4-11): the grid behind - * `rangeKeys` without the extra keys (targeting.js extendedGrid; the grid itself when nothing extends it), or the - * unit's own range while a skill's grid only selects targets (`targeting.showOwnRange`: 荒芜拉普兰德 S1, no official - * range change). Rebuilt on deploy / relocate / skill range switches and whenever either extend changes (rangeChanged). - */ - _refreshRange(u) { - const tg = u.skill && u.skill.active ? u.skill.spec.targeting : null; - const grid = (tg && tg.rangeGrid) || u.rangeGrid || [[0, 0]]; - const ext = (tg && tg.noRangeExtend ? 0 : u.s.rangeExtend) + ((tg && tg.rangeExtend) || 0); - u._rangeExtend = u.s.rangeExtend; - u._baseExtend = u.s.baseRangeExtend; - const keys = absoluteRangeKeys(grid, u.tileR, u.tileC, u.dir, ext); - const set = new Set(keys); - const extra = u.extraRangeKeys; - if (extra) for (const k of extra) if (!set.has(k)) { set.add(k); keys.push(k); } - u.rangeKeys = keys; - u.rangeKeySet = set; - const own = !!(tg && tg.showOwnRange); - const lg = own ? u.rangeGrid || [[0, 0]] : grid, le = own ? u.s.rangeExtend : ext; - u.liveRangeGrid = le > 0 ? extendedGrid(lg, le) : lg; - if (u.kind !== 'device') u.baseRangeKeys = absoluteRangeKeys(u.rangeGrid || [[0, 0]], u.tileR, u.tileC, u.dir, u.s.baseRangeExtend); - if (u.skill) u.skill._trigKeys = null; // CUSTOM_RANGE trigger grid is relative to the tile - } - - /** True when a buff changed the unit's rangeExtend (total or permanent part) since its range was last built. */ - rangeChanged(u) { - return u._rangeExtend !== undefined && (u._rangeExtend !== u.s.rangeExtend || u._baseExtend !== u.s.baseRangeExtend); - } - - /** Public: rebuild a unit's range after content changed `unit.rangeGrid` (流形 copies) or its tile keys. */ - refreshRange(unit) { - if (!unit || unit.side !== 'ally' || !unit.alive || !unit.deployed) return false; - this._refreshRange(unit); - return true; - } - - /** - * Extra targetable tiles merged into the unit's range (蕾缪安 wanted targets, 维娜 S3, …): absolute tile keys - * (row × COLS + col), kept across every later range rebuild until content sets them again (null / [] clears). - * Not part of `baseRangeKeys` (the DEFAULT trigger range) — see SkillRuntime.addTriggerRange for that. - */ - setExtraRange(unit, keys) { - if (!unit || unit.side !== 'ally') return false; - const out = []; - const seen = new Set(); - for (const k of keys || []) if (Number.isInteger(k) && k >= 0 && k < ROWS * COLS && !seen.has(k)) { seen.add(k); out.push(k); } - unit.extraRangeKeys = out.length ? out : null; - if (unit.alive && unit.deployed) this._refreshRange(unit); - return true; - } - - // ============================================================================================================= - // content helpers - - /** - * Token def of `tokenId` as `owner` (an ally unit: its chess + selected skill / module; or a chess id) summons it — - * the def spawnToken uses. For content that reads summon stats / skill blackboards: exact in a multi-player field - * where two players give the same chess different loadouts (an id-only `data.getToken(id, chessId)` is not). - */ - tokenDef(tokenId, owner = null) { - return this._tokenDef(tokenId, owner, null); - } - - /** - * Whether an operator's selected skill / module produces `tokenId` (DESIGN §16, DATA.md §14 `sources`): false only - * when the owner's own tokens.json variant says so (`sources` without 'skill' / 'talent' — e.g. 琳琅诗怀雅 S1/S3 make - * no 香槟炸弹, 赫默 S1 no 医疗探机); true when the data does not tell (no owner variant, inline defs, tokens of - * other chess). - */ - producesToken(owner, tokenId, def = null) { - if (!owner || typeof owner !== 'object' || owner.kind !== 'op') return true; - const d = def ?? this.tokenDef(tokenId, owner); - const src = d && Array.isArray(d.sources) ? d.sources : null; - if (!src || src.includes('skill') || src.includes('talent')) return true; - const vs = this.data.rawToken?.(tokenId)?.variants; - const id = String(owner.defId ?? ''); - return !(vs && typeof vs === 'object' && (vs[id] || vs[id.replace(/_b$/, '_a')])); - } - - /** - * Spawn (and deploy) a token. `owner` = ally unit or playerId. Returns the token unit or null. The def is the owner's - * variant for its selected skill / module (`opts.def` = an inline def instead). While an operator runs a NON-default - * skill, a summon that skill does not produce (producesToken) is refused unless `opts.anySource`: hand-authored kit - * install hooks are written for the default skill and run under every skill (琳琅诗怀雅 S1/S3 would drop 香槟炸弹); - * under the default skill the kit stays the authority. - */ - spawnToken(owner, tokenId, row, col, opts = {}) { - const ownerUnit = owner && typeof owner === 'object' ? owner : null; - const pid = ownerUnit ? ownerUnit.ownerId : owner; - const ps = this.getPlayer(pid) ?? (ownerUnit ? ownerUnit.player : null); - const def = opts.def ? normalizeToken(tokenId, opts.def) : this._tokenDef(tokenId, ownerUnit, null); - if (!def) { this.log(`unknown token ${tokenId}`); return null; } - if (!opts.def && !opts.anySource && ownerUnit && ownerUnit.def?.loadout?.skillIsDefault === false && !this.producesToken(ownerUnit, tokenId, def)) { - this.log(`${ownerUnit.defId} (skill ${ownerUnit.def?.loadout?.skillIndex ?? '?'}) does not produce ${tokenId}`); - return null; - } - if (!Number.isInteger(row) || !Number.isInteger(col) || !this.grid.inRect(row, col)) return null; - const occ = this._occ[row * COLS + col]; - if (occ && occ.alive && !opts.force) return null; - const dir = opts.dir != null ? normDir(opts.dir) : opts.facing != null ? normDir(opts.facing) : ownerUnit ? ownerUnit.dir : ps ? ps.dir : 'RIGHT'; - const u = this._makeAlly(ps, def, 'token', row, col, { ownerUnit, dir }); - if (opts.stats) for (const [k, v] of Object.entries(opts.stats)) if (Number.isFinite(v)) u.base[k] = v; - this._setupUnit(u, opts.kit ?? null); - if (opts.untargetable) this.addBuff(u, { key: 'trait:untargetable', flags: { untargetable: true }, persist: true, allowDead: true }); - if (!this._deploy(u, { initial: false })) { - // tile still busy (a unit stands there even with `force`): drop the half-built token and its hooks - u.removed = true; - this.offOwner(u); - return null; - } - if (opts.hp != null && Number.isFinite(Number(opts.hp))) u.hp = Math.max(1, Math.min(u.s.maxHp, Number(opts.hp))); - if (opts.duration > 0 && Number.isFinite(Number(opts.duration))) this.after(Number(opts.duration), () => { if (u.alive) this.retreat(u, { reason: 'expired', permanent: true }); }, { owner: u }); - return u; - } - - /** - * Spawn a stage device (e.g. crates). opts: { hp, obstacle, obstacleKind, blockCnt, name, def, res, atk, bat, aspd }. - * An `obstacle` device is an obstacle-like tile by default (`obstacleKind` 'crate': enemies route around it at cost - * 1000 and, when it is the only way, walk into it, get blocked by it and break it — research 08 §3.1); 'block' makes - * the tile impassable. - */ - spawnDevice(key, row, col, opts = {}) { - // Devices are ally-side units on a field tile: never outside the rect, never on top of a living unit or of a - // knocked-out operator (downOn). - if (!Number.isInteger(row) || !Number.isInteger(col) || !this.grid.inRect(row, col)) return null; - const occ = this._occ[row * COLS + col]; - if (occ && occ.alive) return null; - if (this.downOn(row, col)) return null; - const hp = fin(opts.hp, 100); - const bat = fin(opts.bat, 1), aspd = fin(opts.aspd, 100); - const def = { - type: 'device', id: key, baseId: key, name: opts.name ?? key, tier: 0, golden: false, profession: 'DEVICE', subProf: null, - stats: { maxHp: hp > 0 ? hp : 100, atk: Math.max(0, fin(opts.atk, 0)), def: Math.max(0, fin(opts.def, 0)), res: Math.min(100, Math.max(0, fin(opts.res, 0))), aspd: aspd > 0 ? aspd : 100, bat: bat > 0 ? bat : 1, blockCnt: Math.max(0, fin(opts.blockCnt, 99)), cost: 0, respawnTime: 0, spRecovery: 0, tauntLevel: -1, massLevel: 0, hpRecoveryPerSec: 0 }, - rangeGrid: [[0, 0]], skill: null, talents: [], spine: key, avatar: key, - }; - const u = this._makeAlly(null, def, 'device', row, col, opts.dir != null ? { dir: opts.dir } : {}); - u.ownerId = null; - u.kit = {}; - u.profile = { noAttack: true, maxTargets: 0 }; - u.skill = new SkillRuntime(this, u, null, null, {}); - u.obstacle = !!opts.obstacle; - u.obstacleKind = opts.obstacleKind === 'block' ? 'block' : 'crate'; - u.alive = true; - u.deployed = true; - u.ground = true; - u.markDirty(); - u.hp = u.s.maxHp; - u.deploySeq = ++this._deploySeq; - u.aggroSeq = u.deploySeq; - u.deployedAt = this.time; - u.rangeKeys = []; - this._occ[row * COLS + col] = u; - if (u.obstacle) this.grid.setObstacle(row, col, true, u.obstacleKind); - this._ev(['spawn', unitInfo(u)]); - if (this._hooks.deploy) this.emit('deploy', { unit: u, initial: !this.started }); - return u; - } - - _spawnStageDevices() { - if (this.opts.devices === false) return; - for (const d of this.stage.devices || []) { - // data/stages.json `active` = present at match start (= not hidden in the 下半 level file: act1 m02 starts with no - // crates, research 08 §3.3); research stages have no `active` ⇒ `hidden` decides. - const act = d.raw && typeof d.raw.active === 'boolean' ? d.raw.active : !d.hidden && d.active !== false; - if (!act) continue; - if (d.role === 'platform' || d.role === 'mound') { - // 射击台 / mounds [ASSUMED, research 08 §8 #1]: hard-block ground movement; an operator standing on one is elevated - // (does not block) — the match lets ranged operators deploy there (deployTiles.rangedOnly). - if (!this.grid.inRect(d.row, d.col)) continue; - this.grid.setObstacle(d.row, d.col, true); - (this._elevated ??= new Set()).add(d.row * COLS + d.col); - continue; - } - const spec = OBSTACLE_DEVICES[d.key] ?? (d.role === 'crate' ? { hp: d.stats?.maxHp ?? 100, name: d.name } : null); - if (!spec) continue; - if (!this.grid.inRect(d.row, d.col)) continue; - if (this._occ[d.row * COLS + d.col]) continue; - this.spawnDevice(d.key, d.row, d.col, { hp: spec.hp, obstacle: true, name: spec.name }); - } - } - - /** Toggle a ground obstacle (enemies re-read their flow field). `kind` 'block' (default, impassable) | 'crate'. */ - setObstacle(r, c, on, kind = 'block') { this.grid.setObstacle(r, c, on, kind); } - - addProjectile(p) { return this.projectiles.add(p); } - - /** Move an ally to another tile (keeps state); never onto a living unit or a knocked-out operator (downOn). */ - relocate(unit, r, c) { - // only a living, deployed ally moves, and only onto an integer tile of this field (a dead unit left in _occ - // would later "block" from a tile it no longer stands on once it redeploys at home) - if (!unit || unit.side !== 'ally' || !unit.alive || !unit.deployed) return false; - if (!Number.isInteger(r) || !Number.isInteger(c) || !this.grid.inRect(r, c)) return false; - const k = r * COLS + c; - if (this._occ[k] && this._occ[k] !== unit && this._occ[k].alive) return false; - if (this.downOn(r, c)) return false; - const ok = unit.tileR * COLS + unit.tileC; - if (this._occ[ok] === unit) this._occ[ok] = null; - this.releaseBlocked(unit); - if (unit.obstacle) this.grid.setObstacle(unit.tileR, unit.tileC, false, unit.obstacleKind); - unit.tileR = r; unit.tileC = c; unit.x = c; unit.y = r; - unit.ground = this.grid.isLow(r, c) && !this._elevated?.has(k); - this._occ[k] = unit; - if (unit.obstacle) this.grid.setObstacle(r, c, true, unit.obstacleKind); - this._refreshRange(unit); // current + base range, CUSTOM_RANGE trigger keys - return true; - } - - /** - * 【移动】 (PRTS 术语释义 移动: "不退场，以当前血量在目标位置部署 … 本质上为一次特殊的撤退-再部署行为"): `unit` leaves its - * tile (relocate: same checks, false = refused, nothing changed) and is deployed on (r, c) at once. A new deployment — - * deploySeq / aggroSeq / deployedAt (the deploy animation; once-per-deployment effects re-arm) — announced by - * `deploy` { initial: false, move: true }: deploy effects fire again ("可以通过移动行为多次触发部署时触发的效果"). Not an - * exit: no `die` / `death`, so no knock-out, no redeploy timer or cost ("因移动撤退时不会积累再部署惩罚") — 不屈 and - * 阿戈尔's revive, which act on exits "因移动之外的原因" (PRTS 阿戈尔 备注), never see it. HP, buffs and a running skill - * stay: officially nothing carries over but what the mover's skill names (乌尔比安 S3: 技能进度 and the second talent's - * stacks); the remake keeps the rest too (owner's deviation, DESIGN §22.3). `clearSp`: the 技力 is emptied before the - * deploy handlers run ("部署时将清空技力"; 乌尔比安's 【返回】 "将清空技力，但仍可以享受后续由其他效果提供的技力"). - */ - moveRedeploy(unit, r, c, { clearSp = false } = {}) { - if (!this.relocate(unit, r, c)) return false; - unit.deploySeq = ++this._deploySeq; - unit.aggroSeq = unit.deploySeq; - unit.deployedAt = this.time; - const sk = unit.skill; - if (clearSp && sk && !sk.noSkill && sk.kind !== 'passive' && !(sk.active && sk.isTimed)) { - sk.sp = 0; - sk.charges = sk.spCost <= 0 ? sk.maxCharges : 0; // (a free skill is available once per deployment: skills.js reset) - } - this._ev(['deploy', unit.id]); - if (this._hooks.deploy) this.emit('deploy', { unit, initial: false, move: true }); - return true; - } - - /** - * 受力等级 of enemy `e` under a push / pull of 力度 `force` (微小力 −1, 小力 0, 中力 1, 较大力 2, 大力 3, 大力+1 4, 特大力 5): - * force − its current 重量等级 (massLevel incl. 失重) — PRTS 游戏数据基础 §重量公式, 推与拉 (user playtest #6 item 14). - */ - forceLevel(e, force) { - return Math.round(fin(force, 0)) - (e && e.s ? e.s.massLevel : 0); - } - - /** - * Push enemy `e` with 力度 `force` (PRTS 推与拉 §推力): the official distance of its 受力等级 (constants.js PUSH_TILES: - * a 中力 push moves a weight-1 enemy 1.7 tiles, a weight-2 one 0.44, weight 3 0.12, weight ≥ 4 not at all). Radial - * (the default: away from `from`, the pusher's centre — "沿着干员向自身中心点的射线方向"; the client's buff template - * knockback[relative]: 琳琅诗怀雅 S3, 山 S3, 莫斯提马 S3) or directional (`dir` = the pusher's direction {x, y}; template - * knockback[dir], Knockback {_useSourceDirection: true, _decreaseForceLevelWhenNotInDirection: 2}: 推击手, 野鬃 S2 - * "往攻击方向"); a directional push on a target more than 45° off `dir` or nearer than 0.25 tile becomes radial with - * 受力等级 −2 ("特殊修正"). `fixed` waives both corrections (圣聆初雪 S1 "朝部署方向": KnockBackWithCharacterDirection, - * PRTS 备注 "不会因角度过大或距离过近而变化方向与力度"); `fixedAngle` only the angle one (PRTS 见行者 S2 备注 "不会因为角度过大 - * 而改变推动的方向或削减力度" — the < 0.25 tile rule still applies). `inward` = a radial push towards `from` (薄绿 S2's "拖拽", PRTS 备注 "实际为 - * 反方向（指向薄绿方向）的推开"), never nearer than PULL_STOP_RADIUS to its centre [ASSUMED: "至面前"]. `effect` = a 特效 - * push (PRTS 推与拉: one frame less of travel than a 弹道 push — constants.js PUSH_TILES_EFFECT / PUSH_EFFECT_SKILLS). - * Returns the tiles moved. - */ - push(e, force, { from = null, dir = null, fixed = false, fixedAngle = false, inward = false, effect = false } = {}) { - if (!this._displaceable(e)) return 0; - let level = this.forceLevel(e, force); - const fx0 = fin(from?.x, e.x), fy0 = fin(from?.y, e.y); - const vx = e.x - fx0, vy = e.y - fy0, d = Math.hypot(vx, vy); - let ux = 0, uy = 0; - const dirX = dir ? fin(dir.x, 0) : 0, dirY = dir ? fin(dir.y, 0) : 0; - const dl = Math.hypot(dirX, dirY); - if (dl > 0) { - ux = dirX / dl; uy = dirY / dl; - if (from && !fixed && (d < PUSH_DIRECTIONAL_MIN_DIST || (!fixedAngle && vx * ux + vy * uy < d * Math.SQRT1_2))) { - level -= 2; - if (d > 1e-6) { ux = vx / d; uy = vy / d; } - } - } else if (d > 1e-6) { ux = vx / d; uy = vy / d; } - else if (!inward && from && Array.isArray(from.fwd)) { ux = from.fwd[1]; uy = from.fwd[0]; } - else return 0; - let dist = pushTiles(level, effect); - if (inward && !(dl > 0)) { ux = -ux; uy = -uy; dist = Math.min(dist, Math.max(0, d - PULL_STOP_RADIUS)); } - return this.displace(e, { x: ux, y: uy }, dist); - } - - /** - * Pull enemy `e` with 力度 `force` towards the point `to` (PRTS 推与拉 §拉力 / §捕网): 受力等级 ≥ 0 — all the way, until it - * is within `stop` tiles of `center` (急停; `center` defaults to `to`, `stop` to PULL_STOP_RADIUS) or reaches `to`; - * −1 — PULL_WEAK_SHARE of its starting distance to `to`; −2 — PULL_CRAWL tiles; ≤ −3 — nothing. `pullToFront` aims at - * the official 拉力起点 in front of an operator. Returns the tiles moved. - */ - pull(e, force, { to, center = null, stop = PULL_STOP_RADIUS } = {}) { - if (!this._displaceable(e) || !to) return 0; - // an enemy the puller itself blocks already stands in front of it (at contact) [ASSUMED: no pull, no unblocking] - if (center && center.side === 'ally' && e.blockedBy === center) return 0; - const tx = fin(to.x, e.x), ty = fin(to.y, e.y); - const dx = tx - e.x, dy = ty - e.y, d0 = Math.hypot(dx, dy); - if (!(d0 > 1e-6)) return 0; - const ux = dx / d0, uy = dy / d0; - // travel until inside the stop circle around `center` (smaller root of |e + t·u − c| = stop), else up to `to` - let full = d0; - const cx = fin(center?.x, tx), cy = fin(center?.y, ty), r = Math.max(0, fin(stop, 0)); - const wx = e.x - cx, wy = e.y - cy, wu = wx * ux + wy * uy, w2 = wx * wx + wy * wy; - if (w2 <= r * r) full = 0; - else { - const disc = wu * wu - w2 + r * r; - if (disc >= 0) { const t = -wu - Math.sqrt(disc); if (t >= 0) full = Math.min(full, t); } - } - const level = this.forceLevel(e, force); - const dist = level >= 0 ? full : level === -1 ? Math.min(full, PULL_WEAK_SHARE * d0) : level === -2 ? Math.min(full, PULL_CRAWL) : 0; - return dist > 1e-6 ? this.displace(e, { x: ux, y: uy }, dist) : 0; - } - - /** Official distance (tiles) a push of 力度 `force` would move `e` on open ground (0 when it cannot be displaced). */ - pushDistance(e, force, { effect = false } = {}) { - return this._displaceable(e) ? pushTiles(this.forceLevel(e, force), effect) : 0; - } - - /** Pull `e` "至面前" of ally `unit` (拉力起点 PULL_ORIGIN tiles ahead along its direction, 急停 around its centre). */ - pullToFront(e, unit, force) { - if (!unit) return 0; - const f = Array.isArray(unit.fwd) ? unit.fwd : [0, 1]; - return this.pull(e, force, { to: { x: unit.x + f[1] * PULL_ORIGIN, y: unit.y + f[0] * PULL_ORIGIN }, center: unit, stop: PULL_STOP_RADIUS }); - } - - /** - * Can `e` be displaced at all: a living enemy, not a leader part of the boss pool, not 失衡免疫 (flag `noDisplace`: - * 近地悬浮, 浮空, the 胄 parts …) and not a 静态刚体 (data `staticBody`). PRTS 特殊机制 静态刚体: such a unit "可以进入 - * 失衡状态 … 但物理层面上无法产生任何速度或移动" — every air unit of the mode except “炎佑”, plus the boss 昆图斯 (build-data - * STATIC_BODIES; player report after 0.1.0, "飞机可以被薄绿的技能拉走"). A skill that reaches it still hits it (its targeting - * is the skill's own: 锏 S3, 薄绿, the 钩索师 …); only the movement is 0, so distance-based effects (drag damage, 见行者 S2's - * wall stun) come to nothing. [ASSUMED] the 0.1 s 失衡硬直 a 静态刚体 still gets is not modelled (no displacement models it). - */ - _displaceable(e) { - return !!(e && e.alive && e.side === 'enemy' && !e.isBoss && !e.s.flags.noDisplace && !(e.def && e.def.staticBody)); - } - - /** - * Move an enemy `distance` tiles along `dir` = {x, y} (normalised internally) over passable tiles — the raw mover of - * push() / pull(), which apply the official 力度 − 重量 rules (content uses those; the old `force` option is gone). - * 失衡免疫 (flag `noDisplace`: 近地悬浮, 浮空 — PRTS 异常效果 "不会被位移影响"), 静态刚体 (data `staticBody`) and leaders - * ⇒ no movement (_displaceable). The tiles it may cross follow its movement (`motion`): a hovering enemy walks the - * ground, so it stays on ground-passable tiles. - */ - displace(e, dir, distance) { - if (!this._displaceable(e) || !dir) return 0; - const dxv = fin(dir.x, 0), dyv = fin(dir.y, 0); - const len = Math.hypot(dxv, dyv); - if (!(len > 0)) return 0; - const eff = Math.min(fin(distance, 0), 2 * COLS); - if (!(eff > 0)) return 0; - const ux = dxv / len, uy = dyv / len; - let moved = 0; - const stepLen = 0.1; - while (moved + 1e-9 < eff) { - const s = Math.min(stepLen, eff - moved); // (the last step is a partial one: 0.12 tiles moves 0.12, not 0.2) - const nx = e.x + ux * s, ny = e.y + uy * s; - const r = Math.round(ny), c = Math.round(nx); - const ok = e.motion === 'FLY' ? this.grid.inRect(r, c) : this.grid.groundPassable(r, c); - if (!ok) break; - e.x = nx; e.y = ny; moved += s; - } - if (moved > 0) { - this._unblock(e); - if (e.route) e.route.pts = null; - this.fx('displace', { x: e.x, y: e.y, id: e.id }); - } - return moved; - } - - /** - * A tile no automatic placement may take (the 突袭 landing tile, tactical points, summon / device tiles): a living - * unit stands on it, or it is the rest tile (restTile) of an ally piece that has not deployed yet or waits to - * redeploy — the tile a knocked-out operator lies on ("倒地干员所在地块…所有我方单位在此处的部署行为将被阻止", PRTS - * 卫戍协议/帮助 §作战阶段 单位部署), else its home tile (a token parked there would keep that unit off the field). - */ - isReservedTile(r, c) { - if (!Number.isInteger(r) || !Number.isInteger(c) || r < 0 || r >= ROWS || c < 0 || c >= COLS) return true; - const u = this._occ[r * COLS + c]; - if (u && u.alive) return true; - for (const a of this.allyUnits) { - if (a.alive || a.removed || (a.kind !== 'op' && a.kind !== 'token')) continue; - const [tr, tc] = this.restTile(a); - if (tr === r && tc === c) return true; - } - return false; - } - - /** - * The knocked-out operator (isDown) lying on (r, c), other than `except`, or null. Official (PRTS 卫戍协议/帮助 §作战阶段 - * 单位部署): "干员退场后…原地留下一个“倒地干员”…满足再部署条件时，移除场上的该倒地干员并自动部署至该位置" and "倒地干员所在 - * 地块视为可部署，但所有我方单位在此处的部署行为将被阻止" — its tile (`body`, _layBody) takes no other ally: `_deploy` - * (initial deploys, redeploys, the 突袭 landing, summons), `spawnDevice` and `relocate` refuse it. - */ - downOn(r, c, except = null) { - for (const a of this.allyUnits) { - if (a === except || !this.isDown(a)) continue; - const [br, bc] = a.body ?? [a.tileR, a.tileC]; - if (br === r && bc === c) return a; - } - return null; - } - - /** - * The tile a withdrawn ally comes back on (redeploy, _checkRedeploys): a down operator's body tile (isDown) — where it - * fell, or its home (_layBody) — else its home tile. - */ - restTile(u) { - return this.isDown(u) ? (u.body ? [u.body[0], u.body[1]] : [u.tileR, u.tileC]) : [u.homeR, u.homeC]; - } - - /** - * Where a knocked-out operator lies (it redeploys there): the tile it fell on, except — "若干员被击倒的位置为其他干员或 - * 召唤物的初始位置，则在被击倒后，尝试返回其自身的初始位置" (PRTS 卫戍协议/帮助) — a tile that is another board piece's - * home (a piece with a board uid: the 初始位置 is the prep placement — whether that piece is on the field, waiting or - * gone: a summon only leaves its home free once it has expired or been killed, so a removed one must count too), where - * it goes back to its own home tile when that is in the rect and free (isReservedTile: no living unit, no other body, - * no other waiting piece's tile). It stays where it fell when its home is taken [ASSUMED: one attempt, at the - * knock-out]. Only an operator moved off its board tile — a 突袭 jump, 乌尔比安's anchor — can fall elsewhere. Sets - * `u.body` (b.snap `down` carries it); x / y / tileR / tileC keep where it fell, so the `kill` / `death` handlers - * (被击倒时 effects) still act there. - */ - _layBody(u) { - const r = u.tileR, c = u.tileC, hr = u.homeR, hc = u.homeC; - u.body = [r, c]; - if (r === hr && c === hc) return; - if (!this.allyUnits.some((a) => a !== u && a.uid != null && (a.kind === 'op' || a.kind === 'token') && a.homeR === r && a.homeC === c)) return; - if (!this.grid.inRect(hr, hc) || this.isReservedTile(hr, hc)) return; - u.body = [hr, hc]; - } - - /** - * Tactical point (战术点) for tactician reinforcements: a free (isReservedTile) walkable ground tile of the unit's - * initial range (baseRangeKeys), on an enemy ground path first (groundPathTiles — where a player would put the - * blocker), then nearest to the unit (Chebyshev; the smaller sideways offset — in the unit's facing-RIGHT frame, so - * its forward line — breaks ties), then the lowest local (row, col) offset (sim/dir.js localOrder: for a RIGHT-facing - * unit exactly the lowest tile key). The choice turns with the unit's direction. null when none. - */ - findTacticalPoint(unit) { - if (!unit) return null; - const onPath = this.groundPathTiles(); - let best = null, bp = 2, bd = Infinity, bo = null; - for (const k of unit.baseRangeKeys || unit.rangeKeys || []) { - const r = (k / COLS) | 0, c = k % COLS; - if (!this.grid.groundPassable(r, c) || !this.grid.canStand(r, c)) continue; - if (this.isReservedTile(r, c)) continue; - const o = localOrder(r - unit.tileR, c - unit.tileC, unit.dir); - const d = Math.max(Math.abs(r - unit.tileR), Math.abs(c - unit.tileC)) + 0.01 * Math.abs(o[0]); - if (!(d > 0)) continue; - const p = onPath.has(k) ? 0 : 1; - if (p < bp || (p === bp && (d < bd - 1e-9 || (Math.abs(d - bd) <= 1e-9 && localBefore(o, bo))))) { bp = p; bd = d; bo = o; best = [r, c]; } - } - return best; - } - - /** - * Ground tiles the enemies of this field walk on: the flow-field routes (grid.findPath, live obstacles) of the - * non-FLY routes this battle's wave spawns on (every non-FLY route when no queued spawn names one — e.g. content-only - * battles), leg by leg (start → MOVE/APPEAR checkpoints → end, clamped to the rect). R1–R3 spawn at the lower gate - * only (research 08 §4.1), so the unused upper lane does not attract tactical points. Set of tile keys, cached per - * grid version. - */ - groundPathTiles() { - const ver = this.grid.version ?? 0; - const used = (this._pathRoutesUsed ??= new Set()); - const before = used.size; - for (const p of this._pending || []) if (!p.route && Number.isInteger(p.routeIndex)) used.add(p.routeIndex); - if (this._pathTiles && this._pathTilesVer === ver && used.size === before) return this._pathTiles; - const set = new Set(); - const R = this.rect; - const clampPt = (p) => [Math.max(R.r0, Math.min(R.r1, Math.round(p[0]))), Math.max(R.c0, Math.min(R.c1, Math.round(p[1])))]; - const ok = (p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]); - const walk = (route) => route && route.motion !== 'FLY' && ok(route.start); - const routes = this.routes || []; - const any = [...used].some((i) => walk(routes[i])); - routes.forEach((route, i) => { - if (!walk(route) || (any && !used.has(i))) return; - const pts = [clampPt(route.start)]; - for (const cp of route.checkpoints || []) if ((cp.type === 'MOVE' || cp.type === 'APPEAR') && ok(cp.pos)) pts.push(clampPt(cp.pos)); - if (ok(route.end)) pts.push(clampPt(route.end)); - for (let j = 1; j < pts.length; j++) { - const [a, b] = [pts[j - 1], pts[j]]; - const p = this.grid.findPath(a[0], a[1], b[0], b[1]) || this.grid.findPath(a[0], a[1], b[0], b[1], { ignoreObstacles: true }); - for (const [r, c] of p || []) set.add(r * COLS + c); - } - }); - this._pathTiles = set; - this._pathTilesVer = ver; - return set; - } - - addDp(playerId, n) { - const ps = this.getPlayer(playerId); - if (!ps || !Number.isFinite(n)) return 0; - ps.dp = Math.max(0, Math.min(this.flags.dpMax, ps.dp + n)); - return ps.dp; - } - - /** - * Record an IN_BATTLE layer gain (no-op when gains are disabled). Returns the layers added: at most the room left - * under BOND_LAYER_CAP (999, shared/constants.js) on the live copy — the client's AddBondCount `min(L + n, 999)`; the - * `layerGain` hook (魔王's +1 …) runs first, then the clamp; a bond already at the cap gains 0 (no hook, no event). - * Without a live copy of the bond (a partial PlayerBattleInput) the battle's own gains count; the match's settle - * clamps the persistent count the same way. - */ - addLayers(playerId, bondId, n, reason = '', opts = {}) { - if (!this.flags.layerGainsEnabled || !(n > 0) || !Number.isFinite(n) || playerId == null) return 0; - const pp = this._pp(playerId); - if (!pp) return 0; - const ps = this.getPlayer(playerId); - const live = ps && ps.bonds[bondId] ? (ps.bonds[bondId].layers ?? 0) : (pp.layerGains[bondId] ?? 0); - if (!(layerGainRoom(live, Infinity) > 0)) return 0; - const source = opts.source ?? null; - const ctx = { playerId, bondId, n, reason, source, tile: Array.isArray(opts.tile) ? opts.tile : this._sourceTile(source) }; - if (this._hooks.layerGain) { this.emit('layerGain', ctx); if (!(ctx.n > 0) || !Number.isFinite(ctx.n)) return 0; } - const add = layerGainRoom(live, ctx.n); - if (!(add > 0)) return 0; - pp.layerGains[bondId] = (pp.layerGains[bondId] ?? 0) + add; - if (ps && ps.bonds[bondId]) ps.bonds[bondId].layers = (ps.bonds[bondId].layers ?? 0) + add; - this._ev(['layer', playerId, bondId, add]); - return add; - } - - /** - * Tile of a gain's source unit ([r, c]): where it stands, or where it stood when it left the field during this very - * instant (a "被击倒时" gain fires from its `death`). null otherwise (no source, long gone, not a unit). - */ - _sourceTile(u) { - if (!u || typeof u !== 'object' || !Number.isFinite(u.x)) return null; - const here = u.alive && u.deployed && !u.hidden; - if (!here && !(u.deathAt === this.time && !u.alive)) return null; - return u.side === 'ally' ? [u.tileR, u.tileC] : [Math.round(u.y), Math.round(u.x)]; - } - - addCoins(playerId, n) { - const pp = this._pp(playerId); - if (!pp || !(n > 0) || !Number.isFinite(n)) return 0; - pp.coins += n; - this._ev(['bounty', playerId, n]); - return n; - } - - fx(kind, params = {}) { - const { x = 0, y = 0, ...extra } = params || {}; - this._ev(['fx', kind, Math.round(x * 100) / 100, Math.round(y * 100) / 100, extra]); - } - - log(msg) { - const k = 'log:' + msg; - if (this._errKeys.has(k)) return; - this._errKeys.add(k); - if (this.opts.verbose) this.logger.warn?.(`[sim] ${msg}`); - } - - // ============================================================================================================= - // internals: hidden / boss / clamp / events / errors - - _setHidden(e, on) { - if (e.hidden === on) return; - e.hidden = on; - if (on) this._unblock(e); - this.fx(on ? 'disappear' : 'appear', { x: e.x, y: e.y, id: e.id }); - } - - _syncBossHp(e) { - const pool = e.bossPool; - if (!pool) return; - if (Number.isFinite(pool.maxHp) && pool.maxHp > 0 && e.base.maxHp !== pool.maxHp) { e.base.maxHp = pool.maxHp; e.markDirty(); } - // a broken pool (NaN hp) must not leak NaN into the unit: show it full until the pool is sane again - const ratio = pool.maxHp > 0 ? (Number.isFinite(pool.hp) ? Math.max(0, pool.hp) / pool.maxHp : 1) : 0; - e.hp = e.s.maxHp * Math.min(1, ratio); - } - - _bossSync() { - if (!this.sharedBoss) return; - for (const e of this.enemies) if (e.alive && e.bossPool) { - this._syncBossHp(e); - if (e.bossPool.hp <= 0) this.kill(e, null); - } - } - - _clampPos(e) { - const R = this.rect; - if (e.x < R.c0 - 0.5) e.x = R.c0 - 0.5; - if (e.x > R.c1 + 0.5) e.x = R.c1 + 0.5; - if (e.y < R.r0 - 0.5) e.y = R.r0 - 0.5; - if (e.y > R.r1 + 0.5) e.y = R.r1 + 0.5; - } - - _compactEnemies() { - if (!this._enemiesDirty) return; - this.enemies = this.enemies.filter((e) => e.alive); - this._enemiesDirty = false; - } - - _ev(tuple) { - if (!this.recordEvents) return; - this._evq.push(tuple); - if (this._evq.length > EVENT_BUFFER_CAP) this._evq.splice(0, this._evq.length - EVENT_BUFFER_CAP / 2); - } - - /** Client-facing events since the last drain (DESIGN §8.2 tuples). */ - drainEvents() { - const ev = this._evq; - this._evq = []; - return ev; - } - - /** - * Compact full snapshot of this field (DESIGN §8.2 b.snap), plus (only when non-empty): - * down: [[id, respawnAt, respawnTime, state, row, col]] — operators that left the field waiting to redeploy (isDown): the - * game time their respawn timer ends, its length (s), constants.js DOWN_STATE and the tile they lie on (and - * come back on: _layBody — where they fell, or their home); - * elem: [[id, element, fill, cooldownEnd, cooldown]] — the element gauge each unit shows (damage.js elementView). - */ - snapshot() { - const snap = { - fieldId: this.fieldId, - t: Math.round(this.time * 1000) / 1000, - units: snapshotUnits(this.units, this.time), - dp: this.players.length ? Math.floor(this.players[0].dp) : 0, - killed: this.killed, - total: this.total, - }; - if (this.players.length > 1) { - snap.dps = {}; - for (const p of this.players) snap.dps[p.playerId] = Math.floor(p.dp); - } - if (this.sharedBoss) snap.boss = { hp: Math.max(0, Math.round(this.sharedBoss.hp)), max: Math.round(this.sharedBoss.maxHp) }; - const r2 = (v) => Math.round(v * 100) / 100; - let down = null; - for (const u of this.allyUnits) { - if (!this.isDown(u)) continue; - (down || (down = [])).push([u.id, r2(u.respawnAt), r2(Math.max(0, u.respawnAt - u.deathAt)), this._downState(u), ...this.restTile(u)]); - } - if (down) snap.down = down; - let elem = null; - for (const u of this.units) { - if (!u.alive || !u.deployed || u.hidden) continue; - const v = elementView(u, this.time); - if (v) (elem || (elem = [])).push([u.id, v[0], v[1], v[2], v[3]]); - } - if (elem) snap.elem = elem; - return snap; - } - - /** - * An operator lying on the field, waiting to redeploy on that tile (DESIGN §5.5: after its respawn time, when the tile - * is free and DP ≥ cost; _layBody, downOn). PRTS 卫戍协议/帮助 §作战阶段 单位部署: "干员退场后，将返回隐藏的待部署区，并原地 - * 留下一个“倒地干员”以供查看信息，满足再部署条件时，移除场上的该倒地干员并自动部署至该位置。" — every 退场 (GitHub #60, the owner's - * decision of 2026-10-04): knocked out ('killed'), entering the battle knocked out (FORCED_EXIT, 联防) and forced out - * by its own effects ('retreat': 史尔特尔's 余烬, 耀骑士临光 S2, 骑士戒律 + 竞技旗, 伊内丝 S3; 'merchant': a 商人 that cannot - * pay) — except the 突袭 retreat ('raid', redeployed at once on its landing tile); not removed for good, after it was - * deployed. A forced exit stays no kill: its 'die' / `death` reason is not 'killed' (no 被击倒 effect, 不屈, 阿戈尔, no - * knock-down count). The client keeps its model on that tile knocked down with a redeploy countdown (b.snap `down`, - * render/units.js); summons, devices and enemies simply leave. - */ - isDown(u) { - return !!u && u.side === 'ally' && u.kind === 'op' && !u.alive && !u.removed && u.removeReason !== 'raid' - && u.deploySeq > 0 && Number.isFinite(u.respawnAt); - } - - /** - * constants.js DOWN_STATE of a down operator: its timer runs, or it waits for its tile / the DP — the same checks as - * _checkRedeploys (a living unit or another body on its rest tile). No ally may take the tile it lies on (downOn), so - * WAIT_TILE is a safeguard only. - */ - _downState(u) { - if (this.time + 1e-9 < u.respawnAt) return DOWN_STATE.COUNTING; - const [r, c] = this.restTile(u); - const occ = this._occ[r * COLS + c]; - if ((occ && occ.alive && occ !== u) || this.downOn(r, c, u)) return DOWN_STATE.WAIT_TILE; - const ps = this.getPlayer(u.ownerId); - return !ps || ps.dp + 1e-9 < u.base.cost ? DOWN_STATE.WAIT_DP : DOWN_STATE.COUNTING; - } - - /** - * Field meta for m.field: { fieldId, kind, rect, stageId, units: UnitInfo[] } — the units on the field, knocked-out - * operators waiting to redeploy included (a client joining mid-battle shows them down). - */ - fieldMeta() { - return { - fieldId: this.fieldId, kind: this.kind, rect: { ...this.rect }, stageId: this.stageId, - units: this.units.filter((u) => (u.alive && u.deployed && !u.hidden) || this.isDown(u)).map(unitInfo), - }; - } - - /** Run a content callback (skill/buff/projectile/timer/install) isolated from errors; shares the hook depth guard. */ - _safe(fn, label, owner = null) { - if (this._emitDepth >= MAX_HOOK_DEPTH) { - this._handlerError(`hookDepth:${label}`, owner, new Error(`callback nesting deeper than ${MAX_HOOK_DEPTH}; skipped — ${this._chain(label)}`)); - return undefined; - } - const d = this._emitDepth++; - this._frameName[d] = label; - this._frameOwner[d] = owner; - this._frameCtx[d] = null; - try { return fn(); } catch (e) { this._handlerError(label, owner, e); return undefined; } finally { this._emitDepth--; } - } - - _handlerError(label, owner, e, internal = false) { - this.errorCount++; - const who = owner && owner.defId ? owner.defId : (owner && owner.name) || ''; - const key = `${label}|${who}|${e && e.message}`; - if (!this._errKeys.has(key)) { - this._errKeys.add(key); - if (this.errors.length < 100) this.errors.push({ label, who, message: String(e && e.message), stack: e && e.stack }); - if (this.opts.quiet !== true) this.logger.error?.(`[sim] ${label}${who ? ' (' + who + ')' : ''} failed: ${e && e.stack ? e.stack.split('\n').slice(0, 3).join(' | ') : e}`); - } - // Content handler errors are isolated (the handler is skipped, the battle continues). Repeated *engine* - // errors mean the field state is suspect: force-end it as a timeout (DESIGN §11). - if (internal) { - this.internalErrorCount = (this.internalErrorCount ?? 0) + 1; - if (this.internalErrorCount > MAX_INTERNAL_ERRORS && !this.finished && !this._forcing) { - this._forcing = true; - try { this.forceEnd('timeout'); } catch { this._hardFinish('timeout'); } - } - } - } - - _internalError(label, e) { this._handlerError('internal:' + label, null, e, true); } - [Symbol.for('nodejs.util.inspect.custom')]() { return `Battle<${this.kind} seed=${this.seed} t=${this.time.toFixed(2)} units=${this.units.length}${this.finished ? ' ' + this.reason : ''}>`; } +} - // exposed for ai/content convenience - effectiveProfile(u) { return effectiveProfile(u); } - /** - * Perform an immediate attack with a unit's current profile (content: "立即攻击", extra attacks, counters). It is an - * attack in every respect (hooks, attack SP, a running ammo skill's bullet) — except with `noAmmo: true`: an extra - * attack that spends no ammo (no `ammoUsed`, the skill never ends on it; 圣约送葬人 "不额外消耗弹药"). - * Returns true when an attack was made. - */ - forceAttack(u, targets = null, { noAmmo = false } = {}) { - if (!u || !u.alive || !u.profile) return false; - const prof = effectiveProfile(u); - const t = targets ?? acquireTargets(this, u, prof); - if (!t || !t.length) return false; - const n0 = u.stats.attacks; - performAttack(this, u, prof, t, noAmmo ? { noAmmo: true } : null); - return u.stats.attacks > n0; +// the method modules, in this order (a name defined twice is an error, never a silent override) +for (const part of [BattlePlayers, BattleLifecycle, BattleHooks, BattleSpawns, BattleDeploy, BattleBlocking, BattleStatus, BattleCombat, BattleQueries, BattleSummons, BattleTiles, BattleDisplacement, BattleEconomy, BattleEvents]) { + for (const key of Reflect.ownKeys(part.prototype)) { + if (key === 'constructor') continue; + if (Object.prototype.hasOwnProperty.call(Battle.prototype, key)) throw new Error(`Battle.${String(key)} is defined twice`); + Object.defineProperty(Battle.prototype, key, Object.getOwnPropertyDescriptor(part.prototype, key)); } } diff --git a/server/sim/battle/blocking.js b/server/sim/battle/blocking.js new file mode 100644 index 00000000..369e41f3 --- /dev/null +++ b/server/sim/battle/blocking.js @@ -0,0 +1,120 @@ +// server/sim/battle/blocking.js — Battle methods: blocking: the contact rule (block radius, capacity, fenced tiles, +// 起飞), the blocked targets of a blocker, block release and the 隐匿 switch-off after a block ends. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { ROWS, COLS, BLOCK_RADIUS_SQ, STEALTH_RESTORE } from '../constants.js'; +import { canTargetEnemy, stealthOffKey } from '../targeting.js'; + +export class BattleBlocking { + /** + * Try to block enemy `e` where it stands. Returns true if it is (now) blocked. Official contact rule (constants.js + * BLOCK_RADIUS, PRTS 游戏数据基础 §阻挡半径): the enemy's position within the blocker's block radius of the blocker's + * centre (ground 0.7071 — the tile's circumscribed circle, reaching 0.21 tile into the side neighbours; air 0.8944; + * devices 0.4472), and the blocker has free capacity for the enemy's block weight (and may block it at all: a unit on + * a fenced tile blocks no ground enemy, _blockerFor). Checked every tick for every + * unblocked enemy, moving or not, so an enemy overlapping an operator is taken over as soon as its blocker is gone or + * the operator's capacity frees up (user playtest #5 item 4). Several blockers in contact → the nearest [ASSUMED], + * ties → the first in row-then-column scan order. + */ + _checkBlock(e) { + if (e.blockedBy || e.hidden || !e.alive) return !!e.blockedBy; + const f = e.s.flags; + if (f.unblockable || f.levitate || f.fear) return false; + const r0 = Math.round(e.y), c0 = Math.round(e.x); + const w = e.blockWeight ?? 1; + let u = null, bd = Infinity; + const fly = e.isFlying; + for (let r = r0 - 1; r <= r0 + 1; r++) { + if (r < 0 || r >= ROWS) continue; + for (let c = c0 - 1; c <= c0 + 1; c++) { + // a diagonal neighbour's centre is ≥ √0.5 away: out of reach of the ground (and device) radius + if (c < 0 || c >= COLS || (!fly && r !== r0 && c !== c0)) continue; + const o = this._occ[r * COLS + c]; + if (!o || !this._blockerFor(o, e, w)) continue; + const d2 = (e.x - c) * (e.x - c) + (e.y - r) * (e.y - r); + const r2 = o.kind === 'device' ? BLOCK_RADIUS_SQ.device : fly ? BLOCK_RADIUS_SQ.fly : BLOCK_RADIUS_SQ.ground; + if (d2 < r2 && d2 < bd) { u = o; bd = d2; } + } + } + if (!u) return false; + e.blockedBy = u; + u.blocking.push(e); + e.moving = false; + if (this._hooks.blocked) this.emit('blocked', { blocker: u, enemy: e }); + return true; + } + + /** + * The enemies ally `u` blocks that it may target with `profile` — always selectable by their blocker, inside its range + * or not, whatever its facing ("可以选择且优先选择阻挡单位", PRTS 选择器; ai.js acquireTargets, the skills' DEFAULT + * trigger). That holds for a ranged operator on a melee tile too: the user's rule after playtest #6, "阻挡了就一定要能 + * 打到" — officially the collision pushes a blocked enemy to its blocker's front, so whatever blocks an enemy can hit + * it (DESIGN §20; it replaces the playtest #5 QA's melee-only restriction). Only for attacks that hit enemies: a heal + * attack never asks — it keeps selecting injured allies while its unit blocks (PRTS 卫戍协议/帮助 "对于医疗干员 + * （咒愈师分支除外），攻击目标为需要治疗的单位"; PRTS 选择器 adds only the blocked units its side can pick). + */ + blockedTargets(u, profile) { + const out = []; + if (!u || !u.blocking || !u.blocking.length) return out; + for (const e of u.blocking) if (e.blockedBy === u && canTargetEnemy(u, e, profile)) out.push(e); + return out; + } + + /** + * Can ally/device `u` block enemy `e` (block weight `w`) right now — everything but the contact distance. A unit on a + * tile ground units cannot pass blocks no ground enemy: the fenced tiles (围墙 tile_fence_bound / 围栏 tile_fence — + * low ground, deployable, passable to flyers only) — PRTS 围墙 / 围栏 地形机制 "部署在其中的单位，若当前阻挡类型为'地面 + * 阻挡'则无法阻挡敌人". The gate reads the tile's ground passability; on the stages the fenced tiles are the only low + * tiles ground units cannot pass. Air blocking (blockFly against flyers) stays [ASSUMED: PRTS restricts the rule to + * 地面阻挡]. Nothing walks onto such a tile, so it matters for an enemy pushed or pulled against the fence + * (Battle.displace stops it at the tile edge, 0.5 from the fenced unit — inside the ground block radius). An airborne + * unit (起飞, flag `liftoff`: "不阻挡地面敌人…可以阻挡飞行敌人") blocks flyers only. + */ + _blockerFor(u, e, w) { + if (!u.alive || !u.deployed || u.hidden || u.s.flags.noBlock || u.s.flags.sleep) return false; + if (e.isFlying && !(u.s.flags.blockFly || (u.profile && u.profile.blockFly))) return false; + // ground enemies: only a ground unit that has not taken off (起飞 "不阻挡地面敌人": flag `liftoff`), standing on a tile + // ground units can pass (not a fenced 围墙 / 围栏 tile) + if (!e.isFlying && (!u.ground || u.s.flags.liftoff || this.grid.tile(u.tileR, u.tileC).pass !== 'ALL')) return false; + const cap = u.s.blockCnt; + if (cap <= 0) return false; + let used = 0; + for (const x of u.blocking) used += x.blockWeight ?? 1; + return used + w <= cap; + } + + _unblock(e) { + const bl = e.blockedBy; + if (!bl) return; + const i = bl.blocking.indexOf(e); + if (i >= 0) bl.blocking.splice(i, 1); + e.blockedBy = null; + this._stealthSwitch(e); + } + + /** Release every enemy blocked by ally `u` (death, retreat, block count drop, substitution…). */ + releaseBlocked(u) { + if (!u || !u.blocking || !u.blocking.length) return; + const was = u.blocking; + u.blocking = []; + for (const e of was) if (e.blockedBy === u) { e.blockedBy = null; this._stealthSwitch(e); } + } + + /** + * A block on enemy `e` just ended (every release goes through here: `_unblock`, `releaseBlocked`, ai.js + * enforceBlockCapacity). Each 隐匿 source it holds stays switched off for its restore time — PRTS 作战机制 §隐匿 "对于 + * 绝大部分可隐匿的敌人而言，在被我方单位阻挡后会解除隐匿，不被阻挡的3秒后重新进入隐匿" (STEALTH_RESTORE), or the source's + * own "（解除阻挡N秒后恢复）" (buff `data.stealthRestore`, content/enemies.js: 0 s / 1 s on some enemy pages) — as a + * `stealthOff` buff per source; meanwhile it is targetable, operator splash reaches it and it is drawn solid + * (targeting.js enemyStealthed). A new block inside the window lifts it again and its end restarts the window. Our + * operators' 隐匿 / 迷彩 are never lifted by blocking (only enemies get here). + */ + _stealthSwitch(e) { + if (!e || e.side !== 'enemy' || !e.alive || !e.s.flags.stealth) return; + for (const b of e.buffs.slice()) { + if (!b.flags || !b.flags.stealth) continue; + const t = Number.isFinite(b.data?.stealthRestore) ? b.data.stealthRestore : STEALTH_RESTORE; + if (t > 0) this.addBuff(e, { key: stealthOffKey(b.key), duration: t, flags: { stealthOff: true } }); + } + } +} diff --git a/server/sim/battle/combat.js b/server/sim/battle/combat.js new file mode 100644 index 00000000..e4fce6ee --- /dev/null +++ b/server/sim/battle/combat.js @@ -0,0 +1,59 @@ +// server/sim/battle/combat.js — Battle methods: damage, heal and HP loss (the guarded entry points of the damage.js +// pipeline), projectiles and forced attacks (ai.js performAttack). +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { dealDamage as pipeDamage, heal as pipeHeal, applyHpLoss, makeDamageInfo, reduceElement, leaderHitCancelled } from '../damage.js'; +import { effectiveProfile, performAttack, acquireTargets } from '../ai.js'; + +export class BattleCombat { + dealDamage(source, target, dmg) { + try { return pipeDamage(this, source, target, dmg); } catch (e) { this._internalError('dealDamage', e); return 0; } + } + + heal(source, target, amount, opts = {}) { + try { return pipeHeal(this, source, target, amount, opts); } catch (e) { this._internalError('heal', e); return 0; } + } + + /** + * HP loss that ignores DEF/RES, dodge and shields (流失). May kill. opts: { source, silent, tags, from } — `from` = the + * DamageInfo this loss derives from (damage passed on to a leader, split, shared…): its tags are inherited and it is + * kept as `dmg.origin`, so `damaged` handlers that skip their own tagged damage also skip what it turned into; a loss + * derived from 无来源 damage (`from.sourceless`, element bursts) is 无来源 too (hooks see no source, `source` is credited). + * `sourceless: true` makes the loss itself 无来源 ("受到等量的无来源生命流失": hooks see no source; `source` keeps the + * credit — the stats and the per-player shared-pool tally). + * On a leader in a boss / hidden battle a loss of ≥ BOSS_HIT_LIMIT is cancelled like a hit (damage.js leaderHitCancelled). + */ + loseHp(target, amount, { source = null, silent = false, tags = null, from = null, sourceless = false } = {}) { + if (!target || !target.alive || !(amount > 0)) return 0; + // 限伤 (shared/constants.js BOSS_HIT_LIMIT): a loss passed on to a leader (parts' 传递, 无人机) is one hit too + if (leaderHitCancelled(this, target, amount)) return 0; + const t = ['hpLoss']; + for (const list of [from && from.tags, tags]) if (Array.isArray(list)) for (const x of list) if (!t.includes(x)) t.push(x); + return applyHpLoss(this, source, target, amount, { type: 'true', tags: t, noSp: true, silent, origin: from ?? null, sourceless: !!sourceless || !!(from && from.sourceless) }); + } + + reduceElement(target, amount, element = null) { return reduceElement(target, amount, element); } + + makeDamage(d) { return makeDamageInfo(d); } + + addProjectile(p) { return this.projectiles.add(p); } + + // exposed for ai/content convenience + effectiveProfile(u) { return effectiveProfile(u); } + + /** + * Perform an immediate attack with a unit's current profile (content: "立即攻击", extra attacks, counters). It is an + * attack in every respect (hooks, attack SP, a running ammo skill's bullet) — except with `noAmmo: true`: an extra + * attack that spends no ammo (no `ammoUsed`, the skill never ends on it; 圣约送葬人 "不额外消耗弹药"). + * Returns true when an attack was made. + */ + forceAttack(u, targets = null, { noAmmo = false } = {}) { + if (!u || !u.alive || !u.profile) return false; + const prof = effectiveProfile(u); + const t = targets ?? acquireTargets(this, u, prof); + if (!t || !t.length) return false; + const n0 = u.stats.attacks; + performAttack(this, u, prof, t, noAmmo ? { noAmmo: true } : null); + return u.stats.attacks > n0; + } +} diff --git a/server/sim/battle/deploy.js b/server/sim/battle/deploy.js new file mode 100644 index 00000000..9b51e715 --- /dev/null +++ b/server/sim/battle/deploy.js @@ -0,0 +1,255 @@ +// server/sim/battle/deploy.js — Battle methods: deployment, death and redeploy: _deploy (home, landing or rest tile; 联防 +// carry), kill / retreat and the removal bookkeeping (_remove, hooks of removed units released at step end), redeploy / +// automatic redeploys, leaks. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { COLS } from '../constants.js'; +import { unitInfo } from '../snapshot.js'; +import { fin } from './util.js'; + +export class BattleDeploy { + /** + * Deploy `u` on its home tile, or on `tile` ([r, c]: a one-off landing tile — the home stays the board tile; an + * operator that left the field comes back on its body tile, restTile). `keepSp` = { sp, charges } + * restored right after the skill reset, before the `deploy` hook fires. + */ + _deploy(u, { initial = false, carry = null, tile = null, keepSp = null } = {}) { + if ((u.alive && u.deployed) || u._removing) return false; + const R0 = tile ? tile[0] : u.homeR, C0 = tile ? tile[1] : u.homeC; + if (!this.grid.inRect(R0, C0)) { + this.log(`${u} at ${R0},${C0} is outside the field rect; not deployed`); + if (!tile) u.removed = true; + return false; + } + const k = R0 * COLS + C0; + const occ = this._occ[k]; + if (occ && occ !== u && occ.alive && occ.deployed) { this.log(`tile ${R0},${C0} occupied; ${u} not deployed`); return false; } + // "倒地干员所在地块视为可部署，但所有我方单位在此处的部署行为将被阻止" (PRTS 卫戍协议/帮助 §作战阶段 单位部署) + if (this.downOn(R0, C0, u)) { this.log(`a knocked-out operator lies on ${R0},${C0}; ${u} not deployed`); return false; } + const first = u.deploySeq === 0; + u.alive = true; + u.deployed = true; + u.removed = false; + u.hidden = false; + u.body = null; + u.x = C0; u.y = R0; u.tileR = R0; u.tileC = C0; + u.blocking = []; + u.deploySeq = ++this._deploySeq; + u.aggroSeq = u.deploySeq; + u.deployedAt = this.time; + u.atkCd = 0; + u.lastAttackAt = -Infinity; + u.elem.burn = u.elem.neural = u.elem.necrosis = u.elem.apoptosis = u.elem.erosion = 0; + u.ground = this.grid.isLow(R0, C0) && !this._elevated?.has(k); + u.markDirty(); + u.hp = u.s.maxHp; + // 联防 carry (PRTS 卫戍协议/帮助 §联防阶段 "将对应单位的生命比例、技力修改至与上一阶段结束时相同（召唤物仅修改技力…）"): + // an operator's HP ratio here, the SP in skill.reset and again after the `deploy` hook (below) — a summon's SP only + const cs = initial || (first && this._startDeploying) ? (carry ?? u.carry) : null; + if (cs && u.kind === 'op' && Number.isFinite(cs.hpPct)) u.hp = Math.max(1, u.s.maxHp * Math.max(0.01, Math.min(1, cs.hpPct))); + this._occ[k] = u; + this._refreshRange(u); // also rebuilds baseRangeKeys (initial range incl. permanent rangeExtend) + if (!u.skill) this._setupUnit(u); + u.skill.reset(cs); + const sk = u.skill; + // "自动操作具有3s冷却，在完成一次操作或作战开始时部署的单位将进入冷却" (PRTS 卫戍协议/帮助; skills.js) + if (initial) sk.opReadyAt = this.time + this.flags.startOpCooldown; + if (keepSp && !sk.noSkill && sk.kind !== 'passive' && !sk.active) { + sk.charges = Math.max(0, Math.min(sk.maxCharges, Math.floor(fin(keepSp.charges, 0)))); + sk.sp = Math.max(0, Math.min(sk.spCost, fin(keepSp.sp, 0))); + if (sk.charges >= sk.maxCharges) sk.sp = sk.spCost; + } + if (first) this._ev(['spawn', unitInfo(u)]); + this._ev(['deploy', u.id]); + if (this._hooks.deploy) this.emit('deploy', { unit: u, initial }); + // 联防: "部署完成后，将对应单位的…技力修改至与上一阶段结束时相同" — the carried SP is set again once the deployment is + // done, so a deploy-time SP gift (独行, 黄沙罗盘 …) does not come on top of it; later redeploys keep those gifts + if (cs && Number.isFinite(cs.sp) && u.alive && u.skill) u.skill.setSpTotal(cs.sp); + return true; + } + + /** Mark `unit` dead (hp reached 0). Fires `kill` then `death`. */ + kill(unit, killer = null) { + if (!unit || !unit.alive) return; + unit.hp = 0; + if (this._hooks.kill) this.emit('kill', { killer, victim: unit }); + // a nested kill/retreat inside the handlers already removed it: a later handler's hp write must not stick + if (!unit.alive) { if (!unit.bossPool) unit.hp = 0; return; } + if (unit.hp > 0 && !unit.bossPool) { // revived by a kill handler (clamped: a handler may write any number) + unit.hp = Math.min(unit.hp, unit.s.maxHp); + return; + } + unit.hp = 0; // NaN / negative writes from handlers + this._remove(unit, 'killed', killer); + } + + /** + * Withdraw an ally without a kill (it may redeploy after its respawn time): an operator lies down where it stood and + * comes back there (isDown, GitHub #60) — unless `permanent`, or the 突袭 retreat ('raid') that redeploys it at once. + */ + retreat(unit, { reason = 'retreat', permanent = false } = {}) { + if (!unit || !unit.alive || unit.side !== 'ally') return; + this._remove(unit, reason, null, permanent); + } + + _remove(unit, reason, killer = null, permanent = false) { + unit.alive = false; + unit.removeReason = reason; + unit.deployed = false; + unit.deathAt = this.time; + // while the removal bookkeeping runs, a skill onEnd handler must not redeploy the unit (it would come back + // alive but without its tile in _occ, its buffs wiped and a respawn timer pending) — redeploy from `death` instead + unit._removing = true; + if (unit.skill && unit.skill.active) { + this._safe(() => unit.skill.end('death'), 'skill.end', unit); + unit.skill.active = false; + } + unit._removing = false; + if (unit.side === 'ally') { + this.releaseBlocked(unit); + const k = unit.tileR * COLS + unit.tileC; + if (this._occ[k] === unit) this._occ[k] = null; + // keep persistent buffs only + const kept = []; + for (const b of unit.buffs) { + if (b.persist) kept.push(b); + else if (b.visible || b.status) this._ev(['status', unit.id, b.status ?? b.key, 0]); + } + unit.buffs = kept; + unit.markDirty(); + if (unit.kind === 'op' && !permanent) { + if (reason === 'killed') { const pp = this._pp(unit.ownerId); if (pp) pp.deaths++; } + const mul = unit.persist.redeployMul * unit.s.redeployMul; + unit.respawnAt = this.time + Math.max(0, unit.base.respawnTime * mul); + if (this.isDown(unit)) this._layBody(unit); // before `die` / `death`: the body's tile is final for them + } else { + unit.removed = true; + } + if (unit.kind === 'device' && unit.obstacle) this.grid.setObstacle(unit.tileR, unit.tileC, false, unit.obstacleKind); + } else { + unit.removed = true; + this._unblock(unit); + this._enemiesDirty = true; + if (reason === 'killed') { + if (unit.counted) { + this.killed++; + const pp = this._pp(unit.ownerId); + if (pp) pp.killed++; + } + if (killer) killer.stats.kills++; + if (unit.bounty && unit.bounty.coins > 0) { + const payee = killer && killer.side === 'ally' && killer.ownerId != null ? killer.ownerId : (unit.bounty.ownerPlayerId ?? unit.ownerId); + this.addCoins(payee, unit.bounty.coins); + } + } + } + // the reason ('killed' | 'retreat' | 'expired' | …) lets the client keep the knock-down sound for real knock-outs + if (reason !== 'leak') this._ev(['die', unit.id, reason]); + if (this._hooks.death) this.emit('death', { unit, reason, killer }); + if (unit.removed) this._toRelease.push(unit); + } + + /** + * Drop hooks and periodic timers (`every`) owned by permanently removed units (killed/leaked enemies, expired + * tokens, destroyed devices). Runs at the end of the step, so the unit's own death/leak handlers still fire; + * one-shot `after` callbacks are kept (they run once and are gone). Without this, per-enemy content hooks pile up + * and every emit walks the handlers of every enemy that ever spawned. + */ + _releaseRemoved() { + const set = new Set(); + for (const u of this._toRelease) if (u.removed && !u.alive) set.add(u); + this._toRelease = []; + if (!set.size) return; + for (const name of Object.keys(this._hooks)) { + const list = this._hooks[name]; + let w = 0; + for (let i = 0; i < list.length; i++) { + const h = list[i]; + if (h.owner != null && set.has(h.owner)) h.removed = true; + else list[w++] = h; + } + list.length = w; + if (!w) delete this._hooks[name]; + } + for (const sc of this._sched) if (sc.interval > 0 && sc.owner != null && set.has(sc.owner)) sc.cancelled = true; + } + + /** + * Immediately redeploy a dead (or retreated) ally on its rest tile (restTile: where an operator that left the field + * lies, else its home tile). opts: + * free=true no DP cost (false: pays `base.cost`, refused when the player lacks the DP) + * tile=[r,c] land on this in-rect tile instead (the home stays the board tile); refused (false) when the tile is + * outside the rect, a living unit stands there or another knocked-out operator lies there — no fallback + * keepSp keep the SP / charges the unit had (保留技力): restored before the `deploy` hook fires + * Returns true when the unit was deployed (full HP, `deploy {initial:false}` fires). + */ + redeploy(unit, { free = true, tile = null, keepSp = false } = {}) { + if (!unit || unit.side !== 'ally' || unit.alive || unit.removed) return false; + let at = null; + if (tile != null) { + if (!Array.isArray(tile) || !Number.isInteger(tile[0]) || !Number.isInteger(tile[1]) || !this.grid.inRect(tile[0], tile[1])) return false; + at = [tile[0], tile[1]]; + } else { + const rest = this.restTile(unit); + if (rest[0] !== unit.homeR || rest[1] !== unit.homeC) at = rest; + } + const k = at ? at[0] * COLS + at[1] : unit.homeR * COLS + unit.homeC; + const occ = this._occ[k]; + if (occ && occ.alive && occ !== unit) return false; + if (at && this.downOn(at[0], at[1], unit)) return false; + const ps = this.getPlayer(unit.ownerId); + const cost = unit.base.cost; + let paid = 0; + if (!free) { + if (!ps || ps.dp + 1e-9 < cost) return false; + paid = Math.min(ps.dp, cost); + ps.dp = Math.max(0, ps.dp - cost); // paid before `deploy` fires (handlers see the new DP) + } + const sk = unit.skill; + const keep = keepSp && sk && !sk.noSkill && sk.kind !== 'passive' ? { sp: sk.sp, charges: sk.charges } : null; + if (this._deploy(unit, { initial: false, tile: at, keepSp: keep })) return true; + if (paid > 0 && ps) ps.dp = Math.min(this.flags.dpMax, ps.dp + paid); + return false; + } + + /** + * Automatic redeploys (DESIGN §5.5): an operator that left the field and whose timer is done comes back on its rest + * tile — where it lies ("满足再部署条件时，移除场上的该倒地干员并自动部署至该位置", PRTS 卫戍协议/帮助) — when that tile + * is free and its player has the DP. + */ + _checkRedeploys() { + for (const u of this.allyUnits) { + if (u.alive || u.removed || u.kind !== 'op') continue; + if (this.time + 1e-9 < u.respawnAt) continue; + // the DP first: an operator past its timer mostly waits for DP, and the tile checks scan every ally + const ps = this.getPlayer(u.ownerId); + const cost = u.base.cost; + if (!ps || ps.dp + 1e-9 < cost) continue; + const [r, c] = this.restTile(u); + const occ = this._occ[r * COLS + c]; + if (occ && occ.alive && occ !== u) continue; + if (this.downOn(r, c, u)) continue; + ps.dp = Math.max(0, ps.dp - cost); + this._deploy(u, { initial: false, tile: r === u.homeR && c === u.homeC ? null : [r, c] }); + } + } + + /** Leak: an enemy reached its goal. */ + leak(e) { + if (!e || !e.alive || e.side !== 'enemy') return; + this._recordLeak(e, false); + this._remove(e, 'leak'); + this._ev(['leak', e.id]); + if (this._hooks.enemyLeak) this.emit('enemyLeak', { enemy: e }); + } + + _recordLeak(e, timeout) { + const owner = timeout ? e.ownerId : this._ownerForTile([Math.round(e.y), Math.round(e.x)]) ?? e.ownerId; + const pp = this._pp(owner) ?? this._pp(e.ownerId); + if (pp) { + pp.leaked.push({ enemyKey: e.defId, mods: e.mods ?? null, lpr: e.lpr ?? 1, sourcePlayerId: e.sourcePlayerId ?? e.ownerId, tag: e.tag ?? null, counted: !!e.counted || e.isBoss, boss: e.isBoss || undefined, spawned: true }); + if (e.counted || e.isBoss) pp.perfect = false; + } + if (e.counted) this.leakedCount++; + } +} diff --git a/server/sim/battle/displacement.js b/server/sim/battle/displacement.js new file mode 100644 index 00000000..dfa80be1 --- /dev/null +++ b/server/sim/battle/displacement.js @@ -0,0 +1,147 @@ +// server/sim/battle/displacement.js — Battle methods: displacement of enemies: 受力等级 (force − weight), push (radial / +// directional), pull, the raw mover displace and who can be moved at all. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { COLS, PUSH_TILES, PUSH_TILES_EFFECT, PULL_WEAK_SHARE, PULL_CRAWL, PULL_ORIGIN, PULL_STOP_RADIUS, PUSH_DIRECTIONAL_MIN_DIST } from '../constants.js'; +import { fin } from './util.js'; + +/** + * Official push distance (tiles) of a 受力等级 (constants.js PUSH_TILES: ≤ −3 → 0, ≥ 3 → the 3 value); `effect` = a 特效 + * push (PRTS 推与拉's 特效 column, PUSH_TILES_EFFECT: 见行者), else the 弹道 column. + */ +export function pushTiles(level, effect = false) { + const l = Math.round(fin(level, -99)); + if (l <= -3) return 0; + return (effect ? PUSH_TILES_EFFECT : PUSH_TILES)[Math.min(3, l)]; +} + +export class BattleDisplacement { + /** + * 受力等级 of enemy `e` under a push / pull of 力度 `force` (微小力 −1, 小力 0, 中力 1, 较大力 2, 大力 3, 大力+1 4, 特大力 5): + * force − its current 重量等级 (massLevel incl. 失重) — PRTS 游戏数据基础 §重量公式, 推与拉 (user playtest #6 item 14). + */ + forceLevel(e, force) { + return Math.round(fin(force, 0)) - (e && e.s ? e.s.massLevel : 0); + } + + /** + * Push enemy `e` with 力度 `force` (PRTS 推与拉 §推力): the official distance of its 受力等级 (constants.js PUSH_TILES: + * a 中力 push moves a weight-1 enemy 1.7 tiles, a weight-2 one 0.44, weight 3 0.12, weight ≥ 4 not at all). Radial + * (the default: away from `from`, the pusher's centre — "沿着干员向自身中心点的射线方向"; the client's buff template + * knockback[relative]: 琳琅诗怀雅 S3, 山 S3, 莫斯提马 S3) or directional (`dir` = the pusher's direction {x, y}; template + * knockback[dir], Knockback {_useSourceDirection: true, _decreaseForceLevelWhenNotInDirection: 2}: 推击手, 野鬃 S2 + * "往攻击方向"); a directional push on a target more than 45° off `dir` or nearer than 0.25 tile becomes radial with + * 受力等级 −2 ("特殊修正"). `fixed` waives both corrections (圣聆初雪 S1 "朝部署方向": KnockBackWithCharacterDirection, + * PRTS 备注 "不会因角度过大或距离过近而变化方向与力度"); `fixedAngle` only the angle one (PRTS 见行者 S2 备注 "不会因为角度过大 + * 而改变推动的方向或削减力度" — the < 0.25 tile rule still applies). `inward` = a radial push towards `from` (薄绿 S2's "拖拽", PRTS 备注 "实际为 + * 反方向（指向薄绿方向）的推开"), never nearer than PULL_STOP_RADIUS to its centre [ASSUMED: "至面前"]. `effect` = a 特效 + * push (PRTS 推与拉: one frame less of travel than a 弹道 push — constants.js PUSH_TILES_EFFECT / PUSH_EFFECT_SKILLS). + * Returns the tiles moved. + */ + push(e, force, { from = null, dir = null, fixed = false, fixedAngle = false, inward = false, effect = false } = {}) { + if (!this._displaceable(e)) return 0; + let level = this.forceLevel(e, force); + const fx0 = fin(from?.x, e.x), fy0 = fin(from?.y, e.y); + const vx = e.x - fx0, vy = e.y - fy0, d = Math.hypot(vx, vy); + let ux = 0, uy = 0; + const dirX = dir ? fin(dir.x, 0) : 0, dirY = dir ? fin(dir.y, 0) : 0; + const dl = Math.hypot(dirX, dirY); + if (dl > 0) { + ux = dirX / dl; uy = dirY / dl; + if (from && !fixed && (d < PUSH_DIRECTIONAL_MIN_DIST || (!fixedAngle && vx * ux + vy * uy < d * Math.SQRT1_2))) { + level -= 2; + if (d > 1e-6) { ux = vx / d; uy = vy / d; } + } + } else if (d > 1e-6) { ux = vx / d; uy = vy / d; } + else if (!inward && from && Array.isArray(from.fwd)) { ux = from.fwd[1]; uy = from.fwd[0]; } + else return 0; + let dist = pushTiles(level, effect); + if (inward && !(dl > 0)) { ux = -ux; uy = -uy; dist = Math.min(dist, Math.max(0, d - PULL_STOP_RADIUS)); } + return this.displace(e, { x: ux, y: uy }, dist); + } + + /** + * Pull enemy `e` with 力度 `force` towards the point `to` (PRTS 推与拉 §拉力 / §捕网): 受力等级 ≥ 0 — all the way, until it + * is within `stop` tiles of `center` (急停; `center` defaults to `to`, `stop` to PULL_STOP_RADIUS) or reaches `to`; + * −1 — PULL_WEAK_SHARE of its starting distance to `to`; −2 — PULL_CRAWL tiles; ≤ −3 — nothing. `pullToFront` aims at + * the official 拉力起点 in front of an operator. Returns the tiles moved. + */ + pull(e, force, { to, center = null, stop = PULL_STOP_RADIUS } = {}) { + if (!this._displaceable(e) || !to) return 0; + // an enemy the puller itself blocks already stands in front of it (at contact) [ASSUMED: no pull, no unblocking] + if (center && center.side === 'ally' && e.blockedBy === center) return 0; + const tx = fin(to.x, e.x), ty = fin(to.y, e.y); + const dx = tx - e.x, dy = ty - e.y, d0 = Math.hypot(dx, dy); + if (!(d0 > 1e-6)) return 0; + const ux = dx / d0, uy = dy / d0; + // travel until inside the stop circle around `center` (smaller root of |e + t·u − c| = stop), else up to `to` + let full = d0; + const cx = fin(center?.x, tx), cy = fin(center?.y, ty), r = Math.max(0, fin(stop, 0)); + const wx = e.x - cx, wy = e.y - cy, wu = wx * ux + wy * uy, w2 = wx * wx + wy * wy; + if (w2 <= r * r) full = 0; + else { + const disc = wu * wu - w2 + r * r; + if (disc >= 0) { const t = -wu - Math.sqrt(disc); if (t >= 0) full = Math.min(full, t); } + } + const level = this.forceLevel(e, force); + const dist = level >= 0 ? full : level === -1 ? Math.min(full, PULL_WEAK_SHARE * d0) : level === -2 ? Math.min(full, PULL_CRAWL) : 0; + return dist > 1e-6 ? this.displace(e, { x: ux, y: uy }, dist) : 0; + } + + /** Official distance (tiles) a push of 力度 `force` would move `e` on open ground (0 when it cannot be displaced). */ + pushDistance(e, force, { effect = false } = {}) { + return this._displaceable(e) ? pushTiles(this.forceLevel(e, force), effect) : 0; + } + + /** Pull `e` "至面前" of ally `unit` (拉力起点 PULL_ORIGIN tiles ahead along its direction, 急停 around its centre). */ + pullToFront(e, unit, force) { + if (!unit) return 0; + const f = Array.isArray(unit.fwd) ? unit.fwd : [0, 1]; + return this.pull(e, force, { to: { x: unit.x + f[1] * PULL_ORIGIN, y: unit.y + f[0] * PULL_ORIGIN }, center: unit, stop: PULL_STOP_RADIUS }); + } + + /** + * Can `e` be displaced at all: a living enemy, not a leader part of the boss pool, not 失衡免疫 (flag `noDisplace`: + * 近地悬浮, 浮空, the 胄 parts …) and not a 静态刚体 (data `staticBody`). PRTS 特殊机制 静态刚体: such a unit "可以进入 + * 失衡状态 … 但物理层面上无法产生任何速度或移动" — every air unit of the mode except “炎佑”, plus the boss 昆图斯 (build-data + * STATIC_BODIES; player report after 0.1.0, "飞机可以被薄绿的技能拉走"). A skill that reaches it still hits it (its targeting + * is the skill's own: 锏 S3, 薄绿, the 钩索师 …); only the movement is 0, so distance-based effects (drag damage, 见行者 S2's + * wall stun) come to nothing. [ASSUMED] the 0.1 s 失衡硬直 a 静态刚体 still gets is not modelled (no displacement models it). + */ + _displaceable(e) { + return !!(e && e.alive && e.side === 'enemy' && !e.isBoss && !e.s.flags.noDisplace && !(e.def && e.def.staticBody)); + } + + /** + * Move an enemy `distance` tiles along `dir` = {x, y} (normalised internally) over passable tiles — the raw mover of + * push() / pull(), which apply the official 力度 − 重量 rules (content uses those; the old `force` option is gone). + * 失衡免疫 (flag `noDisplace`: 近地悬浮, 浮空 — PRTS 异常效果 "不会被位移影响"), 静态刚体 (data `staticBody`) and leaders + * ⇒ no movement (_displaceable). The tiles it may cross follow its movement (`motion`): a hovering enemy walks the + * ground, so it stays on ground-passable tiles. + */ + displace(e, dir, distance) { + if (!this._displaceable(e) || !dir) return 0; + const dxv = fin(dir.x, 0), dyv = fin(dir.y, 0); + const len = Math.hypot(dxv, dyv); + if (!(len > 0)) return 0; + const eff = Math.min(fin(distance, 0), 2 * COLS); + if (!(eff > 0)) return 0; + const ux = dxv / len, uy = dyv / len; + let moved = 0; + const stepLen = 0.1; + while (moved + 1e-9 < eff) { + const s = Math.min(stepLen, eff - moved); // (the last step is a partial one: 0.12 tiles moves 0.12, not 0.2) + const nx = e.x + ux * s, ny = e.y + uy * s; + const r = Math.round(ny), c = Math.round(nx); + const ok = e.motion === 'FLY' ? this.grid.inRect(r, c) : this.grid.groundPassable(r, c); + if (!ok) break; + e.x = nx; e.y = ny; moved += s; + } + if (moved > 0) { + this._unblock(e); + if (e.route) e.route.pts = null; + this.fx('displace', { x: e.x, y: e.y, id: e.id }); + } + return moved; + } +} diff --git a/server/sim/battle/economy.js b/server/sim/battle/economy.js new file mode 100644 index 00000000..e3e1861b --- /dev/null +++ b/server/sim/battle/economy.js @@ -0,0 +1,58 @@ +// server/sim/battle/economy.js — Battle methods: DP, IN_BATTLE bond layer gains (capped by layerGainRoom) and bounty +// coins. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { layerGainRoom } from '../../../shared/constants.js'; + +export class BattleEconomy { + addDp(playerId, n) { + const ps = this.getPlayer(playerId); + if (!ps || !Number.isFinite(n)) return 0; + ps.dp = Math.max(0, Math.min(this.flags.dpMax, ps.dp + n)); + return ps.dp; + } + + /** + * Record an IN_BATTLE layer gain (no-op when gains are disabled). Returns the layers added: at most the room left + * under BOND_LAYER_CAP (999, shared/constants.js) on the live copy — the client's AddBondCount `min(L + n, 999)`; the + * `layerGain` hook (魔王's +1 …) runs first, then the clamp; a bond already at the cap gains 0 (no hook, no event). + * Without a live copy of the bond (a partial PlayerBattleInput) the battle's own gains count; the match's settle + * clamps the persistent count the same way. + */ + addLayers(playerId, bondId, n, reason = '', opts = {}) { + if (!this.flags.layerGainsEnabled || !(n > 0) || !Number.isFinite(n) || playerId == null) return 0; + const pp = this._pp(playerId); + if (!pp) return 0; + const ps = this.getPlayer(playerId); + const live = ps && ps.bonds[bondId] ? (ps.bonds[bondId].layers ?? 0) : (pp.layerGains[bondId] ?? 0); + if (!(layerGainRoom(live, Infinity) > 0)) return 0; + const source = opts.source ?? null; + const ctx = { playerId, bondId, n, reason, source, tile: Array.isArray(opts.tile) ? opts.tile : this._sourceTile(source) }; + if (this._hooks.layerGain) { this.emit('layerGain', ctx); if (!(ctx.n > 0) || !Number.isFinite(ctx.n)) return 0; } + const add = layerGainRoom(live, ctx.n); + if (!(add > 0)) return 0; + pp.layerGains[bondId] = (pp.layerGains[bondId] ?? 0) + add; + if (ps && ps.bonds[bondId]) ps.bonds[bondId].layers = (ps.bonds[bondId].layers ?? 0) + add; + this._ev(['layer', playerId, bondId, add]); + return add; + } + + /** + * Tile of a gain's source unit ([r, c]): where it stands, or where it stood when it left the field during this very + * instant (a "被击倒时" gain fires from its `death`). null otherwise (no source, long gone, not a unit). + */ + _sourceTile(u) { + if (!u || typeof u !== 'object' || !Number.isFinite(u.x)) return null; + const here = u.alive && u.deployed && !u.hidden; + if (!here && !(u.deathAt === this.time && !u.alive)) return null; + return u.side === 'ally' ? [u.tileR, u.tileC] : [Math.round(u.y), Math.round(u.x)]; + } + + addCoins(playerId, n) { + const pp = this._pp(playerId); + if (!pp || !(n > 0) || !Number.isFinite(n)) return 0; + pp.coins += n; + this._ev(['bounty', playerId, n]); + return n; + } +} diff --git a/server/sim/battle/events.js b/server/sim/battle/events.js new file mode 100644 index 00000000..690b4c54 --- /dev/null +++ b/server/sim/battle/events.js @@ -0,0 +1,83 @@ +// server/sim/battle/events.js — Battle methods: client events (DESIGN §8.2 tuples, bounded buffer), the snapshot, field +// meta, fx and the sim log. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { EVENT_BUFFER_CAP } from '../constants.js'; +import { elementView } from '../damage.js'; +import { unitInfo, snapshotUnits } from '../snapshot.js'; + +export class BattleEvents { + fx(kind, params = {}) { + const { x = 0, y = 0, ...extra } = params || {}; + this._ev(['fx', kind, Math.round(x * 100) / 100, Math.round(y * 100) / 100, extra]); + } + + log(msg) { + const k = 'log:' + msg; + if (this._errKeys.has(k)) return; + this._errKeys.add(k); + if (this.opts.verbose) this.logger.warn?.(`[sim] ${msg}`); + } + + _ev(tuple) { + if (!this.recordEvents) return; + this._evq.push(tuple); + if (this._evq.length > EVENT_BUFFER_CAP) this._evq.splice(0, this._evq.length - EVENT_BUFFER_CAP / 2); + } + + /** Client-facing events since the last drain (DESIGN §8.2 tuples). */ + drainEvents() { + const ev = this._evq; + this._evq = []; + return ev; + } + + /** + * Compact full snapshot of this field (DESIGN §8.2 b.snap), plus (only when non-empty): + * down: [[id, respawnAt, respawnTime, state, row, col]] — operators that left the field waiting to redeploy (isDown): the + * game time their respawn timer ends, its length (s), constants.js DOWN_STATE and the tile they lie on (and + * come back on: _layBody — where they fell, or their home); + * elem: [[id, element, fill, cooldownEnd, cooldown]] — the element gauge each unit shows (damage.js elementView). + */ + snapshot() { + const snap = { + fieldId: this.fieldId, + t: Math.round(this.time * 1000) / 1000, + units: snapshotUnits(this.units, this.time), + dp: this.players.length ? Math.floor(this.players[0].dp) : 0, + killed: this.killed, + total: this.total, + }; + if (this.players.length > 1) { + snap.dps = {}; + for (const p of this.players) snap.dps[p.playerId] = Math.floor(p.dp); + } + if (this.sharedBoss) snap.boss = { hp: Math.max(0, Math.round(this.sharedBoss.hp)), max: Math.round(this.sharedBoss.maxHp) }; + const r2 = (v) => Math.round(v * 100) / 100; + let down = null; + for (const u of this.allyUnits) { + if (!this.isDown(u)) continue; + (down || (down = [])).push([u.id, r2(u.respawnAt), r2(Math.max(0, u.respawnAt - u.deathAt)), this._downState(u), ...this.restTile(u)]); + } + if (down) snap.down = down; + let elem = null; + for (const u of this.units) { + if (!u.alive || !u.deployed || u.hidden) continue; + const v = elementView(u, this.time); + if (v) (elem || (elem = [])).push([u.id, v[0], v[1], v[2], v[3]]); + } + if (elem) snap.elem = elem; + return snap; + } + + /** + * Field meta for m.field: { fieldId, kind, rect, stageId, units: UnitInfo[] } — the units on the field, knocked-out + * operators waiting to redeploy included (a client joining mid-battle shows them down). + */ + fieldMeta() { + return { + fieldId: this.fieldId, kind: this.kind, rect: { ...this.rect }, stageId: this.stageId, + units: this.units.filter((u) => (u.alive && u.deployed && !u.hidden) || this.isDown(u)).map(unitInfo), + }; + } +} diff --git a/server/sim/battle/hooks.js b/server/sim/battle/hooks.js new file mode 100644 index 00000000..a4acd262 --- /dev/null +++ b/server/sim/battle/hooks.js @@ -0,0 +1,188 @@ +// server/sim/battle/hooks.js — Battle methods: the hook bus (on / off / offOwner / emit, the MAX_HOOK_DEPTH guard and +// its chain diagnostics), the timers (after / every, run at the start of each tick) and the isolation of content +// callbacks (_safe, _handlerError: a failing handler is skipped and counted; repeated engine errors end the battle as a +// timeout). +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { TICK, MAX_INTERNAL_ERRORS, MAX_HOOK_DEPTH } from '../constants.js'; + +let hookSeq = 0; + +let schedSeq = 0; + +export class BattleHooks { + // ============================================================================================================= + // hook bus + + on(name, fn, opts = {}) { + if (typeof fn !== 'function') return null; + const h = { name, fn, priority: Number(opts.priority) || 0, owner: opts.owner ?? null, seq: ++hookSeq, removed: false, once: !!opts.once }; + const list = this._hooks[name] ?? (this._hooks[name] = []); + let i = list.length; + while (i > 0 && list[i - 1].priority < h.priority) i--; + list.splice(i, 0, h); + return h; + } + + off(nameOrHandle, fn) { + if (nameOrHandle && typeof nameOrHandle === 'object') { + const h = nameOrHandle; + h.removed = true; + const list = this._hooks[h.name]; + if (list) { + const i = list.indexOf(h); + if (i >= 0) list.splice(i, 1); + if (!list.length) delete this._hooks[h.name]; + } + return; + } + const list = this._hooks[nameOrHandle]; + if (!list) return; + for (let i = list.length - 1; i >= 0; i--) if (!fn || list[i].fn === fn) { list[i].removed = true; list.splice(i, 1); } + if (!list.length) delete this._hooks[nameOrHandle]; + } + + /** Remove every hook and scheduled callback registered with `owner`. */ + offOwner(owner) { + for (const name of Object.keys(this._hooks)) { + const list = this._hooks[name]; + for (let i = list.length - 1; i >= 0; i--) if (list[i].owner === owner) { list[i].removed = true; list.splice(i, 1); } + if (!list.length) delete this._hooks[name]; + } + for (const s of this._sched) if (s.owner === owner) s.cancelled = true; + } + + hasHook(name) { return !!this._hooks[name]; } + + emit(name, ctx) { + const list = this._hooks[name]; + if (!list) return ctx; + // Recursion guard: handlers that re-trigger their own event (damaged → dealDamage → damaged …) would otherwise + // recurse until a stack overflow, whose depth (and thus the outcome) depends on the machine — not deterministic. + if (this._emitDepth >= MAX_HOOK_DEPTH) { + this._handlerError(`hookDepth:${name}`, null, new Error(`hook nesting deeper than ${MAX_HOOK_DEPTH}; handlers skipped — ${this._chain(name)}`)); + return ctx; + } + const arr = list.length === 1 ? [list[0]] : list.slice(); + const d = this._emitDepth++; + this._frameCtx[d] = ctx; + try { + for (const h of arr) { + if (h.removed) continue; + this._frameName[d] = name; + this._frameOwner[d] = h.owner; + try { h.fn(ctx, this); } catch (e) { this._handlerError(`hook:${name}`, h.owner, e); } + if (h.once) this.off(h); + if (ctx && ctx.stopPropagation) break; + } + } finally { + this._emitDepth--; + } + return ctx; + } + + /** + * The open hook/callback frames (outermost first) — names the loop when the nesting guard trips, e.g. + * "chain: hit(enemy_1430_lrrook) > damaged(chess_char_3_18_a) > hit(enemy_1430_lrrook) > … > damaged". + */ + _chain(last) { + const id = (u) => (u && typeof u === 'object' ? (u.defId ?? u.name ?? '?') : u == null ? '' : String(u)); + const lab = (i) => { + const o = this._frameOwner[i]; + let who = id(o); + const c = this._frameCtx[i]; + if (!who && c && typeof c === 'object') { // global handler: show the units of the event instead + const a = c.source ?? c.attacker ?? c.killer ?? null, t = c.target ?? c.unit ?? c.victim ?? c.enemy ?? null; + who = a || t ? `${id(a)}→${id(t)}` : ''; + } + return `${this._frameName[i]}${who ? `(${who})` : ''}`; + }; + const n = this._emitDepth; + const parts = []; + for (let i = 0; i < Math.min(n, 4); i++) parts.push(lab(i)); + if (n > 12) parts.push('…'); + for (let i = Math.max(4, n - 8); i < n; i++) parts.push(lab(i)); + parts.push(last); + return `chain: ${parts.join(' > ')}`; + } + + // ============================================================================================================= + // scheduling + + after(seconds, fn, opts = {}) { + const s = { due: this.time + Math.max(0, Number(seconds) || 0), fn, owner: opts.owner ?? null, interval: 0, seq: ++schedSeq, cancelled: false, holdsBattle: !!opts.holdsBattle }; + s.cancel = () => { s.cancelled = true; }; + this._sched.push(s); + return s; + } + + every(seconds, fn, opts = {}) { + const iv = Math.max(TICK, Number(seconds) || TICK); + const s = { due: this.time + (opts.immediate ? 0 : iv), fn, owner: opts.owner ?? null, interval: iv, seq: ++schedSeq, cancelled: false, count: 0, holdsBattle: false }; + s.cancel = () => { s.cancelled = true; }; + this._sched.push(s); + return s; + } + + _runScheduled() { + if (!this._sched.length) return; + const now = this.time + 1e-9; + let due = this._sched.filter((s) => !s.cancelled && s.due <= now); + if (!due.length) { if (this._sched.some((s) => s.cancelled)) this._sched = this._sched.filter((s) => !s.cancelled); return; } + due.sort((a, b) => a.due - b.due || a.seq - b.seq); + for (const s of due) { + if (s.cancelled) continue; + if (s.interval > 0) { + let n = 0; + while (s.due <= now && !s.cancelled && n++ < 8) { + s.count++; + this._safe(() => s.fn(this, s), 'every', s.owner); + s.due += s.interval; + } + if (s.due <= now) s.due = this.time + s.interval; + } else { + s.cancelled = true; + this._safe(() => s.fn(this, s), 'after', s.owner); + } + } + this._sched = this._sched.filter((s) => !s.cancelled); + } + + // ============================================================================================================= + // callback isolation and errors + + /** Run a content callback (skill/buff/projectile/timer/install) isolated from errors; shares the hook depth guard. */ + _safe(fn, label, owner = null) { + if (this._emitDepth >= MAX_HOOK_DEPTH) { + this._handlerError(`hookDepth:${label}`, owner, new Error(`callback nesting deeper than ${MAX_HOOK_DEPTH}; skipped — ${this._chain(label)}`)); + return undefined; + } + const d = this._emitDepth++; + this._frameName[d] = label; + this._frameOwner[d] = owner; + this._frameCtx[d] = null; + try { return fn(); } catch (e) { this._handlerError(label, owner, e); return undefined; } finally { this._emitDepth--; } + } + + _handlerError(label, owner, e, internal = false) { + this.errorCount++; + const who = owner && owner.defId ? owner.defId : (owner && owner.name) || ''; + const key = `${label}|${who}|${e && e.message}`; + if (!this._errKeys.has(key)) { + this._errKeys.add(key); + if (this.errors.length < 100) this.errors.push({ label, who, message: String(e && e.message), stack: e && e.stack }); + if (this.opts.quiet !== true) this.logger.error?.(`[sim] ${label}${who ? ' (' + who + ')' : ''} failed: ${e && e.stack ? e.stack.split('\n').slice(0, 3).join(' | ') : e}`); + } + // Content handler errors are isolated (the handler is skipped, the battle continues). Repeated *engine* + // errors mean the field state is suspect: force-end it as a timeout (DESIGN §11). + if (internal) { + this.internalErrorCount = (this.internalErrorCount ?? 0) + 1; + if (this.internalErrorCount > MAX_INTERNAL_ERRORS && !this.finished && !this._forcing) { + this._forcing = true; + try { this.forceEnd('timeout'); } catch { this._hardFinish('timeout'); } + } + } + } + + _internalError(label, e) { this._handlerError('internal:' + label, null, e, true); } +} diff --git a/server/sim/battle/lifecycle.js b/server/sim/battle/lifecycle.js new file mode 100644 index 00000000..57fbbabd --- /dev/null +++ b/server/sim/battle/lifecycle.js @@ -0,0 +1,240 @@ +// server/sim/battle/lifecycle.js — Battle methods: lifecycle: start (the battle-start deployment: by column, operators +// then summons; 联防 forced exits; `battleStart`), step (the tick order of the Battle.js header), the end checks, timeout +// / forced / cleared finishes and the BattleResult. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { FORCED_EXIT, MAX_BATTLE_TIME } from '../constants.js'; +import { updateAlly, updateEnemy } from '../ai.js'; + +export class BattleLifecycle { + start() { + if (this.started) return; + this.started = true; + this._safe(() => this._spawnStageDevices(), 'stageDevices'); + // PRTS 卫戍协议/帮助 §作战阶段: "按从上到下>从左到右的顺序部署。优先部署干员，随后为召唤物（如果有）", noted "自卫戍协议： + // 盟约 下半（2026/3/14）起，部署顺序由“从左到右>从下到上”更改为“从上到下>从左到右”" — a scanning order: down each column + // (top first), the columns from left to right; act 1's along each row, the rows from the bottom. It is the order PRTS + // gives the 阿戈尔 devour ("从最先部署（更靠左和靠上的）的【阿戈尔】干员开始", content/bonds/core.js egirOrder) and the one + // act-2 videos show. Per player the operators, left column first, top to bottom within a column (the mirrored right + // boss side from its own left, i.e. the highest field column — PRTS "部署顺序…左右镜像", research 01 §4.3), then the + // summon pieces in the same order. Until 0.1.3 the top row came first (row-major). [ASSUMED] On a shared field (联防, + // boss) the players' fields deploy at the same time (PRTS: one unit after another with a fixed delay, from the battle + // start), so the i-th operators of all players come in together (in `players` order), then the summons likewise + const seq0 = this._deploySeq; + const lists = this.players.map((ps) => ps.units.filter((u) => u.kind === 'op' || u.kind === 'token').slice().sort((a, b) => + (ps.mirror ? b.homeC - a.homeC : a.homeC - b.homeC) || b.homeR - a.homeR || a.id - b.id)); + // a summon piece flagged `deferDeploy` by content (one its owner's loadout does not make — 赫默 on S1 with a drone + // piece —, or a skill's summon when shared/constants.js SKILL_SUMMON_START_DEPLOY is off: content/tokens.js + // dockSkillSummons) stays off the field, its tile reserved (isReservedTile), until content deploys it + // (_startDeploying: a board piece content brings in during this deployment — a tactician's 流形 / 狼群 comes with + // its owner's deploy — takes its 联防 carry on that first deployment too) + this._startDeploying = true; + for (const kind of ['op', 'token']) { + const per = lists.map((l) => l.filter((u) => u.kind === kind && !u.deferDeploy)); + const n = Math.max(0, ...per.map((l) => l.length)); + for (let i = 0; i < n; i++) for (const l of per) if (l[i]) this._safe(() => this._deploy(l[i], { initial: true }), 'initialDeploy', l[i]); + } + this._startDeploying = false; + // 仇恨 (targeting.js sortAllyTargets: the later deployed is attacked first): every summon that came in during the + // initial deployment — also one an operator's deploy brought along (a tactician's 援军, a start-of-battle summon) + // — ranks after all the operators (of every player on the field [ASSUMED]), in the order it came + const summons = this.allyUnits.filter((u) => u.kind === 'token' && u.alive && u.deployed && u.deploySeq > seq0).sort((a, b) => a.deploySeq - b.deploySeq); + for (const t of summons) t.aggroSeq = ++this._deploySeq; + // 联防 (PRTS 卫戍协议/帮助 "部署完成后…上一阶段为退场状态的干员强制退场"): an operator knocked out at the end of its + // own combat is withdrawn right after the deployment — down on its tile, its redeploy timer starting now (re-read + // after battleStart below; DESIGN §5.5). Its HP ratio is the end-of-phase one (0, as after kill()) until it + // redeploys at full HP. + for (const u of this.allyUnits) { + if (u.kind === 'op' && u.alive && u.carry && u.carry.down === true) { + this._safe(() => { u.hp = 0; this.retreat(u, { reason: FORCED_EXIT }); }, 'forcedExit', u); + } + } + this.emit('battleStart', {}); + // redeploy-time effects that start with the battle (机变 征召 "所有干员的再部署时间-50%", added by a battleStart + // handler) cover the operators forced out above too: their timer is re-read with them, as a later knock-out's is + for (const u of this.allyUnits) { + if (u.kind !== 'op' || u.alive || u.removed || u.removeReason !== FORCED_EXIT) continue; + u.respawnAt = u.deathAt + Math.max(0, u.base.respawnTime * u.persist.redeployMul * u.s.redeployMul); + } + } + + step() { + if (this.finished || this._stepping) return; // re-entrant step() from a hook is a no-op + // forceEnd() requested while stepping (content hook, repeated engine errors) is deferred to the end of the + // current phase: the remaining phases are skipped and the result is built once, so nothing mutates it later. + this._stepping = true; + try { + if (!this.started) this._phase('start', () => this.start()); + const dt = this.dt; + this._phase('scheduled', () => this._runScheduled()); + this._phase('spawns', () => this._processSpawns()); + this._phase('dp', () => { + for (const ps of this.players) ps.dp = Math.min(this.flags.dpMax, ps.dp + this.flags.dpPerSec * dt); + }); + this._phase('buffs', () => this._tickBuffs(dt)); + this._phase('enemies', () => { + // enemies spawned by hooks during this loop start moving next tick (a leak hook that spawns an enemy which + // leaks at once would otherwise loop forever inside a single tick) + const list = this.enemies; + for (let i = 0, n = list.length; i < n && !this._endReq; i++) { + const e = list[i]; + if (!e.alive) continue; + try { updateEnemy(this, e, dt); } catch (err) { this._internalError('updateEnemy', err); } + this._clampPos(e); + } + }); + this._compactEnemies(); + this._phase('enemyIndex', () => this._buildEnemyIndex()); + this._phase('allies', () => { + const list = this.allyUnits; + for (let i = 0; i < list.length && !this._endReq; i++) { + const u = list[i]; + if (!u.alive || !u.deployed) continue; + try { + if (u.skill) u.skill.tick(dt); + if (u.alive && u.kind !== 'device') updateAlly(this, u, dt); + } catch (err) { this._internalError('updateAlly', err); } + } + }); + this._phase('projectiles', () => this.projectiles.update(dt)); + this._phase('redeploy', () => this._checkRedeploys()); + this._phase('boss', () => this._bossSync()); + if (this._hooks.tick) this._phase('tickHook', () => this.emit('tick', { dt })); + this._compactEnemies(); + if (this._toRelease.length) this._releaseRemoved(); + if (!this._endReq && !this.finished) { + this.tickCount++; + this.time = this.tickCount * dt; // no floating drift over long battles + this._phase('endCheck', () => this._checkEnd()); + } + } finally { + this._stepping = false; + } + if (this._endReq && !this.finished) { + try { this.forceEnd(this._endReq); } catch (e) { this._handlerError('internal:forceEnd', null, e); this._hardFinish(this._endReq); } + } + } + + /** Last-resort finish when building the normal result threw (never throws itself). */ + _hardFinish(reason) { + if (this.finished) return; + this.finished = true; + this.reason = reason === 'timeout' ? 'timeout' : 'forced'; + this._endReq = null; + try { this._result = this._buildResult(); } catch { this._result = { time: this.time, reason: this.reason, perPlayer: {}, killed: this.killed, total: this.total, errors: this.errorCount }; } + this.projectiles.clear(); + } + + /** Run until finished or `maxSeconds` of game time elapsed. Returns the result when finished. */ + runToEnd(maxSeconds = MAX_BATTLE_TIME) { + const limit = this.time + maxSeconds; + while (!this.finished && this.time < limit) this.step(); + return this.finished ? this.result() : null; + } + + _phase(name, fn) { + if (this.finished || this._endReq) return; + try { fn(); } catch (e) { this._internalError(name, e); } + } + + _checkEnd() { + if (this.finished) return; + if (this.sharedBoss && this.sharedBoss.hp <= 0) { this._finish('cleared'); return; } + // A boss / hidden field with a shared pool ends only when the pool is empty or the match forces an end (DESIGN + // §5.5) — never merely because it emptied: the h07_04 pair leader (official route: no wait) can walk into the + // objective, and the field then idles while another field may still empty the pool or the overtime drain ends it. + const poolHolds = !!this.sharedBoss && (this.kind === 'boss' || this.kind === 'hidden'); + if (this.autoFinish && !poolHolds && !this._pending.length && !this.enemies.some((e) => e.alive) && this.started) { + if (!this._hasPendingEnemySchedules()) { this._finish('cleared'); return; } + } + if (this.time >= this.timeLimit - 1e-9) { this._timeout(); return; } + if (this.time >= MAX_BATTLE_TIME) { this._timeout(); return; } + } + + _hasPendingEnemySchedules() { + for (const s of this._sched) if (!s.cancelled && s.holdsBattle) return true; + return false; + } + + _timeout() { + // Remaining non-boss enemies on the field count as leaked (DESIGN §5.5). Spawns that never happened before the + // limit are dropped: they are removed from `total` and reported in `result().unspawned` (not leaks). A content-made + // neutral (`mem.noLeak`: 隐德来希's 心烛, which follows its original) is never a leak — it is in no spawn schedule, so + // a client result listing it would be rejected (fields.js validateClientResult 'leak key'). + for (const e of this.enemies) { + if (!e.alive || e.isBoss || e.mem.noLeak) continue; + this._recordLeak(e, true); + } + this.unspawned = []; + for (const p of this._pending) { + if (p.precounted) { + this.total--; + const pp = this._pp(p.ownerPlayerId ?? this._ownerForTile(p.pos ?? this._routeFor(p.routeIndex, p.route)?.start)); + if (pp) pp.total--; + } + this.unspawned.push({ enemyKey: p.enemyKey, time: p.time, tag: p.tag ?? null, sourcePlayerId: p.sourcePlayerId ?? null }); + } + this._pending = []; + this._finish('timeout'); + } + + forceEnd(reason = 'forced') { + if (this.finished) return; + if (this._stepping) { if (!this._endReq) this._endReq = reason; return; } // finalised when step() unwinds + this._endReq = null; + if (!this.started) this.start(); + if (this.finished) return; + if (reason === 'timeout') this._timeout(); + else this._finish('forced'); + } + + _finish(reason) { + if (this.finished) return; + this.finished = true; + this.reason = reason; + this._endReq = null; + const res = this._buildResult(); + this._result = res; + this.emit('battleEnd', { result: res }); + // re-sync fields that battleEnd handlers may have changed (layer gains / coins live in perPlayer objects) + for (const pid of Object.keys(res.perPlayer)) { + const pp = res.perPlayer[pid]; + pp.perfect = !pp.leaked.some((l) => l.counted !== false); + } + this.projectiles.clear(); + } + + _buildResult() { + const perPlayer = {}; + for (const ps of this.players) { + const pp = this._perPlayer[ps.playerId]; + pp.perfect = !pp.leaked.some((l) => l.counted !== false); + // the operators and the board's summon pieces (a board uid): 联防 carries an operator's HP ratio and SP, a summon's + // SP only (match/unite.js). `sp` is the official 技力 — stored charges included (PRTS 技能 "可充能X次…当前技力上限等于该 + // 技能技力需求的X倍"); a running skill spent its SP at activation, so it reports what was left (0 for one charge). + // `skillActive` is reported, never carried. + pp.unitsEnd = ps.units.filter((u) => u.kind === 'op' || (u.kind === 'token' && u.uid != null)).map((u) => ({ + uid: u.uid, id: u.id, defId: u.defId, + hpPct: u.alive ? Math.max(0, Math.min(1, u.hp / u.s.maxHp)) : 0, + sp: u.skill && !u.skill.noSkill ? Math.round(u.skill.spTotal * 100) / 100 : 0, + skillActive: !!(u.skill && u.skill.active && u.skill.kind !== 'passive'), + alive: !!u.alive, + })); + pp.unitStats = ps.units.map((u) => ({ + id: u.id, uid: u.uid, defId: u.defId, name: u.name, kind: u.kind, + dmg: Math.round(u.stats.dmg), kills: u.stats.kills, heal: Math.round(u.stats.heal), taken: Math.round(u.stats.taken), attacks: u.stats.attacks, + })); + perPlayer[ps.playerId] = pp; + } + const res = { time: Math.round(this.time * 1000) / 1000, reason: this.reason, perPlayer, killed: this.killed, total: this.total, errors: this.errorCount }; + if (this.unspawned && this.unspawned.length) res.unspawned = this.unspawned; + if (this.sharedBoss) res.bossHpLeft = Math.max(0, this.sharedBoss.hp); + return res; + } + + /** BattleResult (valid once finished; a provisional result before). */ + result() { + if (this._result) return this._result; + return this._buildResult(); + } +} diff --git a/server/sim/battle/players.js b/server/sim/battle/players.js new file mode 100644 index 00000000..1a29aa44 --- /dev/null +++ b/server/sim/battle/players.js @@ -0,0 +1,178 @@ +// server/sim/battle/players.js — Battle methods: players and units: board → field tiles and directions, ally creation +// from the PlayerBattleInput, token defs for an owner's loadout, and the kit / profile / skill setup of a unit. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { COLS, BOSS_ROW_OFFSET } from '../constants.js'; +import { Unit } from '../units.js'; +import { normDir, mirrorDir } from '../dir.js'; +import { SkillRuntime } from '../skills.js'; +import { resolveProfile } from '../professions.js'; +import { normalizeToken } from '../simdata.js'; +import { setupUnitKit } from '../content/index.js'; +import { clone } from './util.js'; + +export class BattlePlayers { + _addPlayer(p) { + const bossLike = this.kind === 'boss' || this.kind === 'hidden'; + const side = p.side === 'R' ? 'R' : 'L'; + const mirror = bossLike && side === 'R'; + const ps = { + playerId: p.playerId, + seat: p.seat ?? this.players.length, + side, + colOffset: Number(p.colOffset) || 0, + rowOffset: p.rowOffset, + coords: p.coords ?? 'board', + mirror, + facing: mirror ? -1 : 1, + // default direction of this player's units on this field (the FA right side is mirrored: RIGHT ↔ LEFT) + dir: mirror ? 'LEFT' : 'RIGHT', + half: mirror || (Number(p.colOffset) || 0) >= 8 ? 'R' : 'L', + bonds: clone(p.bonds ?? {}), + bandId: p.bandId ?? null, + playerEffects: clone(p.playerEffects ?? []), + lpForBoss: p.lpForBoss ?? null, + dp: this.flags.dpInit, + units: [], + input: p, + }; + this.players.push(ps); + this._perPlayer[ps.playerId] = { + killed: 0, total: 0, leaked: [], perfect: true, layerGains: {}, coins: 0, + damageDealt: 0, bossDamage: 0, healingDone: 0, deaths: 0, unitsEnd: [], unitStats: [], + }; + const late = []; + for (const u of p.units ?? []) { + try { + const unit = this._createAllyFromInput(ps, u); + if (unit && unit.kind === 'token' && !unit.ownerUnit && u.ownerUid != null) late.push([unit, u]); + } catch (e) { this._internalError('createUnit', e); } + } + // a token piece listed before its owner (board order is top→bottom) is linked once every unit exists, and takes + // the owner-level variant (elite owners: `_b` stats) of the owner's loadout (DESIGN §16) + for (const [t, inp] of late) { + const owner = ps.units.find((x) => x.kind === 'op' && x.uid === inp.ownerUid); + if (!owner) continue; + t.ownerUnit = owner; + const def = inp.def ? null : this._tokenDef(inp.tokenId ?? inp.chessId, owner, null); + if (!def || def === t.def) continue; + const st = def.stats; + t.def = def; t.defId = def.id; t.name = def.name; t.rangeGrid = def.rangeGrid; + Object.assign(t.base, { + maxHp: st.maxHp, atk: st.atk, def: st.def, res: st.res, aspd: st.aspd, bat: st.bat, blockCnt: st.blockCnt, spRecovery: st.spRecovery, + tauntLevel: st.tauntLevel, massLevel: st.massLevel, hpRecoveryPerSec: st.hpRecoveryPerSec, cost: st.cost, respawnTime: st.respawnTime, + }); + t.markDirty(); + t.hp = t.s.maxHp; + } + } + + /** Board → field tile for a player (see header). */ + mapTile(ps, row, col, abs = false) { + if (abs || ps.coords === 'field') return [row, col]; + const bossLike = this.kind === 'boss' || this.kind === 'hidden'; + let r = row; + if (ps.rowOffset != null) r = row + ps.rowOffset; + else if (bossLike && row >= 7) r = row + BOSS_ROW_OFFSET; + const c = ps.mirror ? (col <= 10 ? COLS - 1 - col : col) : col + ps.colOffset; + return [r, c]; + } + + /** + * Board direction → field direction for a player (DESIGN §3): as given (default RIGHT) except on the mirrored Final + * Assault right side, where RIGHT ↔ LEFT (UP / DOWN unchanged). `abs` / field coordinates are taken as they are. + */ + mapDir(ps, dir, abs = false) { + const d = normDir(dir); + return ps && ps.mirror && !abs && ps.coords !== 'field' ? mirrorDir(d) : d; + } + + _createAllyFromInput(ps, inp) { + // coerce (a string row would otherwise concatenate: "10" + -7 → "10-7"); non-integers never deploy + const row = Number(inp.row), col = Number(inp.col); + if (!Number.isInteger(row) || !Number.isInteger(col)) { this.log(`bad tile ${inp.row},${inp.col} for ${inp.chessId ?? inp.tokenId}`); return null; } + const [r, c] = this.mapTile(ps, row, col, !!inp.abs); + const dir = this.mapDir(ps, inp.dir, !!inp.abs); + if (inp.kind === 'token') { + const owner = inp.ownerUid != null ? ps.units.find((x) => x.uid === inp.ownerUid) : null; + const def = this._tokenDef(inp.tokenId ?? inp.chessId, owner, inp.def); + if (!def) { this.log(`unknown token ${inp.tokenId}`); return null; } + const u = this._makeAlly(ps, def, 'token', r, c, { uid: inp.uid, ownerUnit: owner, dir }); + u.carry = inp.carryState ?? null; + return u; + } + // the unit's own loadout (DESIGN §16): an entry without loadout fields is the DEFAULT — never another player's + // choice for the same chess id in a multi-player field (the per-battle data view maps id-only lookups) + const def = this.data.getChess(inp.chessId, { skillIndex: inp.skillIndex ?? null, moduleId: inp.moduleId ?? null }); + if (!def) { this.log(`unknown chess ${inp.chessId}`); return null; } + const u = this._makeAlly(ps, def, 'op', r, c, { uid: inp.uid, dir }); + u.items = [...(inp.items ?? [])]; + u.carry = inp.carryState ?? null; + return u; + } + + /** + * Token def: an inline def (PlayerBattleInput `def`, spawnToken `opts.def`) as given, else the data record's variant + * for the owner — `owner` = the owning ally unit (its chess and its selected skill / module: getToken(id, + * owner.defId, owner.def.loadout), DESIGN §16), a chess id, or null. + */ + _tokenDef(tokenId, owner, inline) { + if (inline) return normalizeToken(tokenId, inline); + if (!this.data.getToken) return null; + if (owner && typeof owner === 'object') return this.data.getToken(tokenId, owner.defId ?? null, owner.def?.loadout ?? null); + return this.data.getToken(tokenId, owner ?? null); + } + + _makeAlly(ps, def, kind, r, c, extra = {}) { + const st = def.stats; + const u = new Unit({ + id: ++this._idSeq, side: 'ally', kind, def, defId: def.id, name: def.name, ownerId: ps ? ps.playerId : null, + uid: extra.uid ?? null, ownerUnit: extra.ownerUnit ?? null, x: c, y: r, tileR: r, tileC: c, + dir: extra.dir != null ? normDir(extra.dir) : extra.facing != null ? normDir(extra.facing) : ps ? ps.dir : 'RIGHT', + base: { + maxHp: st.maxHp, atk: st.atk, def: st.def, res: st.res, aspd: st.aspd, bat: st.bat, blockCnt: st.blockCnt, + moveSpeed: 0, spRecovery: st.spRecovery, tauntLevel: st.tauntLevel, massLevel: st.massLevel, + hpRecoveryPerSec: st.hpRecoveryPerSec, cost: st.cost, respawnTime: st.respawnTime, + }, + }); + u.alive = false; + u.deployed = false; + u.items = []; + u.rangeGrid = def.rangeGrid; + u.player = ps; + this.units.push(u); + this.allyUnits.push(u); + if (ps) ps.units.push(u); + return u; + } + + /** Resolve kit/profile/skill for a unit (called by content/index.js; safe to call again). */ + _setupUnit(u, kit = null) { + if (!kit) { + try { kit = setupUnitKit(this, u, this.contentMode); } catch (e) { this._internalError('setupUnitKit', e); kit = null; } + } + u.kit = kit || {}; + u.profile = resolveProfile(u.def, u.kit.trait || null); + if (u.def.untargetable) this.addBuff(u, { key: 'trait:untargetable', flags: { untargetable: true }, persist: true, allowDead: true }); + // abnormal effects a summon holds (tokens.json `abnormal`, PRTS; user playtest #6 item 18): 禁疗 — no heal reaches it; + // 孤立 ("无法被同阵营选中") — no ally heal or ally selection (auras over a range) reaches it + const ab = u.def.abnormal; + if (Array.isArray(ab) && ab.length) { + const flags = {}; + if (ab.includes('healFree')) flags.noHeal = true; + if (ab.includes('isolated')) { flags.isolated = true; flags.noHeal = true; } + if (Object.keys(flags).length) this.addBuff(u, { key: 'trait:abnormal', flags, persist: true, allowDead: true }); + } + const spec = u.kit.skill || null; + u.skill = new SkillRuntime(this, u, u.def.skill, spec, u.def.skill?.bb ?? {}); + if (u.profile.install && !u._profInstalled) { + u._profInstalled = true; + this._safe(() => u.profile.install(this, u), 'profile.install', u); + } + for (const t of u.kit.talents || []) { + if (t && typeof t.install === 'function') this._safe(() => t.install(this, u), 'talent.install', u); + } + if (typeof u.kit.install === 'function') this._safe(() => u.kit.install(this, u), 'kit.install', u); + return u.kit; + } +} diff --git a/server/sim/battle/queries.js b/server/sim/battle/queries.js new file mode 100644 index 00000000..f5b36283 --- /dev/null +++ b/server/sim/battle/queries.js @@ -0,0 +1,247 @@ +// server/sim/battle/queries.js — Battle methods: queries: the per-tick enemy tile index, enemies / allies by tile keys, +// grid, radius and selectability, players, and the range rebuild of an ally (current, base and extra range keys). +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { ROWS, COLS } from '../constants.js'; +import { absoluteRangeKeys, canTargetEnemy, extendedGrid, enemyStealthed } from '../targeting.js'; +import { bodyKeys, bodyInKeys, bodyInRadius } from '../body.js'; + +export class BattleQueries { + /** + * Tile buckets of the living enemies: a regular enemy on the tile of its position, a huge one (body.js) on every tile + * it occupies. + */ + _buildEnemyIndex() { + for (const k of this._ebUsed) this._eb[k].length = 0; + this._ebUsed.length = 0; + for (const e of this.enemies) { + if (!e.alive || e.hidden) continue; + if (e.hitArea) { + for (const k of bodyKeys(e)) { const b = this._eb[k]; if (!b.length) this._ebUsed.push(k); b.push(e); } + continue; + } + const r = Math.round(e.y), c = Math.round(e.x); + if (r < 0 || r >= ROWS || c < 0 || c >= COLS) continue; + const k = r * COLS + c; + const b = this._eb[k]; + if (!b.length) this._ebUsed.push(k); + b.push(e); + } + } + + /** Targetable enemies whose body is on any of `keys` (absolute tile keys; a huge enemy is listed once). */ + enemiesInKeys(keys, attacker, profile) { + const out = []; + if (!keys) return out; + for (let i = 0; i < keys.length; i++) { + const b = this._eb[keys[i]]; + if (!b || !b.length) continue; + for (const e of b) if (e.alive && (!e.hitArea || !out.includes(e)) && canTargetEnemy(attacker, e, profile)) out.push(e); + } + return out; + } + + /** + * A living enemy whose body is on any of `keys` — targetable or not (stealthed, untargetable, asleep, flying): the + * 技能范围 trigger "技能范围内存在敌人（无视其不可选中）" (skills.js SKILL_RANGE). + */ + anyEnemyInKeys(keys) { + if (!keys) return false; + for (let i = 0; i < keys.length; i++) { + const b = this._eb[keys[i]]; + if (b && b.length) for (const e of b) if (e.alive && e.deployed) return true; + } + return false; + } + + /** Allies (not devices) within tiles `keys`, sorted by HP ratio (lowest first) that need healing. */ + injuredAlliesInKeys(keys, healer, includeElement = false) { + const out = []; + if (!keys) return out; + const set = keys instanceof Set ? keys : (healer && healer.rangeKeys === keys && healer.rangeKeySet ? healer.rangeKeySet : new Set(keys)); + for (const a of this.allyUnits) { + if (!a.alive || !a.deployed || a.hidden || a.kind === 'device') continue; + if (!set.has(a.tileR * COLS + a.tileC)) continue; + if (a !== healer && (a.s.flags.noHeal || (a.profile && a.profile.noHeal))) continue; + const injured = a.hp < a.s.maxHp - 1e-6; + const elem = includeElement && (a.elem.burn + a.elem.neural + a.elem.necrosis + a.elem.apoptosis + a.elem.erosion) > 0; + if (injured || elem) out.push(a); + } + out.sort((a, b) => a.hpRatio - b.hpRatio || a.deploySeq - b.deploySeq); + return out; + } + + lowestHpAllyInRange(unit) { + const l = this.injuredAlliesInKeys(unit.rangeKeys, unit); + return l[0] ?? null; + } + + /** Units of the opposite side (or `side`) whose tile is inside `grid` offsets relative to `unit`. */ + unitsInGrid(unit, grid, { side = null, extend = 0 } = {}) { + const keys = absoluteRangeKeys(grid || unit.rangeGrid || [[0, 0]], Math.round(unit.y), Math.round(unit.x), unit.dir, extend); + const want = side ?? (unit.side === 'ally' ? 'enemy' : 'ally'); + const set = new Set(keys); + const out = []; + const list = want === 'enemy' ? this.enemies : this.allyUnits; + for (const x of list) { + if (!x.alive || !x.deployed || x.hidden) continue; + if (bodyInKeys(x, set)) out.push(x); + } + return out; + } + + /** Allies inside `unit`'s current range (for auras) — not the 孤立 ones ("无法被同阵营选中": 炎佑), `unit` aside. */ + alliesInGrid(unit) { + const set = unit.rangeKeySet || new Set(unit.rangeKeys || []); + return this.allyUnits.filter((a) => a.alive && a.deployed && !a.hidden && a.kind !== 'device' && set.has(a.tileR * COLS + a.tileC) && this.allySelectable(a, unit)); + } + + /** + * May an ability of ally `by` select ally `a`? Never a 孤立 unit (炎佑, 从不混淆的方向; flag `isolated`) other than `by` + * itself — PRTS 选择器: selectors decide "天赋是否能给予某个干员Buff" and every heal / buff / aura target, and their 可选判定 + * rejects a 孤立 target of a friendly selector ("若掩码中孤立为1，且选择器的阵营与目标为友好关系，则不可选中"; user playtest #6 + * item 18). Enemies still target it (a hostile selector). 禁疗 only keeps heals off (heal pipeline, injuredAlliesInKeys). + */ + allySelectable(a, by = null) { + return !!a && (a === by || !a.s.flags.isolated); + } + + /** Deployed allies (no devices) an ability of ally `by` may select: allies(ownerId) without the 孤立 ones. */ + alliesFor(by, ownerId = null) { + return this.allies(ownerId).filter((a) => this.allySelectable(a, by)); + } + + /** + * Living enemies whose body (body.js: a huge enemy's hit rectangle, else its position) is within `r` of (x, y). + * `centre` = a 中点判定 radius — splash around a struck / marked target (PRTS 作战机制: "中点判定…案例：阻挡，酒神1天赋的1.3 + * 溅射半径"): every enemy counts by its position (判定中心), a huge one too. + */ + enemiesInRadius(x, y, r, centre = false) { + const out = []; + const r2 = r * r + 1e-9; + for (const e of this.enemies) { + if (!e.alive || e.hidden) continue; + if (e.hitArea && !centre) { if (bodyInRadius(e, x, y, r)) out.push(e); continue; } + const dx = e.x - x, dy = e.y - y; + if (dx * dx + dy * dy <= r2) out.push(e); + } + return out; + } + + /** + * The enemies within `r` (as enemiesInRadius) an ally-side area effect can select — PRTS 作战机制 §AOE伤害判定 "AOE的判定是 + * 对攻击范围内的每个可以被选中的敌人进行判定", 隐匿 "隐匿状态下的单位一般无法被敌方的索敌机制和Buff选择器选中为目标": no + * untargetable enemy and no 隐匿 one unless revealed, blocked or not hidden again yet after a block (targeting.js + * enemyStealthed; tile selectors — enemiesInKeys / canTargetEnemy — already skip them). Flying and asleep enemies stay + * the caller's choice. Enemy-side effects on other enemies (auras, heals) and physical collisions keep enemiesInRadius. + * Player report #8 after 0.1.0 (the 逐火 余烬): until 0.1.1 profession splash and skill circles still reached an + * unblocked 隐匿 enemy. + */ + foesInRadius(x, y, r, centre = false) { + const out = this.enemiesInRadius(x, y, r, centre); + let n = 0; + for (const e of out) { + const f = e.s.flags; + if (f.untargetable || (f.stealth && enemyStealthed(e))) continue; + out[n++] = e; + } + out.length = n; + return out; + } + + /** + * Every deployed ally within `r` of (x, y) — no selection rule: an enemy's area effect selects among them with + * targeting.js areaSelectable (content/enemies.js areaAllies: no 隐匿 ally, the blocker included, GitHub #97; DESIGN §22.12). + */ + alliesInRadius(x, y, r, ownerId = null, { includeDevices = false } = {}) { + const out = []; + const r2 = r * r + 1e-9; + for (const a of this.allyUnits) { + if (!a.alive || !a.deployed || a.hidden) continue; + if (!includeDevices && a.kind === 'device') continue; + if (ownerId != null && a.ownerId !== ownerId) continue; + const dx = a.x - x, dy = a.y - y; + if (dx * dx + dy * dy <= r2) out.push(a); + } + return out; + } + + /** Alive deployed allies (ops + tokens), optionally of one player. */ + allies(ownerId = null) { + return this.allyUnits.filter((a) => a.alive && a.deployed && a.kind !== 'device' && (ownerId == null || a.ownerId === ownerId)); + } + + aliveEnemies() { return this.enemies.filter((e) => e.alive); } + + unitAt(r, c) { const u = this._occ[r * COLS + c]; return u && u.alive ? u : null; } + + unitById(id) { return this.units.find((u) => u.id === id) ?? null; } + + tileInfo(r, c) { return this.grid.tile(r, c); } + + getPlayer(playerId) { return this.players.find((p) => p.playerId === playerId) ?? null; } + + _pp(playerId) { return playerId == null ? null : this._perPlayer[playerId] ?? null; } + + // ============================================================================================================= + // ranges + + /** + * Recompute a unit's absolute range tile keys: `rangeKeys` / `rangeKeySet` = current range (skill range override + + * rangeExtend — the unit's own 攻击距离 unless the running skill's range ignores it, `targeting.noRangeExtend`: 信仰搅拌机 + * S3, PRTS 备注 "此技能的攻击范围不受'攻击距离'属性影响" — plus the skill's own `targeting.rangeExtend`) ∪ + * `unit.extraRangeKeys` (content extra targets — setExtraRange); `baseRangeKeys` = the INITIAL range of the DEFAULT + * skill trigger: the unit's own grid + its permanent rangeExtend (`s.baseRangeExtend`: persistent, never-expiring + * buffs — talents, modules, bonds), no skill range, no temporary extend, no extra keys; `liveRangeGrid` = the + * relative grid (facing RIGHT) of the 攻击范围 the detail card shows (shared/protocol.js unitStatsEntry `range`; + * community report E1 after 0.1.0: the card kept the base grid while 烛煌 S3 attacked with 4-11): the grid behind + * `rangeKeys` without the extra keys (targeting.js extendedGrid; the grid itself when nothing extends it), or the + * unit's own range while a skill's grid only selects targets (`targeting.showOwnRange`: 荒芜拉普兰德 S1, no official + * range change). Rebuilt on deploy / relocate / skill range switches and whenever either extend changes (rangeChanged). + */ + _refreshRange(u) { + const tg = u.skill && u.skill.active ? u.skill.spec.targeting : null; + const grid = (tg && tg.rangeGrid) || u.rangeGrid || [[0, 0]]; + const ext = (tg && tg.noRangeExtend ? 0 : u.s.rangeExtend) + ((tg && tg.rangeExtend) || 0); + u._rangeExtend = u.s.rangeExtend; + u._baseExtend = u.s.baseRangeExtend; + const keys = absoluteRangeKeys(grid, u.tileR, u.tileC, u.dir, ext); + const set = new Set(keys); + const extra = u.extraRangeKeys; + if (extra) for (const k of extra) if (!set.has(k)) { set.add(k); keys.push(k); } + u.rangeKeys = keys; + u.rangeKeySet = set; + const own = !!(tg && tg.showOwnRange); + const lg = own ? u.rangeGrid || [[0, 0]] : grid, le = own ? u.s.rangeExtend : ext; + u.liveRangeGrid = le > 0 ? extendedGrid(lg, le) : lg; + if (u.kind !== 'device') u.baseRangeKeys = absoluteRangeKeys(u.rangeGrid || [[0, 0]], u.tileR, u.tileC, u.dir, u.s.baseRangeExtend); + if (u.skill) u.skill._trigKeys = null; // CUSTOM_RANGE trigger grid is relative to the tile + } + + /** True when a buff changed the unit's rangeExtend (total or permanent part) since its range was last built. */ + rangeChanged(u) { + return u._rangeExtend !== undefined && (u._rangeExtend !== u.s.rangeExtend || u._baseExtend !== u.s.baseRangeExtend); + } + + /** Public: rebuild a unit's range after content changed `unit.rangeGrid` (流形 copies) or its tile keys. */ + refreshRange(unit) { + if (!unit || unit.side !== 'ally' || !unit.alive || !unit.deployed) return false; + this._refreshRange(unit); + return true; + } + + /** + * Extra targetable tiles merged into the unit's range (蕾缪安 wanted targets, 维娜 S3, …): absolute tile keys + * (row × COLS + col), kept across every later range rebuild until content sets them again (null / [] clears). + * Not part of `baseRangeKeys` (the DEFAULT trigger range) — see SkillRuntime.addTriggerRange for that. + */ + setExtraRange(unit, keys) { + if (!unit || unit.side !== 'ally') return false; + const out = []; + const seen = new Set(); + for (const k of keys || []) if (Number.isInteger(k) && k >= 0 && k < ROWS * COLS && !seen.has(k)) { seen.add(k); out.push(k); } + unit.extraRangeKeys = out.length ? out : null; + if (unit.alive && unit.deployed) this._refreshRange(unit); + return true; + } +} diff --git a/server/sim/battle/spawns.js b/server/sim/battle/spawns.js new file mode 100644 index 00000000..dfecdd60 --- /dev/null +++ b/server/sim/battle/spawns.js @@ -0,0 +1,202 @@ +// server/sim/battle/spawns.js — Battle methods: enemies: the spawn queue (counted in `total` up front), routes and the +// owner of a tile, spawnEnemy, and the enemies on the field — hidden ones, the shared boss pool sync, the field clamp +// and the list compaction. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { MAX_ALIVE_ENEMIES } from '../constants.js'; +import { Unit } from '../units.js'; +import { compileRoute } from '../ai.js'; +import { unitInfo } from '../snapshot.js'; +import { normalizeRoute, normalizeEnemy } from '../simdata.js'; +import { fin } from './util.js'; + +const FALLBACK_ENEMY = Object.freeze({ + type: 'enemy', id: 'enemy_unknown', key: 'enemy_unknown', name: '未知敌人', rank: 'NORMAL', maxHp: 2000, atk: 200, def: 100, res: 0, + aspd: 100, bat: 2, rangeRadius: 0, moveSpeed: 1, massLevel: 1, lpr: 1, motion: 'WALK', applyWay: 'MELEE', dmgType: 'phys', + immune: new Set(), tauntLevel: 0, blockCnt: 1, epResistance: 0, epDamageResistance: 0, hpRecoveryPerSec: 0, notCountInTotal: false, + tags: [], abilities: [], skills: [], talent: {}, spine: 'unknown', avatar: 'unknown', raw: {}, +}); + +export class BattleSpawns { + _queueSpawn(s, precount) { + if (Number(s.time) === Infinity) return; // "never" — not scheduled, not counted + // capped: a bogus count (Infinity, 1e9) would otherwise hang the constructor / exhaust memory + const count = Math.min(MAX_ALIVE_ENEMIES, Math.max(1, Math.floor(fin(s.count ?? 1, 1)) || 1)); + const interval = Math.max(0, fin(s.interval, 0)); + const def = this.data.getEnemy(s.enemyKey); + for (let i = 0; i < count; i++) { + const p = { + time: Math.max(0, fin(s.time, 0)) + i * interval, enemyKey: s.enemyKey, routeIndex: s.routeIndex ?? 0, route: s.route ?? null, + mods: s.mods ?? null, sourcePlayerId: s.sourcePlayerId ?? null, bounty: s.bounty ?? null, tag: s.tag ?? null, + ownerPlayerId: s.ownerPlayerId ?? null, pos: s.pos ?? null, seq: ++this._spawnSeq, countInTotal: s.countInTotal, + }; + p.counted = p.countInTotal ?? (!(def && def.notCountInTotal) && p.tag !== 'boss' && p.tag !== 'part'); + if (precount && p.counted) { + this.total++; + const owner = p.ownerPlayerId ?? this._ownerForTile(p.pos ?? this._routeFor(p.routeIndex, p.route)?.start); + const pp = this._pp(owner); + if (pp) pp.total++; + p.precounted = true; + } + this._pending.push(p); + } + } + + _processSpawns() { + const now = this.time + 1e-9; + while (this._pending.length && this._pending[0].time <= now) { + const p = this._pending.shift(); + this._safe(() => this.spawnEnemy(p.enemyKey, { ...p, _precounted: p.precounted }), 'spawnEnemy'); + } + } + + _routeFor(idx, explicit = null) { + if (explicit) return normalizeRoute(explicit); + return this.routes[idx] ?? this.routes[0] ?? this._defaultRoute(); + } + + _defaultRoute() { + if (this._defRoute !== undefined) return this._defRoute; + const starts = this.grid.specialTiles('start'); + const ends = this.grid.specialTiles('end'); + this._defRoute = starts.length && ends.length ? { motion: 'WALK', start: starts[0], end: ends[0], checkpoints: [] } : null; + return this._defRoute; + } + + _ownerForTile(tile) { + if (!this.players.length) return null; + if (this.players.length === 1 || !tile) return this.players[0].playerId; + const c = Array.isArray(tile) ? tile[1] : tile.c; + const half = c >= 11 ? 'R' : 'L'; + return (this.players.find((p) => p.half === half) ?? this.players[0]).playerId; + } + + /** + * Spawn an enemy now. opts: { routeIndex, route, pos:[r,c], mods:{hpMul,atkMul,defMul,resMul,speedMul}, tag, + * sourcePlayerId, ownerPlayerId, bounty:{coins,ownerPlayerId}, countInTotal } + */ + spawnEnemy(enemyKey, opts = {}) { + if (this.enemies.length >= MAX_ALIVE_ENEMIES && this.aliveEnemies().length >= MAX_ALIVE_ENEMIES) { + this._handlerError('spawnEnemy', null, new Error(`more than ${MAX_ALIVE_ENEMIES} living enemies; spawn of ${enemyKey} refused`)); + return null; + } + // opts.def: an inline record (data/enemies.json shape, or an already normalised EnemyDef) for keys absent from data + let def = null; + if (opts.def && typeof opts.def === 'object') { + try { def = opts.def.type === 'enemy' && opts.def.immune instanceof Set ? opts.def : normalizeEnemy(enemyKey, opts.def); } catch (e) { this._handlerError('spawnEnemy.def', null, e); } + } + if (!def) def = this.data.getEnemy(enemyKey); + if (!def) { this.log(`unknown enemy ${enemyKey}`); def = { ...FALLBACK_ENEMY, id: enemyKey, key: enemyKey }; } + const ov = this.enemyOverrides[def.key] ?? this.enemyOverrides[enemyKey]; + if (ov && ov.stats) { + const st = ov.stats; + def = { ...def, + maxHp: Math.max(1, fin(st.maxHp ?? st.hp, def.maxHp)), atk: Math.max(0, fin(st.atk, def.atk)), def: Math.max(0, fin(st.def, def.def)), + res: Math.max(0, fin(st.res, def.res)), moveSpeed: Math.max(0, fin(st.moveSpeed, def.moveSpeed)), + bat: Math.max(0.1, fin(st.bat, def.bat)), aspd: fin(st.aspd, def.aspd) || def.aspd, + rangeRadius: Math.max(0, fin(st.rangeRadius, def.rangeRadius)), massLevel: fin(st.massLevel, def.massLevel), + lpr: fin(st.lpr, def.lpr), blockCnt: Math.max(1, fin(st.blockCnt, def.blockCnt)) }; + } + const route = opts.route ? normalizeRoute(opts.route) : this._routeFor(opts.routeIndex ?? 0); + let start = opts.pos ?? route?.start ?? [this.rect.r0, this.rect.c1]; + if (!Array.isArray(start) || !Number.isFinite(start[0]) || !Number.isFinite(start[1])) start = route?.start ?? [this.rect.r0, this.rect.c1]; + const R = this.rect; // spawn inside the field (same bounds as _clampPos) + start = [Math.max(R.r0 - 0.5, Math.min(R.r1 + 0.5, start[0])), Math.max(R.c0 - 0.5, Math.min(R.c1 + 0.5, start[1]))]; + // multipliers: finite and ≥ 0 (hp > 0), anything else counts as 1 + const mm = (v, pos = false) => { const n = fin(v, 1); return n < 0 || (pos && n <= 0) ? 1 : n; }; + const m0 = opts.mods || {}; + const m = { hpMul: mm(m0.hpMul, true), atkMul: mm(m0.atkMul), defMul: mm(m0.defMul), resMul: mm(m0.resMul), speedMul: mm(m0.speedMul) }; + const e = new Unit({ + id: ++this._idSeq, side: 'enemy', kind: 'enemy', def, defId: def.key ?? enemyKey, name: def.name, + x: start[1], y: start[0], motion: def.motion, + base: { + maxHp: def.maxHp * (m.hpMul ?? 1), atk: def.atk * (m.atkMul ?? 1), def: def.def * (m.defMul ?? 1), res: def.res * (m.resMul ?? 1), + aspd: def.aspd, bat: def.bat, blockCnt: 0, moveSpeed: def.moveSpeed * (m.speedMul ?? 1), spRecovery: 0, + tauntLevel: def.tauntLevel, massLevel: def.massLevel, hpRecoveryPerSec: def.hpRecoveryPerSec, rangeRadius: def.rangeRadius, + }, + }); + e.alive = true; + e.deployed = true; + e.blockWeight = def.blockCnt ?? 1; + e.hitArea = def.hitArea ?? null; // 巨型单位 hit rectangle (body.js); null = a point + e.lpr = def.lpr; + e.mods = opts.mods ?? null; + e.tag = opts.tag ?? null; + e.bounty = opts.bounty ?? null; + e.sourcePlayerId = opts.sourcePlayerId ?? null; + e.ownerId = opts.ownerPlayerId ?? this._ownerForTile(start); + e.spawnX = e.x; e.spawnY = e.y; + e.spawnSeq = ++this._spawnSeq; + e.deploySeq = ++this._deploySeq; + e.deployedAt = this.time; + e.atkCd = 0; + e.pauseUntil = -Infinity; // content holds (暴鸰's drop) + e.atkStandUntil = -Infinity; // standing for its attack clip (ai.js attackStand) + // every enemy profile starts with the same fields (stable object shapes keep the hot loop's property reads fast); + // `dmgType` null = the data's (content may arm a data-unarmed enemy: ai.js enemyAttack) + e.profile = { noAttack: def.dmgType === 'none', maxTargets: 1, atkScale: 1, dmgType: null }; + e.route = { legs: route ? compileRoute(route, this.rect) : [], legIdx: 0, pts: null, ptIdx: 0, suffix: null, version: -1, waitLeft: null }; + if (!e.route.legs.length) { + const end = this.grid.specialTiles('end')[0]; + if (end) e.route.legs.push({ t: 'move', r: end[0], c: end[1], final: true }); + } + e.counted = opts.countInTotal ?? (!def.notCountInTotal && e.tag !== 'boss' && e.tag !== 'part'); + if (e.counted && !opts._precounted) { + this.total++; + const pp = this._pp(e.ownerId); + if (pp) pp.total++; + } + if (e.tag === 'boss') { + e.isBoss = true; + if (this.sharedBoss) { e.bossPool = this.sharedBoss; this._syncBossHp(e); } + } + e.hp = e.bossPool ? e.hp : e.s.maxHp; + this.units.push(e); + this.enemies.push(e); + this._ev(['spawn', unitInfo(e)]); + if (this._hooks.deploy) this.emit('deploy', { unit: e, initial: false }); + if (this._hooks.enemySpawn) this.emit('enemySpawn', { enemy: e }); + return e; + } + + // ============================================================================================================= + // enemies on the field: hidden, boss pool, clamp, compaction + + _setHidden(e, on) { + if (e.hidden === on) return; + e.hidden = on; + if (on) this._unblock(e); + this.fx(on ? 'disappear' : 'appear', { x: e.x, y: e.y, id: e.id }); + } + + _syncBossHp(e) { + const pool = e.bossPool; + if (!pool) return; + if (Number.isFinite(pool.maxHp) && pool.maxHp > 0 && e.base.maxHp !== pool.maxHp) { e.base.maxHp = pool.maxHp; e.markDirty(); } + // a broken pool (NaN hp) must not leak NaN into the unit: show it full until the pool is sane again + const ratio = pool.maxHp > 0 ? (Number.isFinite(pool.hp) ? Math.max(0, pool.hp) / pool.maxHp : 1) : 0; + e.hp = e.s.maxHp * Math.min(1, ratio); + } + + _bossSync() { + if (!this.sharedBoss) return; + for (const e of this.enemies) if (e.alive && e.bossPool) { + this._syncBossHp(e); + if (e.bossPool.hp <= 0) this.kill(e, null); + } + } + + _clampPos(e) { + const R = this.rect; + if (e.x < R.c0 - 0.5) e.x = R.c0 - 0.5; + if (e.x > R.c1 + 0.5) e.x = R.c1 + 0.5; + if (e.y < R.r0 - 0.5) e.y = R.r0 - 0.5; + if (e.y > R.r1 + 0.5) e.y = R.r1 + 0.5; + } + + _compactEnemies() { + if (!this._enemiesDirty) return; + this.enemies = this.enemies.filter((e) => e.alive); + this._enemiesDirty = false; + } +} diff --git a/server/sim/battle/status.js b/server/sim/battle/status.js new file mode 100644 index 00000000..a4983963 --- /dev/null +++ b/server/sim/battle/status.js @@ -0,0 +1,294 @@ +// server/sim/battle/status.js — Battle methods: buffs and statuses: addBuff (refresh rules) / removeBuff, the per-tick +// buff pass (onTick, expiry, natural regeneration), catalogue statuses (immunities, 抵抗, 寒冷 → 冻结, 浮空, 诱导, 恐惧) and +// "同名效果取最高". +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { COLD_FREEZE_DURATION, LEVITATE_HALF_WEIGHT, RESIST_DEFAULT } from '../constants.js'; +import { makeBuff, STATUS, RESIST_STATUSES } from '../buffs.js'; +import { palsyBuff } from '../damage.js'; +import { evadesGround } from '../targeting.js'; +import { stampFear } from '../fear.js'; + +export class BattleStatus { + addBuff(unit, b) { + if (!unit || (!unit.alive && !b.allowDead)) return null; + const buff = makeBuff(b); + const list = unit.buffs; + let idx = -1; + for (let i = 0; i < list.length; i++) if (list[i].key === buff.key) { idx = i; break; } + if (idx >= 0 && buff.refresh !== 'independent') { + const old = list[idx]; + switch (buff.refresh) { + case 'keep': + return old; + case 'stack': + old.stacks = Math.min(old.stacks + buff.stacks, Math.max(old.maxStacks, buff.maxStacks)); + old.maxStacks = Math.max(old.maxStacks, buff.maxStacks); + old.timeLeft = buff.duration; + old.duration = buff.duration; + if (buff.mods) old.mods = buff.mods; + if (buff.flags) old.flags = buff.flags; + unit.markDirty(); + return old; + case 'extend': + old.timeLeft = Math.max(old.timeLeft, buff.duration); + old.duration = Math.max(old.duration, buff.duration); + if (buff.mods) old.mods = buff.mods; + if (buff.flags) old.flags = buff.flags; + if (buff.shield > old.shield) old.shield = buff.shield; + if (buff.shieldHits > old.shieldHits) old.shieldHits = buff.shieldHits; + unit.markDirty(); + return old; + default: + list[idx] = buff; + unit.markDirty(); + return buff; + } + } + if (buff.refresh === 'independent') { + const same = list.filter((x) => x.key === buff.key); + if (same.length >= buff.maxStacks) { + const oldest = same.reduce((a, c) => (a.seq < c.seq ? a : c)); + this._removeBuffAt(unit, list.indexOf(oldest), true); + } + } + list.push(buff); + unit.markDirty(); + if (buff.visible || buff.status) { + const key = buff.status ?? buff.key; + if (list.filter((x) => (x.status ?? x.key) === key).length === 1) this._ev(['status', unit.id, key, 1]); + } + return buff; + } + + removeBuff(unit, keyOrBuff) { + if (!unit) return 0; + let n = 0; + for (let i = unit.buffs.length - 1; i >= 0; i--) { + const b = unit.buffs[i]; + if (b === keyOrBuff || b.key === keyOrBuff) { this._removeBuffAt(unit, i, true); n++; } + } + return n; + } + + _removeBuffAt(unit, i, callRemove = true) { + const b = unit.buffs[i]; + if (!b) return; + unit.buffs.splice(i, 1); + unit.markDirty(); + if ((b.visible || b.status)) { + const key = b.status ?? b.key; + if (!unit.buffs.some((x) => (x.status ?? x.key) === key)) this._ev(['status', unit.id, key, 0]); + } + if (callRemove && b.onRemove) this._safe(() => b.onRemove({ battle: this, unit, buff: b }), 'buff.onRemove', unit); + } + + _tickBuffs(dt) { + const units = this.units; + for (let i = 0, n = units.length; i < n; i++) { // units created by onTick handlers start ticking next tick + const u = units[i]; + if (!u.alive || u.removed) continue; + if (u.buffs.length) { + const arr = u.buffs.slice(); + for (const b of arr) { + if (!u.alive) break; + if (u.buffs.indexOf(b) < 0) continue; + if (b.onTick) { + if (b.interval > 0) { + b._acc += dt; + let n = 0; + while (b._acc >= b.interval - 1e-9 && n++ < 8) { + b._acc -= b.interval; + this._safe(() => b.onTick({ battle: this, unit: u, buff: b, dt: b.interval }), 'buff.onTick', u); + } + } else this._safe(() => b.onTick({ battle: this, unit: u, buff: b, dt }), 'buff.onTick', u); + } + if (b.timeLeft !== Infinity) { + b.timeLeft -= dt; + if (b.timeLeft <= 1e-9) { + const i = u.buffs.indexOf(b); + if (i >= 0) { + this._removeBuffAt(u, i, false); + if (b.onExpire) this._safe(() => b.onExpire({ battle: this, unit: u, buff: b }), 'buff.onExpire', u); + } + } + } + } + } + // natural HP regeneration + if (u.alive && u.deployed && !u.bossPool) { + const regen = u.s.hpRegen; + if (regen > 0 && u.hp < u.s.maxHp) { + u._regenAcc = (u._regenAcc ?? 0) + regen * dt; + if (u._regenAcc >= 1 || u.hp + u._regenAcc >= u.s.maxHp) { + this.heal(u, u, u._regenAcc, { self: true, silent: true, regen: true }); + u._regenAcc = 0; + } + } + } + } + } + + /** + * Apply a catalogue status. opts: { duration, source, value, force, refresh, point, resistApplied } — returns true + * when applied. Honours enemy immunities (stun/silence/sleep/frozen/levitate/feared) unless `force`. `beforeStatus` + * handlers may cancel it or change `duration` / `value`. Official rules (buffs.js STATUS): 抵抗 (the `resist` status) + * shortens the RESIST_STATUSES by its value (default half; applied after `beforeStatus`; `resistApplied` skips that + * pass — the cold-on-cold 冻结 below already used post-抵抗 lengths). A second 寒冷 while 寒冷 remains applies 冻结 for + * max(remaining, this cold after 抵抗) (PRTS 术语释义 寒冷 「持续时间取双方之中最高」). 浮空 lasts half as long on units heavier + * than LEVITATE_HALF_WEIGHT (current massLevel); 冻结's RES cut hits enemies only; 麻痹 adds stacks; "同名效果取最高" + * statuses (`valued`) keep the strongest value — a weaker application only extends past the stronger one's end (it + * then resumes); other statuses refresh to the longer duration. 诱导 (`attract`) walks the enemy to `point` + * ([r, c] or {x, y}; default the source's tile — a new application moves the point); 恐惧 (`fear`) stamps where it + * was applied and from where (fear.js stampFear: the fan of 恐惧可达地块 its movement uses). A stunned/sleeping operator + * releases the enemies it blocks; a feared/levitated/unblockable/attracted enemy is released by its blocker. + * `statusApplied` reports the final duration and `entered` (the target did not carry the status before). + * A unit that is 无敌 and 无法选中 at once (a 重生 in progress, a hovering or 永久无敌 leader part) takes no status from + * the other side, `force` included — PRTS 无敌 "无法被不同阵营选中": so a status carried by the very hit that knocked an + * enemy out does not land after its 重生's cleanse (DESIGN §21.4). A ground enemy's status never lands on an airborne + * 起飞 ally (对地规避: targeting.js evadesGround) unless `opts.ignoreSelect`. + */ + applyStatus(target, key, opts = {}) { + if (!target || !target.alive) return false; + const src = opts.source; + if (src && src.side && src.side !== target.side && target.s.flags.invulnerable && target.s.flags.untargetable) return false; + if (!opts.ignoreSelect && target.s.flags.liftoff && evadesGround(src, target)) return false; + const tpl = STATUS[key] || { flags: { [key]: true } }; + let duration = opts.duration == null ? Infinity : Number(opts.duration); + let value = opts.value; + if (!(duration > 0)) return false; + const immune = target.def && target.def.immune; + if (!opts.force && tpl.immune && immune && immune.has(tpl.immune)) return false; + // 浮空 Buff (PRTS 异常效果: "若单位数据上为飞行单位且不持有缚地异常或是持有浮空异常则Buff取消"; 行动方式 "行动类型（数据）为 + // 飞行的单位、以及已持有浮空异常的单位无法被施加浮空Buff"): refused on data flyers (`motion` FLY) and units already + // levitated — a hovering 近地悬浮 enemy is WALK in its data, so it can be levitated (no 缚地 / 浮空强化 in this mode) + if (key === 'levitate' && (target.motion === 'FLY' || target.s.flags.levitate)) return false; + if (this._hooks.beforeStatus) { + const c = this.emit('beforeStatus', { source: opts.source ?? null, target, status: key, duration, value, cancel: false }); + if (c.cancel || !target.alive) return false; + const d = Number(c.duration); + if (d === Infinity || (Number.isFinite(d) && d > 0)) duration = d; + else if (Number.isFinite(d) && d <= 0) return false; + value = c.value; + } + if (RESIST_STATUSES.has(key) && !opts.resistApplied) { + const rv = this.resistOf(target); + if (rv > 0) duration *= 1 - rv; + } + if (key === 'levitate' && target.s.massLevel > LEVITATE_HALF_WEIGHT) duration /= 2; + if (!(duration > 0)) return false; + if (key === 'cold' && target.findBuff('cold') && !(immune && immune.has('frozen'))) { + // PRTS 术语释义 寒冷: 友方寒冷 pairs into 冻结, 「持续时间取双方之中最高」. `duration` is this cold after 抵抗; + // the cold already on the target keeps timeLeft. addBuff refresh 'extend' below sets that cold to the same max. + // COLD_FREEZE_DURATION is only the fallback when neither side has a duration. resistApplied: that max is already + // post-抵抗, so the freeze must not be halved again. + // [ASSUMED] one catalogue cold, so an enemy-applied second cold uses this max too. PRTS states it on the 友方 + // line only (敌方 cold becomes 冻结 when the target already has 敌方 cold or 敌方 冻结). + const prev = target.findBuff('cold'); + const spans = [prev.timeLeft, duration].filter((t) => t === Infinity || (Number.isFinite(t) && t > 0)); + const freezeFor = spans.length ? Math.max(...spans) : COLD_FREEZE_DURATION; + this.applyStatus(target, 'freeze', { + duration: freezeFor, source: opts.source, force: opts.force, + ...(spans.length ? { resistApplied: true } : {}), + }); + if (!target.alive) return false; + } + const source = opts.source ?? null; + let entered = true; + for (const b of target.buffs) if ((b.status ?? b.key) === key) { entered = false; break; } + if (tpl.palsy) { + this.addBuff(target, { ...palsyBuff(value ?? 1), duration, source }); + } else if (tpl.valued != null && typeof tpl.mods === 'function' && opts.refresh == null) { + this._applyValuedStatus(target, key, tpl, duration, value ?? tpl.valued, source); + } else { + const mods = tpl.enemyOnlyMods && target.side !== 'enemy' ? null : typeof tpl.mods === 'function' ? tpl.mods(value) : (tpl.mods || null); + const b = this.addBuff(target, { key, duration, refresh: opts.refresh ?? 'extend', mods, flags: tpl.flags || null, status: key, visible: true, source }); + if (tpl.attract && b) this._setAttractPoint(target, b, opts.point ?? value, source); + // 恐惧: the hit position and the source's position of every application (fear.js — the fan of reachable tiles) + if (key === 'fear' && b && target.side === 'enemy') stampFear(this, target, b, source); + } + const f = tpl.flags; + if (f && target.side === 'enemy' && (f.levitate || f.unblockable || f.fear)) this._unblock(target); + if (f && target.side === 'ally' && f.noBlock) this.releaseBlocked(target); + if (this._hooks.statusApplied) this.emit('statusApplied', { source, target, status: key, duration, value, entered }); + return true; + } + + /** 抵抗 of a unit: share of a resisted status's duration removed (0 = none; the `resist` status value, ≤ 0.95). */ + resistOf(unit) { + if (!unit || !unit.buffs.length) return 0; + let r = 0; + for (const b of unit.buffs) { + if (b.status !== 'resist') continue; + const v = Number.isFinite(b.data?.value) ? b.data.value : RESIST_DEFAULT; + if (v > r) r = v; + } + return Math.min(0.95, r); + } + + /** 诱导 target point of an `attract` status buff (enemy walks there; see ai.js moveAttracted). */ + _setAttractPoint(target, buff, point, source) { + let r = null, c = null; + if (Array.isArray(point) && Number.isFinite(point[0]) && Number.isFinite(point[1])) { r = point[0]; c = point[1]; } + else if (point && typeof point === 'object' && Number.isFinite(point.x) && Number.isFinite(point.y)) { r = point.y; c = point.x; } + else if (source && Number.isFinite(source.x) && Number.isFinite(source.y)) { r = source.y; c = source.x; } + if (r == null) { if (!buff.data.attract) buff.data = { ...buff.data, attract: null }; return; } + const R = this.rect; + r = Math.max(R.r0, Math.min(R.r1, Math.round(r))); + c = Math.max(R.c0, Math.min(R.c1, Math.round(c))); + buff.data = { ...buff.data, attract: { r, c, pts: null, i: 0, ver: -1 } }; + } + + /** + * "同名效果取最高" for a content effect that is not a catalogue status (no immunities, 抵抗, `beforeStatus` / + * `statusApplied` hooks or status icon): ONE instance of `key` per target whatever the number of sources — the + * strongest `value` applies, a weaker application only extends past the stronger one's end (it then resumes), an + * equal one refreshes to the longer duration. `mods(value)` builds the buff's mods. The engine's default for two + * same-named buffs (PRTS 作战机制 "同名buff的默认叠加策略buff只能表现出一个"). Returns true when applied. + * @param {object} target + * @param {string} key + * @param {{ duration: number, value: number, mods: (v: number) => object, source?: object|null }} opts + */ + applyStrongest(target, key, { duration, value, mods, source = null } = {}) { + if (!target || !target.alive || !(Number(duration) > 0) || !Number.isFinite(value) || typeof mods !== 'function') return false; + this._applyValuedStatus(target, key, { mods, valued: value, plain: true }, Number(duration), value, source); + return true; + } + + /** + * "同名效果取最高": keep the strongest value; a weaker one that outlasts it resumes afterwards (buff.data.tail). A + * `plain` template (applyStrongest) is an ordinary invisible buff, not a status. + */ + _applyValuedStatus(target, key, tpl, duration, value, source) { + const strength = (v) => Math.abs(Number.isFinite(v) ? v : tpl.valued); + const make = (v, dur, tail) => ({ + ...(tpl.buff || null), // extra buff fields of the status (抵抗: the 麻痹 decay tick) + key, duration: dur, refresh: 'replace', mods: tpl.mods(v), flags: tpl.flags || null, status: tpl.plain ? null : key, + visible: !tpl.plain, source, + data: { value: v, tail }, + onExpire: ({ battle, unit, buff }) => { + const t = buff.data.tail; + if (t && t.until - battle.time > 1e-6 && unit.alive) battle.addBuff(unit, make(t.value, t.until - battle.time, null)); + }, + }); + const old = target.buffs.find((b) => b.key === key && (tpl.plain || b.status === key)); + if (!old) { this.addBuff(target, make(value, duration, null)); return; } + const oldV = old.data && Number.isFinite(old.data.value) ? old.data.value : tpl.valued; + const oldEnd = this.time + old.timeLeft, newEnd = this.time + duration; + const oldTail = old.data && old.data.tail; + const longerTail = (a, b) => (!a ? b : !b ? a : (b.until > a.until ? b : a)); + if (strength(value) > strength(oldV) + 1e-12) { + // stronger: takes over now; the weaker old one (or its tail) resumes if it lasts longer + const tail = longerTail(oldEnd > newEnd ? { value: oldV, until: oldEnd } : null, oldTail && oldTail.until > newEnd ? oldTail : null); + this.addBuff(target, make(value, duration, tail)); + } else if (strength(value) < strength(oldV) - 1e-12) { + // weaker: never overrides; remembered as the tail when it outlasts the running one + if (newEnd > oldEnd && (!oldTail || newEnd > oldTail.until)) old.data = { ...old.data, value: oldV, tail: { value, until: newEnd } }; + } else if (duration > old.timeLeft) { + old.timeLeft = duration; + old.duration = Math.max(old.duration, duration); + } + } + + removeStatus(target, key) { return this.removeBuff(target, key); } +} diff --git a/server/sim/battle/summons.js b/server/sim/battle/summons.js new file mode 100644 index 00000000..2f1acca4 --- /dev/null +++ b/server/sim/battle/summons.js @@ -0,0 +1,139 @@ +// server/sim/battle/summons.js — Battle methods: summons and devices: the token def of an owner's loadout, whether its +// skill produces a token, spawnToken, spawnDevice and the stage devices (crates, platforms) placed at the start. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { COLS, OBSTACLE_DEVICES } from '../constants.js'; +import { normDir } from '../dir.js'; +import { SkillRuntime } from '../skills.js'; +import { unitInfo } from '../snapshot.js'; +import { normalizeToken } from '../simdata.js'; +import { fin } from './util.js'; + +export class BattleSummons { + /** + * Token def of `tokenId` as `owner` (an ally unit: its chess + selected skill / module; or a chess id) summons it — + * the def spawnToken uses. For content that reads summon stats / skill blackboards: exact in a multi-player field + * where two players give the same chess different loadouts (an id-only `data.getToken(id, chessId)` is not). + */ + tokenDef(tokenId, owner = null) { + return this._tokenDef(tokenId, owner, null); + } + + /** + * Whether an operator's selected skill / module produces `tokenId` (DESIGN §16, DATA.md §14 `sources`): false only + * when the owner's own tokens.json variant says so (`sources` without 'skill' / 'talent' — e.g. 琳琅诗怀雅 S1/S3 make + * no 香槟炸弹, 赫默 S1 no 医疗探机); true when the data does not tell (no owner variant, inline defs, tokens of + * other chess). + */ + producesToken(owner, tokenId, def = null) { + if (!owner || typeof owner !== 'object' || owner.kind !== 'op') return true; + const d = def ?? this.tokenDef(tokenId, owner); + const src = d && Array.isArray(d.sources) ? d.sources : null; + if (!src || src.includes('skill') || src.includes('talent')) return true; + const vs = this.data.rawToken?.(tokenId)?.variants; + const id = String(owner.defId ?? ''); + return !(vs && typeof vs === 'object' && (vs[id] || vs[id.replace(/_b$/, '_a')])); + } + + /** + * Spawn (and deploy) a token. `owner` = ally unit or playerId. Returns the token unit or null. The def is the owner's + * variant for its selected skill / module (`opts.def` = an inline def instead). While an operator runs a NON-default + * skill, a summon that skill does not produce (producesToken) is refused unless `opts.anySource`: hand-authored kit + * install hooks are written for the default skill and run under every skill (琳琅诗怀雅 S1/S3 would drop 香槟炸弹); + * under the default skill the kit stays the authority. + */ + spawnToken(owner, tokenId, row, col, opts = {}) { + const ownerUnit = owner && typeof owner === 'object' ? owner : null; + const pid = ownerUnit ? ownerUnit.ownerId : owner; + const ps = this.getPlayer(pid) ?? (ownerUnit ? ownerUnit.player : null); + const def = opts.def ? normalizeToken(tokenId, opts.def) : this._tokenDef(tokenId, ownerUnit, null); + if (!def) { this.log(`unknown token ${tokenId}`); return null; } + if (!opts.def && !opts.anySource && ownerUnit && ownerUnit.def?.loadout?.skillIsDefault === false && !this.producesToken(ownerUnit, tokenId, def)) { + this.log(`${ownerUnit.defId} (skill ${ownerUnit.def?.loadout?.skillIndex ?? '?'}) does not produce ${tokenId}`); + return null; + } + if (!Number.isInteger(row) || !Number.isInteger(col) || !this.grid.inRect(row, col)) return null; + const occ = this._occ[row * COLS + col]; + if (occ && occ.alive && !opts.force) return null; + const dir = opts.dir != null ? normDir(opts.dir) : opts.facing != null ? normDir(opts.facing) : ownerUnit ? ownerUnit.dir : ps ? ps.dir : 'RIGHT'; + const u = this._makeAlly(ps, def, 'token', row, col, { ownerUnit, dir }); + if (opts.stats) for (const [k, v] of Object.entries(opts.stats)) if (Number.isFinite(v)) u.base[k] = v; + this._setupUnit(u, opts.kit ?? null); + if (opts.untargetable) this.addBuff(u, { key: 'trait:untargetable', flags: { untargetable: true }, persist: true, allowDead: true }); + if (!this._deploy(u, { initial: false })) { + // tile still busy (a unit stands there even with `force`): drop the half-built token and its hooks + u.removed = true; + this.offOwner(u); + return null; + } + if (opts.hp != null && Number.isFinite(Number(opts.hp))) u.hp = Math.max(1, Math.min(u.s.maxHp, Number(opts.hp))); + if (opts.duration > 0 && Number.isFinite(Number(opts.duration))) this.after(Number(opts.duration), () => { if (u.alive) this.retreat(u, { reason: 'expired', permanent: true }); }, { owner: u }); + return u; + } + + /** + * Spawn a stage device (e.g. crates). opts: { hp, obstacle, obstacleKind, blockCnt, name, def, res, atk, bat, aspd }. + * An `obstacle` device is an obstacle-like tile by default (`obstacleKind` 'crate': enemies route around it at cost + * 1000 and, when it is the only way, walk into it, get blocked by it and break it — research 08 §3.1); 'block' makes + * the tile impassable. + */ + spawnDevice(key, row, col, opts = {}) { + // Devices are ally-side units on a field tile: never outside the rect, never on top of a living unit or of a + // knocked-out operator (downOn). + if (!Number.isInteger(row) || !Number.isInteger(col) || !this.grid.inRect(row, col)) return null; + const occ = this._occ[row * COLS + col]; + if (occ && occ.alive) return null; + if (this.downOn(row, col)) return null; + const hp = fin(opts.hp, 100); + const bat = fin(opts.bat, 1), aspd = fin(opts.aspd, 100); + const def = { + type: 'device', id: key, baseId: key, name: opts.name ?? key, tier: 0, golden: false, profession: 'DEVICE', subProf: null, + stats: { maxHp: hp > 0 ? hp : 100, atk: Math.max(0, fin(opts.atk, 0)), def: Math.max(0, fin(opts.def, 0)), res: Math.min(100, Math.max(0, fin(opts.res, 0))), aspd: aspd > 0 ? aspd : 100, bat: bat > 0 ? bat : 1, blockCnt: Math.max(0, fin(opts.blockCnt, 99)), cost: 0, respawnTime: 0, spRecovery: 0, tauntLevel: -1, massLevel: 0, hpRecoveryPerSec: 0 }, + rangeGrid: [[0, 0]], skill: null, talents: [], spine: key, avatar: key, + }; + const u = this._makeAlly(null, def, 'device', row, col, opts.dir != null ? { dir: opts.dir } : {}); + u.ownerId = null; + u.kit = {}; + u.profile = { noAttack: true, maxTargets: 0 }; + u.skill = new SkillRuntime(this, u, null, null, {}); + u.obstacle = !!opts.obstacle; + u.obstacleKind = opts.obstacleKind === 'block' ? 'block' : 'crate'; + u.alive = true; + u.deployed = true; + u.ground = true; + u.markDirty(); + u.hp = u.s.maxHp; + u.deploySeq = ++this._deploySeq; + u.aggroSeq = u.deploySeq; + u.deployedAt = this.time; + u.rangeKeys = []; + this._occ[row * COLS + col] = u; + if (u.obstacle) this.grid.setObstacle(row, col, true, u.obstacleKind); + this._ev(['spawn', unitInfo(u)]); + if (this._hooks.deploy) this.emit('deploy', { unit: u, initial: !this.started }); + return u; + } + + _spawnStageDevices() { + if (this.opts.devices === false) return; + for (const d of this.stage.devices || []) { + // data/stages.json `active` = present at match start (= not hidden in the 下半 level file: act1 m02 starts with no + // crates, research 08 §3.3); research stages have no `active` ⇒ `hidden` decides. + const act = d.raw && typeof d.raw.active === 'boolean' ? d.raw.active : !d.hidden && d.active !== false; + if (!act) continue; + if (d.role === 'platform' || d.role === 'mound') { + // 射击台 / mounds [ASSUMED, research 08 §8 #1]: hard-block ground movement; an operator standing on one is elevated + // (does not block) — the match lets ranged operators deploy there (deployTiles.rangedOnly). + if (!this.grid.inRect(d.row, d.col)) continue; + this.grid.setObstacle(d.row, d.col, true); + (this._elevated ??= new Set()).add(d.row * COLS + d.col); + continue; + } + const spec = OBSTACLE_DEVICES[d.key] ?? (d.role === 'crate' ? { hp: d.stats?.maxHp ?? 100, name: d.name } : null); + if (!spec) continue; + if (!this.grid.inRect(d.row, d.col)) continue; + if (this._occ[d.row * COLS + d.col]) continue; + this.spawnDevice(d.key, d.row, d.col, { hp: spec.hp, obstacle: true, name: spec.name }); + } + } +} diff --git a/server/sim/battle/tiles.js b/server/sim/battle/tiles.js new file mode 100644 index 00000000..a93ca0ae --- /dev/null +++ b/server/sim/battle/tiles.js @@ -0,0 +1,210 @@ +// server/sim/battle/tiles.js — Battle methods: field tiles: obstacles, relocation and 【移动】, knocked-out operators' +// bodies (isDown, downOn, restTile, _layBody) and the tiles no automatic placement may take, tactical points and the +// enemies' ground paths. +// Installed on Battle.prototype by server/sim/Battle.js (a method container: never instantiated; `this` is the battle). + +import { ROWS, COLS, DOWN_STATE } from '../constants.js'; +import { localOrder, localBefore } from '../dir.js'; + +export class BattleTiles { + /** Toggle a ground obstacle (enemies re-read their flow field). `kind` 'block' (default, impassable) | 'crate'. */ + setObstacle(r, c, on, kind = 'block') { this.grid.setObstacle(r, c, on, kind); } + + /** Move an ally to another tile (keeps state); never onto a living unit or a knocked-out operator (downOn). */ + relocate(unit, r, c) { + // only a living, deployed ally moves, and only onto an integer tile of this field (a dead unit left in _occ + // would later "block" from a tile it no longer stands on once it redeploys at home) + if (!unit || unit.side !== 'ally' || !unit.alive || !unit.deployed) return false; + if (!Number.isInteger(r) || !Number.isInteger(c) || !this.grid.inRect(r, c)) return false; + const k = r * COLS + c; + if (this._occ[k] && this._occ[k] !== unit && this._occ[k].alive) return false; + if (this.downOn(r, c)) return false; + const ok = unit.tileR * COLS + unit.tileC; + if (this._occ[ok] === unit) this._occ[ok] = null; + this.releaseBlocked(unit); + if (unit.obstacle) this.grid.setObstacle(unit.tileR, unit.tileC, false, unit.obstacleKind); + unit.tileR = r; unit.tileC = c; unit.x = c; unit.y = r; + unit.ground = this.grid.isLow(r, c) && !this._elevated?.has(k); + this._occ[k] = unit; + if (unit.obstacle) this.grid.setObstacle(r, c, true, unit.obstacleKind); + this._refreshRange(unit); // current + base range, CUSTOM_RANGE trigger keys + return true; + } + + /** + * 【移动】 (PRTS 术语释义 移动: "不退场，以当前血量在目标位置部署 … 本质上为一次特殊的撤退-再部署行为"): `unit` leaves its + * tile (relocate: same checks, false = refused, nothing changed) and is deployed on (r, c) at once. A new deployment — + * deploySeq / aggroSeq / deployedAt (the deploy animation; once-per-deployment effects re-arm) — announced by + * `deploy` { initial: false, move: true }: deploy effects fire again ("可以通过移动行为多次触发部署时触发的效果"). Not an + * exit: no `die` / `death`, so no knock-out, no redeploy timer or cost ("因移动撤退时不会积累再部署惩罚") — 不屈 and + * 阿戈尔's revive, which act on exits "因移动之外的原因" (PRTS 阿戈尔 备注), never see it. HP, buffs and a running skill + * stay: officially nothing carries over but what the mover's skill names (乌尔比安 S3: 技能进度 and the second talent's + * stacks); the remake keeps the rest too (owner's deviation, DESIGN §22.3). `clearSp`: the 技力 is emptied before the + * deploy handlers run ("部署时将清空技力"; 乌尔比安's 【返回】 "将清空技力，但仍可以享受后续由其他效果提供的技力"). + */ + moveRedeploy(unit, r, c, { clearSp = false } = {}) { + if (!this.relocate(unit, r, c)) return false; + unit.deploySeq = ++this._deploySeq; + unit.aggroSeq = unit.deploySeq; + unit.deployedAt = this.time; + const sk = unit.skill; + if (clearSp && sk && !sk.noSkill && sk.kind !== 'passive' && !(sk.active && sk.isTimed)) { + sk.sp = 0; + sk.charges = sk.spCost <= 0 ? sk.maxCharges : 0; // (a free skill is available once per deployment: skills.js reset) + } + this._ev(['deploy', unit.id]); + if (this._hooks.deploy) this.emit('deploy', { unit, initial: false, move: true }); + return true; + } + + /** + * A tile no automatic placement may take (the 突袭 landing tile, tactical points, summon / device tiles): a living + * unit stands on it, or it is the rest tile (restTile) of an ally piece that has not deployed yet or waits to + * redeploy — the tile a knocked-out operator lies on ("倒地干员所在地块…所有我方单位在此处的部署行为将被阻止", PRTS + * 卫戍协议/帮助 §作战阶段 单位部署), else its home tile (a token parked there would keep that unit off the field). + */ + isReservedTile(r, c) { + if (!Number.isInteger(r) || !Number.isInteger(c) || r < 0 || r >= ROWS || c < 0 || c >= COLS) return true; + const u = this._occ[r * COLS + c]; + if (u && u.alive) return true; + for (const a of this.allyUnits) { + if (a.alive || a.removed || (a.kind !== 'op' && a.kind !== 'token')) continue; + const [tr, tc] = this.restTile(a); + if (tr === r && tc === c) return true; + } + return false; + } + + /** + * The knocked-out operator (isDown) lying on (r, c), other than `except`, or null. Official (PRTS 卫戍协议/帮助 §作战阶段 + * 单位部署): "干员退场后…原地留下一个“倒地干员”…满足再部署条件时，移除场上的该倒地干员并自动部署至该位置" and "倒地干员所在 + * 地块视为可部署，但所有我方单位在此处的部署行为将被阻止" — its tile (`body`, _layBody) takes no other ally: `_deploy` + * (initial deploys, redeploys, the 突袭 landing, summons), `spawnDevice` and `relocate` refuse it. + */ + downOn(r, c, except = null) { + for (const a of this.allyUnits) { + if (a === except || !this.isDown(a)) continue; + const [br, bc] = a.body ?? [a.tileR, a.tileC]; + if (br === r && bc === c) return a; + } + return null; + } + + /** + * The tile a withdrawn ally comes back on (redeploy, _checkRedeploys): a down operator's body tile (isDown) — where it + * fell, or its home (_layBody) — else its home tile. + */ + restTile(u) { + return this.isDown(u) ? (u.body ? [u.body[0], u.body[1]] : [u.tileR, u.tileC]) : [u.homeR, u.homeC]; + } + + /** + * Where a knocked-out operator lies (it redeploys there): the tile it fell on, except — "若干员被击倒的位置为其他干员或 + * 召唤物的初始位置，则在被击倒后，尝试返回其自身的初始位置" (PRTS 卫戍协议/帮助) — a tile that is another board piece's + * home (a piece with a board uid: the 初始位置 is the prep placement — whether that piece is on the field, waiting or + * gone: a summon only leaves its home free once it has expired or been killed, so a removed one must count too), where + * it goes back to its own home tile when that is in the rect and free (isReservedTile: no living unit, no other body, + * no other waiting piece's tile). It stays where it fell when its home is taken [ASSUMED: one attempt, at the + * knock-out]. Only an operator moved off its board tile — a 突袭 jump, 乌尔比安's anchor — can fall elsewhere. Sets + * `u.body` (b.snap `down` carries it); x / y / tileR / tileC keep where it fell, so the `kill` / `death` handlers + * (被击倒时 effects) still act there. + */ + _layBody(u) { + const r = u.tileR, c = u.tileC, hr = u.homeR, hc = u.homeC; + u.body = [r, c]; + if (r === hr && c === hc) return; + if (!this.allyUnits.some((a) => a !== u && a.uid != null && (a.kind === 'op' || a.kind === 'token') && a.homeR === r && a.homeC === c)) return; + if (!this.grid.inRect(hr, hc) || this.isReservedTile(hr, hc)) return; + u.body = [hr, hc]; + } + + /** + * Tactical point (战术点) for tactician reinforcements: a free (isReservedTile) walkable ground tile of the unit's + * initial range (baseRangeKeys), on an enemy ground path first (groundPathTiles — where a player would put the + * blocker), then nearest to the unit (Chebyshev; the smaller sideways offset — in the unit's facing-RIGHT frame, so + * its forward line — breaks ties), then the lowest local (row, col) offset (sim/dir.js localOrder: for a RIGHT-facing + * unit exactly the lowest tile key). The choice turns with the unit's direction. null when none. + */ + findTacticalPoint(unit) { + if (!unit) return null; + const onPath = this.groundPathTiles(); + let best = null, bp = 2, bd = Infinity, bo = null; + for (const k of unit.baseRangeKeys || unit.rangeKeys || []) { + const r = (k / COLS) | 0, c = k % COLS; + if (!this.grid.groundPassable(r, c) || !this.grid.canStand(r, c)) continue; + if (this.isReservedTile(r, c)) continue; + const o = localOrder(r - unit.tileR, c - unit.tileC, unit.dir); + const d = Math.max(Math.abs(r - unit.tileR), Math.abs(c - unit.tileC)) + 0.01 * Math.abs(o[0]); + if (!(d > 0)) continue; + const p = onPath.has(k) ? 0 : 1; + if (p < bp || (p === bp && (d < bd - 1e-9 || (Math.abs(d - bd) <= 1e-9 && localBefore(o, bo))))) { bp = p; bd = d; bo = o; best = [r, c]; } + } + return best; + } + + /** + * Ground tiles the enemies of this field walk on: the flow-field routes (grid.findPath, live obstacles) of the + * non-FLY routes this battle's wave spawns on (every non-FLY route when no queued spawn names one — e.g. content-only + * battles), leg by leg (start → MOVE/APPEAR checkpoints → end, clamped to the rect). R1–R3 spawn at the lower gate + * only (research 08 §4.1), so the unused upper lane does not attract tactical points. Set of tile keys, cached per + * grid version. + */ + groundPathTiles() { + const ver = this.grid.version ?? 0; + const used = (this._pathRoutesUsed ??= new Set()); + const before = used.size; + for (const p of this._pending || []) if (!p.route && Number.isInteger(p.routeIndex)) used.add(p.routeIndex); + if (this._pathTiles && this._pathTilesVer === ver && used.size === before) return this._pathTiles; + const set = new Set(); + const R = this.rect; + const clampPt = (p) => [Math.max(R.r0, Math.min(R.r1, Math.round(p[0]))), Math.max(R.c0, Math.min(R.c1, Math.round(p[1])))]; + const ok = (p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]); + const walk = (route) => route && route.motion !== 'FLY' && ok(route.start); + const routes = this.routes || []; + const any = [...used].some((i) => walk(routes[i])); + routes.forEach((route, i) => { + if (!walk(route) || (any && !used.has(i))) return; + const pts = [clampPt(route.start)]; + for (const cp of route.checkpoints || []) if ((cp.type === 'MOVE' || cp.type === 'APPEAR') && ok(cp.pos)) pts.push(clampPt(cp.pos)); + if (ok(route.end)) pts.push(clampPt(route.end)); + for (let j = 1; j < pts.length; j++) { + const [a, b] = [pts[j - 1], pts[j]]; + const p = this.grid.findPath(a[0], a[1], b[0], b[1]) || this.grid.findPath(a[0], a[1], b[0], b[1], { ignoreObstacles: true }); + for (const [r, c] of p || []) set.add(r * COLS + c); + } + }); + this._pathTiles = set; + this._pathTilesVer = ver; + return set; + } + + /** + * An operator lying on the field, waiting to redeploy on that tile (DESIGN §5.5: after its respawn time, when the tile + * is free and DP ≥ cost; _layBody, downOn). PRTS 卫戍协议/帮助 §作战阶段 单位部署: "干员退场后，将返回隐藏的待部署区，并原地 + * 留下一个“倒地干员”以供查看信息，满足再部署条件时，移除场上的该倒地干员并自动部署至该位置。" — every 退场 (GitHub #60, the owner's + * decision of 2026-10-04): knocked out ('killed'), entering the battle knocked out (FORCED_EXIT, 联防) and forced out + * by its own effects ('retreat': 史尔特尔's 余烬, 耀骑士临光 S2, 骑士戒律 + 竞技旗, 伊内丝 S3; 'merchant': a 商人 that cannot + * pay) — except the 突袭 retreat ('raid', redeployed at once on its landing tile); not removed for good, after it was + * deployed. A forced exit stays no kill: its 'die' / `death` reason is not 'killed' (no 被击倒 effect, 不屈, 阿戈尔, no + * knock-down count). The client keeps its model on that tile knocked down with a redeploy countdown (b.snap `down`, + * render/units.js); summons, devices and enemies simply leave. + */ + isDown(u) { + return !!u && u.side === 'ally' && u.kind === 'op' && !u.alive && !u.removed && u.removeReason !== 'raid' + && u.deploySeq > 0 && Number.isFinite(u.respawnAt); + } + + /** + * constants.js DOWN_STATE of a down operator: its timer runs, or it waits for its tile / the DP — the same checks as + * _checkRedeploys (a living unit or another body on its rest tile). No ally may take the tile it lies on (downOn), so + * WAIT_TILE is a safeguard only. + */ + _downState(u) { + if (this.time + 1e-9 < u.respawnAt) return DOWN_STATE.COUNTING; + const [r, c] = this.restTile(u); + const occ = this._occ[r * COLS + c]; + if ((occ && occ.alive && occ !== u) || this.downOn(r, c, u)) return DOWN_STATE.WAIT_TILE; + const ps = this.getPlayer(u.ownerId); + return !ps || ps.dp + 1e-9 < u.base.cost ? DOWN_STATE.WAIT_DP : DOWN_STATE.COUNTING; + } +} diff --git a/server/sim/battle/util.js b/server/sim/battle/util.js new file mode 100644 index 00000000..22b68cdf --- /dev/null +++ b/server/sim/battle/util.js @@ -0,0 +1,12 @@ +// server/sim/battle/util.js — small helpers shared by the Battle method modules (server/sim/battle/*.js). + +/** Finite number or the default (content may pass undefined/NaN/Infinity/strings to helpers). */ +export const fin = (v, d) => { const n = typeof v === 'number' ? v : (v == null || v === '' ? NaN : Number(v)); return Number.isFinite(n) ? n : d; }; + +export function clone(v) { + if (v == null || typeof v !== 'object') return v; + if (Array.isArray(v)) return v.map(clone); + const o = {}; + for (const k of Object.keys(v)) o[k] = clone(v[k]); + return o; +} diff --git a/test/docs-consistency.test.js b/test/docs-consistency.test.js index 8b739d06..3ca02a0d 100644 --- a/test/docs-consistency.test.js +++ b/test/docs-consistency.test.js @@ -23,7 +23,7 @@ // 重装 skills (§21.29, GitHub issue #4 / PR #12). import { test } from 'node:test'; import assert from 'node:assert/strict'; -import { readFileSync } from 'node:fs'; +import { readFileSync, readdirSync } from 'node:fs'; import { join, dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; import { GameData } from '../server/match/gamedata.js'; @@ -49,6 +49,8 @@ import { DATA, makeMatch } from './match/harness.js'; const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..'); const doc = (p) => readFileSync(join(ROOT, p), 'utf8'); +/** server/sim/Battle.js with its method modules (server/sim/battle/*.js) as one text. */ +const battleText = () => [doc('server/sim/Battle.js'), ...readdirSync(join(ROOT, 'server/sim/battle')).sort().map((f) => doc(`server/sim/battle/${f}`))].join('\n'); const DESIGN = doc('docs/DESIGN.md'); const META = doc('docs/META.md'); const DATA_MD = doc('docs/DATA.md'); @@ -449,7 +451,7 @@ test('user playtest #6 (DESIGN §20): summons, skill triggers, blocking, push fo assert.match(SIM, /\*\*every blocker\*\* — melee units/); assert.ok(!/targets by its range alone: no/.test(SIM), 'SIM: the melee-only rule is gone'); assert.match(PLAYING, /\*\*阻挡了就一定能打到\*\*/); - const battleSrc = readFileSync(join(ROOT, 'server/sim/Battle.js'), 'utf8'); + const battleSrc = battleText(); assert.ok(!/meleeUnit/.test(battleSrc) && !/export function meleeUnit/.test(readFileSync(join(ROOT, 'server/sim/targeting.js'), 'utf8')), 'no melee gate in the engine'); // #15 / #16: skill triggers and the 3 s operation cooldown (code = §5.6 = §19.2 superseded) assert.equal(AUTO_OP_COOLDOWN, 3); @@ -552,7 +554,7 @@ test('playtest6b follow-up (DESIGN §20.10–§20.13): leader HP, 直接乘算, assert.equal(BOND_LAYER_CAP, 999); assert.equal(layerGainRoom(995, 10), 4); assert.ok(!('BOND_LAYER_CAP' in SIM_CONST) && !('layerRoom' in SIM_CONST), 'no second cap in server/sim/constants.js'); - for (const f of ['server/match/PlayerState.js', 'server/match/Match.js', 'server/sim/Battle.js']) { + for (const f of ['server/match/PlayerState.js', 'server/match/Match.js', 'server/sim/battle/economy.js']) { const src = doc(f); assert.match(src, /layerGainRoom/, `${f} clamps with layerGainRoom`); assert.ok(!/layerRoom\b/.test(src), `${f}: no layerRoom`); @@ -771,7 +773,7 @@ test('batch 6 QA residuals (DESIGN §21.21–§21.25): the lock per deployment f assert.ok(!/燃烧区域和减益都落不到她身上/.test(PLAYING), 'PLAYING: no blanket 减益 claim'); assert.match(PLAYING, /地面敌人的光环和全场效果[^\n]*照常生效/); // F5: rule 3 counts every board piece's home, removed or not - const battleSrc = doc('server/sim/Battle.js'); + const battleSrc = battleText(); assert.match(battleSrc, /a\.uid != null && \(a\.kind === 'op' \|\| a\.kind === 'token'\) && a\.homeR === r && a\.homeC === c/); assert.match(sub(24), /Every board piece's home counts now, on the field or not/); assert.match(SIM, /the piece on the field or not — a summon leaves its home free only once it has expired or been\nkilled/);