BlueGit

timfa questward

Files

questward / client / src / play / main.js

main.js

main.js 54.1 KiB Download Raw
1import { MessageType, GAIT, CHUNK_SIZE } from "/shared/protocol/constants.js";
2import { COMBAT_RANGE_TILES } from "/shared/spells/constants.js";
3import { BlockType, BLOCK_DEFINITIONS, GROUND_DEFINITIONS, normalizeGround, resourceNodeDisplayName, isChopableTreeBlock, isPickablePlantBlock } from "/shared/definitions/tiles.js";
4import { OVERWORLD_ID } from "/shared/world/dimensions.js";
5import { GameSocket, defaultSocketUrl } from "../net/socket.js";
6import { fetchAuthStatus, formatAccountLabel, loginUrl, logoutUrl } from "../net/auth.js";
7import { loadSpriteCatalog, preloadCatalogImages, applySpriteSheets, useNearestNeighbour, playImagesFromCatalog } from "../render/sprites.js";
8import { WorldView } from "../render/worldView.js";
9import { initSocial } from "./social.js";
10import { initChat } from "./chat.js";
11import { initInventory } from "./inventory.js";
12import { initSkills } from "./skills.js";
13import { initSpells } from "./spells.js";
14import { initCrafting } from "./crafting.js";
15import { initAlchemy } from "./alchemy.js";
16import { initStamina } from "./stamina.js";
17import { initHealth } from "./health.js";
18import { initStatusEffects } from "./statusEffects.js";
19import { initContextMenu } from "./contextMenu.js";
20import { initDeath } from "./death.js";
21import { initToasts } from "./toasts.js";
22import { initQuests } from "./quests.js";
23import { initDialogue } from "./dialogue.js";
24import { initShop } from "./shop.js";
25import { initMarket } from "./market.js";
26import { initBounty } from "./bounty.js";
27import { initBarber } from "./barber.js";
28import { bindHairControls } from "./hairControls.js";
29import { bindCreateClothingControls } from "./createClothingControls.js";
30import { paintCharacterPreview } from "./characterPreview.js";
31import { initGraphicsSettings } from "./graphicsSettings.js";
32import { CraftingStationId } from "/shared/definitions/craftingStations.js";
33import { isOreBoulderState } from "/shared/definitions/materialTiers.js";
34import { formatQuantity } from "/shared/items/formatQuantity.js";
35import { ItemId } from "/shared/definitions/items.js";
36import { countCoinsInSlots } from "/shared/items/inventory.js";
37
38const game = new Game();
39const hud = document.getElementById("hud");
40const overlay = document.getElementById("overlay");
41const statusEl = document.getElementById("status");
42const characterList = document.getElementById("character-list");
43const errorEl = document.getElementById("error");
44const assetLoadEl = document.getElementById("asset-load");
45const assetLoadBar = document.getElementById("asset-load-bar");
46const assetLoadLabel = document.getElementById("asset-load-label");
47const createCharacterOpen = document.getElementById("create-character-open");
48const worldTooltip = document.getElementById("world-tooltip");
49
50let socket;
51let session = null;
52let playing = false;
53let view = null;
54let graphicsSettingsUi = null;
55let scene = null;
56let gait = GAIT.walk;
57let catalog = { grounds: {}, blocks: {} };
58let social;
59let chat;
60let inventory;
61let skills;
62let spells;
63let crafting;
64let alchemy;
65let staminaUi;
66let healthUi;
67let statusEffectsUi;
68let contextMenu;
69let death;
70let toasts;
71let questsUi;
72let dialogueUi;
73let shop;
74let playZoomRaf = 0;
75let playZoomDelta = 0;
76let market;
77let bounty;
78let barber;
79let createHairControls;
80let createClothingControls;
81let createActiveTab = "appearance";
82let pendingPickup = null;
83/** @type {{ kind: "bank" | "doorway" | "cauldron" | "station" | "mine" | "chop", tileX: number, tileY: number, stationId?: string, getCheques?: boolean } | { kind: "talk", targetEntityId: number } | null } */
84let pendingInteract = null;
85/** Last approach moveTo so we do not re-path every frame (resets server walkCarry). */
86let approachMove = null;
87/** Framework can report mousePressed for two frames; latch so one physical click is one command. */
88let leftClickConsumed = false;
89
90function consumeWorldClick ()
91{
92 leftClickConsumed = true;
93}
94
95function showError (message)
96{
97 errorEl.textContent = message ?? "";
98}
99
100function setAssetLoading (active, { loaded = 0, total = 0, phase = "" } = {})
101{
102 if (assetLoadEl)
103 { assetLoadEl.hidden = !active; }
104 if (characterList)
105 { characterList.hidden = active; }
106 if (createCharacterOpen)
107 { createCharacterOpen.hidden = active; }
108 if (!active)
109 { return; }
110 if (assetLoadBar && total > 0)
111 { assetLoadBar.value = Math.round((loaded / total) * 100); }
112 if (assetLoadLabel)
113 {
114 assetLoadLabel.textContent = phase
115 || (total > 0 ? `Loading assets… ${loaded}/${total}` : "Loading assets…");
116 }
117}
118
119function renderCharacters (characters)
120{
121 characterList.innerHTML = "";
122 for (const character of characters)
123 {
124 const row = document.createElement("div");
125 row.className = "character-row";
126 const pending = character.deletionScheduledAt
127 ? ` (deleting ${new Date(character.deletionScheduledAt).toLocaleString()})`
128 : "";
129 row.innerHTML = `<strong>${character.firstName} ${character.lastName}</strong> · ${character.sex}${pending}`;
130 const play = document.createElement("button");
131 play.textContent = "Play";
132 play.disabled = !!character.deletionScheduledAt;
133 play.addEventListener("click", () => socket.send({ type: MessageType.selectCharacter, characterId: character.characterId }));
134 const del = document.createElement("button");
135 del.textContent = character.deletionScheduledAt ? "Cancel delete" : "Delete";
136 del.addEventListener("click", () =>
137 {
138 socket.send({
139 type: character.deletionScheduledAt ? MessageType.cancelDeleteCharacter : MessageType.scheduleDeleteCharacter,
140 characterId: character.characterId
141 });
142 });
143 row.append(play, del);
144 characterList.append(row);
145 }
146}
147
148function uiBlocked ()
149{
150 return !!(social?.isBlocking() || chat?.isBlocking() || inventory?.isBlocking()
151 || crafting?.isBlocking() || alchemy?.isBlocking() || shop?.isBlocking()
152 || market?.isBlocking() || bounty?.isBlocking() || barber?.isBlocking()
153 || questsUi?.isBlocking() || dialogueUi?.isBlocking()
154 || contextMenu?.isOpen() || death?.isBlocking() || spells?.isBlocking()
155 || graphicsSettingsUi?.isBlocking?.()
156 || pointerOverSpellUi());
157}
158
159function pointerOverSpellUi ()
160{
161 const el = document.elementFromPoint(GameInput.mousePosition.x, GameInput.mousePosition.y);
162 if (!el)
163 { return false; }
164 return !!el.closest("#spells-panel, #spell-favorites-bar, #spells-toggle");
165}
166
167function applyGraphicsSettings (settings)
168{
169 view?.setGraphicsPrefs(settings);
170 if (socket && playing)
171 {
172 socket.send({
173 type: MessageType.setGraphicsSettings,
174 viewDistance: settings.viewDistance
175 });
176 }
177}
178
179function clearPendingPickup ()
180{
181 pendingPickup = null;
182}
183
184function clearPendingInteract ()
185{
186 pendingInteract = null;
187 approachMove = null;
188}
189
190function clearAllPendingActions ()
191{
192 clearPendingPickup();
193 clearPendingInteract();
194}
195
196function approachAdjacentTile (tileX, tileY)
197{
198 const local = view.entities.get(view.localEntityId);
199 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
200 {
201 approachMove = null;
202 return true;
203 }
204 let bestWalkable = null;
205 let bestWalkableDist = Infinity;
206 let bestAny = null;
207 let bestAnyDist = Infinity;
208 for (let dy = -1; dy <= 1; dy++)
209 {
210 for (let dx = -1; dx <= 1; dx++)
211 {
212 if (dx === 0 && dy === 0)
213 { continue; }
214 const destX = tileX + dx;
215 const destY = tileY + dy;
216 const dist = local
217 ? chebyshev(local.tileX, local.tileY, destX, destY)
218 : 0;
219 if (dist < bestAnyDist)
220 {
221 bestAnyDist = dist;
222 bestAny = { tileX: destX, tileY: destY };
223 }
224 if (isClientApproachable(destX, destY) && dist < bestWalkableDist)
225 {
226 bestWalkableDist = dist;
227 bestWalkable = { tileX: destX, tileY: destY };
228 }
229 }
230 }
231 const best = bestWalkable ?? bestAny;
232 if (!best)
233 { return false; }
234 if (
235 approachMove
236 && approachMove.focusX === tileX
237 && approachMove.focusY === tileY
238 && approachMove.destX === best.tileX
239 && approachMove.destY === best.tileY
240 )
241 { return false; }
242 approachMove = {
243 focusX: tileX,
244 focusY: tileY,
245 destX: best.tileX,
246 destY: best.tileY
247 };
248 socket.send({ type: MessageType.moveTo, tileX: best.tileX, tileY: best.tileY });
249 return false;
250}
251
252function requestOpenBank (tileX, tileY, { getCheques = false } = {})
253{
254 clearAllPendingActions();
255 pendingInteract = { kind: "bank", tileX, tileY, getCheques: !!getCheques };
256 const local = view?.entities.get(view.localEntityId);
257 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
258 { flushPendingInteract(); }
259 else
260 { approachAdjacentTile(tileX, tileY); }
261}
262
263function requestEnterDoorway (tileX, tileY)
264{
265 clearAllPendingActions();
266 pendingInteract = { kind: "doorway", tileX, tileY };
267 const local = view?.entities.get(view.localEntityId);
268 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
269 { flushPendingInteract(); }
270 else
271 { approachAdjacentTile(tileX, tileY); }
272}
273
274function requestOpenMarket (tileX, tileY)
275{
276 clearAllPendingActions();
277 pendingInteract = { kind: "market", tileX, tileY };
278 const local = view?.entities.get(view.localEntityId);
279 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
280 { flushPendingInteract(); }
281 else
282 { approachAdjacentTile(tileX, tileY); }
283}
284
285function requestOpenBounty (tileX, tileY)
286{
287 clearAllPendingActions();
288 pendingInteract = { kind: "bounty", tileX, tileY };
289 const local = view?.entities.get(view.localEntityId);
290 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
291 { flushPendingInteract(); }
292 else
293 { approachAdjacentTile(tileX, tileY); }
294}
295
296function requestOpenBarber (tileX, tileY)
297{
298 clearAllPendingActions();
299 pendingInteract = { kind: "barber", tileX, tileY };
300 const local = view?.entities.get(view.localEntityId);
301 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
302 { flushPendingInteract(); }
303 else
304 { approachAdjacentTile(tileX, tileY); }
305}
306
307function requestOpenCauldron (tileX, tileY)
308{
309 clearAllPendingActions();
310 pendingInteract = { kind: "cauldron", tileX, tileY };
311 const local = view?.entities.get(view.localEntityId);
312 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
313 { flushPendingInteract(); }
314 else
315 { approachAdjacentTile(tileX, tileY); }
316}
317
318function requestOpenFurnace (tileX, tileY)
319{
320 requestOpenCraftStation(CraftingStationId.furnace, tileX, tileY);
321}
322
323function requestOpenCraftStation (stationId, tileX, tileY)
324{
325 clearAllPendingActions();
326 pendingInteract = { kind: "station", stationId, tileX, tileY };
327 const local = view?.entities.get(view.localEntityId);
328 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
329 { flushPendingInteract(); }
330 else
331 { approachAdjacentTile(tileX, tileY); }
332}
333
334function requestMine (tileX, tileY)
335{
336 clearAllPendingActions();
337 pendingInteract = { kind: "mine", tileX, tileY };
338 const local = view?.entities.get(view.localEntityId);
339 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
340 { flushPendingInteract(); }
341 else
342 { approachAdjacentTile(tileX, tileY); }
343}
344
345function requestChop (tileX, tileY)
346{
347 clearAllPendingActions();
348 pendingInteract = { kind: "chop", tileX, tileY };
349 const local = view?.entities.get(view.localEntityId);
350 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
351 { flushPendingInteract(); }
352 else
353 { approachAdjacentTile(tileX, tileY); }
354}
355
356function requestPick (tileX, tileY)
357{
358 clearAllPendingActions();
359 pendingInteract = { kind: "pick", tileX, tileY };
360 const local = view?.entities.get(view.localEntityId);
361 if (local && chebyshev(local.tileX, local.tileY, tileX, tileY) <= 1)
362 { flushPendingInteract(); }
363 else
364 { approachAdjacentTile(tileX, tileY); }
365}
366
367function requestTalk (targetEntityId, purpose = null)
368{
369 clearAllPendingActions();
370 pendingInteract = { kind: "talk", targetEntityId, purpose };
371 const target = view?.entities.get(targetEntityId);
372 if (!target)
373 {
374 clearPendingInteract();
375 return;
376 }
377 if (approachAdjacentTile(target.tileX, target.tileY))
378 { flushPendingInteract(); }
379}
380
381function flushPendingInteract ()
382{
383 if (!pendingInteract || !view)
384 { return; }
385 const local = view.entities.get(view.localEntityId);
386 if (!local)
387 { return; }
388
389 if (pendingInteract.kind === "bank")
390 {
391 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
392 { return; }
393 const getCheques = !!pendingInteract.getCheques;
394 socket.send({ type: MessageType.openBank });
395 if (getCheques)
396 { inventory?.getBlankCheques(); }
397 clearPendingInteract();
398 return;
399 }
400
401 if (pendingInteract.kind === "doorway")
402 {
403 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
404 { return; }
405 socket.send({
406 type: MessageType.enterDoorway,
407 tileX: pendingInteract.tileX,
408 tileY: pendingInteract.tileY
409 });
410 clearPendingInteract();
411 return;
412 }
413
414 if (pendingInteract.kind === "market")
415 {
416 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
417 { return; }
418 socket.send({ type: MessageType.openMarket });
419 clearPendingInteract();
420 return;
421 }
422
423 if (pendingInteract.kind === "bounty")
424 {
425 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
426 { return; }
427 socket.send({ type: MessageType.openBounty });
428 clearPendingInteract();
429 return;
430 }
431
432 if (pendingInteract.kind === "barber")
433 {
434 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
435 { return; }
436 socket.send({ type: MessageType.openBarber });
437 clearPendingInteract();
438 return;
439 }
440
441 if (pendingInteract.kind === "cauldron")
442 {
443 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
444 { return; }
445 socket.send({ type: MessageType.openCauldron });
446 clearPendingInteract();
447 return;
448 }
449
450 if (pendingInteract.kind === "station")
451 {
452 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
453 { return; }
454 socket.send({
455 type: MessageType.openStation,
456 stationId: pendingInteract.stationId
457 });
458 clearPendingInteract();
459 return;
460 }
461
462 if (pendingInteract.kind === "mine")
463 {
464 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
465 { return; }
466 socket.send({
467 type: MessageType.mine,
468 tileX: pendingInteract.tileX,
469 tileY: pendingInteract.tileY
470 });
471 clearPendingInteract();
472 return;
473 }
474
475 if (pendingInteract.kind === "chop")
476 {
477 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
478 { return; }
479 socket.send({
480 type: MessageType.chop,
481 tileX: pendingInteract.tileX,
482 tileY: pendingInteract.tileY
483 });
484 clearPendingInteract();
485 return;
486 }
487
488 if (pendingInteract.kind === "pick")
489 {
490 if (chebyshev(local.tileX, local.tileY, pendingInteract.tileX, pendingInteract.tileY) > 1)
491 { return; }
492 socket.send({
493 type: MessageType.pick,
494 tileX: pendingInteract.tileX,
495 tileY: pendingInteract.tileY
496 });
497 clearPendingInteract();
498 return;
499 }
500
501 if (pendingInteract.kind === "talk")
502 {
503 const target = view.entities.get(pendingInteract.targetEntityId);
504 if (!target)
505 {
506 clearPendingInteract();
507 return;
508 }
509 if (chebyshev(local.tileX, local.tileY, target.tileX, target.tileY) > 1)
510 {
511 // Target may have moved — keep chasing.
512 approachAdjacentTile(target.tileX, target.tileY);
513 return;
514 }
515 socket.send({
516 type: MessageType.interact,
517 targetEntityId: pendingInteract.targetEntityId,
518 purpose: pendingInteract.purpose || undefined
519 });
520 clearPendingInteract();
521 }
522}
523
524function requestPickup (ground)
525{
526 if (!ground)
527 { return; }
528 clearPendingInteract();
529 pendingPickup = {
530 groundItemId: ground.groundItemId,
531 tileX: ground.tileX,
532 tileY: ground.tileY
533 };
534 const local = view.entities.get(view.localEntityId);
535 if (local && local.tileX === ground.tileX && local.tileY === ground.tileY)
536 {
537 flushPendingPickup();
538 return;
539 }
540 socket.send({ type: MessageType.moveTo, tileX: ground.tileX, tileY: ground.tileY });
541}
542
543function flushPendingPickup ()
544{
545 if (!pendingPickup || !view)
546 { return; }
547 const item = view.groundItems.get(pendingPickup.groundItemId);
548 if (!item)
549 {
550 clearPendingPickup();
551 return;
552 }
553 const local = view.entities.get(view.localEntityId);
554 if (!local)
555 { return; }
556 if (local.tileX !== pendingPickup.tileX || local.tileY !== pendingPickup.tileY)
557 { return; }
558 socket.send({ type: MessageType.pickupItem, groundItemId: pendingPickup.groundItemId });
559 clearPendingPickup();
560}
561
562function requestAttack (targetEntityId)
563{
564 clearAllPendingActions();
565 socket.send({ type: MessageType.attack, targetEntityId });
566}
567
568function isAttackableEntity (entity)
569{
570 if (!entity || entity.untargetable)
571 { return false; }
572 if (entity.canFight)
573 { return true; }
574 // Snapshots can omit canFight; mobs are still attackable via LMB.
575 return !!entity.mobTypeId && !entity.talkable;
576}
577
578function canTalkToEntity (entity)
579{
580 return !!(entity && (entity.hasDialogue || entity.talkable || entity.hasShop));
581}
582
583function handleLeftClick (mouseX, mouseY)
584{
585 const tile = view.screenToTile(mouseX, mouseY);
586 const armed = spells?.getArmedSpell?.();
587 if (armed?.target === "tile" && armed.canCast && spells.tryCastAtTile(tile.tileX, tile.tileY))
588 { return; }
589
590 const entity = view.entityAtScreen(mouseX, mouseY);
591 if (entity && entity.entityId !== view.localEntityId && !entity.untargetable)
592 {
593 clearPendingPickup();
594 if (entity.characterId)
595 {
596 clearPendingInteract();
597 social.inspect(entity);
598 return;
599 }
600 // Dialogue (or shop/talkable) wins over attack as the default click.
601 if (canTalkToEntity(entity))
602 {
603 // Same intent as context-menu Talk / Shop so dialogue pin matches.
604 const purpose = entity.hasDialogue || (entity.talkable && !entity.hasShop)
605 ? "talk"
606 : (entity.hasShop ? "shop" : "talk");
607 requestTalk(entity.entityId, purpose);
608 return;
609 }
610 if (isAttackableEntity(entity))
611 {
612 if (spells?.tryCastAtEntity?.(entity.entityId))
613 { return; }
614 requestAttack(entity.entityId);
615 return;
616 }
617 // Clicked an entity we don't act on — do not fall through to walk (that cancels combat).
618 return;
619 }
620
621 const ground = view.groundItemAtTile(tile.tileX, tile.tileY);
622 if (ground)
623 { requestPickup(ground); }
624 else if (isBankTile(view, tile.tileX, tile.tileY))
625 { requestOpenBank(tile.tileX, tile.tileY); }
626 else if (isDoorwayTile(view, tile.tileX, tile.tileY))
627 { requestEnterDoorway(tile.tileX, tile.tileY); }
628 else if (isMarketplaceTile(view, tile.tileX, tile.tileY))
629 { requestOpenMarket(tile.tileX, tile.tileY); }
630 else if (isBountyOfficeTile(view, tile.tileX, tile.tileY))
631 { requestOpenBounty(tile.tileX, tile.tileY); }
632 else if (isBarberTile(view, tile.tileX, tile.tileY))
633 { requestOpenBarber(tile.tileX, tile.tileY); }
634 else if (isCauldronTile(view, tile.tileX, tile.tileY))
635 { requestOpenCauldron(tile.tileX, tile.tileY); }
636 else if (isFurnaceTile(view, tile.tileX, tile.tileY))
637 { requestOpenCraftStation(CraftingStationId.furnace, tile.tileX, tile.tileY); }
638 else if (isAnvilTile(view, tile.tileX, tile.tileY))
639 { requestOpenCraftStation(CraftingStationId.anvil, tile.tileX, tile.tileY); }
640 else if (isWoodworkingBenchTile(view, tile.tileX, tile.tileY))
641 { requestOpenCraftStation(CraftingStationId.woodworkingBench, tile.tileX, tile.tileY); }
642 else if (isCraftingBenchTile(view, tile.tileX, tile.tileY))
643 { requestOpenCraftStation(CraftingStationId.craftingBench, tile.tileX, tile.tileY); }
644 else if (isSpinningWheelTile(view, tile.tileX, tile.tileY))
645 { requestOpenCraftStation(CraftingStationId.spinningWheel, tile.tileX, tile.tileY); }
646 else if (isLoomTile(view, tile.tileX, tile.tileY))
647 { requestOpenCraftStation(CraftingStationId.loom, tile.tileX, tile.tileY); }
648 else if (isTailorBenchTile(view, tile.tileX, tile.tileY))
649 { requestOpenCraftStation(CraftingStationId.tailorBench, tile.tileX, tile.tileY); }
650 else if (isLeatherworkingTableTile(view, tile.tileX, tile.tileY))
651 { requestOpenCraftStation(CraftingStationId.leatherworkingStation, tile.tileX, tile.tileY); }
652 else if (isOreBoulderTile(view, tile.tileX, tile.tileY))
653 { requestMine(tile.tileX, tile.tileY); }
654 else if (isChopableTreeTile(view, tile.tileX, tile.tileY))
655 { requestChop(tile.tileX, tile.tileY); }
656 else if (isPickablePlantTile(view, tile.tileX, tile.tileY))
657 { requestPick(tile.tileX, tile.tileY); }
658 else
659 {
660 clearAllPendingActions();
661 socket.send({ type: MessageType.moveTo, tileX: tile.tileX, tileY: tile.tileY });
662 }
663}
664
665function handleRightClick (event, mouseX, mouseY)
666{
667 event.preventDefault();
668 if (spells?.isTargeting?.())
669 {
670 spells.cancelTargeting();
671 view?.clearSpellTargetHighlight();
672 return;
673 }
674 const tile = view.screenToTile(mouseX, mouseY);
675 const items = [];
676 const walkTileX = tile.tileX;
677 const walkTileY = tile.tileY;
678
679 items.push({
680 label: "Walk here",
681 onSelect: () =>
682 {
683 clearAllPendingActions();
684 socket.send({ type: MessageType.moveTo, tileX: walkTileX, tileY: walkTileY });
685 }
686 });
687
688 for (const entity of view.entitiesAtTile(tile.tileX, tile.tileY))
689 {
690 if (entity.entityId === view.localEntityId)
691 { continue; }
692 const targetName = entityLabel(entity);
693 items.push({
694 label: `Follow ${targetName}`,
695 onSelect: () =>
696 {
697 clearAllPendingActions();
698 socket.send({ type: MessageType.follow, targetEntityId: entity.entityId });
699 }
700 });
701 if (entity.untargetable)
702 { continue; }
703 if (entity.hasShop)
704 {
705 items.push({
706 label: `Shop ${targetName}`,
707 onSelect: () => requestTalk(entity.entityId, "shop")
708 });
709 }
710 if (entity.hasDialogue || (entity.talkable && !entity.hasShop))
711 {
712 items.push({
713 label: `Talk to ${targetName}`,
714 onSelect: () => requestTalk(entity.entityId, "talk")
715 });
716 }
717 if (entity.characterId)
718 {
719 items.push({
720 label: `${targetName} info`,
721 onSelect: () =>
722 {
723 clearAllPendingActions();
724 social.inspect(entity);
725 }
726 });
727 }
728 items.push({
729 label: `Attack ${targetName}`,
730 onSelect: () => requestAttack(entity.entityId)
731 });
732 }
733
734 for (const ground of view.groundItemsAtTile(tile.tileX, tile.tileY))
735 {
736 const name = groundLabel(ground);
737 items.push({
738 label: `Pick up ${name}`,
739 onSelect: () => requestPickup(ground)
740 });
741 }
742
743 if (isBankTile(view, tile.tileX, tile.tileY))
744 {
745 items.push({
746 label: "Bank",
747 onSelect: () => requestOpenBank(tile.tileX, tile.tileY)
748 });
749 items.push({
750 label: "Get Blank Cheques",
751 onSelect: () => requestOpenBank(tile.tileX, tile.tileY, { getCheques: true })
752 });
753 }
754
755 if (isDoorwayTile(view, tile.tileX, tile.tileY))
756 {
757 items.push({
758 label: "Enter",
759 onSelect: () => requestEnterDoorway(tile.tileX, tile.tileY)
760 });
761 }
762
763 if (isMarketplaceTile(view, tile.tileX, tile.tileY))
764 {
765 items.push({
766 label: "Central Exchange",
767 onSelect: () => requestOpenMarket(tile.tileX, tile.tileY)
768 });
769 }
770
771 if (isBountyOfficeTile(view, tile.tileX, tile.tileY))
772 {
773 items.push({
774 label: "Bounty Office",
775 onSelect: () => requestOpenBounty(tile.tileX, tile.tileY)
776 });
777 }
778
779 if (isBarberTile(view, tile.tileX, tile.tileY))
780 {
781 items.push({
782 label: "Barber",
783 onSelect: () => requestOpenBarber(tile.tileX, tile.tileY)
784 });
785 }
786
787 if (isCauldronTile(view, tile.tileX, tile.tileY))
788 {
789 items.push({
790 label: "Alchemy",
791 onSelect: () => requestOpenCauldron(tile.tileX, tile.tileY)
792 });
793 }
794
795 if (isFurnaceTile(view, tile.tileX, tile.tileY))
796 {
797 items.push({
798 label: "Smelt",
799 onSelect: () => requestOpenCraftStation(CraftingStationId.furnace, tile.tileX, tile.tileY)
800 });
801 }
802
803 if (isAnvilTile(view, tile.tileX, tile.tileY))
804 {
805 items.push({
806 label: "Smith",
807 onSelect: () => requestOpenCraftStation(CraftingStationId.anvil, tile.tileX, tile.tileY)
808 });
809 }
810
811 if (isWoodworkingBenchTile(view, tile.tileX, tile.tileY))
812 {
813 items.push({
814 label: "Woodwork",
815 onSelect: () => requestOpenCraftStation(CraftingStationId.woodworkingBench, tile.tileX, tile.tileY)
816 });
817 }
818
819 if (isCraftingBenchTile(view, tile.tileX, tile.tileY))
820 {
821 items.push({
822 label: "Craft",
823 onSelect: () => requestOpenCraftStation(CraftingStationId.craftingBench, tile.tileX, tile.tileY)
824 });
825 }
826
827 if (isSpinningWheelTile(view, tile.tileX, tile.tileY))
828 {
829 items.push({
830 label: "Spin",
831 onSelect: () => requestOpenCraftStation(CraftingStationId.spinningWheel, tile.tileX, tile.tileY)
832 });
833 }
834
835 if (isLoomTile(view, tile.tileX, tile.tileY))
836 {
837 items.push({
838 label: "Weave",
839 onSelect: () => requestOpenCraftStation(CraftingStationId.loom, tile.tileX, tile.tileY)
840 });
841 }
842
843 if (isTailorBenchTile(view, tile.tileX, tile.tileY))
844 {
845 items.push({
846 label: "Tailor",
847 onSelect: () => requestOpenCraftStation(CraftingStationId.tailorBench, tile.tileX, tile.tileY)
848 });
849 }
850
851 if (isLeatherworkingTableTile(view, tile.tileX, tile.tileY))
852 {
853 items.push({
854 label: "Leatherwork",
855 onSelect: () => requestOpenCraftStation(CraftingStationId.leatherworkingStation, tile.tileX, tile.tileY)
856 });
857 }
858
859 if (isOreBoulderTile(view, tile.tileX, tile.tileY))
860 {
861 items.push({
862 label: "Mine",
863 onSelect: () => requestMine(tile.tileX, tile.tileY)
864 });
865 }
866
867 if (isChopableTreeTile(view, tile.tileX, tile.tileY))
868 {
869 items.push({
870 label: "Chop",
871 onSelect: () => requestChop(tile.tileX, tile.tileY)
872 });
873 }
874
875 if (isPickablePlantTile(view, tile.tileX, tile.tileY))
876 {
877 items.push({
878 label: "Pick",
879 onSelect: () => requestPick(tile.tileX, tile.tileY)
880 });
881 }
882
883 contextMenu.show(event.clientX, event.clientY, items);
884}
885
886function entityLabel (entity)
887{
888 const first = (entity?.firstName ?? "").trim();
889 const last = (entity?.lastName ?? "").trim();
890 const name = first && last ? `${first} ${last}` : (first || "target");
891 const level = entity?.level | 0;
892 if (entity?.mobTypeId && level > 0)
893 { return `Lv.${level} ${name}`; }
894 return name;
895}
896
897function groundLabel (ground)
898{
899 const name = (ground?.displayName ?? "").trim() || "item";
900 const qty = ground?.quantity ?? 1;
901 if (qty <= 1)
902 { return name; }
903 return `${name} (${formatQuantity(qty)})`;
904}
905
906function startPlay (payload)
907{
908 playing = true;
909 overlay.hidden = true;
910 hud.hidden = false;
911 const settingsToggle = document.getElementById("settings-toggle");
912 if (settingsToggle)
913 { settingsToggle.hidden = false; }
914 document.getElementById("you").textContent = `${payload.firstName} ${payload.lastName} (${session.authSubject})`;
915 gait = payload.gait ?? GAIT.walk;
916 document.getElementById("gait").textContent = gait;
917 staminaUi?.show();
918 healthUi?.show();
919 statusEffectsUi?.show();
920 if (payload.stamina != null)
921 { staminaUi?.apply(payload.stamina); }
922 if (payload.health != null || payload.maxHealth != null)
923 {
924 healthUi?.apply({
925 current: payload.health ?? healthUi.getCurrent?.(),
926 max: payload.maxHealth ?? healthUi.getMax?.()
927 });
928 }
929 if (!scene)
930 {
931 scene = new Scene(0, 0, window.innerWidth, window.innerHeight);
932 game.loadScene(scene);
933 useNearestNeighbour(scene, game.images);
934 }
935 if (!view)
936 {
937 view = new WorldView(game, scene, catalog);
938 graphicsSettingsUi?.apply();
939 const ticker = new GameObject(0, 0, null, 10);
940 ticker.update = (dt) =>
941 {
942 const leftPressed = GameInput.mousePressed(GameInput.MouseButtons.Left);
943 const leftHeld = GameInput.mouseHeld(GameInput.MouseButtons.Left);
944 if (!leftPressed && !leftHeld)
945 { leftClickConsumed = false; }
946 else if (!leftClickConsumed && playing && !uiBlocked())
947 {
948 leftClickConsumed = true;
949 const canvas = scene.canvas;
950 const rect = canvas.getBoundingClientRect();
951 const mouseX = GameInput.mousePosition.x - rect.left;
952 const mouseY = GameInput.mousePosition.y - rect.top;
953 handleLeftClick(mouseX, mouseY);
954 }
955 if (GameInput.isPressed(82) && !uiBlocked())
956 {
957 const next = gait === GAIT.run ? GAIT.walk : GAIT.run;
958 if (next === GAIT.run && (staminaUi?.getCurrent?.() ?? 1) <= 0)
959 { return; }
960 socket.send({ type: MessageType.setGait, gait: next });
961 // Walk always applies; run waits for authoritative STAMINA (may reject if empty).
962 if (next === GAIT.walk)
963 {
964 gait = next;
965 document.getElementById("gait").textContent = gait;
966 }
967 }
968 if (playing && !death?.isBlocking())
969 {
970 flushPendingPickup();
971 flushPendingInteract();
972 social?.updateNametag(view, scene, view.localEntityId);
973 chat?.update(view, scene);
974 updateSpellTargetHighlight();
975 updateWorldTooltip();
976 }
977 else
978 {
979 hideWorldTooltip();
980 view?.clearSpellTargetHighlight();
981 }
982 view.update(dt);
983 };
984 scene.addObject(ticker);
985 window.addEventListener("resize", () =>
986 {
987 scene.size.x = window.innerWidth;
988 scene.size.y = window.innerHeight;
989 scene.g_fixSize();
990 useNearestNeighbour(scene, game.images);
991 });
992 window.addEventListener("wheel", (event) =>
993 {
994 if (!playing || uiBlocked())
995 { return; }
996 playZoomDelta += event.deltaY < 0 ? 0.25 : -0.25;
997 if (playZoomRaf)
998 { return; }
999 playZoomRaf = requestAnimationFrame(() =>
1000 {
1001 playZoomRaf = 0;
1002 if (!view || !playZoomDelta)
1003 { return; }
1004 view.setZoom(view.zoom + playZoomDelta);
1005 playZoomDelta = 0;
1006 document.getElementById("zoom").textContent = `${view.zoom.toFixed(2)}×`;
1007 });
1008 }, { passive: true });
1009 scene.canvas.addEventListener("contextmenu", (event) =>
1010 {
1011 if (!playing || uiBlocked())
1012 { return; }
1013 const rect = scene.canvas.getBoundingClientRect();
1014 handleRightClick(event, event.clientX - rect.left, event.clientY - rect.top);
1015 });
1016 }
1017 view.setSettings(payload.settings ?? view.settings);
1018 chat?.syncSettings();
1019 view.worldHour = payload.worldTime?.hour ?? 12;
1020 view.setDimensionId(payload.dimensionId ?? OVERWORLD_ID);
1021 view.setDimensionModes(payload.lightingMode, payload.seasonMode);
1022 view.setWorldSeason(payload.worldTime?.season);
1023 view.setLocalEntity(
1024 payload.entityId,
1025 payload.tileX,
1026 payload.tileY,
1027 payload.gait,
1028 payload.sex,
1029 payload.firstName,
1030 payload.lastName,
1031 payload.characterId,
1032 payload.layers,
1033 payload.health,
1034 payload.maxHealth
1035 );
1036 graphicsSettingsUi?.apply();
1037}
1038
1039async function main ()
1040{
1041 const authStatus = await fetchAuthStatus();
1042 updateAuthUi(authStatus);
1043 if (!authStatus.authenticated)
1044 {
1045 statusEl.textContent = "Sign in to play Questward.";
1046 showError("");
1047 return;
1048 }
1049
1050 setAssetLoading(true, { phase: "Loading catalog…" });
1051 catalog = await loadSpriteCatalog();
1052 const assetTotal = playImagesFromCatalog(catalog).length;
1053 setAssetLoading(true, { loaded: 0, total: assetTotal, phase: "Loading assets…" });
1054 await preloadCatalogImages(game, catalog, {
1055 onProgress ({ loaded, total })
1056 {
1057 setAssetLoading(true, { loaded, total });
1058 }
1059 });
1060 applySpriteSheets(game.images, catalog);
1061 if (!scene)
1062 {
1063 scene = new Scene(0, 0, window.innerWidth, window.innerHeight);
1064 game.loadScene(scene);
1065 }
1066 setAssetLoading(false);
1067 statusEl.textContent = "Connecting…";
1068 createHairControls = bindHairControls({
1069 root: document.getElementById("create-hair"),
1070 resolveSpriteUrl (name)
1071 {
1072 return catalog?.images?.find((entry) => entry.name === name)?.url ?? null;
1073 },
1074 getSex: () => document.getElementById("sex")?.value ?? "male",
1075 getBag: () => null,
1076 hideHeadgear: true,
1077 onChange ()
1078 {
1079 if (createActiveTab === "clothing")
1080 { void refreshCreateClothingPreview(); }
1081 }
1082 });
1083 createClothingControls = bindCreateClothingControls({
1084 root: document.getElementById("create-clothing"),
1085 onChange ()
1086 {
1087 if (createActiveTab === "clothing")
1088 { void refreshCreateClothingPreview(); }
1089 }
1090 });
1091 initCreateTabs();
1092 document.getElementById("sex")?.addEventListener("change", () =>
1093 {
1094 createHairControls?.fillStyles();
1095 void createHairControls?.refreshPreview();
1096 if (createActiveTab === "clothing")
1097 { void refreshCreateClothingPreview(); }
1098 });
1099 void createHairControls?.refreshPreview();
1100 void refreshCreateClothingPreview();
1101 graphicsSettingsUi = initGraphicsSettings({
1102 onChange: applyGraphicsSettings,
1103 onSuppressWorldClick: consumeWorldClick
1104 });
1105 social = initSocial({
1106 socket: { send (payload) { socket.send(payload); } },
1107 MessageType
1108 });
1109 contextMenu = initContextMenu({ onSuppressWorldClick: consumeWorldClick });
1110 inventory = initInventory({
1111 socket: { send (payload) { socket.send(payload); } },
1112 MessageType,
1113 contextMenu,
1114 resolveSpriteUrl (name)
1115 {
1116 return catalog?.images?.find((entry) => entry.name === name)?.url ?? null;
1117 },
1118 getFriends ()
1119 {
1120 return social?.getFriends?.() ?? [];
1121 },
1122 getLocalName ()
1123 {
1124 const you = document.getElementById("you")?.textContent ?? "";
1125 return you.split("(")[0].trim() || "Unknown";
1126 }
1127 });
1128 skills = initSkills();
1129 spells = initSpells({
1130 socket: { send (payload) { socket.send(payload); } },
1131 MessageType
1132 });
1133 crafting = initCrafting({
1134 socket: { send (payload) { socket.send(payload); } },
1135 MessageType,
1136 getInventorySlots ()
1137 {
1138 return inventory?.getInventorySlots?.() ?? [];
1139 },
1140 getSkillLevel (skillId)
1141 {
1142 return skills?.skillLevel?.(skillId) ?? 1;
1143 }
1144 });
1145 alchemy = initAlchemy({
1146 socket: { send (payload) { socket.send(payload); } },
1147 MessageType,
1148 getInventorySlots ()
1149 {
1150 return inventory?.getInventorySlots?.() ?? [];
1151 }
1152 });
1153 staminaUi = initStamina();
1154 healthUi = initHealth();
1155 statusEffectsUi = initStatusEffects();
1156 toasts = initToasts();
1157 questsUi = initQuests({
1158 socket: { send (payload) { socket.send(payload); } },
1159 MessageType,
1160 toasts
1161 });
1162 dialogueUi = initDialogue({
1163 socket: { send (payload) { socket.send(payload); } },
1164 MessageType,
1165 getEntity (id)
1166 {
1167 if (id === "local")
1168 { return view?.entities.get(view.localEntityId) ?? null; }
1169 return view?.entities.get(id) ?? null;
1170 },
1171 captureSpeakerIcon (entityId, size = 64)
1172 {
1173 return view?.captureEntityPortrait?.(entityId, { size }) ?? null;
1174 }
1175 });
1176 shop = initShop({
1177 socket: { send (payload) { socket.send(payload); } },
1178 MessageType,
1179 onSuppressWorldClick: consumeWorldClick,
1180 getCoinCount ()
1181 {
1182 return countCoinsInSlots(inventory?.getInventorySlots?.() ?? []);
1183 },
1184 getInventorySlots ()
1185 {
1186 return inventory?.getInventorySlots?.() ?? [];
1187 }
1188 });
1189 market = initMarket({
1190 socket: { send (payload) { socket.send(payload); } },
1191 MessageType,
1192 onSuppressWorldClick: consumeWorldClick,
1193 getCoinCount ()
1194 {
1195 return countCoinsInSlots(inventory?.getInventorySlots?.() ?? []);
1196 },
1197 getInventorySlots ()
1198 {
1199 return inventory?.getInventorySlots?.() ?? [];
1200 },
1201 getLocalCharacterId ()
1202 {
1203 return inventory?.getLocalCharacterId?.() ?? null;
1204 }
1205 });
1206 bounty = initBounty({
1207 socket: { send (payload) { socket.send(payload); } },
1208 MessageType,
1209 onSuppressWorldClick: consumeWorldClick,
1210 resolveSpriteUrl (name)
1211 {
1212 return catalog?.images?.find((entry) => entry.name === name)?.url ?? null;
1213 }
1214 });
1215 barber = initBarber({
1216 socket: { send (payload) { socket.send(payload); } },
1217 MessageType,
1218 onSuppressWorldClick: consumeWorldClick,
1219 resolveSpriteUrl (name)
1220 {
1221 return catalog?.images?.find((entry) => entry.name === name)?.url ?? null;
1222 },
1223 getInventoryBag ()
1224 {
1225 return {
1226 equipment: { slots: inventory?.getEquipment?.() ?? {} },
1227 inventory: inventory?.getInventorySlots?.() ?? []
1228 };
1229 }
1230 });
1231 chat = initChat({
1232 socket: { send (payload) { socket.send(payload); } },
1233 MessageType,
1234 getSettings: () => view?.settings
1235 });
1236 death = initDeath({
1237 socket: { send (payload) { socket.send(payload); } },
1238 MessageType
1239 });
1240 game.startGame();
1241 useNearestNeighbour(scene, game.images);
1242
1243 socket = new GameSocket(defaultSocketUrl(), (message) =>
1244 {
1245 switch (message.type)
1246 {
1247 case MessageType.session:
1248 session = message;
1249 statusEl.textContent = `Signed in as ${message.username ?? message.authSubject}${message.isAdmin ? " · admin" : ""}`;
1250 renderCharacters(message.characters);
1251 break;
1252 case MessageType.characterList:
1253 renderCharacters(message.characters);
1254 if (!playing)
1255 { overlay.hidden = false; }
1256 break;
1257 case MessageType.enterWorld:
1258 closeCreateModal();
1259 startPlay(message);
1260 inventory?.setLocalCharacterId(message.characterId);
1261 toasts?.applyRestartStatus?.(message.restartStatus);
1262 socket.send({ type: MessageType.requestQuests });
1263 break;
1264 case MessageType.chunkSnapshot:
1265 view?.applySnapshot(message);
1266 break;
1267 case MessageType.dimensionChanged:
1268 if (view)
1269 {
1270 view.setDimensionId(message.dimensionId);
1271 view.setDimensionModes(message.lightingMode, message.seasonMode);
1272 view.clearAllChunks();
1273 if (message.tileX != null && message.tileY != null && view.localEntityId != null)
1274 {
1275 view.moveEntity({
1276 entityId: view.localEntityId,
1277 tileX: message.tileX,
1278 tileY: message.tileY
1279 });
1280 }
1281 }
1282 break;
1283 case MessageType.chunkDelta:
1284 for (const tile of message.tiles ?? [])
1285 {
1286 view?.updateAuthoredTile(
1287 message.chunkX,
1288 message.chunkY,
1289 tile.localX,
1290 tile.localY,
1291 { ground: tile.ground, block: tile.block, light: tile.light }
1292 );
1293 }
1294 break;
1295 case MessageType.unsubscribeChunk:
1296 view?.removeChunk(message.chunkX, message.chunkY);
1297 break;
1298 case MessageType.entitySpawn:
1299 view?.spawnEntity(message);
1300 break;
1301 case MessageType.entityMove:
1302 view?.moveEntity(message);
1303 if (message.entityId === view?.localEntityId && message.gait)
1304 {
1305 gait = message.gait;
1306 document.getElementById("gait").textContent = gait;
1307 }
1308 break;
1309 case MessageType.entityDespawn:
1310 view?.despawnEntity(message.entityId);
1311 break;
1312 case MessageType.entityAppearance:
1313 view?.setAppearance(message);
1314 break;
1315 case MessageType.groundItemAppear:
1316 view?.upsertGroundItem(message);
1317 break;
1318 case MessageType.groundItemDespawn:
1319 view?.despawnGroundItem(message.groundItemId);
1320 break;
1321 case MessageType.inventory:
1322 inventory?.handleInventory(message);
1323 crafting?.refresh();
1324 alchemy?.refresh();
1325 shop?.refresh();
1326 market?.refresh();
1327 break;
1328 case MessageType.skills:
1329 skills?.render(message.skills);
1330 crafting?.refresh();
1331 break;
1332 case MessageType.spells:
1333 case MessageType.spellsUpdated:
1334 spells?.render(message);
1335 break;
1336 case MessageType.spellArmed:
1337 spells?.handleSpellArmed(message);
1338 break;
1339 case MessageType.spellDisarmed:
1340 spells?.handleSpellDisarmed();
1341 break;
1342 case MessageType.spellProjectile:
1343 view?.spawnSpellProjectileFx(message);
1344 break;
1345 case MessageType.spellFizzle:
1346 view?.spawnSpellFizzleFx(message);
1347 if (message.casterId === view?.localEntityId)
1348 { toasts?.show("Failed to cast spell"); }
1349 break;
1350 case MessageType.spellCastFlash:
1351 break;
1352 case MessageType.spellLightAppear:
1353 case MessageType.spellLightUpdate:
1354 case MessageType.spellLightRemove:
1355 break;
1356 case MessageType.stamina:
1357 staminaUi?.apply(message);
1358 if (message.gait)
1359 {
1360 gait = message.gait;
1361 document.getElementById("gait").textContent = gait;
1362 }
1363 break;
1364 case MessageType.statusEffects:
1365 view?.setLocalBlind(!!message.blind);
1366 statusEffectsUi?.apply(message);
1367 break;
1368 case MessageType.bankSnapshot:
1369 inventory?.handleBank(message);
1370 break;
1371 case MessageType.cauldronSnapshot:
1372 alchemy?.handleSnapshot(message);
1373 break;
1374 case MessageType.pigeonDispatched:
1375 inventory?.handlePigeonDispatched(message);
1376 break;
1377 case MessageType.pigeonDelivered:
1378 inventory?.handlePigeonDelivered(message);
1379 break;
1380 case MessageType.characterSearchResult:
1381 inventory?.handleCharacterSearch(message);
1382 break;
1383 case MessageType.craftResult:
1384 crafting?.handleCraftResult(message);
1385 break;
1386 case MessageType.worldStatus:
1387 if (view)
1388 {
1389 view.setSettings(message.settings ?? view.settings);
1390 view.worldHour = message.worldTime?.hour ?? view.worldHour;
1391 view.setWorldSeason(message.worldTime?.season);
1392 chat?.syncSettings();
1393 }
1394 toasts?.applyRestartStatus?.(message.restartStatus);
1395 break;
1396 case MessageType.restartStatus:
1397 toasts?.applyRestartStatus?.(message.restartStatus);
1398 break;
1399 case MessageType.chatBubble:
1400 chat?.showBubble(message);
1401 break;
1402 case MessageType.friends:
1403 social?.handleFriends(message);
1404 break;
1405 case MessageType.combatSwing:
1406 view?.spawnCombatSwing(message);
1407 break;
1408 case MessageType.combatProjectile:
1409 view?.spawnPhysicalProjectileFx({
1410 ...message,
1411 sprite: "fx:projectile:arrow"
1412 });
1413 break;
1414 case MessageType.combatNoArrows:
1415 toasts?.show("Out of arrows!");
1416 break;
1417 case MessageType.gatherSwing:
1418 case MessageType.tileShove:
1419 view?.spawnGatherSwing(message);
1420 break;
1421 case MessageType.stationOpen:
1422 if (message.stationId)
1423 { crafting?.openStation(message.stationId); }
1424 break;
1425 case MessageType.shopOpen:
1426 shop?.handleShopOpen(message);
1427 break;
1428 case MessageType.shopClosed:
1429 shop?.handleShopClosed(message);
1430 break;
1431 case MessageType.marketOpen:
1432 market?.handleOpen(message);
1433 break;
1434 case MessageType.marketClosed:
1435 market?.handleClosed(message);
1436 break;
1437 case MessageType.marketTrade:
1438 market?.handleTrade(message);
1439 toasts?.show(`Trade: ${message.quantity} @ ${message.unitPrice} coins`);
1440 break;
1441 case MessageType.bountySnapshot:
1442 bounty?.handleSnapshot(message);
1443 break;
1444 case MessageType.closeBounty:
1445 bounty?.handleClosed(message);
1446 break;
1447 case MessageType.characterBounty:
1448 bounty?.handleCharacterBounty(message);
1449 social?.handleCharacterBounty(message);
1450 break;
1451 case MessageType.barberSnapshot:
1452 barber?.handleSnapshot(message);
1453 break;
1454 case MessageType.closeBarber:
1455 barber?.handleClosed(message);
1456 break;
1457 case MessageType.itemBubble:
1458 chat?.showItemBubble(message);
1459 break;
1460 case MessageType.gatherComplete:
1461 crafting?.refresh();
1462 break;
1463 case MessageType.combatHit:
1464 {
1465 const applyHit = () =>
1466 {
1467 view?.updateEntityHealth(message.targetId, message.health, message.maxHealth);
1468 view?.flashDamage(message.targetId);
1469 view?.spawnDamageNumber(message.targetId, message.damage);
1470 if (message.targetId === view?.localEntityId)
1471 {
1472 healthUi?.apply({
1473 current: message.health,
1474 max: message.maxHealth
1475 });
1476 }
1477 };
1478 if (!view?.deferCombatHit?.(message, applyHit))
1479 { applyHit(); }
1480 break;
1481 }
1482 case MessageType.combatMiss:
1483 view?.markProjectileMiss?.(message);
1484 break;
1485 case MessageType.combatBlock:
1486 {
1487 const applyBlock = () =>
1488 {
1489 view?.flashDamage(message.targetId);
1490 if (message.health != null)
1491 { view?.updateEntityHealth(message.targetId, message.health, message.maxHealth); }
1492 };
1493 if (!view?.deferCombatHit?.(message, applyBlock))
1494 { applyBlock(); }
1495 break;
1496 }
1497 case MessageType.entityHealth:
1498 view?.updateEntityHealth(message.entityId, message.health, message.maxHealth);
1499 if (message.entityId === view?.localEntityId)
1500 {
1501 healthUi?.apply({
1502 current: message.health,
1503 max: message.maxHealth
1504 });
1505 }
1506 break;
1507 case MessageType.skillLevelUp:
1508 view?.spawnSkillLevelUp(message.entityId, message);
1509 if (message.entityId === view?.localEntityId)
1510 {
1511 const name = message.displayName ?? message.skillId ?? "Skill";
1512 toasts?.show(`${name} level ${message.level}!`);
1513 }
1514 break;
1515 case MessageType.playerDied:
1516 clearAllPendingActions();
1517 contextMenu?.hide();
1518 death?.show();
1519 if (message.entityId === view?.localEntityId)
1520 {
1521 healthUi?.apply({ current: 0, max: healthUi.getMax?.() });
1522 view?.updateEntityHealth(message.entityId, 0, healthUi.getMax?.());
1523 }
1524 break;
1525 case MessageType.playerRespawned:
1526 death?.hide();
1527 view?.updateEntityHealth(message.entityId, message.health, message.maxHealth);
1528 if (message.entityId === view?.localEntityId)
1529 {
1530 healthUi?.apply({
1531 current: message.health,
1532 max: message.maxHealth
1533 });
1534 }
1535 if (message.stamina != null || message.maxStamina != null)
1536 {
1537 staminaUi?.apply({
1538 current: message.stamina ?? staminaUi.getCurrent?.(),
1539 max: message.maxStamina ?? staminaUi.getMax?.()
1540 });
1541 }
1542 break;
1543 case MessageType.error:
1544 if (playing)
1545 { toasts?.show(message.message); }
1546 else
1547 {
1548 const createPanel = document.getElementById("create-panel");
1549 const createError = document.getElementById("create-error");
1550 if (createPanel && !createPanel.hidden && createError)
1551 { createError.textContent = message.message ?? ""; }
1552 else
1553 { showError(message.message); }
1554 }
1555 social?.showError(message.message);
1556 break;
1557 case MessageType.toast:
1558 if (playing)
1559 { toasts?.show(message.message); }
1560 break;
1561 case MessageType.questsSnapshot:
1562 questsUi?.applySnapshot(message);
1563 break;
1564 case MessageType.questStepComplete:
1565 questsUi?.handleStepComplete(message);
1566 break;
1567 case MessageType.dialogueStep:
1568 dialogueUi?.handleStep(message);
1569 break;
1570 case MessageType.dialogueChoices:
1571 dialogueUi?.handleChoices(message);
1572 break;
1573 case MessageType.dialogueClose:
1574 dialogueUi?.handleClose(message);
1575 break;
1576 case MessageType.forceLogout:
1577 returnToMenu(message.reason);
1578 break;
1579 }
1580 }, {
1581 onClose (event)
1582 {
1583 if (playing)
1584 { returnToMenu(event.reason || "Disconnected from server."); }
1585 }
1586 });
1587 await socket.connect();
1588 if (typeof window !== "undefined")
1589 {
1590 window.__craftDev = (stationId = CraftingStationId.craftingBench) =>
1591 {
1592 crafting?.openStation(stationId);
1593 };
1594 }
1595}
1596
1597function returnToMenu (reason = "")
1598{
1599 playing = false;
1600 clearAllPendingActions();
1601 social?.reset();
1602 chat?.reset();
1603 inventory?.reset();
1604 crafting?.reset();
1605 alchemy?.reset();
1606 staminaUi?.hide();
1607 healthUi?.hide();
1608 statusEffectsUi?.hide();
1609 skills?.hide();
1610 spells?.hide();
1611 contextMenu?.hide();
1612 death?.reset();
1613 shop?.close({ notifyServer: false });
1614 bounty?.close();
1615 barber?.close();
1616 questsUi?.reset();
1617 dialogueUi?.reset();
1618 hideWorldTooltip();
1619 if (view)
1620 { view.clearPlaySession(); }
1621 overlay.hidden = false;
1622 hud.hidden = true;
1623 const settingsToggle = document.getElementById("settings-toggle");
1624 if (settingsToggle)
1625 { settingsToggle.hidden = true; }
1626 graphicsSettingsUi?.close();
1627 if (reason)
1628 { statusEl.textContent = reason; }
1629}
1630
1631document.getElementById("create-character-open")?.addEventListener("click", () =>
1632{
1633 showError("");
1634 const createError = document.getElementById("create-error");
1635 if (createError)
1636 { createError.textContent = ""; }
1637 document.getElementById("create-backdrop").hidden = false;
1638 document.getElementById("create-panel").hidden = false;
1639 setCreateTab("appearance");
1640 void createHairControls?.refreshPreview();
1641});
1642
1643function closeCreateModal ()
1644{
1645 document.getElementById("create-backdrop").hidden = true;
1646 document.getElementById("create-panel").hidden = true;
1647}
1648
1649document.getElementById("create-close")?.addEventListener("click", closeCreateModal);
1650document.getElementById("create-backdrop")?.addEventListener("click", closeCreateModal);
1651
1652document.getElementById("create-form").addEventListener("submit", (event) =>
1653{
1654 event.preventDefault();
1655 showError("");
1656 const createError = document.getElementById("create-error");
1657 if (createError)
1658 { createError.textContent = ""; }
1659 socket.send({
1660 type: MessageType.createCharacter,
1661 firstName: document.getElementById("first-name").value,
1662 lastName: document.getElementById("last-name").value,
1663 sex: document.getElementById("sex").value,
1664 hair: createHairControls?.currentHair?.() ?? null,
1665 clothing: createClothingControls?.currentClothing?.() ?? null
1666 });
1667});
1668
1669function initCreateTabs ()
1670{
1671 const tabs = document.querySelectorAll(".create-tab");
1672 for (const tab of tabs)
1673 {
1674 tab.addEventListener("click", () => setCreateTab(tab.dataset.createTab));
1675 }
1676 setCreateTab("appearance");
1677}
1678
1679function setCreateTab (name)
1680{
1681 createActiveTab = name === "clothing" ? "clothing" : "appearance";
1682 for (const tab of document.querySelectorAll(".create-tab"))
1683 {
1684 const on = tab.dataset.createTab === createActiveTab;
1685 tab.classList.toggle("active", on);
1686 tab.setAttribute("aria-selected", on ? "true" : "false");
1687 }
1688 for (const pane of document.querySelectorAll("[data-create-pane]"))
1689 { pane.hidden = pane.dataset.createPane !== createActiveTab; }
1690 if (createActiveTab === "clothing")
1691 { void refreshCreateClothingPreview(); }
1692 else
1693 { void createHairControls?.refreshPreview(); }
1694}
1695
1696async function refreshCreateClothingPreview ()
1697{
1698 const canvas = document.getElementById("create-clothing-preview");
1699 if (!canvas || !createClothingControls)
1700 { return; }
1701 try
1702 {
1703 await paintCharacterPreview(canvas, {
1704 sex: document.getElementById("sex")?.value ?? "male",
1705 bag: createClothingControls.previewBag(),
1706 hair: createHairControls?.currentHair?.() ?? null,
1707 hideHeadgear: true,
1708 resolveSpriteUrl (name)
1709 {
1710 return catalog?.images?.find((entry) => entry.name === name)?.url ?? null;
1711 },
1712 scale: 4
1713 });
1714 }
1715 catch (error)
1716 { console.warn(error); }
1717}
1718
1719document.getElementById("leave").addEventListener("click", () =>
1720{
1721 socket.send({ type: MessageType.leaveWorld });
1722 returnToMenu();
1723});
1724
1725main().catch((error) =>
1726{
1727 showError(error.message);
1728 console.error(error);
1729});
1730
1731function isBankTile (view, tileX, tileY)
1732{
1733 return blockTypeAt(view, tileX, tileY) === BlockType.bank;
1734}
1735
1736function isDoorwayTile (view, tileX, tileY)
1737{
1738 return blockTypeAt(view, tileX, tileY) === BlockType.doorway;
1739}
1740
1741function isMarketplaceTile (view, tileX, tileY)
1742{
1743 return blockTypeAt(view, tileX, tileY) === BlockType.marketplace;
1744}
1745
1746function isBountyOfficeTile (view, tileX, tileY)
1747{
1748 return blockTypeAt(view, tileX, tileY) === BlockType.bountyOffice;
1749}
1750
1751function isBarberTile (view, tileX, tileY)
1752{
1753 return blockTypeAt(view, tileX, tileY) === BlockType.barber;
1754}
1755
1756function isCauldronTile (view, tileX, tileY)
1757{
1758 return blockTypeAt(view, tileX, tileY) === BlockType.cauldron;
1759}
1760
1761function isFurnaceTile (view, tileX, tileY)
1762{
1763 return blockTypeAt(view, tileX, tileY) === BlockType.furnace;
1764}
1765
1766function isAnvilTile (view, tileX, tileY)
1767{
1768 return blockTypeAt(view, tileX, tileY) === BlockType.anvil;
1769}
1770
1771function isWoodworkingBenchTile (view, tileX, tileY)
1772{
1773 return blockTypeAt(view, tileX, tileY) === BlockType.woodworkingBench;
1774}
1775
1776function isCraftingBenchTile (view, tileX, tileY)
1777{
1778 return blockTypeAt(view, tileX, tileY) === BlockType.craftingBench;
1779}
1780
1781function isSpinningWheelTile (view, tileX, tileY)
1782{
1783 return blockTypeAt(view, tileX, tileY) === BlockType.spinningWheel;
1784}
1785
1786function isLoomTile (view, tileX, tileY)
1787{
1788 return blockTypeAt(view, tileX, tileY) === BlockType.loom;
1789}
1790
1791function isTailorBenchTile (view, tileX, tileY)
1792{
1793 return blockTypeAt(view, tileX, tileY) === BlockType.tailorBench;
1794}
1795
1796function isLeatherworkingTableTile (view, tileX, tileY)
1797{
1798 return blockTypeAt(view, tileX, tileY) === BlockType.leatherworkingTable;
1799}
1800
1801function isOreBoulderTile (view, tileX, tileY)
1802{
1803 const block = blockAt(view, tileX, tileY);
1804 return block?.typeId === BlockType.boulder && isOreBoulderState(block.state);
1805}
1806
1807function isChopableTreeTile (view, tileX, tileY)
1808{
1809 return isChopableTreeBlock(blockAt(view, tileX, tileY));
1810}
1811
1812function isPickablePlantTile (view, tileX, tileY)
1813{
1814 return isPickablePlantBlock(blockAt(view, tileX, tileY));
1815}
1816
1817function updateSpellTargetHighlight ()
1818{
1819 if (!view || !playing || uiBlocked() || !spells?.isTargeting?.())
1820 {
1821 view?.clearSpellTargetHighlight();
1822 return;
1823 }
1824 const canvas = scene?.canvas;
1825 if (!canvas)
1826 { return; }
1827 const rect = canvas.getBoundingClientRect();
1828 const mouseX = GameInput.mousePosition.x - rect.left;
1829 const mouseY = GameInput.mousePosition.y - rect.top;
1830 if (mouseX < 0 || mouseY < 0 || mouseX >= rect.width || mouseY >= rect.height)
1831 {
1832 view.clearSpellTargetHighlight();
1833 return;
1834 }
1835 const tile = view.screenToTile(mouseX, mouseY);
1836 const local = view.entities.get(view.localEntityId);
1837 const inRange = !local
1838 || chebyshev(local.tileX, local.tileY, tile.tileX, tile.tileY) <= COMBAT_RANGE_TILES;
1839 view.setSpellTargetHighlight(tile.tileX, tile.tileY, inRange);
1840}
1841
1842function hideWorldTooltip ()
1843{
1844 if (worldTooltip)
1845 { worldTooltip.hidden = true; }
1846}
1847
1848/** Cursor tip for gatherable resource nodes (ores now; trees / fish / herbs later). */
1849function updateWorldTooltip ()
1850{
1851 if (!worldTooltip || !view || !scene || uiBlocked())
1852 {
1853 hideWorldTooltip();
1854 return;
1855 }
1856 const canvas = scene.canvas;
1857 const rect = canvas.getBoundingClientRect();
1858 const mouseX = GameInput.mousePosition.x - rect.left;
1859 const mouseY = GameInput.mousePosition.y - rect.top;
1860 if (mouseX < 0 || mouseY < 0 || mouseX >= rect.width || mouseY >= rect.height)
1861 {
1862 hideWorldTooltip();
1863 return;
1864 }
1865 const entity = view.entityAtScreen(mouseX, mouseY);
1866 if (entity && entity.entityId !== view.localEntityId)
1867 {
1868 const label = entityLabel(entity);
1869 worldTooltip.hidden = false;
1870 worldTooltip.textContent = label;
1871 worldTooltip.style.left = `${GameInput.mousePosition.x + 14}px`;
1872 worldTooltip.style.top = `${GameInput.mousePosition.y + 16}px`;
1873 return;
1874 }
1875 const tile = view.screenToTile(mouseX, mouseY);
1876 const label = resourceNodeDisplayName(blockAt(view, tile.tileX, tile.tileY));
1877 if (!label)
1878 {
1879 hideWorldTooltip();
1880 return;
1881 }
1882 worldTooltip.hidden = false;
1883 worldTooltip.textContent = label;
1884 worldTooltip.style.left = `${GameInput.mousePosition.x + 14}px`;
1885 worldTooltip.style.top = `${GameInput.mousePosition.y + 16}px`;
1886}
1887
1888function blockTypeAt (view, tileX, tileY)
1889{
1890 return blockAt(view, tileX, tileY)?.typeId ?? null;
1891}
1892
1893function blockAt (view, tileX, tileY)
1894{
1895 const chunkX = Math.floor(tileX / CHUNK_SIZE);
1896 const chunkY = Math.floor(tileY / CHUNK_SIZE);
1897 const snapshot = view.chunks.get(`${chunkX},${chunkY}`);
1898 if (!snapshot)
1899 { return null; }
1900 const localX = tileX - chunkX * CHUNK_SIZE;
1901 const localY = tileY - chunkY * CHUNK_SIZE;
1902 return snapshot.blocks[localY * CHUNK_SIZE + localX] ?? null;
1903}
1904
1905function groundTypeAt (view, tileX, tileY)
1906{
1907 const chunkX = Math.floor(tileX / CHUNK_SIZE);
1908 const chunkY = Math.floor(tileY / CHUNK_SIZE);
1909 const snapshot = view.chunks.get(`${chunkX},${chunkY}`);
1910 if (!snapshot)
1911 { return null; }
1912 const localX = tileX - chunkX * CHUNK_SIZE;
1913 const localY = tileY - chunkY * CHUNK_SIZE;
1914 return normalizeGround(snapshot.grounds?.[localY * CHUNK_SIZE + localX]).typeId;
1915}
1916
1917/** Best-effort client filter for approach destinations (server still authorizes paths). */
1918function isClientApproachable (tileX, tileY)
1919{
1920 if (!view)
1921 { return true; }
1922 const groundId = groundTypeAt(view, tileX, tileY);
1923 const groundDef = groundId != null ? GROUND_DEFINITIONS[groundId] : null;
1924 if (groundDef && !groundDef.passable)
1925 { return false; }
1926 const block = blockAt(view, tileX, tileY);
1927 if (block?.typeId != null)
1928 {
1929 const blockDef = BLOCK_DEFINITIONS[block.typeId];
1930 if (blockDef && !blockDef.passable)
1931 { return false; }
1932 }
1933 for (const entity of view.entitiesAtTile(tileX, tileY))
1934 {
1935 if (entity.entityId === view.localEntityId)
1936 { continue; }
1937 if (entity.untargetable || entity.freeFlight)
1938 { continue; }
1939 return false;
1940 }
1941 return true;
1942}
1943
1944function chebyshev (ax, ay, bx, by)
1945{
1946 return Math.max(Math.abs(ax - bx), Math.abs(ay - by));
1947}
1948
1949function updateAuthUi (authStatus)
1950{
1951 const signIn = document.getElementById("auth-sign-in");
1952 const signOut = document.getElementById("auth-sign-out");
1953 const exportLink = document.getElementById("auth-export");
1954 if (signIn)
1955 {
1956 signIn.hidden = !!authStatus?.authenticated;
1957 signIn.href = loginUrl("/");
1958 }
1959 if (signOut)
1960 {
1961 signOut.hidden = !authStatus?.authenticated;
1962 signOut.href = logoutUrl("/");
1963 }
1964 if (exportLink)
1965 { exportLink.hidden = !authStatus?.authenticated; }
1966 if (authStatus?.authenticated && !session)
1967 {
1968 statusEl.textContent = `Signed in as ${formatAccountLabel(authStatus)}`;
1969 }
1970}