231 lines
13 KiB
JavaScript
231 lines
13 KiB
JavaScript
// ui/gameLogic/phases.js — phase families, banners, the round's result box and 战斗结束 sound, countdowns. Re-exported
|
||
// from ../gameLogic.js.
|
||
|
||
import { PHASE } from '../../../../shared/constants.js';
|
||
import { bossLevelSeconds } from '../matchStatus.js';
|
||
import { clamp, int, isObj, sortedPlayers } from './shared.js';
|
||
import { normalizeSp } from './draft.js';
|
||
import { t } from '../../../../shared/i18n.js';
|
||
|
||
|
||
// ---- phases ----------------------------------------------------------------------------------------
|
||
|
||
const COMBAT_PHASES = new Set([PHASE.COMBAT, PHASE.UNITE, PHASE.FINAL_ASSAULT, PHASE.HIDDEN_CORE]);
|
||
const PREP_PHASES = new Set([PHASE.PREP, PHASE.SP_DRAFT, PHASE.ROUND_START]);
|
||
|
||
/**
|
||
* Which screen family a phase belongs to.
|
||
* @param {string} phase
|
||
* @returns {'loading'|'briefing'|'draft'|'boot'|'prep'|'combat'|'settle'|'result'}
|
||
*/
|
||
export function phaseMode(phase) {
|
||
if (!phase) return 'loading';
|
||
if (phase === PHASE.INFO_CHECK) return 'briefing';
|
||
if (phase === PHASE.BAND_DRAFT) return 'draft';
|
||
if (phase === PHASE.BATTLE_CHECK) return 'boot';
|
||
if (phase === PHASE.RESULT) return 'result';
|
||
if (phase === PHASE.SETTLE) return 'settle';
|
||
if (COMBAT_PHASES.has(phase)) return 'combat';
|
||
if (PREP_PHASES.has(phase)) return 'prep';
|
||
return 'prep';
|
||
}
|
||
|
||
export const isCombatPhase = (phase) => COMBAT_PHASES.has(phase);
|
||
/**
|
||
* The HUD's "你已被淘汰 · 可继续观战队友" pill of an eliminated player: outside combat only — in combat and in the SETTLE
|
||
* after it the combat HUD (screens/game.js CombatHud, rendered for mode 'settle' too) already says it, and two
|
||
* elimination banners never show at once.
|
||
* @param {boolean} alive
|
||
* @param {string|null|undefined} phase
|
||
*/
|
||
export const showDeadPill = (alive, phase) => !alive && !COMBAT_PHASES.has(phase) && phase !== PHASE.SETTLE;
|
||
export const isBossPhase = (phase) => phase === PHASE.FINAL_ASSAULT || phase === PHASE.HIDDEN_CORE;
|
||
|
||
/**
|
||
* Banner shown when a phase starts: { title, sub?, tone } or null.
|
||
* @param {string|null|undefined} phase
|
||
* @param {any} pub m.public
|
||
* @param {{ alive?: boolean, spectator?: boolean }} [viewer] the local viewer (screens/game.js): `alive` false for an
|
||
* eliminated player, `spectator` for a spectator seat — it has no row in m.public, so `pub` cannot tell
|
||
*/
|
||
export function phaseBanner(phase, pub, { alive = true, spectator = false } = {}) {
|
||
const r = int(pub?.round, 0);
|
||
switch (phase) {
|
||
case PHASE.BATTLE_CHECK: return { title: t('协议启动'), micro: 'PROTOCOL START', tone: 'mint', sub: t('模拟即将开始'), duration: 2600 };
|
||
// round income goes to the seats still in only (server/match/match/phases.js startRound; eliminate() zeroes funds
|
||
// and pendingFunds): an eliminated player or a spectator seat reads 观战中, never 资金已到账 (GitHub #236, PR #237)
|
||
case PHASE.ROUND_START: return { title: t('第 {r} 回合', { r }), micro: `ROUND ${String(r).padStart(2, '0')}`, tone: 'mint',
|
||
sub: spectator || alive === false ? t('观战中') : t('资金已到账') };
|
||
case PHASE.SP_DRAFT: return { title: t('机变阶段'), micro: 'CONTINGENCY', tone: 'gold', sub: t('依次选择机变') };
|
||
case PHASE.PREP: return { title: t('休整期'), micro: `ROUND ${String(r).padStart(2, '0')} // REST`, tone: 'mint', sub: t('部署干员，准备迎敌') };
|
||
case PHASE.COMBAT: return { title: t('作战开始'), micro: 'COMBAT', tone: 'orange', sub: t('各自行动阶段') };
|
||
case PHASE.UNITE: {
|
||
const names = new Map(sortedPlayers(pub).map((p) => [p.playerId, p.name || t('博士')]));
|
||
const helpers = Array.isArray(pub?.unite?.helpers) ? pub.unite.helpers.map((id) => names.get(id)).filter(Boolean) : [];
|
||
return { title: t('联防阶段'), micro: 'JOINT DEFENSE', tone: 'orange', sub: helpers.length ? t('联防：{names}', { names: helpers }) : t('完美作战的博士迎战突破防线的敌人') };
|
||
}
|
||
case PHASE.FINAL_ASSAULT: return { title: t('最终攻势'), micro: 'FINAL ASSAULT', tone: 'red', sub: t('击败敌方领袖') };
|
||
case PHASE.HIDDEN_CORE: return { title: t('隐秘核心'), micro: 'HIDDEN CORE', tone: 'red', sub: t('被源石侵蚀的假想敌') };
|
||
case PHASE.SETTLE: return null;
|
||
default: return null;
|
||
}
|
||
}
|
||
|
||
// ---- the round's result box and 战斗结束 sound (GitHub #235; PR #112 by @Convey123) ------------------------------------
|
||
// The official round result dialog (research 09 §3.1 "Round result dialog"): 「作战结束」 with 「全员无伤！」, or
|
||
// 「生命值减少」 and the LP lost — official words only (the owner's review of PR #112, 2026-10-05: the
|
||
// remake's own 「联防成功 / 联防失败：还有 N 只突破防线」 line is not in the official dialog). screens/game.js shows it
|
||
// (ui/components.js ResultDialog) and plays the matching BATTLEOVER sound when SETTLE starts — the moment is [ASSUMED]:
|
||
// the sources do not time the dialog, and a 联防 leaker's number exists only after the 联防. Boss rounds have no SETTLE
|
||
// (最终攻势 / 隐秘核心 go to the result screen or the Hidden Core round), so they get neither [ASSUMED].
|
||
|
||
/** How long a result box (ui/components.js ResultDialog) stays up, ms — inside SETTLE's 3 s (server DELAYS.SETTLE). */
|
||
export const RESULT_BOX_MS = 2800;
|
||
|
||
/**
|
||
* What this round's own battle cost the viewer: `min(cap, leaks)`, exactly what settlement charges outside a 联防.
|
||
* `cost` is what screens/game.js `roundLossRef` kept while the battle ran — `leaks` = counted enemies that got through
|
||
* (the highest the round showed: the settled state reads 0 again and must not wipe it), `cap` = the per-round LP cap.
|
||
* @param {{ leaks?: number, cap?: number } | null | undefined} cost
|
||
* @returns {number|null} null when this round's battle was never seen (not in the round, a reconnect landing on SETTLE)
|
||
*/
|
||
export function ownRoundLoss(cost) {
|
||
if (!cost) return null;
|
||
const leaks = Number.isFinite(cost.leaks) ? Math.max(0, Math.trunc(cost.leaks)) : null;
|
||
if (leaks == null) return null;
|
||
const cap = Number.isFinite(cost.cap) && cost.cap > 0 ? Math.trunc(cost.cap) : 10; // no cap known → the official 10
|
||
return Math.min(cap, leaks);
|
||
}
|
||
|
||
/**
|
||
* 战斗结束: one of the official `BATTLEOVER_*` sounds (all three in data/assets.json audio.sfx.ui) — `battleOverReduce`
|
||
* when the round cost the viewer LP, `battleOverNoReduce` when a 联防 ran and the viewer was charged nothing,
|
||
* `battleOverNormal` otherwise; null when this round's battle was never seen. The client data names the three but not
|
||
* their triggers: the mapping is [ASSUMED] (PR #112; the owner's review called the three sounds right).
|
||
* The loss is the authority's per-player charge when a 联防 resolved (`uniteLoss`, m.public.uniteResult.losses — a
|
||
* leaker whose enemies the helpers stopped paid 0), else the own battle's (`ownRoundLoss`).
|
||
* @param {{ leaks?: number, cap?: number, unite?: boolean } | null | undefined} cost
|
||
* @param {number|null} [uniteLoss]
|
||
* @returns {'battleOverReduce'|'battleOverNoReduce'|'battleOverNormal'|null}
|
||
*/
|
||
export function battleOverSfx(cost, uniteLoss = null) {
|
||
if (!cost) return null;
|
||
// `uniteLoss == null` means "no 联防 figure" (Number(null) would read as 0)
|
||
const authority = uniteLoss == null ? NaN : Number(uniteLoss);
|
||
const loss = Number.isFinite(authority) ? Math.max(0, Math.trunc(authority)) : ownRoundLoss(cost);
|
||
if (loss == null) return null;
|
||
if (loss > 0) return 'battleOverReduce';
|
||
return cost.unite ? 'battleOverNoReduce' : 'battleOverNormal';
|
||
}
|
||
|
||
/**
|
||
* The official round result dialog for the viewer's own LP charge `loss`: 「作战结束」 + 「全员无伤！」 (mint) at 0, else
|
||
* 「生命值减少 −N」 (red).
|
||
* @param {number} loss
|
||
* @returns {{ title: string, micro: string, tone: string, sub: string, duration: number }}
|
||
*/
|
||
export function roundResultBox(loss) {
|
||
const n = Math.max(0, Math.trunc(Number(loss) || 0));
|
||
return n === 0
|
||
? { title: t('作战结束'), micro: 'BATTLE OVER', tone: 'mint', sub: t('全员无伤！'), duration: RESULT_BOX_MS }
|
||
: { title: t('作战结束'), micro: 'BATTLE OVER', tone: 'red', sub: t('生命值减少 −{n}', { n }), duration: RESULT_BOX_MS };
|
||
}
|
||
|
||
/**
|
||
* The result box of a round whose 联防 resolved: the same official dialog, its number the authority's charge for the
|
||
* viewer (m.public.uniteResult.losses — in a 联防 a leaker pays for the survivors, not for its own battle's leaks, so the
|
||
* client cannot work it out). The official words only, and only when they are true:
|
||
* 生命值减少 −N the round charged the viewer N (red);
|
||
* 全员无伤！ nothing got through (`through` 0): nobody paid, true for every participant (mint);
|
||
* title alone the 联防 leaked but the viewer was not charged (a helper, a spared leaker — 全员无伤！ would claim the
|
||
* teammate who paid was unharmed too, and the official dialog has no other line; orange). Also the
|
||
* reading of a view without `losses`, which never falls back to the own battle's leaks.
|
||
* A viewer `losses` does not list — a spectator seat, a player eliminated before the round — gets no box, as in a
|
||
* round without 联防, where a viewer without a battle gets none (and no sound) [ASSUMED].
|
||
* @param {{ through?: number, losses?: Record<string, number> } | null | undefined} res m.public.uniteResult
|
||
* @param {string|null|undefined} selfId the viewer's playerId
|
||
* @returns {{ title: string, micro: string, tone: string, sub: string, duration: number } | null} null: no 联防 resolved, or not in the round
|
||
*/
|
||
export function uniteResultBox(res, selfId) {
|
||
const through = Number(res?.through);
|
||
if (!isObj(res) || !Number.isFinite(through) || through < 0) return null;
|
||
const losses = isObj(res.losses) ? res.losses : null;
|
||
if (losses && (selfId == null || !Object.hasOwn(losses, selfId))) return null;
|
||
const raw = losses ? Number(losses[selfId]) : NaN;
|
||
const loss = Number.isFinite(raw) ? Math.max(0, Math.trunc(raw)) : null;
|
||
if (loss != null && loss > 0) return roundResultBox(loss);
|
||
if (loss != null && through === 0) return roundResultBox(0);
|
||
return { title: t('作战结束'), micro: 'BATTLE OVER', tone: 'orange', sub: '', duration: RESULT_BOX_MS };
|
||
}
|
||
|
||
/**
|
||
* The result box of a round without 联防: the own battle's cost as kept while it ran (`ownRoundLoss`; the live pending
|
||
* value is 0 again by the time SETTLE renders). null without a battle seen this round.
|
||
* @param {{ leaks?: number, cap?: number } | null | undefined} cost
|
||
*/
|
||
export function battleResultBox(cost) {
|
||
const loss = ownRoundLoss(cost);
|
||
return loss == null ? null : roundResultBox(loss);
|
||
}
|
||
|
||
/** Label of the prep capsule ("休息一下" in the original). */
|
||
export function prepCapsuleLabel(phase) {
|
||
if (phase === PHASE.SP_DRAFT) return t('机变阶段');
|
||
if (phase === PHASE.ROUND_START) return t('回合开始');
|
||
if (phase === PHASE.BATTLE_CHECK) return t('协议启动');
|
||
if (phase === PHASE.SETTLE) return t('回合结算');
|
||
return t('休息一下');
|
||
}
|
||
|
||
// ---- countdown -------------------------------------------------------------------------------------
|
||
|
||
/**
|
||
* Countdown display state.
|
||
* @param {number|null|undefined} deadline server epoch ms (0/null = untimed)
|
||
* @param {number} now server-corrected epoch ms
|
||
* @param {number} [total] total seconds of the phase (for the 5-bar gauge)
|
||
* @param {number} [warnAt] seconds at/below which the digits turn orange
|
||
* @returns {{ remain: number|null, warn: boolean, bars: number, text: string, frac: number }}
|
||
*/
|
||
export function countdownState(deadline, now, total, warnAt = 10) {
|
||
if (!(Number.isFinite(deadline) && deadline > 0) || !Number.isFinite(now)) {
|
||
return { remain: null, warn: false, bars: 0, text: '--', frac: 0 };
|
||
}
|
||
const remain = Math.max(0, Math.ceil((deadline - now) / 1000));
|
||
const t = Number.isFinite(total) && total > 0 ? total : null;
|
||
const frac = t ? clamp(remain / t, 0, 1) : 1;
|
||
const bars = remain === 0 ? 0 : t ? clamp(Math.ceil(frac * 5), 0, 5) : 5;
|
||
return { remain, warn: remain <= warnAt, bars, text: String(Math.min(999, remain)).padStart(2, '0'), frac };
|
||
}
|
||
|
||
/**
|
||
* Nominal length (s) of the current timed phase from data/config.json, or null when unknown/untimed.
|
||
* @param {any} pub m.public
|
||
* @param {any} config data/config.json
|
||
* @param {string|null} [myId]
|
||
*/
|
||
export function phaseTotalSeconds(pub, config, myId = null) {
|
||
if (!isObj(pub)) return null;
|
||
const timers = isObj(config?.timers) ? config.timers : {};
|
||
const mode = isObj(config?.modes) ? config.modes[pub.modeId] : null;
|
||
const num = (v) => (Number.isFinite(v) && v > 0 ? v : null);
|
||
switch (pub.phase) {
|
||
case PHASE.INFO_CHECK: return num(timers.infoCheck) ?? 25;
|
||
// one countdown: the current turn's (m.public.draft.turnSeconds = Match.BAND_TURN_SECONDS; user playtest #4 item 4)
|
||
case PHASE.BAND_DRAFT: return num(pub.draft?.turnSeconds) ?? num(timers.bandTurn) ?? 30;
|
||
case PHASE.BATTLE_CHECK: return num(timers.battleCheck) ?? 3;
|
||
case PHASE.SP_DRAFT: {
|
||
const sp = normalizeSp(pub.sp, pub.players);
|
||
const first = !sp || sp.pickedCount === 0;
|
||
return first ? (num(timers.spFirst) ?? 30) : (num(timers.spTurn) ?? 16);
|
||
}
|
||
case PHASE.PREP: return num(mode?.rounds?.[String(pub.round)]?.prepTime);
|
||
case PHASE.COMBAT:
|
||
case PHASE.UNITE: return num(mode?.rounds?.[String(pub.round)]?.combatTimeLimit);
|
||
// 最终攻势 / 隐秘核心: m.public.deadline is the level's 120 s countdown (maxPlayTime; the battle goes on past it)
|
||
case PHASE.FINAL_ASSAULT:
|
||
case PHASE.HIDDEN_CORE: return bossLevelSeconds(pub, config);
|
||
default: return null;
|
||
}
|
||
}
|