/** * Scene exploration — UI-driven interactions (hover, click, dialogue, combat, * expeditions, party, admin). No pointer raycasting; the world is 2D UI on a * fixed camera. Active during phase === 'game'. * * Attached to player. */ const SCENES = require('lib/data/scenes.json'); const PROLOGUE_CONFIG = require('lib/data/prologue.json'); const { totalModifier } = require('lib/skill-check.js'); const { requestCaelenIntro, openCaelenDialogue } = require('lib/caelen-intro.js'); const EXPEDITION = require('lib/expedition.js'); const PARTY = require('lib/party.js'); // For hotspots whose dialogue tree is generated per-character (e.g. Caelen), // fall back to the tree cached on the active character. function resolveHotspotDialogue(state, hotspot) { if (!hotspot) { // Expedition events store the active dialogue tree in state if (state && state.expeditionActiveDialogue) return state.expeditionActiveDialogue; return null; } if (hotspot.id === 'npc-traveler') { var ch = state && state.character; if (ch && ch.caelenDialogue) return ch.caelenDialogue; } return hotspot.dialogue || null; } // Expedition hotspot ids that aren't in scenes.json but live entirely in state. function isExpeditionHotspotId(id) { return id === '__expedition_event__' || id === '__expedition_battle__'; } const TYPEWRITER_SPEED = 15; // ms per character const RAY_RANGE = 80; const HIGHLIGHT_COLOR = 'oklch(0.85 0.12 260)'; const EXIT_COLOR = 'oklch(0.82 0.10 80)'; function getScene(id) { return SCENES.scenes[id] || null; } function findHotspotForObject(scene, objectId) { return (scene.hotspots || []).find(function(h) { return h.objectId === objectId; }) || null; } function findCharacterForObject(scene, objectId) { return (scene.characters || []).find(function(c) { return c.objectId === objectId; }) || null; } // --- Quest helpers --- var QUESTS_DB = require('lib/data/quests.json'); function getCharacterQuest(character, questId) { var quests = (character && character.quests) || []; for (var i = 0; i < quests.length; i++) { if (quests[i].id === questId) return quests[i]; } return null; } function getActiveQuestStep(character, questId) { var q = getCharacterQuest(character, questId); if (!q || q.complete) return null; var def = QUESTS_DB.quests[questId]; if (!def) return null; return def.steps[q.stepIndex] || null; } function advanceQuest(api, questId) { var s = api.getState(); var ch = s.character; if (!ch) return false; var quests = ch.quests ? ch.quests.slice() : []; for (var i = 0; i < quests.length; i++) { if (quests[i].id === questId && !quests[i].complete) { var def = QUESTS_DB.quests[questId]; if (!def) return false; quests[i] = Object.assign({}, quests[i], { stepIndex: quests[i].stepIndex + 1 }); if (quests[i].stepIndex >= def.steps.length) { quests[i].complete = true; // Give rewards var rewards = def.rewards || {}; var newXp = (s.character.xp || 0) + (rewards.xp || 0); var newGold = (s.character.gold || 0) + (rewards.gold || 0); ch.xp = newXp; ch.gold = newGold; // Queue mid-screen popup (mirror admin testquestcomplete payload). ch._questCompletePopup = { title: def.title || 'Quest Complete', description: def.description || '', rewards: rewards, }; } ch.quests = quests; var chars = Array.isArray(s.characters) ? s.characters.slice() : []; var slot = s.csSelectedSlot; if (slot != null && chars[slot]) chars[slot] = ch; api.patchState({ character: ch, characters: chars }); if (quests[i].complete) { api.playSound('/cdn/sfx-ui-quest-complete-triumphant-chime.mp3', { volume: 0.5 }); } return true; } } return false; } function grantQuest(api, questId, flags) { var def = QUESTS_DB.quests[questId]; if (!def) return false; var s = api.getState(); var ch = s.character; if (!ch) return false; var quests = ch.quests ? ch.quests.slice() : []; if (quests.some(function(q) { return q.id === questId; })) return false; var questRec = { id: questId, title: def.title, stepIndex: 0, complete: false }; if (flags && typeof flags === 'object') questRec.flags = Object.assign({}, flags); quests.push(questRec); ch.quests = quests; var chars = Array.isArray(s.characters) ? s.characters.slice() : []; var slot = s.csSelectedSlot; if (slot != null && chars[slot]) chars[slot] = ch; api.patchState({ character: ch, characters: chars, _questAcceptToast: { title: def.title, description: def.description }, _questAcceptTimer: 5.0, }); api.playSound('/cdn/sfx-ui-quest-accepted-ethereal-chime.mp3', { volume: 0.5 }); return true; } function openPanel(api, text, title) { api.patchState({ scenePanelOpen: true, scenePanelText: text, scenePanelTitle: title || null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: text.length, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, }); } // Open a dialogue node — text + choices + optional pending skill result badge. // dialogue = the hotspot.dialogue object, nodeId = node to enter, hotspotId/label // for context, skillResult = optional result to display as badge on this node. function openDialogueNode(api, dialogue, nodeId, hotspotId, label, skillResult) { if (!dialogue || !dialogue.nodes || !dialogue.nodes[nodeId]) return; var node = dialogue.nodes[nodeId]; var choices = Array.isArray(node.choices) ? node.choices : []; api.patchState({ scenePanelOpen: true, scenePanelText: node.text || '', scenePanelTitle: label || null, scenePanelCharIdx: 0, scenePanelSkillResult: skillResult || null, _scenePanelFullLen: (node.text || '').length, _sceneTypeTimer: 0, sceneDialogueNode: nodeId, sceneDialogueChoices: choices, sceneDialogueHotspot: hotspotId, sceneDialogueGrantOnClose: node._grantOnClose || null, scenePanelSpeaker: node.speaker || label || null, scenePanelIsPlayer: false, _sceneDialoguePending: null, }); } // Open a player-speech panel — shows the player's line with portrait, then on // advance applies the pending resolution (check / next node / grant). function openPlayerSpeechPanel(api, sayText, hotspotId, pendingResolve, expression) { var s = api.getState(); var ch = s.character || {}; var speakerName = ch.name || 'You'; api.patchState({ scenePanelOpen: true, scenePanelText: sayText, scenePanelTitle: speakerName, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: sayText.length, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: hotspotId, sceneDialogueGrantOnClose: null, scenePanelSpeaker: speakerName, scenePanelIsPlayer: true, scenePanelExpression: expression || 'Neutral', _sceneDialoguePending: pendingResolve || null, }); } // Smooth zone transition — fade to black, swap scene at peak, fade back in. function fadeZoneTransition(api, targetSceneId) { var s = api.getState(); if (!getScene(targetSceneId)) { api.toast('The way ahead is unclear.', { duration: 2 }); return; } // Close any open panel immediately so text doesn't hang over the fade api.patchState({ _zoneFade: 'out', _pendingZoneTarget: targetSceneId, scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, _hoverTarget: null, _hoverLabel: null, _hoverIsExit: false, }); api.runInSeconds(0.28, function() { var zs = api.getState(); var target = zs._pendingZoneTarget; if (!target) return; api.patchState({ currentScene: target, _sceneEntryShown: false, _sceneCooldown: 0.5, _zoneFade: 'hold', }); // Persist lastScene on character var zcs = api.getState(); var zch = zcs.character; if (zch) { zch.lastScene = target; zch.visitedScenes = zcs.visitedScenes || {}; var zchars = Array.isArray(zcs.characters) ? zcs.characters.slice() : []; var zslot = zcs.csSelectedSlot; if (zslot != null && zchars[zslot]) { zchars[zslot] = zch; api.patchState({ character: zch, characters: zchars }); } } // One brief hold frame so the new scene paints behind black, then fade in api.runInSeconds(0.05, function() { api.patchState({ _zoneFade: 'in', _pendingZoneTarget: null }); api.runInSeconds(0.32, function() { api.patchState({ _zoneFade: null }); }); }); }); } // Start the guided combat tutorial. Ensures starter abilities and bread, // then enters a scripted slime fight with tutorial flags set. function startCombatTutorial(api) { var s = api.getState(); var ENEMY_DATA = require('lib/data/enemies.json'); var tutTpl = (ENEMY_DATA.enemies || {})['tutorial-slime']; // Stamp with runtime instance id so the combat loop tracks this mob uniquely. var tutSlime = Object.assign({ id: 'tut-slime-1' }, tutTpl); var tutCh = s.character ? Object.assign({}, s.character) : {}; if (!tutCh.abilities) tutCh.abilities = {}; if (!tutCh.abilities.straight_punch) tutCh.abilities.straight_punch = { level: 1 }; if (!tutCh.abilities.low_kick) tutCh.abilities.low_kick = { level: 1 }; var tutBar = (tutCh.abilityBar || [null,null,null,null,null,null]).slice(); if (!tutBar[0]) tutBar[0] = 'straight_punch'; if (!tutBar[1]) tutBar[1] = 'low_kick'; tutCh.abilityBar = tutBar; var tutInv = Array.isArray(tutCh.inventory) ? tutCh.inventory.slice() : new Array(100).fill(null); var tutQi = Array.isArray(tutCh.quickItems) ? tutCh.quickItems.slice() : [null,null,null,null,null]; var tutBreadIdx = -1; for (var tbi = 0; tbi < tutInv.length; tbi++) { if (tutInv[tbi] && tutInv[tbi].id === 'bread') { tutBreadIdx = tbi; if (tutInv[tbi].qty < 3) tutInv[tbi] = { id: 'bread', qty: 5 }; break; } } if (tutBreadIdx < 0) { for (var tbi2 = 0; tbi2 < tutInv.length; tbi2++) { if (!tutInv[tbi2]) { tutInv[tbi2] = { id: 'bread', qty: 5 }; tutBreadIdx = tbi2; break; } } } if (tutBreadIdx >= 0 && !tutQi[0]) tutQi[0] = { id: 'bread', qty: 5, invIdx: tutBreadIdx }; tutCh.inventory = tutInv; tutCh.quickItems = tutQi; tutCh.combatTutorialSeen = true; var tutChars = (s.characters || []).slice(); var tutSlot = s.csSelectedSlot; if (tutSlot != null && tutChars[tutSlot]) tutChars[tutSlot] = tutCh; else { for (var tci = 0; tci < tutChars.length; tci++) { if (tutChars[tci] && tutChars[tci].name === tutCh.name) { tutChars[tci] = tutCh; break; } } } // Seed aggro table — tutorial is solo so the single player owns the table. var { seedThreatTables: tutSeedThreat, aliveAlliesFor: tutAllies } = require('lib/aggro.js'); var tutEnemies = tutSeedThreat(api, [tutSlime], tutAllies(api, s)); api.patchState({ character: tutCh, characters: tutChars, inCombat: true, combatEncounter: 'tutorial', combatEnemies: tutEnemies, combatBackground: 'forest-path', combatBasicAttackCd: 0, combatBasicAttackCdMax: 5.6, combatAbilityCds: [0,0,0,0,0,0], combatPhase: 'intro', combatRewards: null, _combatCatDmg: {}, _combatDeathTimer: 0, _combatIntroTimer: 4.2, combatTutorial: true, tutorialStep: 0, _tutorialTimer: 0, }); api.playSound('/cdn/sfx-combat-dramatic-whoosh-sweep.mp3', { volume: 0.45 }); api.runInSeconds(0.9, function() { api.playSound('/cdn/sfx-combat-metal-sword-clash-ring.mp3', { volume: 0.55 }); }); api.runInSeconds(1.15, function() { api.playSound('/cdn/sfx-combat-impact-burst-sparks.mp3', { volume: 0.4 }); }); api.musicShift('/cdn/music-epic-orchestral-combat-theme-ngu-exp9.mp3', { volume: 0.55, fade: 3.5 }); } // Home point: bind the current scene as the character's respawn point. function applyHomepointAction(api, action) { var s = api.getState(); var closePanel = { scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, }; if (action === 'setHome') { var hch = s.character ? Object.assign({}, s.character) : {}; hch.homeScene = s.currentScene; var hchars = Array.isArray(s.characters) ? s.characters.slice() : []; var hslot = s.csSelectedSlot; if (hslot != null && hchars[hslot]) hchars[hslot] = hch; api.patchState(Object.assign({ character: hch, characters: hchars }, closePanel)); var hsceneName = (getScene(s.currentScene) || {}).name || s.currentScene; api.toast('Home point set — ' + hsceneName, { duration: 3 }); api.playSound('/cdn/sfx-ui-skill-check-success-chime.mp3', { volume: 0.4 }); } else { api.patchState(closePanel); } } // Resolve a pending dialogue step: run any check, transition to next node, or grant/close. function resolveDialoguePending(api, pending, hotspotId) { // Home-point actions resolve without a dialogue tree. if (pending && pending.homepointAction) { applyHomepointAction(api, pending.homepointAction); return; } var s = api.getState(); var scene2 = getScene(s.currentScene); var hotspot = scene2 && hotspotId ? (scene2.hotspots || []).find(function(h) { return h.id === hotspotId; }) : null; var dialogue = resolveHotspotDialogue(s, hotspot); if (!dialogue) { // Nothing to resolve against — close panel api.patchState({ scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, }); return; } var checkResult = null; var nextNodeId = null; if (pending.check) { var dch = s.character || {}; checkResult = rollSkillCheck(api, { stat: pending.check.stat, dc: pending.check.dc }, dch.stats || {}, dch.traits || []); nextNodeId = checkResult.success ? pending.check.success : pending.check.failure; } else if (pending.next) { nextNodeId = pending.next; } var grantInfo = null; if (pending.grant && hotspot && hotspot.questGrant) { grantInfo = { questId: hotspot.questGrant, flags: pending.flags || null }; } // If we rolled, show the d20 overlay for ~1.8s before transitioning. if (checkResult) { api.playSound('/cdn/sfx-dice-roll-table-impact.mp3', { volume: 0.6 }); api.patchState({ sceneRoll: checkResult, _sceneDialoguePending: null, }); var deferred = { nextNodeId: nextNodeId, grantInfo: grantInfo, checkResult: checkResult, hotspotId: hotspotId, pending: pending }; api.runInSeconds(0.8, function() { if (checkResult.success) { api.playSound('/cdn/sfx-ui-success-bright-chime.mp3', { volume: 0.4 }); } else { api.playSound('/cdn/sfx-ui-fail-low-thud.mp3', { volume: 0.4 }); } }); api.runInSeconds(1.8, function() { applyDialogueResolution(api, deferred); }); return; } applyDialogueResolution(api, { nextNodeId: nextNodeId, grantInfo: grantInfo, checkResult: null, hotspotId: hotspotId, pending: pending }); } function applyDialogueResolution(api, r) { var s = api.getState(); var scene2 = getScene(s.currentScene); var hotspot = scene2 && r.hotspotId ? (scene2.hotspots || []).find(function(h) { return h.id === r.hotspotId; }) : null; var dialogue = resolveHotspotDialogue(s, hotspot); var nextNodeId = r.nextNodeId; var grantInfo = r.grantInfo; var checkResult = r.checkResult; // --- Expedition event terminal / rewards handling --- var isExpEvent = r.hotspotId === '__expedition_event__' || (r.pending && r.pending._expeditionEnd); var pendingFlag = r.pending || {}; if (r.hotspotId === '__expedition_event__' && (!dialogue || !nextNodeId || !dialogue.nodes[nextNodeId] || pendingFlag._expeditionEnd)) { // Terminal node — apply rewards, grant items, close panel, then either // advance or trigger a battle (if the choice provoked combat). var xpAdd = pendingFlag._expeditionRewardXp || 0; var gdAdd = pendingFlag._expeditionRewardGold || 0; var patch = { scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, expeditionActiveDialogue: null, }; if (xpAdd > 0) patch.expeditionXpEarned = (s.expeditionXpEarned || 0) + xpAdd; if (gdAdd > 0) patch.expeditionGoldEarned = (s.expeditionGoldEarned || 0) + gdAdd; // Party / non-leader protagonist: xp/gold totals and the // advance-or-battle decision are LEADER-authoritative. Forward the // intent via a packet on our own state; the leader's update() drain // picks it up next tick, applies totals to the shared expedition, and // calls advance/triggerExpeditionBattle on the authoritative side. var protForwardTerminal = !!(s.partyId && s.expeditionActive && !iAmLeaderLocal(s)); if (protForwardTerminal) { // Strip leader-authoritative fields from our local patch so we don't // fight the mirror — leader will apply these on session. delete patch.expeditionXpEarned; delete patch.expeditionGoldEarned; // expeditionActiveDialogue is ALWAYS_MIRROR (leader-owned). Leader // will clear it as part of processing the terminal packet. delete patch.expeditionActiveDialogue; } // --- Item grant(s) --- // Supports: _expeditionGrantItem (legacy singular) and _expeditionGrantItems (array). // Both get collected, stacked into inventory, and toasted. var grantList = []; if (Array.isArray(pendingFlag._expeditionGrantItems)) { for (var gli = 0; gli < pendingFlag._expeditionGrantItems.length; gli++) { var glItem = pendingFlag._expeditionGrantItems[gli]; if (glItem && glItem.id) grantList.push({ id: glItem.id, qty: Math.max(1, glItem.qty || 1) }); } } if (pendingFlag._expeditionGrantItem && pendingFlag._expeditionGrantItem.id) { grantList.push({ id: pendingFlag._expeditionGrantItem.id, qty: Math.max(1, pendingFlag._expeditionGrantItem.qty || 1), }); } if (grantList.length > 0) { // Expedition event grants land in the per-player loot bank instead of // the live inventory. Bank gets claimed (success/abandon) or lost // (death) at expedition end. See EXPEDITION.returnToTown. var gItemsLib = require('lib/items.js'); var gBank = Array.isArray(s.expeditionLootBank) ? s.expeditionLootBank.slice() : []; var grantedNames = []; for (var ggi = 0; ggi < grantList.length; ggi++) { var gGrant = grantList[ggi]; var gDef = gItemsLib.getItem(gGrant.id); if (!gDef) continue; gBank = EXPEDITION.stackIntoBank(gBank, gGrant.id, gGrant.qty); grantedNames.push(gDef.name + (gGrant.qty > 1 ? ' x' + gGrant.qty : '')); } if (grantedNames.length > 0) { patch.expeditionLootBank = gBank; api.toast('Added to your haul: ' + grantedNames.join(', '), { duration: 3 }); api.playSound('/cdn/sfx-ui-item-pickup-chime.mp3', { volume: 0.4 }); } } api.patchState(patch); // --- Quest step completion (quest-locked expedition event terminal) --- var cq = pendingFlag._expeditionCompleteQuest; if (cq && cq.questId && cq.stepId) { var cqCh = (api.getState().character) || {}; var cqQ = getCharacterQuest(cqCh, cq.questId); if (cqQ && !cqQ.complete) { var cqDef = QUESTS_DB.quests[cq.questId]; var cqStep = cqDef && cqDef.steps ? cqDef.steps[cqQ.stepIndex] : null; if (cqStep && cqStep.id === cq.stepId) { advanceQuest(api, cq.questId); } } } // --- Battle trigger or normal advance --- if (protForwardTerminal) { // Forward terminal intent to leader via packet. Include xp/gold totals // and the battle-trigger template id so the leader can apply them and // flip the expedition state authoritatively. Use a monotonic id so the // leader's drain can skip duplicates across ticks. var termSeq = (s._terminalActionSeq || 0) + 1; api.patchState({ _terminalActionSeq: termSeq, _pendingEventTerminal: { id: api.id + ':' + termSeq, playerId: api.id, xpAdd: xpAdd, goldAdd: gdAdd, battleId: pendingFlag._expeditionTriggerBattle || null, }, }); } else if (pendingFlag._expeditionTriggerBattle) { var triggered = EXPEDITION.triggerExpeditionBattle(api, pendingFlag._expeditionTriggerBattle); if (!triggered) EXPEDITION.advance(api); } else { EXPEDITION.advance(api); } return; } if (dialogue && nextNodeId && dialogue.nodes[nextNodeId]) { var nextNode = dialogue.nodes[nextNodeId]; var nextChoices = Array.isArray(nextNode.choices) ? nextNode.choices : []; // Flag-gate choices so authored quest scenes can reveal recognition // branches only when the player learned the truth upstream. nextChoices = EXPEDITION.filterChoicesByCharFlags(nextChoices, (api.getState() || {}).character); api.patchState({ scenePanelOpen: true, scenePanelText: nextNode.text || '', scenePanelTitle: hotspot ? (hotspot.label || null) : null, scenePanelCharIdx: 0, scenePanelSkillResult: checkResult, _scenePanelFullLen: (nextNode.text || '').length, _sceneTypeTimer: 0, sceneDialogueNode: nextNodeId, sceneDialogueChoices: nextChoices, sceneDialogueHotspot: r.hotspotId, sceneDialogueGrantOnClose: grantInfo, scenePanelSpeaker: nextNode.speaker || (hotspot ? hotspot.label : null) || null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, }); } else if (grantInfo) { api.patchState({ scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, }); grantQuest(api, grantInfo.questId, grantInfo.flags); } else { api.patchState({ scenePanelOpen: false, scenePanelText: null, scenePanelTitle: null, scenePanelCharIdx: 0, scenePanelSkillResult: null, _scenePanelFullLen: 0, _sceneTypeTimer: 0, sceneDialogueNode: null, sceneDialogueChoices: null, sceneDialogueHotspot: null, sceneDialogueGrantOnClose: null, scenePanelSpeaker: null, scenePanelIsPlayer: false, _sceneDialoguePending: null, sceneRoll: null, }); } } // Compute the list of players in the same town who can be invited to a party. // Run server-side from the leader's player behavior so we have full visibility // into every player's state (UI render can't always see other players' state). function computeInviteCandidates(api, s) { var myTown = s.expeditionOriginScene || s.currentScene || null; var allSessions = api.query({ tags: ['party-session'] }); var liveSessionIds = {}; for (var si = 0; si < allSessions.length; si++) liveSessionIds[allSessions[si].id] = true; var sess = null; if (s.partyId) { for (var sj = 0; sj < allSessions.length; sj++) if (allSessions[sj].id === s.partyId) { sess = allSessions[sj]; break; } } var pendingIds = {}; var memberIds = {}; if (sess && sess.state) { var pend = sess.state.pendingInvites || []; for (var pi = 0; pi < pend.length; pi++) pendingIds[pend[pi].toPlayerId] = true; var mem = sess.state.members || []; for (var mi = 0; mi < mem.length; mi++) memberIds[mem[mi].playerId] = true; } var players = api.getPlayers(); var out = []; for (var k = 0; k < players.length; k++) { var p = players[k]; if (!p || p.id === api.id) continue; var pst = p.state || {}; var pch = pst.character || null; if (!pch) continue; if (myTown && pst.currentScene !== myTown) continue; // Ignore stale partyId — if their session is gone, they're actually free. if (pst.partyId && liveSessionIds[pst.partyId]) continue; if (pendingIds[p.id]) continue; if (memberIds[p.id]) continue; var prof = null; try { prof = p.getProfile && p.getProfile(); } catch(_) {} out.push({ playerId: p.id, name: pch.name || 'Traveler', displayName: prof && prof.displayName ? prof.displayName : null, level: pch.level || 1, }); if (out.length >= 20) break; } return out; } // ---- Party session mirroring ---- // Fields mirrored between the leader's player state and the party-session // entity. Companions copy these from the session into their own state each // tick so everyone sees the same scene/expedition/combat. // Always mirrored — expedition meta, results, rewards. Safe to share at all // times; these fields don't affect town-level per-player state. var ALWAYS_MIRROR_FIELDS = [ 'expeditionActive', 'expeditionPreparing', 'expeditionPlan', 'expeditionNodeIdx', 'expeditionDifficulty', 'expeditionBiomeName', 'expeditionActiveDialogue', 'expeditionXpEarned', 'expeditionGoldEarned', 'expeditionRewardsOpen', 'expeditionResult', ]; // Mirrored ONLY while the party is in an expedition (active||preparing). // In town, each player runs their own dialogue + combat locally — a companion // must not see Maren's panel because the leader opened it. When the leader // returns to town, these fields are cleared on the companion once. // // NOTE: expeditionOpen / expeditionClosing are LOCAL per-player — the // planner panel is a private view. currentScene is LOCAL in town but // mirrored during expeditions so companions enter the same scene as the leader. var EXPEDITION_ONLY_MIRROR_FIELDS = [ 'currentScene', '_sceneBackgroundIdx', 'scenePanelOpen', 'scenePanelText', 'scenePanelTitle', 'scenePanelCharIdx', 'scenePanelSkillResult', '_scenePanelFullLen', '_sceneTypeTimer', 'scenePanelSpeaker', 'scenePanelIsPlayer', 'sceneRoll', 'sceneDialogueNode', 'sceneDialogueChoices', 'sceneDialogueHotspot', 'sceneDialogueGrantOnClose', '_sceneDialoguePending', 'inCombat', 'combatEncounter', 'combatEnemies', 'combatBackground', 'combatPhase', // NOTE: combatBasicAttackCd, combatBasicAttackCdMax, combatAbilityCds, // combatRewards, _combatDeathTimer, _combatOutroTimer are all LOCAL // per player. Each companion runs her own death → rewards → outro // independently so loot drops roll per-member and the ready-to-continue // latch works per-player. Leader owns combatEnemies authoritatively; // companions forward damage requests via _pendingCombatAction (see below). ]; var SESSION_MIRROR_FIELDS = ALWAYS_MIRROR_FIELDS.concat(EXPEDITION_ONLY_MIRROR_FIELDS); // Subset of EXPEDITION_ONLY_MIRROR_FIELDS whose authority transfers to the // protagonist during an active expedition EVENT node. Everyone else (leader // included) pulls these from session. For non-event nodes (biome/battle/ // transition/final), the leader keeps ownership as usual. var SCENE_PANEL_FIELD_SET = { scenePanelOpen: true, scenePanelText: true, scenePanelTitle: true, scenePanelCharIdx: true, scenePanelSkillResult: true, _scenePanelFullLen: true, _sceneTypeTimer: true, scenePanelSpeaker: true, scenePanelIsPlayer: true, sceneRoll: true, sceneDialogueNode: true, sceneDialogueChoices: true, sceneDialogueHotspot: true, sceneDialogueGrantOnClose: true, _sceneDialoguePending: true, }; var SCENE_PANEL_FIELDS = Object.keys(SCENE_PANEL_FIELD_SET); function getMyPartySession(api, s) { if (!s || !s.partyId) return null; // Read by id — bypasses AOI filtering (the sentinel is shared across places // and may be outside any one player's area of interest). try { var st = api.getObjectState(s.partyId); if (!st) return null; return { id: s.partyId, state: st }; } catch (_) { return null; } } // Is this player the leader of their current party? // Prefer the LOCAL-TRUTH flag set at party creation — it survives the client // prediction / server snap boundary that can desync api.id string comparisons. // Fall back to the session id comparison for safety. function iAmLeaderLocal(s) { return !!(s && s.partyId && s._iAmLeaderForParty === s.partyId); } function iAmLeader(api, s, sess) { if (iAmLeaderLocal(s)) return true; if (!sess) sess = getMyPartySession(api, s); return !!(sess && sess.state && sess.state.leaderId === api.id); } // Leader writes current expedition/scene snapshot to session. // Scene panel + combat fields only get mirrored during an actual expedition // (active || preparing). In town, the leader's Maren dialogue stays local. // // Panel fields are always written because the leader's own syncFromSession // keeps her local panel in sync with session — so re-writing the same // values back is a no-op functionally but guarantees the leader seeds the // panel for every new event node (including ones where the protagonist is // a non-leader companion who will take over authority on the next tick). function mirrorToSession(api, s) { if (!s || !s.partyId) return; if (!iAmLeaderLocal(s)) return; var inExpedition = !!(s.expeditionActive || s.expeditionPreparing); var leaderIsSceneOwner = inExpedition ? iAmSceneOwner(api, s) : true; var patch = {}; for (var i = 0; i < ALWAYS_MIRROR_FIELDS.length; i++) { var k = ALWAYS_MIRROR_FIELDS[i]; patch[k] = (s[k] === undefined) ? null : s[k]; } if (inExpedition) { for (var j = 0; j < EXPEDITION_ONLY_MIRROR_FIELDS.length; j++) { var ek = EXPEDITION_ONLY_MIRROR_FIELDS[j]; // Scene-panel fields: the leader only writes them when SHE is the scene // owner. When a non-leader protagonist owns the scene, her // mirrorProtagonistSceneToSession is the source — the leader must not // clobber those session writes with her stale local panel values. if (SCENE_PANEL_FIELD_SET[ek] && !leaderIsSceneOwner) continue; patch[ek] = (s[ek] === undefined) ? null : s[ek]; } } try { api.patchObjectState(s.partyId, patch); } catch (_) {} } // Non-leader protagonist writes scene-panel fields to session directly during // their active event node. Sig-gated so it only fires when values change. // Called from update() each tick; safe to call unconditionally (bails if not // applicable). function mirrorProtagonistSceneToSession(api, s) { if (!s || !s.partyId) return; if (iAmLeaderLocal(s)) return; // leader handles via mirrorToSession if (!s.expeditionActive) return; if (!iAmSceneOwner(api, s)) return; var sigParts = []; for (var i = 0; i < SCENE_PANEL_FIELDS.length; i++) { sigParts.push(JSON.stringify(s[SCENE_PANEL_FIELDS[i]])); } var sig = sigParts.join('|'); if (s._lastProtagonistMirrorSig === sig) return; var patch = {}; for (var j = 0; j < SCENE_PANEL_FIELDS.length; j++) { var k = SCENE_PANEL_FIELDS[j]; patch[k] = (s[k] === undefined) ? null : s[k]; } try { api.patchObjectState(s.partyId, patch); } catch (_) {} api.patchState({ _lastProtagonistMirrorSig: sig }); } // Companion reads session snapshot into own state. // Expedition-only fields are pulled only during an active expedition, so // companions can run their own town dialogue (Maren, notice board, etc.) // without the leader's scene panel bleeding into their UI. // // Leaders also pull during expeditions so their local panel stays in sync // with the session — this lets a non-leader protagonist drive the panel // via her own mirrorProtagonistSceneToSession writes without the leader's // subsequent mirrorToSession clobbering them (leader re-writes the same // values she just pulled). function syncFromSession(api, s) { if (!s || !s.partyId) return false; var sess = getMyPartySession(api, s); if (!sess) return false; var amLeader = iAmLeaderLocal(s) || sess.state.leaderId === api.id; var sessInExpedition = !!(sess.state.expeditionActive || sess.state.expeditionPreparing); // Companion who already pressed Return Home locally — she's home, but the // session still has leader's live expedition state. Block ALL expedition // mirror pulls until sessInExpedition flips false (leader pressed her own // Return Home), then clear the flag and resume normal sync. if (s._expeditionLeftForMe && !amLeader) { if (!sessInExpedition) { api.patchState({ _expeditionLeftForMe: false }); } return true; } var patch = {}; var changed = false; // ALWAYS_MIRROR_FIELDS are leader-authoritative. Leader skips; others pull. if (!amLeader) { for (var i = 0; i < ALWAYS_MIRROR_FIELDS.length; i++) { var k = ALWAYS_MIRROR_FIELDS[i]; var sv = sess.state[k]; if (sv === undefined) sv = null; if (s[k] !== sv) { patch[k] = sv; changed = true; } } } if (sessInExpedition) { // During expedition, ownership drives pulls: // - Combat fields: leader authoritative (drives enemy AI); leader skips. // - Scene-panel fields: pulled by EVERYONE EXCEPT the current scene owner. // The scene owner (leader for biome/battle/transition, non-leader // protagonist during event nodes) is the WRITE source; pulling back // from session would clobber her fresh local panel on the tick she // opens/advances it. // - EXCEPTION (bootstrap): if the scene owner's local panel is empty // but session has one, pull once. This handles the non-leader // protagonist case — the leader seeds the panel in startEventNode // (direct session write), and the protagonist needs to pick that // up before she can start owning updates. var amSceneOwner = iAmSceneOwner(api, s); var ownerNeedsBootstrap = amSceneOwner && !s.scenePanelOpen && !!sess.state.scenePanelOpen; for (var j = 0; j < EXPEDITION_ONLY_MIRROR_FIELDS.length; j++) { var ek = EXPEDITION_ONLY_MIRROR_FIELDS[j]; if (SCENE_PANEL_FIELD_SET[ek]) { if (amSceneOwner && !ownerNeedsBootstrap) continue; } else if (amLeader) { continue; // non-panel expedition fields: leader authoritative } var sv2 = sess.state[ek]; if (sv2 === undefined) sv2 = null; if (s[ek] !== sv2) { patch[ek] = sv2; changed = true; } } } else if (s._wasInPartyExpedition && !amLeader) { // Transition out of expedition — clear expedition-only fields once so // lingering road dialogue / combat state doesn't follow us home, AND // send the companion to her home town with a clean entry flag so the // auto-entry narration doesn't replay the last road dialogue text. // Leader clears her own state when she ends the expedition. for (var m = 0; m < EXPEDITION_ONLY_MIRROR_FIELDS.length; m++) { var mk = EXPEDITION_ONLY_MIRROR_FIELDS[m]; if (s[mk] !== null && s[mk] !== undefined && s[mk] !== false) { patch[mk] = (mk === 'scenePanelOpen' || mk === 'scenePanelIsPlayer' || mk === 'inCombat') ? false : (mk === 'scenePanelCharIdx' || mk === '_scenePanelFullLen' || mk === '_sceneTypeTimer' || mk === 'combatBasicAttackCd' || mk === 'combatBasicAttackCdMax') ? 0 : null; changed = true; } } // Route home explicitly. character.homeScene is always available locally. var homeId = (s.character && s.character.homeScene) || 'mirrowfeld'; patch.currentScene = homeId; patch._sceneEntryShown = true; // suppress auto-entry narration on arrival patch.expeditionActiveDialogue = null; changed = true; } if (!!s._wasInPartyExpedition !== sessInExpedition) { patch._wasInPartyExpedition = sessInExpedition; changed = true; } if (changed) api.patchState(patch); return true; } // Is this player the protagonist for the current event node? // Returns true if not in a party (solo), or if it's this player's turn. function iAmProtagonistForCurrentNode(api, s) { if (!s || !s.partyId) return true; var sess = getMyPartySession(api, s); if (!sess) return true; var plan = sess.state.expeditionPlan; if (!plan || !plan.nodes) return sess.state.leaderId === api.id; var idx = sess.state.expeditionNodeIdx || 0; var node = plan.nodes[idx]; if (!node) return sess.state.leaderId === api.id; if (node.kind !== 'event') { // Non-event nodes (biome/transition/combat/final) only leader drives return sess.state.leaderId === api.id; } if (node.protagonistPlayerId) return node.protagonistPlayerId === api.id; // Unassigned → leader return sess.state.leaderId === api.id; } // Am I the current "scene owner" — the player authoritative for scene-panel // state? During an active expedition EVENT node, that's the protagonist. // Everywhere else (town, battle nodes, biome transitions, etc.) it's the // leader. Solo always returns true. // // Uses the player's OWN local state for plan/nodeIdx to avoid a stale-session // race during the tick the leader advances (her local state updates before // the mirror catches up to the session). function iAmSceneOwner(api, s) { if (!s || !s.partyId) return true; if (!s.expeditionActive) return iAmLeaderLocal(s); // Prefer the local plan/nodeIdx if present (leader always has it fresh; // companions get it via ALWAYS_MIRROR sync). Fall back to session read. var plan = s.expeditionPlan; var idx = s.expeditionNodeIdx || 0; if (!plan || !plan.nodes) { var sess = getMyPartySession(api, s); if (!sess) return iAmLeaderLocal(s); plan = sess.state.expeditionPlan; idx = sess.state.expeditionNodeIdx || 0; if (!plan || !plan.nodes) return iAmLeaderLocal(s); } var node = plan.nodes[idx]; if (!node || node.kind !== 'event') return iAmLeaderLocal(s); if (node.protagonistPlayerId) return node.protagonistPlayerId === api.id; return iAmLeaderLocal(s); } function rollSkillCheck(api, check, stats, traits) { var stat = check.stat; var dc = check.dc; var mod = totalModifier(stat, stats, traits || []); var roll = Math.floor(api.random() * 20) + 1; var total = roll + mod; var nat20 = roll === 20; var nat1 = roll === 1; var success = nat20 ? true : nat1 ? false : total >= dc; return { success: success, roll: roll, modifier: mod, total: total, stat: stat, dc: dc, nat20: nat20, nat1: nat1 }; } export function onSpawn(api) { var s = api.getState(); // Reconcile party membership against live sessions (server-authoritative). // If any session lists us, adopt that partyId. If no session has us, clear // the stale partyId. This runs on join AND hot-reload. try { var sessions = api.query({ tags: ['party-session'] }); var myId = api.id; var foundPartyId = null; for (var si = 0; si < sessions.length; si++) { var sessObj = sessions[si]; var members = (sessObj.state && sessObj.state.members) || []; for (var mi = 0; mi < members.length; mi++) { if (members[mi] && members[mi].playerId === myId) { foundPartyId = sessObj.id; break; } } if (foundPartyId) break; } if (foundPartyId) { if (s.partyId !== foundPartyId) api.patchState({ partyId: foundPartyId }); } else if (s.partyId) { // Tag query returned nothing but the player still references a party. // The tag query can miss sessions (AOI on client, stale indices on // server) — so before wiping, confirm via direct id lookup. Only clear // if getObjectState confirms the session is truly gone. var directState = null; try { directState = api.getObjectState(s.partyId); } catch (_) {} if (!directState) { api.patchState({ partyId: null, _partyMembers: null, _partyPending: null, _partyLeader: null, _iAmLeader: false, }); } } } catch (_) {} if (s.phase === 'game' && s.currentScene) { var scene = getScene(s.currentScene); if (scene && scene.onEnter) { var visited = s.visitedScenes || {}; if (!visited[s.currentScene] && scene.onEnter.firstTime && !s.scenePanelOpen) { openPanel(api, scene.onEnter.firstTime, null); api.patchState({ visitedScenes: Object.assign({}, visited, { [s.currentScene]: true }) }); } } } } export function update(dt, api) { var s = api.getState(); if (s.phase !== 'game') return; // Chat: every ~1s, refresh the roster cached on the current scene's room // sentinel. Every player runs this — idempotent rewrite, last writer wins, // converges within a second of any join/leave/scene-change. if (s.currentScene) { var chatNow = (typeof Date !== 'undefined' && Date.now) ? Date.now() : 0; if (!s._chatRosterNextAt || chatNow >= s._chatRosterNextAt) { try { var _chatLib = require('lib/chat.js'); _chatLib.refreshRoomRoster(api, s.currentScene); } catch (_) {} api.patchState({ _chatRosterNextAt: chatNow + 1000 }); } } // Party companions mirror the leader's session every tick before anything else. if (s.partyId) { // Self-heal: the local-truth leader flag can get dropped across rejoins / // script reloads (persistence.player.include only keeps 'position', and // onSpawn's reconciliation patches partyId without re-asserting the flag). // Without it, iAmLeaderLocal returns false on the real leader and her // tick-mirror + guarded leader paths all no-op — companions get stranded // on 'Setting Forth'. Re-assert from session.leaderId when we see we are // actually the leader. if (!s._iAmLeaderForParty) { var healSess = null; try { healSess = api.getObjectState(s.partyId); } catch (_) {} if (healSess && healSess.leaderId === api.id) { api.patchState({ _iAmLeaderForParty: s.partyId }); s = api.getState(); } } var synced = syncFromSession(api, s); if (synced) { // Re-read after sync so the rest of update sees the new values. s = api.getState(); } // Leader mirrors her live expedition/scene state into the session every // tick (sig-gated) so async landings — LLM callbacks that flip node // status to 'ready', maybeStartFirstNode flipping expeditionActive — // actually reach companions. Without this, the session froze at the // setForth snapshot and companions stayed stuck on 'preparing' forever. if (iAmLeaderLocal(s)) { var mirrorSigParts = []; for (var msi = 0; msi < ALWAYS_MIRROR_FIELDS.length; msi++) { mirrorSigParts.push(JSON.stringify(s[ALWAYS_MIRROR_FIELDS[msi]] || null)); } var inExpMir = !!(s.expeditionActive || s.expeditionPreparing); if (inExpMir) { for (var msj = 0; msj < EXPEDITION_ONLY_MIRROR_FIELDS.length; msj++) { var msk = EXPEDITION_ONLY_MIRROR_FIELDS[msj]; mirrorSigParts.push(JSON.stringify(s[msk] || null)); } } var mirrorSig = mirrorSigParts.join('|'); if (mirrorSig !== (s._lastMirrorSig || '')) { mirrorToSession(api, s); api.patchState({ _lastMirrorSig: mirrorSig }); s = api.getState(); } } // Non-leader protagonist: mirror scene-panel fields to session so the // leader and other companions see the protagonist's dialogue navigation. mirrorProtagonistSceneToSession(api, s); // Rebuild the local view of members/pending by scanning all players whose // own partyId matches ours. Every player's partyId is authoritative in // their own state, which replicates to other clients through standard AOI // (remote entities ARE snapped, unlike the local controlled entity). // The party-session sentinel entity does NOT reliably replicate to the // local client because its spatial index entry is missing — this scan- // based rebuild sidesteps that entirely. var allP = api.getPlayers(); var membersList = []; var pendingList = null; var leaderFound = null; for (var api_i = 0; api_i < allP.length; api_i++) { var pp = allP[api_i]; var pst = pp.state || {}; if (pst.partyId !== s.partyId) continue; var pch = pst.character || {}; membersList.push({ playerId: pp.id, name: pch.name || 'Traveler', level: pch.level || 1, characterSnapshot: { id: pch.id || null, name: pch.name || 'Traveler', level: pch.level || 1, background: pch.background || null, gender: pch.gender || 'female', traits: (pch.traits || []).slice(), stats: Object.assign({}, pch.stats || {}), layers: pch.layers ? JSON.parse(JSON.stringify(pch.layers)) : {}, equipment: Object.assign({}, pch.equipment || {}), appearance: pch.appearance ? JSON.parse(JSON.stringify(pch.appearance)) : null, personality: pch.personality || null, }, }); if (pst._iAmLeaderForParty === s.partyId) leaderFound = pp.id; } // Keep leader at index 0 so UI slot ordering is stable. if (leaderFound) { membersList.sort(function(a, b) { if (a.playerId === leaderFound) return -1; if (b.playerId === leaderFound) return 1; return 0; }); } // Pending invites — authoritative list lives in the session, but we can // also read it on the leader (she wrote it to her own state at invite time). if (iAmLeaderLocal(s)) { // Filter out invites for players who already joined (their partyId now // matches ours) or declined (cleared incomingInvite without joining). var rawPending = s._partyPending || []; pendingList = []; for (var rp = 0; rp < rawPending.length; rp++) { var inv = rawPending[rp]; var stillPending = false; for (var rp2 = 0; rp2 < allP.length; rp2++) { var ppp = allP[rp2]; if (ppp.id !== inv.toPlayerId) continue; var pppst = ppp.state || {}; if (pppst.partyId === s.partyId) { stillPending = false; break; } if (pppst.incomingInvite && pppst.incomingInvite.partyId === s.partyId) stillPending = true; break; } if (stillPending) pendingList.push(inv); } } else { // Companions: look at the leader's state for pending list. for (var pi = 0; pi < allP.length; pi++) { var pp2 = allP[pi]; if (pp2.id === leaderFound && pp2.state) { pendingList = pp2.state._partyPending || []; break; } } } var prevMembersJson = JSON.stringify(s._partyMembers || null); var newMembersJson = JSON.stringify(membersList); var prevPendingJson = JSON.stringify(s._partyPending || null); var newPendingJson = JSON.stringify(pendingList); if (prevMembersJson !== newMembersJson || prevPendingJson !== newPendingJson || s._partyLeader !== leaderFound) { api.patchState({ _partyMembers: membersList, _partyPending: pendingList, _partyLeader: leaderFound, }); s = api.getState(); } } else if (s._partyMembers || s._partyPending || s._partyLeader || s._iAmLeader) { // partyId is null (player not in a party) — safe to clear stale mirror. api.patchState({ _partyMembers: null, _partyPending: null, _partyLeader: null, _iAmLeader: false }); s = api.getState(); } // When the expedition panel is open, keep the invite candidate list fresh. // IMPORTANT: this behavior runs on both server (authoritative) and client // (predicted). api.getPlayers() returns all players on the server but may // return only self on the client — so the client's compute would always // return [] and clobber the server's real list. Guard: only write when we // can actually see more than ourselves (or when we need to clear). var partyPanelOpen = !!(s.character && s.character._partyPanelOpen); var needsCandidates = (s.expeditionOpen || partyPanelOpen) && s.phase === 'game'; if (needsCandidates) { var allPlayers = api.getPlayers(); if (allPlayers.length > 1) { // NOTE: do NOT self-heal partyId/incomingInvite here by querying // party-session entities. Player-behavior queries are AOI-filtered, // and a session may exist globally while being invisible to this // player — clearing on that signal wipes valid party state. // Rely on onSpawn cleanup + explicit action-path cleanup instead. var cand = computeInviteCandidates(api, s); var sig = cand.map(function(c){ return c.playerId + ':' + c.name + ':' + c.level; }).join('|'); if (sig !== (s._invCandSig || '')) { api.patchState({ _inviteCandidates: cand, _invCandSig: sig }); } } } else if (s._inviteCandidates) { api.patchState({ _inviteCandidates: null, _invCandSig: '' }); } // Scene transition cooldown if (s._sceneCooldown > 0) { api.patchState({ _sceneCooldown: Math.max(0, s._sceneCooldown - dt) }); } // --- Leader drains companion combat packets --- // Companions forward their basic-attack / ability damage via // _pendingCombatAction on their own state. Leader scans party members, // applies damage to her authoritative combatEnemies, and tracks the last // processed sequence per playerId so she never applies the same packet // twice. if (s.partyId && iAmLeaderLocal(s) && s.inCombat && s.combatPhase === 'fight') { var drainEnemies = Array.isArray(s.combatEnemies) ? s.combatEnemies.slice() : null; if (drainEnemies) { var processedSeq = Object.assign({}, s._lastProcessedSeqByPlayer || {}); var drainChanged = false; var drainPlayers = api.getPlayers(); for (var dp = 0; dp < drainPlayers.length; dp++) { var dPlayer = drainPlayers[dp]; if (dPlayer.id === api.id) continue; var dSt = dPlayer.state || {}; if (dSt.partyId !== s.partyId) continue; var pkt = dSt._pendingCombatAction; if (!pkt || !pkt.id) continue; // Skip packets we've already processed for this player. // Use `in` check, not `||` — first packet's seq=0 and `0 || -1` = -1, // which would re-apply the same 1-damage packet every tick until the // enemy died (the "continuous damage" bug). var pktSeq = (pkt.id.indexOf(':') >= 0) ? parseInt(pkt.id.split(':')[1], 10) || 0 : 0; if ((pkt.playerId in processedSeq) && processedSeq[pkt.playerId] >= pktSeq) continue; // Apply packet. var tgtIdx = pkt.enemyIndex; if (tgtIdx < 0 || tgtIdx >= drainEnemies.length) { processedSeq[pkt.playerId] = pktSeq; drainChanged = true; continue; } var drainTgt = Object.assign({}, drainEnemies[tgtIdx]); if (drainTgt.hp <= 0) { processedSeq[pkt.playerId] = pktSeq; drainChanged = true; continue; } var aggroLib = require('lib/aggro.js'); if (pkt.kind === 'ability' && pkt.newTarget) { // Ability resolution — companion already computed full target state // (damage, statuses, stun-interrupt). Trust her computation; splat it. // Then add threat for the companion based on the damage dealt — the // companion's local newTarget doesn't carry an updated threat table // (she doesn't own it), so the leader stamps it here. var splat = pkt.newTarget; // Preserve leader's authoritative threat table on the enemy. if (drainEnemies[tgtIdx] && drainEnemies[tgtIdx].threat) { splat = Object.assign({}, splat, { threat: drainEnemies[tgtIdx].threat }); } aggroLib.addThreat(splat, pkt.playerId, pkt.dmg || 0); drainEnemies[tgtIdx] = splat; } else { // Basic attack — straight hp reduction by precomputed dmg. drainTgt.hp = Math.max(0, drainTgt.hp - (pkt.dmg || 0)); if (drainTgt.hp <= 0 && !drainTgt._deathPhase) { drainTgt._deathPhase = true; drainTgt._deathTime = 1.2; } aggroLib.addThreat(drainTgt, pkt.playerId, pkt.dmg || 0); drainEnemies[tgtIdx] = drainTgt; } processedSeq[pkt.playerId] = pktSeq; drainChanged = true; } if (drainChanged) { // Check for total wipe. var drainAllDead = true; for (var dd = 0; dd < drainEnemies.length; dd++) { if (drainEnemies[dd].hp > 0) { drainAllDead = false; break; } } var drainPatch = { combatEnemies: drainEnemies, _lastProcessedSeqByPlayer: processedSeq, }; if (drainAllDead) { drainPatch.combatPhase = 'death'; drainPatch._combatDeathTimer = 1.8; drainPatch.combatBasicAttackCd = 999; } api.patchState(drainPatch); s = api.getState(); } } } // --- Companion drains enemy-hit packets from leader --- // Leader's enemy AI writes _pendingEnemyHits[playerId] onto the party // session whenever an enemy resolves a cast/attack against a companion. // We read our own slot, apply damage + statuses + interrupt to ourselves, // and track the last processed seq so we don't double-apply. if (s.partyId && !iAmLeaderLocal(s) && s.inCombat && s.combatPhase === 'fight' && (s.health || 0) > 0) { try { var ehSess = api.getObjectState(s.partyId); if (ehSess && ehSess._pendingEnemyHits) { var ehSlot = ehSess._pendingEnemyHits[api.id]; if (ehSlot && typeof ehSlot.seq === 'number' && Array.isArray(ehSlot.hits)) { var ehLastSeq = (s._lastEnemyHitSeq || 0); if (ehSlot.seq > ehLastSeq) { var ehPatch = { _lastEnemyHitSeq: ehSlot.seq }; var ehNewHp = s.health; var ehHitDmg = 0; var ehHitBy = -1; var ehEvaded = false; var ehInterruptCast = false; var ehExistingStatuses = Array.isArray(s.playerStatuses) ? s.playerStatuses.slice() : []; var ehStatusesChanged = false; for (var ehi = 0; ehi < ehSlot.hits.length; ehi++) { var ehHit = ehSlot.hits[ehi]; if (ehHit.evaded) { ehEvaded = true; continue; } if ((ehHit.dmg || 0) > 0) { ehNewHp = Math.max(0, ehNewHp - ehHit.dmg); if (!ehHitDmg) { ehHitDmg = ehHit.dmg; ehHitBy = ehHit.enemyIdx; } if (ehHit.interruptCast && s._playerCastState === 'casting') { ehInterruptCast = true; } // Apply statuses (debuffs) — refresh or append if (Array.isArray(ehHit.statusEffects)) { for (var ehsi = 0; ehsi < ehHit.statusEffects.length; ehsi++) { var ehsDef = ehHit.statusEffects[ehsi]; if (api.random() < (ehsDef.chance != null ? ehsDef.chance : 1.0)) { var ehsNew = { id: ehsDef.id, name: ehsDef.name, icon: ehsDef.icon || '❓', remaining: ehsDef.duration || 4, duration: ehsDef.duration || 4, tint: ehsDef.tint || 'rgba(200,80,80,0.9)', desc: ehsDef.desc || '', effect: ehsDef.effect || {}, _dotAccum: 0, _appliedBy: ehHit.enemyName || 'Enemy', }; var ehReplaced = false; for (var ehsj = 0; ehsj < ehExistingStatuses.length; ehsj++) { if (ehExistingStatuses[ehsj].id === ehsNew.id) { ehExistingStatuses[ehsj] = ehsNew; ehReplaced = true; break; } } if (!ehReplaced) ehExistingStatuses.push(ehsNew); ehStatusesChanged = true; } } } } } if (ehHitDmg > 0) { ehPatch.health = ehNewHp; ehPatch._playerHitTimer = 0.6; ehPatch._playerHitDmg = ehHitDmg; ehPatch._playerHitBy = ehHitBy; api.screenShake(0.06, 0.12); api.playSound('/cdn/sfx-combat-hit-impact-flesh.mp3', { volume: 0.35 }); // Cast burn — interrupting hit landed while we were casting. if (ehInterruptCast && s._playerCastState === 'casting') { var ehBurnSlot = s._playerCastSlotIdx; var ehBurnAb = s._playerCastAbilityId; if (ehBurnSlot >= 0 && ehBurnAb) { var ehBurnCds = (s.combatAbilityCds || [0,0,0,0,0,0]).slice(); var ABILITIES_EH = require('lib/data/abilities.json'); var ehBurnAbDef = ABILITIES_EH.abilities[ehBurnAb]; ehBurnCds[ehBurnSlot] = (ehBurnAbDef && ehBurnAbDef.cooldown) || 3; ehPatch.combatAbilityCds = ehBurnCds; } ehPatch._playerCastState = null; ehPatch._playerCastTimer = 0; ehPatch._playerCastTime = 0; ehPatch._playerCastAbilityId = null; ehPatch._playerCastSlotIdx = -1; ehPatch._playerCastTargetIdx = -1; ehPatch._playerCastTelegraph = null; ehPatch._playerCastBurnedTimer = 0.9; ehPatch._playerCastBurnedName = s._playerCastAbilityName || 'Cast'; ehPatch._playerCastAbilityName = null; api.screenShake(0.08, 0.18); api.playSound('/cdn/sfx-combat-metal-sword-clash-ring.mp3', { volume: 0.32, pitch: 0.7 }); } // Downed-but-not-defeated: in expedition multiplayer we stay // alive at 0 hp so the party can carry the fight. if (ehNewHp <= 0) { if (s.expeditionActive) { ehPatch.combatBasicAttackCd = 999; } else { ehPatch.combatPhase = 'death'; ehPatch._combatDeathTimer = 1.8; ehPatch.combatBasicAttackCd = 999; } } } if (ehEvaded && ehHitDmg === 0) { ehPatch._evadedTimer = 1.0; api.playSound('/cdn/sfx-combat-metal-sword-clash-ring.mp3', { volume: 0.25, pitch: 1.4 }); } if (ehStatusesChanged) { ehPatch.playerStatuses = ehExistingStatuses; ehPatch._debuffAppliedTimer = 0.9; api.playSound('/cdn/sfx-combat-hit-impact-flesh.mp3', { volume: 0.2, pitch: 0.75 }); } api.patchState(ehPatch); s = api.getState(); } } } } catch (_) {} } // --- Leader drains companion terminal-event packets --- // When a non-leader protagonist resolves the terminal branch of an event, // she patches her own state with _pendingEventTerminal: { xpAdd, goldAdd, // battleId }. Leader picks it up here, applies xp/gold to the shared // expedition totals, clears expeditionActiveDialogue, and calls advance // or triggerExpeditionBattle on her authoritative state. if (s.partyId && iAmLeaderLocal(s) && s.expeditionActive) { var termProcessed = Object.assign({}, s._lastTerminalSeqByPlayer || {}); var termPlayers = api.getPlayers(); for (var tp = 0; tp < termPlayers.length; tp++) { var tPlayer = termPlayers[tp]; if (tPlayer.id === api.id) continue; var tSt = tPlayer.state || {}; if (tSt.partyId !== s.partyId) continue; var tPkt = tSt._pendingEventTerminal; if (!tPkt || !tPkt.id) continue; var tSeqStr = tPkt.id.indexOf(':') >= 0 ? tPkt.id.split(':')[1] : '0'; var tSeq = parseInt(tSeqStr, 10) || 0; if ((termProcessed[tPkt.playerId] || 0) >= tSeq) continue; // Apply xp/gold to leader's expedition totals. var termPatch = {}; var curS = api.getState(); if (tPkt.xpAdd > 0) termPatch.expeditionXpEarned = (curS.expeditionXpEarned || 0) + tPkt.xpAdd; if (tPkt.goldAdd > 0) termPatch.expeditionGoldEarned = (curS.expeditionGoldEarned || 0) + tPkt.goldAdd; // Clear the active dialogue — event is over. termPatch.expeditionActiveDialogue = null; // Also clear leader's scene panel (if she was observing). Ownership // will shift back to leader on the next node. termPatch.scenePanelOpen = false; termPatch.scenePanelText = null; termPatch.scenePanelTitle = null; termPatch.scenePanelCharIdx = 0; termPatch.scenePanelSkillResult = null; termPatch._scenePanelFullLen = 0; termPatch._sceneTypeTimer = 0; termPatch.sceneDialogueNode = null; termPatch.sceneDialogueChoices = null; termPatch.sceneDialogueHotspot = null; termPatch.sceneDialogueGrantOnClose = null; termPatch.scenePanelSpeaker = null; termPatch.scenePanelIsPlayer = false; termPatch._sceneDialoguePending = null; termPatch.sceneRoll = null; termProcessed[tPkt.playerId] = tSeq; termPatch._lastTerminalSeqByPlayer = termProcessed; api.patchState(termPatch); s = api.getState(); if (tPkt.battleId) { var termTriggered = EXPEDITION.triggerExpeditionBattle(api, tPkt.battleId); if (!termTriggered) EXPEDITION.advance(api); } else { EXPEDITION.advance(api); } // Process one packet per tick per player — bail out so the new state // settles before we look at more packets. s = api.getState(); break; } } // --- Leader polls party-ready latches for victory-continue gate --- // In multiplayer expeditions, each party member presses Continue on her own // rewards screen to mark herself ready (scene.js sets _combatReady=true). // When every party member (including leader) is ready, leader flips her // combatPhase to 'outro'; the mirror propagates to companions and each // player's outro-midpoint clears their own combat + applies their own // local rewards. Leader also advances the expedition plan after her clear. if (s.partyId && iAmLeaderLocal(s) && s.inCombat && s.combatPhase === 'rewards' && s.expeditionActive && s._combatReady) { var rdyPlayers = api.getPlayers(); var allReady = true; var rdyCount = 0; for (var rp = 0; rp < rdyPlayers.length; rp++) { var rPlayer = rdyPlayers[rp]; var rSt = rPlayer.state || {}; if (rSt.partyId !== s.partyId) continue; rdyCount++; if (!rSt._combatReady) { allReady = false; break; } } if (allReady && rdyCount >= 1) { api.musicShift(null, { fade: 0.8 }); api.patchState({ combatPhase: 'outro', _combatOutroTimer: 1.6, _combatReady: false }); s = api.getState(); } } // --- Leader-authoritative party-defeat detection --- // Solo defeat routes through the eaHp<=0 path at ~line 2037. In a party // expedition that path only sets combatBasicAttackCd=999 (lock the // player out of attacks) so the fight can continue with the survivors. // When every member of the party has fallen and enemies are still // alive, the whole band goes down together. Leader polls live health // across party members and flips her phase to 'outro' with defeat set; // the mirror propagates combatPhase='outro' to companions, whose outro // bootstrap below seeds their own _combatPlayerDefeated locally. if (s.partyId && iAmLeaderLocal(s) && s.inCombat && s.expeditionActive && s.combatPhase === 'fight' && s.combatEnemies) { var defEnemies = s.combatEnemies; var defEnemiesAlive = false; for (var dei = 0; dei < defEnemies.length; dei++) { if ((defEnemies[dei].hp || 0) > 0) { defEnemiesAlive = true; break; } } if (defEnemiesAlive) { var defPlayers = api.getPlayers(); var anyAlive = false; var partyCount = 0; for (var dpl = 0; dpl < defPlayers.length; dpl++) { var dPlSt = defPlayers[dpl].state || {}; if (dPlSt.partyId !== s.partyId) continue; partyCount++; if ((dPlSt.health || 0) > 0) { anyAlive = true; break; } } if (!anyAlive && partyCount >= 1) { api.musicShift(null, { fade: 1.0 }); api.playSound('/cdn/sfx-combat-defeat-dark-stinger.mp3', { volume: 0.5 }); api.patchState({ combatPhase: 'outro', _combatOutroTimer: 1.6, _combatPlayerDefeated: true, combatBasicAttackCd: 999, }); s = api.getState(); } } } // --- Companion: when phase syncs into 'outro' but local timer is 0, // kick it so her outro-midpoint fires (applies her own rewards + clears // her own local combat). Symmetric to the death-timer bootstrap above. // If this player is at 0 HP when outro begins, this is a party-defeat // outro (leader's detection above flipped everyone). Seed // _combatPlayerDefeated locally so the outro-midpoint at ~line 2095 // opens the expedition death screen instead of rolling victory loot. if (s.inCombat && s.combatPhase === 'outro' && (s._combatOutroTimer || 0) <= 0 && s.partyId && s.expeditionActive && !iAmLeaderLocal(s)) { var outroBootPatch = { _combatOutroTimer: 1.6 }; // Only route into defeat if enemies are still alive. If the mirror // flipped us to 'outro' because the leader killed the last enemy while // we were downed, this is a VICTORY outro — the revive-at-10% branch // in outro-midpoint (~line 2189) will carry us through. if ((s.health || 0) <= 0) { var bootEnemies = s.combatEnemies || []; var bootEnemiesAlive = false; for (var bei = 0; bei < bootEnemies.length; bei++) { if ((bootEnemies[bei].hp || 0) > 0) { bootEnemiesAlive = true; break; } } if (bootEnemiesAlive) { outroBootPatch._combatPlayerDefeated = true; api.musicShift(null, { fade: 1.0 }); api.playSound('/cdn/sfx-combat-defeat-dark-stinger.mp3', { volume: 0.5 }); } } api.patchState(outroBootPatch); s = api.getState(); } // Combat cooldown tick if (s.inCombat) { // Companion just entered combat via sync — initialize local cooldowns. // (Leader initializes these when she calls startCombat; companions now // own their own cooldowns so they can attack independently.) if (s.combatBasicAttackCdMax == null) { api.patchState({ combatBasicAttackCd: 0.5, combatBasicAttackCdMax: 5.6, combatAbilityCds: [0,0,0,0,0,0], }); s = api.getState(); } // Companion saw phase sync into 'death' from the leader's drain, but her // local _combatDeathTimer is 0 — she'd stay stuck in death forever and // never reach the rewards screen. Kick the timer so she walks the same // death → rewards flow as solo. Detect "just transitioned" by the // combination (phase === 'death' && timer === 0 && no packet was pending). // // ALSO compute her own combatRewards here, not in the death-timer drain. // Reason: the leader's phase can propagate from 'death' → 'rewards' via // the mirror FASTER than her local death-timer drains (sync runs early in // update, drain runs later; if leader flipped this tick, companion sees // 'rewards' before her own timer hits 0, and the victory branch at // ~line 2172 never fires). Seeding rewards at bootstrap guarantees the // UI has something to render the moment phase flips to 'rewards'. if (s.combatPhase === 'death' && (s._combatDeathTimer || 0) <= 0 && s.partyId && s.expeditionActive && !iAmLeaderLocal(s)) { var bootEnemies = s.combatEnemies || []; var bootTotalExp = 0; var bootTotalGold = 0; var bootDropped = []; for (var bri = 0; bri < bootEnemies.length; bri++) { var ben = bootEnemies[bri]; bootTotalExp += ben.exp || 0; bootTotalGold += ben.gold || 0; if (ben.loot) { for (var bli = 0; bli < ben.loot.length; bli++) { var bdrop = ben.loot[bli]; if (api.random() <= (bdrop.chance || 1)) { var bfound = false; for (var bdi = 0; bdi < bootDropped.length; bdi++) { if (bootDropped[bdi].id === bdrop.id) { bootDropped[bdi].qty += (bdrop.qty || 1); bfound = true; break; } } if (!bfound) bootDropped.push({ id: bdrop.id, qty: bdrop.qty || 1 }); } } } } var bootWpnType = 'unarmed'; var bootCh = s.character; if (bootCh && bootCh.equipment && bootCh.equipment.weapon) { var bootWpnDef = require('lib/items.js').getItem(bootCh.equipment.weapon); if (bootWpnDef && bootWpnDef.weaponType) bootWpnType = bootWpnDef.weaponType; } var bootWpnExp = Math.ceil(bootTotalExp * 0.6); api.patchState({ _combatDeathTimer: 1.8, combatBasicAttackCd: 999, combatRewards: { exp: bootTotalExp, gold: bootTotalGold, items: bootDropped, weaponType: bootWpnType, weaponProfExp: bootWpnExp, }, playerStatuses: [], _playerDotTimer: 0, _debuffAppliedTimer: 0, }); s = api.getState(); } // Companion fallback: if she missed the 'death' window entirely (phase // jumped straight to 'rewards' before her local update ran), seed her // rewards now from her own mirrored enemy snapshot. Same computation, // different trigger. if (s.combatPhase === 'rewards' && !s.combatRewards && s.partyId && s.expeditionActive && !iAmLeaderLocal(s)) { var lateEnemies = s.combatEnemies || []; var lateExp = 0; var lateGold = 0; var lateDropped = []; for (var lri = 0; lri < lateEnemies.length; lri++) { var len2 = lateEnemies[lri]; lateExp += len2.exp || 0; lateGold += len2.gold || 0; if (len2.loot) { for (var lli = 0; lli < len2.loot.length; lli++) { var ldrop = len2.loot[lli]; if (api.random() <= (ldrop.chance || 1)) { var lfound = false; for (var ldi = 0; ldi < lateDropped.length; ldi++) { if (lateDropped[ldi].id === ldrop.id) { lateDropped[ldi].qty += (ldrop.qty || 1); lfound = true; break; } } if (!lfound) lateDropped.push({ id: ldrop.id, qty: ldrop.qty || 1 }); } } } } var lateWpnType = 'unarmed'; var lateCh = s.character; if (lateCh && lateCh.equipment && lateCh.equipment.weapon) { var lateWpnDef = require('lib/items.js').getItem(lateCh.equipment.weapon); if (lateWpnDef && lateWpnDef.weaponType) lateWpnType = lateWpnDef.weaponType; } var lateWpnExp = Math.ceil(lateExp * 0.6); api.patchState({ combatRewards: { exp: lateExp, gold: lateGold, items: lateDropped, weaponType: lateWpnType, weaponProfExp: lateWpnExp, }, combatBasicAttackCd: 999, playerStatuses: [], _playerDotTimer: 0, _debuffAppliedTimer: 0, }); s = api.getState(); } var combatPatch = {}; if (s.combatBasicAttackCd > 0) { combatPatch.combatBasicAttackCd = Math.max(0, s.combatBasicAttackCd - dt); } // Ability cooldown ticks if (s.combatAbilityCds) { var abCds = s.combatAbilityCds.slice(); var abCdChanged = false; for (var aci = 0; aci < abCds.length; aci++) { if (abCds[aci] > 0) { abCds[aci] = Math.max(0, abCds[aci] - dt); abCdChanged = true; } } if (abCdChanged) combatPatch.combatAbilityCds = abCds; } // --- Player cast tick --- // Mirrors enemy cast system — timer counts UP toward castTime. When it // hits, resolve the ability damage (same math as immediate path, inlined // so we don't have to extract a helper from an already-huge file). // Burned casts are handled later when enemy damage resolves — this path // only runs for clean completions. if (s.combatPhase === 'fight' && s._playerCastState === 'casting' && (s.health || 0) > 0) { var pcTimer = (s._playerCastTimer || 0) + dt; var pcTime = s._playerCastTime || 1.0; combatPatch._playerCastTimer = pcTimer; if (pcTimer >= pcTime) { // Resolve cast var pcAbId = s._playerCastAbilityId; var pcSlot = s._playerCastSlotIdx; var pcTgt = s._playerCastTargetIdx; var ABILITIES_RES = require('lib/data/abilities.json'); var pcAb = ABILITIES_RES.abilities[pcAbId]; var pcEnemies = (combatPatch.combatEnemies || s.combatEnemies || []).slice(); var pcValid = pcAb && pcTgt >= 0 && pcTgt < pcEnemies.length && pcEnemies[pcTgt].hp > 0; if (pcValid) { var pcTarget = Object.assign({}, pcEnemies[pcTgt]); var pcCh = s.character || {}; var { computeCombatStats: pcCS } = require('lib/combat-stats.js'); var { computeEquipmentBonuses: pcEQ, getItem: pcGetItem } = require('lib/items.js'); var pcEqB = pcEQ(pcCh.equipment || {}); var pcStats = pcCS(pcCh.stats || {}, s.level || 1, pcEqB); var pcAtk = pcStats.atk; var pcCrit = (pcStats.crit || 5) / 100; var pcCritMult = 1.5 + ((pcStats.crit || 5) * 0.01); var pcMult = pcAb.atkMult || 1; var pcFlat = pcAb.flatDmg || 0; var pcHits = pcAb.hitCount || 1; var pcTotal = 0; var pcAnyCrit = false; for (var pchi = 0; pchi < pcHits; pchi++) { var pcVar = 0.85 + api.random() * 0.3; var pcRaw = Math.round((pcAtk * pcMult + pcFlat) * pcVar); var pcHit = Math.max(1, pcRaw - (pcTarget.def || 0)); var pcIsCrit = api.random() < pcCrit; if (pcIsCrit) { pcHit = Math.max(1, Math.round(pcHit * pcCritMult)); pcAnyCrit = true; } pcTotal += pcHit; } pcTarget.hp = Math.max(0, pcTarget.hp - pcTotal); if (pcTarget.hp <= 0 && !pcTarget._deathPhase) { pcTarget._deathPhase = true; pcTarget._deathTime = 1.2; } // Add threat for this caster on this enemy's table. require('lib/aggro.js').addThreat(pcTarget, api.id, pcTotal); pcEnemies[pcTgt] = pcTarget; // Apply status effects if (pcAb.statusEffects && pcAb.statusEffects.length > 0) { var pcSts = Array.isArray(pcTarget.statuses) ? pcTarget.statuses.slice() : []; var pcStunLanded = false; for (var pcsei = 0; pcsei < pcAb.statusEffects.length; pcsei++) { var pcSE = pcAb.statusEffects[pcsei]; if (api.random() < (pcSE.chance || 0)) { var pcReplaced = false; for (var pcsej = 0; pcsej < pcSts.length; pcsej++) { if (pcSts[pcsej].id === pcSE.id) { pcSts[pcsej] = { id: pcSE.id, name: pcSE.name, remaining: pcSE.duration, effect: pcSE.effect || {} }; pcReplaced = true; break; } } if (!pcReplaced) pcSts.push({ id: pcSE.id, name: pcSE.name, remaining: pcSE.duration, effect: pcSE.effect || {} }); if (pcSE.id === 'stun') pcStunLanded = true; } } pcTarget.statuses = pcSts; // Stun-interrupts enemy cast if (pcStunLanded && pcTarget.castState === 'casting' && !pcTarget.castUnstoppable) { var pcIntId = pcTarget.castAbilityId; if (pcIntId) { pcTarget.abilityCds = Object.assign({}, pcTarget.abilityCds || {}); pcTarget.abilityCds[pcIntId] = 4.0; } pcTarget.castState = 'idle'; pcTarget.castTimer = 0; pcTarget.castTime = 0; pcTarget.castAbilityId = null; pcTarget.castAbilityName = null; pcTarget.castUnstoppable = false; pcTarget.castCooldown = 0; pcTarget.castPlayerStatuses = null; pcTarget.castIdleTimer = 1.0; pcTarget._interruptTimer = 0.9; pcTarget._interruptName = pcTarget._interruptName || 'Cast'; } pcEnemies[pcTgt] = pcTarget; } // Set ability cooldown var pcCds = (combatPatch.combatAbilityCds || s.combatAbilityCds || [0,0,0,0,0,0]).slice(); pcCds[pcSlot] = pcAb.cooldown || 3; combatPatch.combatAbilityCds = pcCds; // Weapon type for VFX var pcWpn = 'unarmed'; if (pcCh.equipment && pcCh.equipment.weapon) { var pcWDef = pcGetItem(pcCh.equipment.weapon); if (pcWDef && pcWDef.weaponType) pcWpn = pcWDef.weaponType; } // --- Fork: leader applies enemies authoritatively; companion forwards. --- var pcAmLeader = iAmLeaderLocal(s); var pcSoloOrLeader = !s.partyId || pcAmLeader; if (pcSoloOrLeader) { combatPatch.combatEnemies = pcEnemies; } else { // Companion: send a cast-resolution packet; leader will apply the // target replacement to authoritative combatEnemies next tick. var pcActionId = api.id + ':' + (s._combatActionSeq || 0); combatPatch._pendingCombatAction = { id: pcActionId, playerId: api.id, kind: 'ability', enemyIndex: pcTgt, // Pass the fully computed target object — leader splats it in. // Companion's damage reflects her own stats, which is correct. newTarget: pcTarget, dmg: pcTotal, isCrit: pcAnyCrit, abilityId: pcAbId, abilityName: s._playerCastAbilityName || (pcAb && pcAb.name) || 'Cast', weaponType: pcWpn, }; combatPatch._combatActionSeq = (s._combatActionSeq || 0) + 1; } // Path contribution: cast credits the ability's OWN path. Sword // abilities (category:'sword') credit 'sword'; brawler (category:'martial') // credit 'unarmed'; magic → 'staff'. _combatCatDmg is now path-keyed. var ABILITY_CAT_TO_PATH = { martial: 'unarmed', sword: 'sword', dagger: 'dagger', staff: 'staff', magic: 'staff' }; var pcCatDmg = Object.assign({}, s._combatCatDmg || {}); var pcCat = ABILITY_CAT_TO_PATH[pcAb.category] || 'unarmed'; pcCatDmg[pcCat] = (pcCatDmg[pcCat] || 0) + pcTotal; combatPatch._combatCatDmg = pcCatDmg; combatPatch._combatHitIndex = pcTgt; combatPatch._combatHitDmg = pcTotal; combatPatch._combatHitCrit = pcAnyCrit; combatPatch._combatHitTimer = 1.0; combatPatch._combatHitKey = (s._combatHitKey || 0) + 1; combatPatch._combatHitSource = 'ability'; combatPatch._combatHitX = s._playerCastX || 0; combatPatch._combatHitY = s._playerCastY || 0; combatPatch._combatHitWeapon = pcWpn; // Punch screen — BIG slam because this is a cast resolving api.screenShake(pcAnyCrit ? 0.35 : 0.25, pcAnyCrit ? 0.45 : 0.38); api.playSound('/cdn/sfx-combat-hit-slash.mp3', { volume: 0.5 }); api.playSound('/cdn/sfx-combat-hit-impact.mp3', { volume: 0.55 }); // Check if all dead — move to death phase (LEADER ONLY; the leader // owns combat phase transitions, companions wait for mirror). if (pcSoloOrLeader) { var pcAllDead = true; for (var pceri = 0; pceri < pcEnemies.length; pceri++) { if (pcEnemies[pceri].hp > 0) { pcAllDead = false; break; } } // Tutorial: advance after cast-timed ability resolves (mirrors // the immediate-path advance in combatUseAbility). if (s.combatTutorial && (s.tutorialStep || 0) === 3) { combatPatch.tutorialStep = 4; combatPatch._tutorialTimer = 0; var pcTutList = combatPatch.combatEnemies || pcEnemies; var pcTutL2 = []; for (var pctl = 0; pctl < pcTutList.length; pctl++) { pcTutL2.push(Object.assign({}, pcTutList[pctl], { atkCd: 2.5, atkCdMax: 2.5 })); } combatPatch.combatEnemies = pcTutL2; } if (pcAllDead) { combatPatch.combatPhase = 'death'; combatPatch._combatDeathTimer = 1.8; combatPatch.combatBasicAttackCd = 999; } } // Fire the impact spectacle — white flash + shockwave + ability banner. combatPatch._playerCastImpactTimer = 0.7; combatPatch._playerCastImpactName = s._playerCastAbilityName || 'Cast'; combatPatch._playerCastImpactTargetIdx = pcTgt; combatPatch._playerCastImpactCrit = pcAnyCrit; combatPatch._playerCastImpactStyle = s._playerCastTelegraph || 'ring-pulse'; } // Clear cast state (resolved cleanly) combatPatch._playerCastState = null; combatPatch._playerCastTimer = 0; combatPatch._playerCastTime = 0; combatPatch._playerCastAbilityId = null; combatPatch._playerCastSlotIdx = -1; combatPatch._playerCastTargetIdx = -1; combatPatch._playerCastTelegraph = null; combatPatch._playerCastAbilityName = null; } } // --- End player cast tick --- // Tick down enemy status durations + death timers if ((s.combatPhase === 'fight' || s.combatPhase === 'death') && s.combatEnemies) { var stEnemies = combatPatch.combatEnemies || s.combatEnemies; var stChanged = false; var stUpdated = []; for (var sti = 0; sti < stEnemies.length; sti++) { var stE = stEnemies[sti]; var needsCopy = false; // Tick death timer if (stE._deathPhase && stE._deathTime > 0) { if (!needsCopy) { stE = Object.assign({}, stE); needsCopy = true; } stE._deathTime = Math.max(0, stE._deathTime - dt); if (stE._deathTime <= 0) stE._deathDone = true; stChanged = true; } // Tick status effects if (stE.statuses && stE.statuses.length > 0 && stE.hp > 0) { if (!needsCopy) { stE = Object.assign({}, stE); needsCopy = true; } stChanged = true; var stNew = []; for (var stj = 0; stj < stE.statuses.length; stj++) { var stS = stE.statuses[stj]; var rem = stS.remaining - dt; if (rem > 0) stNew.push({ id: stS.id, name: stS.name, remaining: rem, effect: stS.effect }); } stE.statuses = stNew; } // Tick heal flash timer (lifesteal popup) if (stE._healFlashTimer && stE._healFlashTimer > 0) { if (!needsCopy) { stE = Object.assign({}, stE); needsCopy = true; } stE._healFlashTimer = Math.max(0, stE._healFlashTimer - dt); if (stE._healFlashTimer <= 0) stE._healFlashAmt = 0; stChanged = true; } stUpdated.push(stE); } if (stChanged) combatPatch.combatEnemies = stUpdated; } // --- Tick player statuses (debuffs the enemies landed on us) --- // Only ticks while actively fighting. Rewards/death/end all leave the // list frozen; explicit clears happen at the transitions below. if (s.combatPhase === 'fight') { var psSrc = Array.isArray(combatPatch.playerStatuses) ? combatPatch.playerStatuses : (Array.isArray(s.playerStatuses) ? s.playerStatuses : null); if (psSrc && psSrc.length > 0) { var psOut = []; var psDotDmg = 0; for (var pti = 0; pti < psSrc.length; pti++) { var pst = Object.assign({}, psSrc[pti]); pst.remaining = (pst.remaining || 0) - dt; if (pst.remaining <= 0) continue; // expired // Accumulate fractional DoT — deal integer damage once per accumulated point var dotRate = (pst.effect && pst.effect.dot) || 0; if (dotRate > 0) { pst._dotAccum = (pst._dotAccum || 0) + dotRate * dt; if (pst._dotAccum >= 1) { var chunk = Math.floor(pst._dotAccum); psDotDmg += chunk; pst._dotAccum -= chunk; } } psOut.push(pst); } if (psOut.length !== psSrc.length || psDotDmg > 0) { combatPatch.playerStatuses = psOut; } else { combatPatch.playerStatuses = psOut; // always write back with decremented timers } if (psDotDmg > 0) { // Current health — respect anything the same frame just patched var curHp = combatPatch.health != null ? combatPatch.health : (s.health || 0); var nextHp = Math.max(0, curHp - psDotDmg); combatPatch.health = nextHp; combatPatch._playerDotTimer = 0.5; combatPatch._playerDotDmg = psDotDmg; // DoT-induced KO — route through same death flow as direct hits if (nextHp <= 0 && combatPatch.combatPhase == null && s.combatPhase === 'fight') { if (s.partyId && s.expeditionActive) { combatPatch.combatBasicAttackCd = 999; } else { combatPatch.combatPhase = 'death'; combatPatch._combatDeathTimer = 1.8; combatPatch.combatBasicAttackCd = 999; } } } } // Tick the "debuff applied" flash timer if ((s._debuffAppliedTimer || 0) > 0 && combatPatch._debuffAppliedTimer == null) { combatPatch._debuffAppliedTimer = Math.max(0, s._debuffAppliedTimer - dt); } // Tick the "cast burned" flash timer (shows INTERRUPTED! after a burn) if ((s._playerCastBurnedTimer || 0) > 0 && combatPatch._playerCastBurnedTimer == null) { combatPatch._playerCastBurnedTimer = Math.max(0, s._playerCastBurnedTimer - dt); } if ((s._playerDotTimer || 0) > 0 && combatPatch._playerDotTimer == null) { combatPatch._playerDotTimer = Math.max(0, s._playerDotTimer - dt); } } // --- Cast impact timer ticks REGARDLESS of phase, because a killing blow // flips phase to 'death' the same frame the impact fires. If this tick // is gated on 'fight', the timer freezes and the 10Hz UI re-render keeps // replaying the CSS animation until combat fully ends. if (s.combatPhase && (s._playerCastImpactTimer || 0) > 0 && combatPatch._playerCastImpactTimer == null) { combatPatch._playerCastImpactTimer = Math.max(0, s._playerCastImpactTimer - dt); } // --- Tutorial timer ticks --- if (s.combatTutorial && s.combatPhase === 'fight' && (s._tutorialTimer || 0) > 0) { var ttNew = Math.max(0, s._tutorialTimer - dt); combatPatch._tutorialTimer = ttNew; if (ttNew <= 0) { // Auto-advance timed steps var tStep = s.tutorialStep || 0; if (tStep === 2) { combatPatch.tutorialStep = 3; } // cooldown shown → ability prompt else if (tStep === 5) { combatPatch.tutorialStep = 6; } // HP shown → item prompt else if (tStep === 7) { combatPatch.combatTutorial = false; combatPatch.tutorialStep = 0; } // done → free fight } } // --- Enemy attack AI --- // Tutorial: freeze enemies unless step 4 (let enemy hit player) var tutorialBlockEnemies = s.combatTutorial && (s.tutorialStep || 0) !== 4; // AUTHORITY: leader (or solo) is the SOLE simulator of enemy attacks. In // multi, companions skip this whole block — they receive hit packets via // the session and apply damage to themselves in the drain block below. // Run even when leader is downed, as long as someone in the party is alive // (downed leader still ticks enemy AI for her teammates). var eaAmAuthority = !s.partyId || iAmLeaderLocal(s); var eaAggro = require('lib/aggro.js'); var eaAliveIds = eaAmAuthority ? eaAggro.aliveAlliesFor(api, s) : []; var eaAnyAlive = eaAliveIds.length > 0; if (eaAmAuthority && s.combatPhase === 'fight' && s.combatEnemies && eaAnyAlive && !tutorialBlockEnemies) { var eaEnemies = combatPatch.combatEnemies || s.combatEnemies; var eaChanged = false; var eaList = []; // Derive player DEF for damage calc (leader's own stats — used when // an enemy's chosen target IS the leader. For companion targets we // look up that companion's def/eva from her player state below.) var eaCh = s.character || {}; var { computeCombatStats: eaCS } = require('lib/combat-stats.js'); var { computeEquipmentBonuses: eaEQ } = require('lib/items.js'); var eaDerived = eaCS(eaCh.stats || {}, s.level || 1, eaEQ(eaCh.equipment || {})); var eaPlayerDef = eaDerived.def; // Pre-build a lookup of {def, eva} per alive party member so we don't // recompute per cast resolution. Leader (self) reuses precomputed vals. var eaTargetStats = {}; eaTargetStats[api.id] = { def: eaDerived.def, eva: eaDerived.eva || 3 }; if (s.partyId) { var eaPlayers = api.getPlayers ? api.getPlayers() : []; for (var epi = 0; epi < eaPlayers.length; epi++) { var epPl = eaPlayers[epi]; if (!epPl || epPl.id === api.id) continue; var epSt = epPl.state || {}; if (epSt.partyId !== s.partyId) continue; var epCh = epSt.character || {}; var epDerived = eaCS(epCh.stats || {}, epSt.level || 1, eaEQ(epCh.equipment || {})); eaTargetStats[epPl.id] = { def: epDerived.def, eva: epDerived.eva || 3 }; } } // Hit packets for companion targets — written to session at end of tick. // Shape: { [playerId]: [{ enemyIdx, enemyName, dmg, isCrit, evaded, statuses, interruptCast }, ...] } var eaCompanionHits = {}; var eaPlayerEva = eaDerived.eva || 3; var eaHp = s.health; var eaHitDmg = 0; var eaHitBy = -1; var eaEvaded = false; var eaInterruptedPlayerCast = false; for (var eai = 0; eai < eaEnemies.length; eai++) { var ea = Object.assign({}, eaEnemies[eai]); if (ea.hp <= 0) { eaList.push(ea); continue; } // Check stun — skip attack entirely var eaStunned = false; if (ea.statuses) { for (var esi = 0; esi < ea.statuses.length; esi++) { if (ea.statuses[esi].id === 'stun' && ea.statuses[esi].remaining > 0) { eaStunned = true; break; } } } // Slow/grapple increase cooldown rate (tick slower) var eaSpdMod = 1; if (ea.statuses) { for (var esj = 0; esj < ea.statuses.length; esj++) { var eff = ea.statuses[esj].effect || {}; if (eff.spdMod) eaSpdMod = Math.max(0.3, eaSpdMod + eff.spdMod * 0.08); } } // Expire any transient interrupt flash on the enemy if (ea._interruptTimer) { ea._interruptTimer = Math.max(0, ea._interruptTimer - dt); if (ea._interruptTimer <= 0) { ea._interruptTimer = 0; ea._interruptName = null; } eaChanged = true; } // Decide whether stun blocks this tick. Unstoppable casts continue // through stun; everything else freezes. var eaBlockedByStun = eaStunned && !(ea.castState === 'casting' && ea.castUnstoppable); if (eaBlockedByStun) { eaList.push(ea); continue; } // --- Cast state machine (if the mob has abilities[]) --- var eaAbilities = Array.isArray(ea.abilities) && ea.abilities.length ? ea.abilities : null; if (eaAbilities) { // Tick any active ability cooldowns down if (ea.abilityCds) { var newCds = {}; var cdsChanged = false; for (var acid in ea.abilityCds) { var cdRem = ea.abilityCds[acid] - dt; if (cdRem > 0) newCds[acid] = cdRem; else cdsChanged = true; } if (cdsChanged) { ea.abilityCds = newCds; eaChanged = true; } } var castState = ea.castState || 'idle'; if (castState === 'idle') { // Wait out the rest between casts var idleRem = ea.castIdleTimer != null ? ea.castIdleTimer : (ea.atkCdMax || 1.5); idleRem = Math.max(0, idleRem - dt * eaSpdMod); ea.castIdleTimer = idleRem; eaChanged = true; if (idleRem <= 0) { // Pick an ability not on cooldown var cds = ea.abilityCds || {}; var pool = []; for (var aai = 0; aai < eaAbilities.length; aai++) { if (!cds[eaAbilities[aai].id]) pool.push(eaAbilities[aai]); } if (pool.length === 0) { ea.castIdleTimer = 0.5; // all on cd, breathe and retry } else { var pick = pool[Math.floor(api.random() * pool.length)]; ea.castState = 'casting'; ea.castTimer = 0; ea.castTime = pick.castTime || 2.0; ea.castAbilityId = pick.id; ea.castAbilityName = pick.name; ea.castDmgMult = pick.dmgMult != null ? pick.dmgMult : 1.0; ea.castFixedDmg = pick.fixedDmg != null ? pick.fixedDmg : null; ea.castLifesteal = pick.lifesteal || 0; ea.castUnstoppable = !!pick.unstoppable; ea.castCanInterruptPlayer = !!pick.canInterruptPlayer; ea.castCooldown = pick.cooldown || 0; ea.castPlayerStatuses = Array.isArray(pick.playerStatusEffects) ? pick.playerStatusEffects : null; } } } else if (castState === 'casting') { ea.castTimer = (ea.castTimer || 0) + dt * eaSpdMod; eaChanged = true; if (ea.castTimer >= (ea.castTime || 2)) { // Pick target via threat table. Solo = always self. Multi = // highest-threat alive ally. Skip if leader's self already ate // a hit this tick (preserves "one-hit-per-tick" smoothing on // the local player; companion targets are unrestricted since // they each track their own incoming). var castTargetId = eaAggro.pickTarget(ea, eaAliveIds, api.id); var castIsForMe = (castTargetId === api.id); var castSkip = castIsForMe && !!eaHitDmg; if (!castSkip) { var tgtStats = eaTargetStats[castTargetId] || { def: eaPlayerDef, eva: eaPlayerEva }; var eaDmg; var eaCritFinal = false; var eaEvadedThis = false; if (ea.castFixedDmg != null) { eaDmg = ea.castFixedDmg; } else { var dmgMult = ea.castDmgMult != null ? ea.castDmgMult : 1.0; var eaVariance = 0.85 + api.random() * 0.3; var eaRaw = (ea.atk || 5) * dmgMult * eaVariance; // Percentage defense: 50 def → 33% reduction, 100 → 50%, etc. eaDmg = Math.max(1, Math.round(eaRaw * (100 / (100 + tgtStats.def)))); eaCritFinal = api.random() < ((ea.crit || 3) / 100); if (eaCritFinal) eaDmg = Math.max(1, Math.round(eaDmg * 1.4)); if (api.random() * 100 < tgtStats.eva) { eaDmg = 0; eaEvadedThis = true; } } // Lifesteal — heals the enemy. Applies regardless of who got hit. if (eaDmg > 0 && ea.castLifesteal && ea.castLifesteal > 0) { var healAmt = Math.max(1, Math.round(eaDmg * ea.castLifesteal)); var newHp = Math.min(ea.maxHp || ea.hp, (ea.hp || 0) + healAmt); if (newHp > ea.hp) { ea.hp = newHp; ea._healFlashAmt = healAmt; ea._healFlashTimer = 1.0; api.playSound('/cdn/sfx-ui-heal-chime.mp3', { volume: 0.3, pitch: 0.9 }); } } if (castIsForMe) { // I am the target — apply locally (legacy path). if (eaDmg > 0) { eaHp = Math.max(0, eaHp - eaDmg); eaHitDmg = eaDmg; eaHitBy = eai; if (ea.castCanInterruptPlayer && s._playerCastState === 'casting') { eaInterruptedPlayerCast = true; } } if (eaEvadedThis && eaDmg === 0) eaEvaded = true; // --- Apply player status effects (debuffs) --- if (eaDmg > 0 && Array.isArray(ea.castPlayerStatuses) && ea.castPlayerStatuses.length > 0) { var existing = Array.isArray(combatPatch.playerStatuses) ? combatPatch.playerStatuses.slice() : (Array.isArray(s.playerStatuses) ? s.playerStatuses.slice() : []); var anyApplied = false; for (var psi = 0; psi < ea.castPlayerStatuses.length; psi++) { var psDef = ea.castPlayerStatuses[psi]; if (api.random() < (psDef.chance != null ? psDef.chance : 1.0)) { var psNew = { id: psDef.id, name: psDef.name, icon: psDef.icon || '❓', remaining: psDef.duration || 4, duration: psDef.duration || 4, tint: psDef.tint || 'rgba(200,80,80,0.9)', desc: psDef.desc || '', effect: psDef.effect || {}, _dotAccum: 0, _appliedBy: ea.name || 'Enemy', }; var replacedPs = false; for (var psj = 0; psj < existing.length; psj++) { if (existing[psj].id === psNew.id) { existing[psj] = psNew; replacedPs = true; break; } } if (!replacedPs) existing.push(psNew); anyApplied = true; } } if (anyApplied) { combatPatch.playerStatuses = existing; combatPatch._debuffAppliedTimer = 0.9; api.playSound('/cdn/sfx-combat-hit-impact-flesh.mp3', { volume: 0.2, pitch: 0.75 }); } } } else { // Target is a companion — write a hit packet. She drains it // on her own update and applies damage/statuses/interrupt // to herself. if (!eaCompanionHits[castTargetId]) eaCompanionHits[castTargetId] = []; eaCompanionHits[castTargetId].push({ enemyIdx: eai, enemyName: ea.name || 'Enemy', dmg: eaDmg, isCrit: eaCritFinal, evaded: eaEvadedThis && eaDmg === 0, statusEffects: Array.isArray(ea.castPlayerStatuses) ? ea.castPlayerStatuses : null, interruptCast: !!ea.castCanInterruptPlayer, }); } // Put on post-use cooldown if the ability defined one if (ea.castCooldown && ea.castAbilityId) { ea.abilityCds = Object.assign({}, ea.abilityCds || {}); ea.abilityCds[ea.castAbilityId] = ea.castCooldown; } // Reset to idle ea.castState = 'idle'; ea.castTimer = 0; ea.castTime = 0; ea.castAbilityId = null; ea.castAbilityName = null; ea.castFixedDmg = null; ea.castLifesteal = 0; ea.castUnstoppable = false; ea.castCooldown = 0; ea.castPlayerStatuses = null; ea.castIdleTimer = ea.atkCdMax != null ? Math.max(0.8, ea.atkCdMax * 0.5) : 1.2; } } } } else { // --- Legacy simple attack (no abilities[]) --- ea.atkCd = Math.max(0, (ea.atkCd || 0) - dt * eaSpdMod); eaChanged = true; if (ea.atkCd <= 0) { // Pick target via threat table; fork solo-self vs companion. var legTargetId = eaAggro.pickTarget(ea, eaAliveIds, api.id); var legIsForMe = (legTargetId === api.id); var legSkip = legIsForMe && !!eaHitDmg; if (!legSkip) { var legStats = eaTargetStats[legTargetId] || { def: eaPlayerDef, eva: eaPlayerEva }; var eaVariance2 = 0.85 + api.random() * 0.3; var eaRaw2 = (ea.atk || 5) * eaVariance2; var eaDmg2 = Math.max(1, Math.round(eaRaw2 * (100 / (100 + legStats.def)))); var eaCrit2 = api.random() < ((ea.crit || 3) / 100); if (eaCrit2) eaDmg2 = Math.max(1, Math.round(eaDmg2 * 1.4)); var legEvadedThis = false; if (api.random() * 100 < legStats.eva) { eaDmg2 = 0; legEvadedThis = true; } if (legIsForMe) { if (eaDmg2 > 0) { eaHp = Math.max(0, eaHp - eaDmg2); eaHitDmg = eaDmg2; eaHitBy = eai; } if (legEvadedThis && eaDmg2 === 0) eaEvaded = true; } else { if (!eaCompanionHits[legTargetId]) eaCompanionHits[legTargetId] = []; eaCompanionHits[legTargetId].push({ enemyIdx: eai, enemyName: ea.name || 'Enemy', dmg: eaDmg2, isCrit: eaCrit2, evaded: legEvadedThis && eaDmg2 === 0, statusEffects: null, interruptCast: false, }); } ea.atkCd = ea.atkCdMax || 4.5; } } } eaList.push(ea); } if (eaChanged) combatPatch.combatEnemies = eaList; // Flush companion hit packets to the party session. Each companion // drains her own slot in the block farther down this update. We bump a // monotonic seq so companions know which packet is fresh. var eaHasCompanionHits = false; for (var echk in eaCompanionHits) { eaHasCompanionHits = true; break; } if (eaHasCompanionHits && s.partyId) { try { var prevSession = api.getObjectState(s.partyId) || {}; var prevPending = prevSession._pendingEnemyHits || {}; var nextPending = Object.assign({}, prevPending); var nextSeq = (prevSession._enemyHitSeq || 0) + 1; for (var ehk in eaCompanionHits) { nextPending[ehk] = { seq: nextSeq, hits: eaCompanionHits[ehk] }; } api.patchObjectState(s.partyId, { _pendingEnemyHits: nextPending, _enemyHitSeq: nextSeq, }); } catch (_) {} } if (eaHitDmg > 0) { combatPatch.health = eaHp; combatPatch._playerHitTimer = 0.6; combatPatch._playerHitDmg = eaHitDmg; combatPatch._playerHitBy = eaHitBy; api.screenShake(0.06, 0.12); // Red edge vignette is rendered by renderPlayerHitOverlay (driven by // _playerHitTimer). No screenFlash — it stacked white over the vignette. api.playSound('/cdn/sfx-combat-hit-impact-flesh.mp3', { volume: 0.35 }); // --- BURN: an interrupting cast landed a hit while player was casting. // Cast is wasted, cooldown is still consumed (the "burned" choice). // A brief timer drives the red flash + "INTERRUPTED!" label in the UI. if (eaInterruptedPlayerCast && s._playerCastState === 'casting') { var burnSlot = s._playerCastSlotIdx; var burnAb = s._playerCastAbilityId; if (burnSlot >= 0 && burnAb) { var burnCds = (combatPatch.combatAbilityCds || s.combatAbilityCds || [0,0,0,0,0,0]).slice(); var ABILITIES_BURN = require('lib/data/abilities.json'); var burnAbDef = ABILITIES_BURN.abilities[burnAb]; burnCds[burnSlot] = (burnAbDef && burnAbDef.cooldown) || 3; combatPatch.combatAbilityCds = burnCds; } combatPatch._playerCastState = null; combatPatch._playerCastTimer = 0; combatPatch._playerCastTime = 0; combatPatch._playerCastAbilityId = null; combatPatch._playerCastSlotIdx = -1; combatPatch._playerCastTargetIdx = -1; combatPatch._playerCastTelegraph = null; combatPatch._playerCastBurnedTimer = 0.9; combatPatch._playerCastBurnedName = s._playerCastAbilityName || 'Cast'; combatPatch._playerCastAbilityName = null; api.screenShake(0.08, 0.18); // Burn (interrupted cast) — the red vignette is already firing from // the damage hit above; the "INTERRUPTED" cast bar carries the rest // of the signal. No screenFlash needed. api.playSound('/cdn/sfx-combat-metal-sword-clash-ring.mp3', { volume: 0.32, pitch: 0.7 }); } // Tutorial: enemy hit player → advance to step 5 (show HP) if (s.combatTutorial && (s.tutorialStep || 0) === 4) { combatPatch.tutorialStep = 5; combatPatch._tutorialTimer = 3.5; // Reset enemy to non-attacking for tutorial — freeze both legacy // atk cooldown and the ability cast state machine. for (var teri = 0; teri < eaList.length; teri++) { eaList[teri] = Object.assign({}, eaList[teri], { atkCd: 99, atkCdMax: 99, castState: 'idle', castTimer: 0, castTime: 0, castAbilityId: null, castAbilityName: null, castUnstoppable: false, castCooldown: 0, castIdleTimer: 999, }); } combatPatch.combatEnemies = eaList; } // Player death if (eaHp <= 0) { // Multiplayer expedition: don't route to defeat — stay down and let // the party finish the fight. Attacks are blocked by the handler's // health guard; victory rewards will revive us to 1/10 max HP. if (s.partyId && s.expeditionActive) { combatPatch.combatBasicAttackCd = 999; } else { combatPatch.combatPhase = 'death'; combatPatch._combatDeathTimer = 1.8; combatPatch.combatBasicAttackCd = 999; } } } // An evade happened this tick — flash the "Evaded" popup. if (eaEvaded && eaHitDmg === 0) { combatPatch._evadedTimer = 1.0; api.playSound('/cdn/sfx-combat-metal-sword-clash-ring.mp3', { volume: 0.25, pitch: 1.4 }); } } // Hit flash timer (enemy) if (s._combatHitTimer > 0) { var ht = Math.max(0, s._combatHitTimer - dt); combatPatch._combatHitTimer = ht; if (ht <= 0) { combatPatch._combatHitIndex = -1; combatPatch._combatHitDmg = 0; } } // Player hit timer if (s._playerHitTimer > 0) { var pht = Math.max(0, s._playerHitTimer - dt); combatPatch._playerHitTimer = pht; if (pht <= 0) { combatPatch._playerHitDmg = 0; } } // Evaded popup timer if (s._evadedTimer > 0) { combatPatch._evadedTimer = Math.max(0, s._evadedTimer - dt); } // Intro phase → fight transition if (s.combatPhase === 'intro' && s._combatIntroTimer > 0) { var iit = Math.max(0, s._combatIntroTimer - dt); combatPatch._combatIntroTimer = iit; if (iit <= 0) { combatPatch.combatPhase = 'fight'; combatPatch.combatBasicAttackCd = 0.5; // Tutorial: start at step 1 (attack prompt) when fight begins if (s.combatTutorial) { combatPatch.tutorialStep = 1; combatPatch._tutorialTimer = 0; } } } // Outro phase — fade to black, clear combat at midpoint, fade back in if (s.combatPhase === 'outro' && s._combatOutroTimer > 0) { var oot = Math.max(0, s._combatOutroTimer - dt); combatPatch._combatOutroTimer = oot; // At midpoint (0.8s), screen is fully black — clear combat and apply rewards if (s._combatOutroTimer > 0.8 && oot <= 0.8) { // Player defeat — end combat, show death screen, wait for player to press respawn if (s._combatPlayerDefeated) { combatPatch.inCombat = false; combatPatch.combatEncounter = null; combatPatch.combatEnemies = null; combatPatch.combatPhase = null; combatPatch.combatRewards = null; combatPatch.combatBasicAttackCd = 0; combatPatch.combatAbilityCds = [0,0,0,0,0,0]; combatPatch._playerCastState = null; combatPatch._playerCastTimer = 0; combatPatch._playerCastTime = 0; combatPatch._playerCastAbilityId = null; combatPatch._playerCastSlotIdx = -1; combatPatch._playerCastTargetIdx = -1; combatPatch._playerCastTelegraph = null; combatPatch._playerCastAbilityName = null; combatPatch._playerCastBurnedTimer = 0; combatPatch._playerCastImpactTimer = 0; combatPatch._playerCastImpactTargetIdx = -1; combatPatch._combatDeathTimer = 0; combatPatch._combatPlayerDefeated = false; combatPatch.combatTutorial = false; combatPatch.tutorialStep = 0; combatPatch._tutorialTimer = 0; // Clear debuffs — the fight is over. combatPatch.playerStatuses = []; combatPatch._playerDotTimer = 0; combatPatch._debuffAppliedTimer = 0; // Open death screen — expedition mode if we fell on the road combatPatch._deathScreenOpen = true; combatPatch._deathScreenKind = s.expeditionActive ? 'expedition' : 'death'; // Suppress the post-combat fade-in; the death screen owns the black screen combatPatch._combatOutroTimer = 0; } else { // --- Victory rewards --- var rewards = s.combatRewards || {}; var och = s.character; if (och) { var oDrops = rewards.items || []; // Expedition combat: items go into the per-player loot bank, NOT // directly into inventory. Bank is claimed at expedition end on // success or abandon, lost on death. Non-expedition combat (none // today, but combat is generic) still writes straight to inventory. if (s.expeditionActive) { var vBank = Array.isArray(s.expeditionLootBank) ? s.expeditionLootBank.slice() : []; for (var voi = 0; voi < oDrops.length; voi++) { var vDrop = oDrops[voi]; if (!vDrop || !vDrop.id) continue; vBank = EXPEDITION.stackIntoBank(vBank, vDrop.id, vDrop.qty || 1); } if (oDrops.length > 0) combatPatch.expeditionLootBank = vBank; } else { var oinv = och.inventory ? och.inventory.slice() : []; while (oinv.length < 100) oinv.push(null); for (var odi = 0; odi < oDrops.length; odi++) { var odrop = oDrops[odi]; var ostacked = false; for (var osi = 0; osi < oinv.length; osi++) { if (oinv[osi] && oinv[osi].id === odrop.id) { oinv[osi] = { id: odrop.id, qty: (oinv[osi].qty || 1) + odrop.qty }; ostacked = true; break; } } if (!ostacked) { for (var ofi = 0; ofi < oinv.length; ofi++) { if (!oinv[ofi] || !oinv[ofi].id) { oinv[ofi] = { id: odrop.id, qty: odrop.qty }; break; } } } // Mark as discovered so rare drops reveal on the expedition card. if (!och.discoveredItems) och.discoveredItems = {}; och.discoveredItems[odrop.id] = true; } } combatPatch.inCombat = false; combatPatch.combatEncounter = null; combatPatch.combatEnemies = null; combatPatch.combatPhase = null; combatPatch.combatRewards = null; combatPatch.combatBasicAttackCd = 0; combatPatch.combatAbilityCds = [0,0,0,0,0,0]; combatPatch._playerCastState = null; combatPatch._playerCastTimer = 0; combatPatch._playerCastTime = 0; combatPatch._playerCastAbilityId = null; combatPatch._playerCastSlotIdx = -1; combatPatch._playerCastTargetIdx = -1; combatPatch._playerCastTelegraph = null; combatPatch._playerCastAbilityName = null; combatPatch._playerCastBurnedTimer = 0; combatPatch._playerCastImpactTimer = 0; combatPatch._playerCastImpactTargetIdx = -1; combatPatch._combatDeathTimer = 0; combatPatch._combatReady = false; combatPatch.combatTutorial = false; combatPatch.tutorialStep = 0; combatPatch._tutorialTimer = 0; combatPatch.gold = (s.gold || 0) + (rewards.gold || 0); var newTotalExp = (s.exp || 0) + (rewards.exp || 0); combatPatch.exp = newTotalExp; // --- Level-up check --- var { xpForLevel, computeCombatStats: recomputeCS } = require('lib/combat-stats.js'); var { computeEquipmentBonuses: recomputeEQ } = require('lib/items.js'); var curLevel = s.level || 1; var newLevel = curLevel; while (newTotalExp >= xpForLevel(newLevel + 1)) newLevel++; var leveledUp = newLevel > curLevel; var lvPopupPayload = null; if (leveledUp) { combatPatch.level = newLevel; // Recompute combat stats at new level var lvBonuses = recomputeEQ(och.equipment || {}); var lvStatsBefore = recomputeCS(och.stats || {}, curLevel, {}); var lvStatsAfter = recomputeCS(och.stats || {}, newLevel, {}); var lvStats = recomputeCS(och.stats || {}, newLevel, lvBonuses); combatPatch.maxHealth = lvStats.maxHp; combatPatch.health = lvStats.maxHp; // full heal on level up combatPatch.maxMana = lvStats.maxMp; combatPatch.mana = lvStats.maxMp; api.playSound('/cdn/sfx-ui-level-up-fanfare-sparkle.mp3', { volume: 0.5 }); // Queue mid-screen popup (mirror admin testlevelup payload). lvPopupPayload = { fromLevel: curLevel, toLevel: newLevel, statsBefore: lvStatsBefore, statsAfter: lvStatsAfter, }; } // --- Multiplayer revive: downed party members come back at 1/10 max HP --- // Level-up already fully healed; only run this if we didn't level up. if (!leveledUp && (s.health || 0) <= 0 && s.partyId && s.expeditionActive) { var reviveMax = s.maxHealth || 1; combatPatch.health = Math.max(1, Math.floor(reviveMax / 10)); api.playSound('/cdn/sfx-ui-skill-check-success-chime.mp3', { volume: 0.35 }); api.toast('You rise, carried through by your companions.', { duration: 3 }); } // --- Per-PATH Proficiency XP (damage-weighted split) --- // Path XP follows what actually carried the fight. Every hit during // combat credited its move's PATH into _combatCatDmg (punch → unarmed, // sword → sword, spell → staff). Split the proficiency pool proportional // to damage dealt per path. Fallback: the equipped weapon's basic path. var PATH_LABEL = { unarmed: 'Brawler', sword: 'Swordplay', dagger: 'Dagger', staff: 'Arcane' }; var wpnPxp = rewards.weaponProfExp || 0; var splitProfXpFn = require('lib/combat-stats.js').splitProfXp; var getWBP = require('lib/items.js').getWeaponBasicPath; var fallbackPath = getWBP((och.equipment && och.equipment.weapon) || null); var xpByPath = splitProfXpFn(s._combatCatDmg, wpnPxp, fallbackPath); // Read/seed per-PATH maps. Migrate legacy 'martial'/'magic' + global // skillPoints onto 'unarmed' / 'staff' on first per-path write. var catExpMap = och.categoryExp ? Object.assign({}, och.categoryExp) : {}; var catLvlMap = och.categoryLevels ? Object.assign({}, och.categoryLevels) : {}; var newCatSp = och.categorySp ? Object.assign({}, och.categorySp) : {}; // Inherit legacy martial pools onto 'unarmed' (primary), 'sword' starts fresh. if (newCatSp.unarmed === undefined) { newCatSp.unarmed = (newCatSp.martial || 0) + ((typeof och.skillPoints === 'number') ? och.skillPoints : 0); } if (newCatSp.sword === undefined) newCatSp.sword = 0; if (newCatSp.staff === undefined) newCatSp.staff = newCatSp.magic || 0; if (catLvlMap.unarmed === undefined) catLvlMap.unarmed = catLvlMap.martial || 1; if (catLvlMap.sword === undefined) catLvlMap.sword = 1; if (catLvlMap.staff === undefined) catLvlMap.staff = catLvlMap.magic || 0; if (catExpMap.unarmed === undefined) catExpMap.unarmed = catExpMap.martial || 0; if (catExpMap.sword === undefined) catExpMap.sword = 0; if (catExpMap.staff === undefined) catExpMap.staff = catExpMap.magic || 0; // Zero legacy keys now that we've inherited from them. newCatSp.martial = 0; newCatSp.magic = 0; catLvlMap.martial = 0; catLvlMap.magic = 0; catExpMap.martial = 0; catExpMap.magic = 0; for (var gainPath in xpByPath) { var gainXp = xpByPath[gainPath]; if (!(gainXp > 0)) continue; if (catExpMap[gainPath] === undefined) catExpMap[gainPath] = 0; if (catLvlMap[gainPath] === undefined) catLvlMap[gainPath] = (gainPath === 'unarmed') ? 1 : 0; if (newCatSp[gainPath] === undefined) newCatSp[gainPath] = 0; catExpMap[gainPath] += gainXp; // Cumulative XP for path level N = 25*N*(N+1) var curCatLv = catLvlMap[gainPath]; var newCatLv = curCatLv; while (catExpMap[gainPath] >= 25 * (newCatLv + 1) * (newCatLv + 2)) newCatLv++; if (newCatLv > curCatLv) { catLvlMap[gainPath] = newCatLv; var gained = newCatLv - curCatLv; newCatSp[gainPath] += gained; var pathLabel = PATH_LABEL[gainPath] || (gainPath.charAt(0).toUpperCase() + gainPath.slice(1)); api.toast(pathLabel + ' Lv.' + newCatLv + ' · +' + gained + ' skill point' + (gained === 1 ? '' : 's'), { duration: 3 }); api.playSound('/cdn/sfx-ui-skill-rank-up-chime.mp3', { volume: 0.45 }); } } // Consumed — clear the per-fight contribution accumulator. combatPatch._combatCatDmg = {}; // On expedition path, oinv is undefined — drop items went to the // loot bank, so character.inventory passes through unchanged here. var updInv = (typeof oinv !== 'undefined') ? oinv : (och.inventory || []); // Zero out legacy 'martial'/'magic' constellation buckets — the per-path // unarmed/sword/staff buckets own this data now. Belt-and-suspenders so // the migration shim in ui-character-sheet stays a no-op next read. var newConPaths = (och.constellation && (och.constellation.martial || och.constellation.magic)) ? Object.assign({}, och.constellation, { martial: { lit: {}, pending: [] }, magic: { lit: {}, pending: [] } }) : och.constellation; var updChar = { ...och, inventory: updInv, level: newLevel, xp: newTotalExp, gold: (s.gold || 0) + (rewards.gold || 0), categoryExp: catExpMap, categoryLevels: catLvlMap, categorySp: newCatSp, constellation: newConPaths }; // Stale legacy global — categorySp owns SP per-path now. updChar.skillPoints = 0; if (lvPopupPayload) updChar._levelUpPopup = lvPopupPayload; combatPatch.character = updChar; // Sync back to characters array var cSlot = s.csSelectedSlot; var cArr = Array.isArray(s.characters) ? s.characters.slice() : []; if (cSlot != null && cArr[cSlot]) { cArr[cSlot] = updChar; combatPatch.characters = cArr; } // Expedition: track rewards + queue advance after outro settles if (s.expeditionActive) { combatPatch.expeditionGoldEarned = (s.expeditionGoldEarned || 0) + (rewards.gold || 0); combatPatch.expeditionXpEarned = (s.expeditionXpEarned || 0) + (rewards.exp || 0); api.runInSeconds(1.0, function() { EXPEDITION.advance(api); }); } } else { combatPatch.inCombat = false; combatPatch.combatEncounter = null; combatPatch.combatEnemies = null; combatPatch.combatPhase = null; combatPatch.combatRewards = null; combatPatch.combatBasicAttackCd = 0; combatPatch.combatAbilityCds = [0,0,0,0,0,0]; combatPatch._playerCastState = null; combatPatch._playerCastTimer = 0; combatPatch._playerCastTime = 0; combatPatch._playerCastAbilityId = null; combatPatch._playerCastSlotIdx = -1; combatPatch._playerCastTargetIdx = -1; combatPatch._playerCastTelegraph = null; combatPatch._playerCastAbilityName = null; combatPatch._playerCastBurnedTimer = 0; combatPatch._playerCastImpactTimer = 0; combatPatch._playerCastImpactTargetIdx = -1; } } // end victory else // Resume scene music if available var sceneData = getScene(s.currentScene); if (sceneData && sceneData.music) { api.musicShift(sceneData.music, { fade: 1.5, volume: 0.35 }); } } } // Death phase → rewards transition if (s.combatPhase === 'death' && s._combatDeathTimer > 0) { var ddt = Math.max(0, s._combatDeathTimer - dt); combatPatch._combatDeathTimer = ddt; if (ddt <= 0) { // combatPhase='death' is used for BOTH outcomes — enemies all dead // (victory) and player at 0 HP (defeat). Disambiguate by checking if // any enemy is still alive. If enemies are dead, it's a win even if // the player is also down (party revives them at 1/10 HP below). // In a party expedition, dead players ride out to victory with the // group — true defeat only triggers if enemies are still alive AND // we're not being carried. var dpEnemies = s.combatEnemies || []; var dpEnemiesAlive = false; for (var dpi = 0; dpi < dpEnemies.length; dpi++) { if ((dpEnemies[dpi].hp || 0) > 0) { dpEnemiesAlive = true; break; } } var playerDown = (s.health || 0) <= 0; var carriedByParty = playerDown && s.partyId && s.expeditionActive; if (playerDown && dpEnemiesAlive && !carriedByParty) { api.musicShift(null, { fade: 1.0 }); api.playSound('/cdn/sfx-combat-defeat-dark-stinger.mp3', { volume: 0.5 }); combatPatch.combatPhase = 'outro'; combatPatch._combatOutroTimer = 1.6; combatPatch._combatPlayerDefeated = true; } else if (s.combatRewards && s.partyId && s.expeditionActive && !iAmLeaderLocal(s)) { // Companion already seeded combatRewards at her death-timer // bootstrap (see ~line 1318). Don't re-roll loot here — just flip // phase to 'rewards' and fire the victory SFX. The outro midpoint // will apply the seeded rewards to her character like normal. combatPatch.combatPhase = 'rewards'; combatPatch.playerStatuses = []; combatPatch._playerDotTimer = 0; combatPatch._debuffAppliedTimer = 0; api.playSound('/cdn/sfx-ui-victory-fanfare.mp3', { volume: 0.5 }); var seedExp2 = (s.combatRewards && s.combatRewards.exp) || 0; var seedGold2 = (s.combatRewards && s.combatRewards.gold) || 0; var seedItems2 = (s.combatRewards && s.combatRewards.items) || []; if (seedExp2 > 0) api.runInSeconds(1.0, function() { api.playSound('/cdn/sfx-ui-experience-gain-sparkle-chime.mp3', { volume: 0.35 }); }); if (seedGold2 > 0) api.runInSeconds(1.5, function() { api.playSound('/cdn/sfx-ui-gold-coins-clinking.mp3', { volume: 0.4 }); }); if (seedItems2.length > 0) api.runInSeconds(2.0, function() { api.playSound('/cdn/sfx-ui-item-drop-reveal-whoosh.mp3', { volume: 0.35 }); }); } else { // Enemies died → victory rewards var enemies = s.combatEnemies || []; var totalExp = 0; var totalGold = 0; var droppedItems = []; for (var ri = 0; ri < enemies.length; ri++) { var en = enemies[ri]; totalExp += en.exp || 0; totalGold += en.gold || 0; if (en.loot) { for (var li = 0; li < en.loot.length; li++) { var drop = en.loot[li]; if (api.random() <= (drop.chance || 1)) { var found = false; for (var di = 0; di < droppedItems.length; di++) { if (droppedItems[di].id === drop.id) { droppedItems[di].qty += (drop.qty || 1); found = true; break; } } if (!found) droppedItems.push({ id: drop.id, qty: drop.qty || 1 }); } } } } combatPatch.combatPhase = 'rewards'; // Clear any lingering debuffs — the fight is over, nothing is // allowed to kill the player in the rewards/victory afterglow. combatPatch.playerStatuses = []; combatPatch._playerDotTimer = 0; combatPatch._debuffAppliedTimer = 0; // Determine active weapon type from equipment var wpnType = 'unarmed'; var fightCh = s.character; if (fightCh && fightCh.equipment && fightCh.equipment.weapon) { var wpnDef = require('lib/items.js').getItem(fightCh.equipment.weapon); if (wpnDef && wpnDef.weaponType) wpnType = wpnDef.weaponType; } var wpnProfExp = Math.ceil(totalExp * 0.6); combatPatch.combatRewards = { exp: totalExp, gold: totalGold, items: droppedItems, weaponType: wpnType, weaponProfExp: wpnProfExp }; api.playSound('/cdn/sfx-ui-victory-fanfare.mp3', { volume: 0.5 }); if (totalExp > 0) { api.runInSeconds(1.0, function() { api.playSound('/cdn/sfx-ui-experience-gain-sparkle-chime.mp3', { volume: 0.35 }); }); } if (totalGold > 0) { api.runInSeconds(1.5, function() { api.playSound('/cdn/sfx-ui-gold-coins-clinking.mp3', { volume: 0.4 }); }); } if (droppedItems.length > 0) { api.runInSeconds(2.0, function() { api.playSound('/cdn/sfx-ui-item-drop-reveal-whoosh.mp3', { volume: 0.35 }); }); } } } } if (Object.keys(combatPatch).length > 0) api.patchState(combatPatch); } // Post-combat fade-in: drain outro timer after combat clears so the overlay disappears if (!s.inCombat && (s._combatOutroTimer || 0) > 0) { api.patchState({ _combatOutroTimer: Math.max(0, s._combatOutroTimer - dt) }); } // --- Combat tutorial trigger: first arrival at the Root Path --- // Fires once the entry text has been shown and the panel is closed. // Independent of which panel closed last (Maren's greeting, entry text, etc.) // so the tutorial can't get skipped by hotspot-close ordering. if (s.phase === 'game' && s.currentScene === 'the-root-path' && s._sceneEntryShown && !s.scenePanelOpen && !s.inCombat && s.character && !s.character.combatTutorialSeen && !s._fadeStage && !s.partyId) { startCombatTutorial(api); s = api.getState(); } // Auto-show entry text for new scenes if (s.currentScene && !s.scenePanelOpen && !s._sceneEntryShown) { var scene = getScene(s.currentScene); if (scene) { var visited = s.visitedScenes || {}; var isFirst = !visited[s.currentScene]; // Check quest overrides on entry text var questEntryText = null; if (scene.onEnter && scene.onEnter.questOverrides) { var overrides = scene.onEnter.questOverrides; var ch = s.character; for (var qid in overrides) { var ov = overrides[qid]; var step = getActiveQuestStep(ch, qid); if (step && step.id === ov.stepId) { questEntryText = ov.text; advanceQuest(api, qid); break; } } } var entryText = questEntryText || (isFirst ? ((scene.onEnter && scene.onEnter.firstTime) || scene.description) : ((scene.onEnter && scene.onEnter.return) || scene.description)); if (entryText) { openPanel(api, entryText, null); api.patchState({ _sceneEntryShown: true, visitedScenes: Object.assign({}, visited, { [s.currentScene]: true }), }); if (scene.music) api.musicShift(scene.music, { fade: 2, volume: 0.35 }); if (scene.ambience) api.ambience(scene.ambience, { fade: 2, volume: 0.25 }); } } } // Quest accept toast timer if (s._questAcceptToast && s._questAcceptTimer > 0) { var qat = s._questAcceptTimer - dt; if (qat <= 0) { api.patchState({ _questAcceptToast: null, _questAcceptTimer: 0 }); } else { api.patchState({ _questAcceptTimer: qat }); } } // Typewriter if (s.scenePanelOpen && s._scenePanelFullLen && s.scenePanelCharIdx < s._scenePanelFullLen) { var twElapsed = (s._sceneTypeTimer || 0) + dt; var charsToAdd = Math.floor(twElapsed / (TYPEWRITER_SPEED / 1000)); if (charsToAdd > 0) { var prevIdx = s.scenePanelCharIdx; var newIdx = Math.min(prevIdx + charsToAdd, s._scenePanelFullLen); api.patchState({ scenePanelCharIdx: newIdx, _sceneTypeTimer: twElapsed - (charsToAdd * (TYPEWRITER_SPEED / 1000)), }); // Voice chirp per typed character (matches prologue pattern) var chirps = (PROLOGUE_CONFIG && PROLOGUE_CONFIG.chirps) || {}; var speaker = s.scenePanelSpeaker || ''; var chirpCfg = null; if (s.scenePanelIsPlayer) { var gen = (s.character && s.character.gender) || 'female'; chirpCfg = chirps[gen] || chirps.female; } else if (speaker === 'narrator' || !speaker) { chirpCfg = chirps.narrator; } else { // NPC voice — default to neutral narrator blip chirpCfg = chirps.narrator || chirps.female; } if (chirpCfg && chirpCfg.clip) { var fullT = s.scenePanelText || ''; var every = chirpCfg.every || 2; for (var ci = prevIdx; ci < newIdx; ci++) { var ch = fullT[ci]; if (ch && ch.trim() && !/[.,!?;:—\-'"()]/.test(ch) && (ci + 1) % every === 0) { var pitchVar = (chirpCfg.pitch || 1.0) + (api.random() - 0.5) * 0.08; api.playSound(chirpCfg.clip, { volume: chirpCfg.volume != null ? chirpCfg.volume : 0.3, pitch: pitchVar }); break; } } } } } // Leader mirrors its state to the session so companions stay in sync. if (s.partyId) { var endSess = getMyPartySession(api, s); if (endSess && endSess.state.leaderId === api.id) { var ls = api.getState(); mirrorToSession(api, ls); } } } export function onInput(input, api) { var s = api.getState(); if (s.phase !== 'game') return; // --- Vendor actions --- if (input.actions.vendorClose) { if (s.vendorOpen && !s.vendorClosing) { api.patchState({ vendorClosing: true }); api.playSound('/cdn/sfx-ui-menu-close-paper-rustle.mp3', { volume: 0.35 }); api.runInSeconds(0.35, function () { api.patchState({ vendorOpen: false, vendorHotspotId: null, vendorClosing: false }); }); return; } } if (input.actions.vendorTab && input.actionData && input.actionData.vendorTab) { if (!s.vendorOpen || s.vendorClosing) return; api.patchState({ vendorTab: input.actionData.vendorTab.tab === 'sell' ? 'sell' : 'buy' }); api.playSound('/cdn/sfx-ui-tab-switch-click.mp3', { volume: 0.3 }); return; } if (input.actions.vendorBuy && input.actionData && input.actionData.vendorBuy) { if (!s.vendorOpen || s.vendorClosing) return; var buyId = input.actionData.vendorBuy.itemId; var vScene = getScene(s.currentScene); var vHotspot = vScene && s.vendorHotspotId ? (vScene.hotspots || []).find(function(h) { return h.id === s.vendorHotspotId; }) : null; var vendorDef = vHotspot && vHotspot.vendor; if (!vendorDef || !buyId) return; var stockEntry = (vendorDef.stock || []).find(function(e) { return (e.id || e) === buyId; }); if (!stockEntry) return; var itemsLib = require('lib/items.js'); var itemDef = itemsLib.getItem(buyId); if (!itemDef) return; var buyMul = vendorDef.buyMultiplier != null ? vendorDef.buyMultiplier : 1.0; var basePrice = stockEntry.price != null ? stockEntry.price : itemsLib.getItemValue(buyId); var cost = Math.max(1, Math.round(basePrice * buyMul)); var vch = s.character; if (!vch) return; if ((vch.gold || 0) < cost) { api.toast('Not enough gold.', { duration: 1.5 }); api.playSound('/cdn/sfx-ui-fail-low-thud.mp3', { volume: 0.3 }); return; } var vInv = vch.inventory ? vch.inventory.slice() : []; while (vInv.length < 100) vInv.push(null); var placed = false; if (itemDef.stackable) { for (var vi = 0; vi < vInv.length; vi++) { if (vInv[vi] && vInv[vi].id === buyId) { vInv[vi] = { id: buyId, qty: (vInv[vi].qty || 1) + 1 }; placed = true; break; } } } if (!placed) { for (var vj = 0; vj < vInv.length; vj++) { if (!vInv[vj] || !vInv[vj].id) { vInv[vj] = { id: buyId, qty: 1 }; placed = true; break; } } } if (!placed) { api.toast('Pack is full.', { duration: 1.5 }); return; } var updatedCh = Object.assign({}, vch, { gold: (vch.gold || 0) - cost, inventory: vInv }); api.patchState({ character: updatedCh }); api.playSound('/cdn/sfx-ui-gold-coins-clinking.mp3', { volume: 0.4 }); return; } if (input.actions.vendorSell && input.actionData && input.actionData.vendorSell) { if (!s.vendorOpen || s.vendorClosing) return; var sellIdx = input.actionData.vendorSell.invIndex; if (sellIdx == null) return; var sScene = getScene(s.currentScene); var sHotspot = sScene && s.vendorHotspotId ? (sScene.hotspots || []).find(function(h) { return h.id === s.vendorHotspotId; }) : null; var sVendor = sHotspot && sHotspot.vendor; if (!sVendor) return; var sch = s.character; if (!sch) return; var sInv = sch.inventory ? sch.inventory.slice() : []; var slotItem = sInv[sellIdx]; if (!slotItem || !slotItem.id) return; var sItemsLib = require('lib/items.js'); var sItemDef = sItemsLib.getItem(slotItem.id); if (!sItemDef) return; var sellMul = sVendor.sellMultiplier != null ? sVendor.sellMultiplier : 0.5; var sellPrice = Math.max(1, Math.round(sItemsLib.getItemValue(slotItem.id) * sellMul)); var newQty = (slotItem.qty || 1) - 1; if (newQty > 0) { sInv[sellIdx] = { id: slotItem.id, qty: newQty }; } else { sInv[sellIdx] = null; } var updatedSCh = Object.assign({}, sch, { gold: (sch.gold || 0) + sellPrice, inventory: sInv }); api.patchState({ character: updatedSCh }); api.playSound('/cdn/sfx-ui-gold-coins-clinking.mp3', { volume: 0.35 }); return; } // --- Inn actions --- if (input.actions.innClose) { if (s.innOpen && !s.innClosing) { api.patchState({ innClosing: true, innConfirmRest: false }); api.playSound('/cdn/sfx-ui-menu-close-paper-rustle.mp3', { volume: 0.35 }); api.runInSeconds(0.35, function () { api.patchState({ innOpen: false, innHotspotId: null, innClosing: false, innConfirmRest: false }); }); return; } } if (input.actions.innBuy && input.actionData && input.actionData.innBuy) { if (!s.innOpen || s.innClosing) return; var iBuyId = input.actionData.innBuy.itemId; var iScene = getScene(s.currentScene); var iHotspot = iScene && s.innHotspotId ? (iScene.hotspots || []).find(function(h) { return h.id === s.innHotspotId; }) : null; var innDef = iHotspot && iHotspot.inn; if (!innDef || !iBuyId) return; var iStockEntry = (innDef.stock || []).find(function(e) { return (e.id || e) === iBuyId; }); if (!iStockEntry) return; var iItemsLib = require('lib/items.js'); var iItemDef = iItemsLib.getItem(iBuyId); if (!iItemDef) return; var iBuyMul = innDef.buyMultiplier != null ? innDef.buyMultiplier : 1.0; var iBasePrice = iStockEntry.price != null ? iStockEntry.price : iItemsLib.getItemValue(iBuyId); var iCost = Math.max(1, Math.round(iBasePrice * iBuyMul)); var ich = s.character; if (!ich) return; if ((ich.gold || 0) < iCost) { api.toast('Not enough gold.', { duration: 1.5 }); api.playSound('/cdn/sfx-ui-fail-low-thud.mp3', { volume: 0.3 }); return; } var iInv = ich.inventory ? ich.inventory.slice() : []; while (iInv.length < 100) iInv.push(null); var iPlaced = false; if (iItemDef.stackable) { for (var ii = 0; ii < iInv.length; ii++) { if (iInv[ii] && iInv[ii].id === iBuyId) { iInv[ii] = { id: iBuyId, qty: (iInv[ii].qty || 1) + 1 }; iPlaced = true; break; } } } if (!iPlaced) { for (var ij = 0; ij < iInv.length; ij++) { if (!iInv[ij] || !iInv[ij].id) { iInv[ij] = { id: iBuyId, qty: 1 }; iPlaced = true; break; } } } if (!iPlaced) { api.toast('Pack is full.', { duration: 1.5 }); return; } var iUpdatedCh = Object.assign({}, ich, { gold: (ich.gold || 0) - iCost, inventory: iInv }); api.patchState({ character: iUpdatedCh }); api.playSound('/cdn/sfx-ui-gold-coins-clinking.mp3', { volume: 0.4 }); return; } if (input.actions.innRestRequest) { if (!s.innOpen || s.innClosing) return; api.patchState({ innConfirmRest: true }); api.playSound('/cdn/sfx-ui-menu-soft-click.mp3', { volume: 0.3 }); return; } if (input.actions.innRestCancel) { if (!s.innOpen || s.innClosing) return; api.patchState({ innConfirmRest: false }); return; } if (input.actions.innRestConfirm) { if (!s.innOpen || s.innClosing) return; var rScene = getScene(s.currentScene); var rHotspot = rScene && s.innHotspotId ? (rScene.hotspots || []).find(function(h) { return h.id === s.innHotspotId; }) : null; var rInnDef = rHotspot && rHotspot.inn; if (!rInnDef) return; var rCost = rInnDef.restCost != null ? rInnDef.restCost : 100; var rCh = s.character; if (!rCh) return; if ((rCh.gold || 0) < rCost) { api.toast('Not enough gold.', { duration: 1.5 }); api.playSound('/cdn/sfx-ui-fail-low-thud.mp3', { volume: 0.3 }); api.patchState({ innConfirmRest: false }); return; } var rMaxHp = s.maxHealth != null ? s.maxHealth : (rCh.maxHp || 100); var rMaxMp = s.maxMana != null ? s.maxMana : (rCh.maxMp || 50); var rUpdatedCh = Object.assign({}, rCh, { gold: (rCh.gold || 0) - rCost }); api.patchState({ character: rUpdatedCh, health: rMaxHp, mana: rMaxMp, innConfirmRest: false, innClosing: true, }); api.playSound('/cdn/sfx-ambient-hearthfire-crackle-warm-settle.mp3', { volume: 0.4 }); api.runInSeconds(0.4, function () { api.playSound('/cdn/sfx-ui-menu-close-paper-rustle.mp3', { volume: 0.3 }); }); api.runInSeconds(0.75, function () { api.patchState({ innOpen: false, innHotspotId: null, innClosing: false }); var restoreText = rInnDef.restResolve || 'You sleep deep. Morning finds you whole.'; openPanel(api, restoreText, 'Rested'); }); return; } // --- Party actions --- if (input.actions.partySlotClick && input