BlueGit

timfa questward

Files

questward / server / src / gateway / websocket.js

websocket.js

websocket.js 64.4 KiB Download Raw
1import { WebSocketServer } from "ws";
2import { MessageType, GAIT } from "../../../shared/protocol/constants.js";
3import { chunkKey, parseChunkKey, tileToChunk, visibleChunkCoords } from "../world/coordinates.js";
4import { VISIBLE_CHUNK_RADIUS, STATIC_CHUNK_RADIUS } from "../../../shared/protocol/constants.js";
5import { staticChunkRadiusForViewDistance, ViewDistance, normalizeGraphicsSettings } from "../../../shared/graphics/settings.js";
6import { broadcastSpeech, broadcastItemBubble } from "../chat/speech.js";
7import { CraftingStationId, craftingStationDefinition } from "../../../shared/definitions/craftingStations.js";
8import { publicSkillsView } from "../../../shared/skills/state.js";
9import { OVERWORLD_ID, normalizeDimensionId } from "../../../shared/world/dimensions.js";
10import { canCharacterSeeGroundItem } from "../../../shared/items/letters.js";
11import { getConsoleSnapshot, subscribeConsole } from "../logging/consoleCapture.js";
12import { resolveAccount } from "../auth/routes.js";
13
14let nextSessionId = 1;
15
16export function attachGateway ({ httpServer, auth, stateDb, characters, friends, editor, simulation, deploy = null })
17{
18 const wss = new WebSocketServer({ server: httpServer, path: "/ws" });
19 const sessions = new Map();
20 let draining = false;
21
22 subscribeConsole((entry) =>
23 {
24 for (const session of sessions.values())
25 {
26 if (session.consoleSubscribed && session.account?.is_admin)
27 {
28 send(session, {
29 type: MessageType.editorConsoleLine,
30 line: entry
31 });
32 }
33 }
34 });
35
36 wss.on("connection", (socket, req) =>
37 {
38 void openSession(socket, req);
39 });
40
41 async function openSession (socket, req)
42 {
43 let identity;
44 try
45 {
46 identity = await auth.authenticateRequest(req);
47 }
48 catch (error)
49 {
50 console.error("[ws] Authentication error:", error?.message ?? error);
51 socket.close(1011, "Authentication failed.");
52 return;
53 }
54 if (!identity)
55 {
56 console.warn("[ws] Connection rejected: no valid session cookie.");
57 socket.close(4401, "Authentication required.");
58 return;
59 }
60
61 try
62 {
63 const account = identity.stub
64 ? stateDb.ensureAccount(identity.authSubject, true, identity.email, identity.username)
65 : await resolveAccount(stateDb, identity);
66 const session = {
67 id: nextSessionId++,
68 socket,
69 account,
70 authSubject: identity.authSubject,
71 username: identity.username ?? account.username ?? null,
72 accessToken: identity.accessToken ?? null,
73 characterId: null,
74 entityId: null,
75 /** Client graphics: long = STATIC_CHUNK_RADIUS map ring; short = VISIBLE_CHUNK_RADIUS. */
76 viewDistance: ViewDistance.long,
77 consoleSubscribed: false,
78 /** Chunks where entity / ground-item replication is active (3×3). */
79 entitySubscribed: new Set(),
80 /** Chunks with map + baked lighting only (5×5 when long). */
81 staticSubscribed: new Set()
82 };
83 auth.register(session);
84 auth.startSessionMaintenance?.(session);
85 sessions.set(session.id, session);
86 send(session, {
87 type: MessageType.session,
88 accountId: account.account_id,
89 authSubject: account.auth_subject,
90 username: session.username,
91 email: account.email ?? null,
92 isAdmin: !!account.is_admin,
93 characters: characters.list(account.account_id)
94 });
95
96 socket.on("message", (raw) =>
97 {
98 let message;
99 try
100 { message = JSON.parse(String(raw)); }
101 catch
102 {
103 send(session, { type: MessageType.error, message: "Invalid JSON." });
104 return;
105 }
106 try
107 { handleMessage(session, message); }
108 catch (error)
109 {
110 send(session, {
111 type: MessageType.error,
112 message: error.userFacing ? error.message : "Request failed."
113 });
114 }
115 });
116
117 socket.on("close", () =>
118 {
119 if (!session.suppressLeaveWorldOnClose)
120 { leaveWorld(session); }
121 auth.release(session);
122 sessions.delete(session.id);
123 });
124 }
125 catch (error)
126 {
127 console.error("[ws] Session setup failed:", error?.message ?? error);
128 socket.close(1011, "Session setup failed.");
129 }
130 }
131
132 function handleMessage (session, message)
133 {
134 if (session.characterId
135 && stateDb.getCharacter(session.characterId)?.is_dead
136 && message.type !== MessageType.respawn
137 && message.type !== MessageType.leaveWorld)
138 {
139 // Dead bodies may only respawn or leave the world — ignore all other intents.
140 return;
141 }
142 switch (message.type)
143 {
144 case MessageType.createCharacter:
145 {
146 const created = characters.create(
147 session.account,
148 message.firstName,
149 message.lastName,
150 message.sex,
151 message.hair ?? null,
152 simulation.settings,
153 message.clothing ?? null
154 );
155 enterWorld(session, created.characterId);
156 }
157 break;
158 case MessageType.selectCharacter:
159 enterWorld(session, message.characterId);
160 break;
161 case MessageType.scheduleDeleteCharacter:
162 characters.scheduleDelete(session.account, message.characterId, simulation.settings.characterDeletionDelayMs);
163 send(session, { type: MessageType.characterList, characters: characters.list(session.account.account_id) });
164 break;
165 case MessageType.cancelDeleteCharacter:
166 characters.cancelDelete(session.account, message.characterId);
167 send(session, { type: MessageType.characterList, characters: characters.list(session.account.account_id) });
168 break;
169 case MessageType.leaveWorld:
170 leaveWorld(session);
171 send(session, { type: MessageType.characterList, characters: characters.list(session.account.account_id) });
172 break;
173 case MessageType.respawn:
174 requirePlaying(session);
175 simulation.enqueue(session.id, {
176 type: "respawn",
177 characterId: session.characterId
178 });
179 break;
180 case MessageType.moveTo:
181 requirePlaying(session);
182 simulation.enqueue(session.id, {
183 type: "move-to",
184 characterId: session.characterId,
185 tileX: message.tileX | 0,
186 tileY: message.tileY | 0
187 });
188 break;
189 case MessageType.setGait:
190 requirePlaying(session);
191 simulation.enqueue(session.id, {
192 type: "set-gait",
193 characterId: session.characterId,
194 gait: message.gait === GAIT.run ? GAIT.run : GAIT.walk
195 });
196 break;
197 case MessageType.friendRequest:
198 requirePlaying(session);
199 friends.request(session.characterId, message.characterId);
200 pushFriends(session.characterId, message.characterId);
201 break;
202 case MessageType.friendAccept:
203 requirePlaying(session);
204 if (message.accountId)
205 { friends.acceptAccount(session.characterId, message.accountId); }
206 else
207 { friends.accept(session.characterId, message.characterId); }
208 pushFriends(session.characterId, message.characterId, message.accountId);
209 break;
210 case MessageType.friendDecline:
211 requirePlaying(session);
212 if (message.accountId)
213 { friends.declineAccount(session.characterId, message.accountId); }
214 else
215 { friends.decline(session.characterId, message.characterId); }
216 pushFriends(session.characterId, message.characterId, message.accountId);
217 break;
218 case MessageType.friendRemove:
219 requirePlaying(session);
220 if (message.accountId)
221 { friends.removeAccount(session.characterId, message.accountId); }
222 else
223 { friends.remove(session.characterId, message.characterId); }
224 pushFriends(session.characterId, message.characterId, message.accountId);
225 break;
226 case MessageType.chatSay:
227 requirePlaying(session);
228 broadcastSpeech(sessions, simulation, session, message.text);
229 break;
230 case MessageType.dropItem:
231 requirePlaying(session);
232 simulation.enqueue(session.id, {
233 type: "drop-item",
234 characterId: session.characterId,
235 slotIndex: message.slotIndex | 0,
236 quantity: message.quantity ?? null
237 });
238 break;
239 case MessageType.pickupItem:
240 requirePlaying(session);
241 simulation.enqueue(session.id, {
242 type: "pickup-item",
243 characterId: session.characterId,
244 groundItemId: message.groundItemId | 0
245 });
246 break;
247 case MessageType.equipItem:
248 requirePlaying(session);
249 simulation.enqueue(session.id, {
250 type: "equip-item",
251 characterId: session.characterId,
252 slotIndex: message.slotIndex | 0
253 });
254 break;
255 case MessageType.unequipItem:
256 requirePlaying(session);
257 simulation.enqueue(session.id, {
258 type: "unequip-item",
259 characterId: session.characterId,
260 equipSlot: message.equipSlot
261 });
262 break;
263 case MessageType.moveInventorySlot:
264 requirePlaying(session);
265 simulation.enqueue(session.id, {
266 type: "move-inventory-slot",
267 characterId: session.characterId,
268 fromSlotIndex: message.fromSlotIndex | 0,
269 toSlotIndex: message.toSlotIndex | 0
270 });
271 break;
272 case MessageType.eatItem:
273 requirePlaying(session);
274 simulation.enqueue(session.id, {
275 type: "eat-item",
276 characterId: session.characterId,
277 slotIndex: message.slotIndex | 0
278 });
279 break;
280 case MessageType.drinkItem:
281 requirePlaying(session);
282 simulation.enqueue(session.id, {
283 type: "drink-item",
284 characterId: session.characterId,
285 slotIndex: message.slotIndex | 0
286 });
287 break;
288 case MessageType.tipArrows:
289 requirePlaying(session);
290 simulation.enqueue(session.id, {
291 type: "tip-arrows",
292 characterId: session.characterId,
293 coatingSlotIndex: message.coatingSlotIndex | 0,
294 arrowSlotIndex: message.arrowSlotIndex | 0,
295 quantity: message.quantity | 0
296 });
297 break;
298 case MessageType.openBank:
299 requirePlaying(session);
300 simulation.enqueue(session.id, {
301 type: "open-bank",
302 characterId: session.characterId
303 });
304 break;
305 case MessageType.enterDoorway:
306 requirePlaying(session);
307 simulation.enqueue(session.id, {
308 type: "enter-doorway",
309 characterId: session.characterId,
310 tileX: message.tileX | 0,
311 tileY: message.tileY | 0
312 });
313 break;
314 case MessageType.openBounty:
315 requirePlaying(session);
316 simulation.enqueue(session.id, {
317 type: "open-bounty",
318 characterId: session.characterId
319 });
320 break;
321 case MessageType.raiseBounty:
322 requirePlaying(session);
323 simulation.enqueue(session.id, {
324 type: "raise-bounty",
325 characterId: session.characterId,
326 firstName: message.firstName,
327 lastName: message.lastName,
328 amountCopper: message.amountCopper
329 });
330 break;
331 case MessageType.getCharacterBounty:
332 requirePlaying(session);
333 simulation.enqueue(session.id, {
334 type: "get-character-bounty",
335 characterId: session.characterId,
336 targetCharacterId: message.characterId,
337 firstName: message.firstName,
338 lastName: message.lastName
339 });
340 break;
341 case MessageType.closeBounty:
342 requirePlaying(session);
343 simulation.enqueue(session.id, {
344 type: "close-bounty",
345 characterId: session.characterId
346 });
347 break;
348 case MessageType.openBarber:
349 requirePlaying(session);
350 simulation.enqueue(session.id, {
351 type: "open-barber",
352 characterId: session.characterId
353 });
354 break;
355 case MessageType.setHair:
356 requirePlaying(session);
357 simulation.enqueue(session.id, {
358 type: "set-hair",
359 characterId: session.characterId,
360 hair: message.hair ?? null
361 });
362 break;
363 case MessageType.closeBarber:
364 requirePlaying(session);
365 simulation.enqueue(session.id, {
366 type: "close-barber",
367 characterId: session.characterId
368 });
369 break;
370 case MessageType.openCauldron:
371 requirePlaying(session);
372 simulation.enqueue(session.id, {
373 type: "open-cauldron",
374 characterId: session.characterId
375 });
376 break;
377 case MessageType.openFurnace:
378 requirePlaying(session);
379 simulation.enqueue(session.id, {
380 type: "open-station",
381 characterId: session.characterId,
382 stationId: CraftingStationId.furnace
383 });
384 break;
385 case MessageType.openStation:
386 {
387 requirePlaying(session);
388 const stationId = typeof message.stationId === "string"
389 ? message.stationId
390 : null;
391 if (!stationId || !craftingStationDefinition(stationId))
392 { break; }
393 simulation.enqueue(session.id, {
394 type: "open-station",
395 characterId: session.characterId,
396 stationId
397 });
398 break;
399 }
400 case MessageType.mine:
401 requirePlaying(session);
402 simulation.enqueue(session.id, {
403 type: "mine",
404 characterId: session.characterId,
405 tileX: message.tileX | 0,
406 tileY: message.tileY | 0
407 });
408 break;
409 case MessageType.chop:
410 requirePlaying(session);
411 simulation.enqueue(session.id, {
412 type: "chop",
413 characterId: session.characterId,
414 tileX: message.tileX | 0,
415 tileY: message.tileY | 0
416 });
417 break;
418 case MessageType.pick:
419 requirePlaying(session);
420 simulation.enqueue(session.id, {
421 type: "pick",
422 characterId: session.characterId,
423 tileX: message.tileX | 0,
424 tileY: message.tileY | 0
425 });
426 break;
427 case MessageType.cancelGather:
428 requirePlaying(session);
429 simulation.enqueue(session.id, {
430 type: "cancel-gather",
431 characterId: session.characterId
432 });
433 break;
434 case MessageType.startCraft:
435 requirePlaying(session);
436 simulation.enqueue(session.id, {
437 type: "start-craft",
438 characterId: session.characterId,
439 stationId: message.stationId,
440 recipeId: message.recipeId,
441 clothTier: message.clothTier ?? null,
442 dyeSlotIndex: message.dyeSlotIndex ?? null,
443 batchCount: message.batchCount ?? null,
444 batchAll: !!message.batchAll
445 });
446 break;
447 case MessageType.startFire:
448 requirePlaying(session);
449 simulation.enqueue(session.id, {
450 type: "start-fire",
451 characterId: session.characterId,
452 groundItemId: message.groundItemId | 0
453 });
454 break;
455 case MessageType.shear:
456 requirePlaying(session);
457 simulation.enqueue(session.id, {
458 type: "shear",
459 characterId: session.characterId,
460 targetEntityId: message.targetEntityId | 0
461 });
462 break;
463 case MessageType.startFish:
464 requirePlaying(session);
465 simulation.enqueue(session.id, {
466 type: "start-fish",
467 characterId: session.characterId,
468 tileX: message.tileX | 0,
469 tileY: message.tileY | 0
470 });
471 break;
472 case MessageType.cancelCraft:
473 requirePlaying(session);
474 simulation.enqueue(session.id, {
475 type: "cancel-craft",
476 characterId: session.characterId
477 });
478 break;
479 case MessageType.cauldronSetSlot:
480 requirePlaying(session);
481 simulation.enqueue(session.id, {
482 type: "cauldron-set-slot",
483 characterId: session.characterId,
484 slotIndex: message.slotIndex | 0,
485 itemId: message.itemId | 0,
486 quantity: message.quantity | 0,
487 instance: message.instance ?? null
488 });
489 break;
490 case MessageType.cauldronSetDyeSlot:
491 requirePlaying(session);
492 simulation.enqueue(session.id, {
493 type: "cauldron-set-dye-slot",
494 characterId: session.characterId,
495 slotIndex: message.slotIndex | 0,
496 itemId: message.itemId | 0,
497 quantity: message.quantity | 0,
498 instance: message.instance ?? null
499 });
500 break;
501 case MessageType.cauldronInsert:
502 requirePlaying(session);
503 simulation.enqueue(session.id, {
504 type: "cauldron-insert",
505 characterId: session.characterId,
506 itemId: message.itemId | 0,
507 quantity: message.quantity | 0,
508 instance: message.instance ?? null
509 });
510 break;
511 case MessageType.cauldronAction:
512 requirePlaying(session);
513 simulation.enqueue(session.id, {
514 type: "cauldron-action",
515 characterId: session.characterId,
516 action: message.action
517 });
518 break;
519 case MessageType.cauldronBottle:
520 requirePlaying(session);
521 simulation.enqueue(session.id, {
522 type: "cauldron-bottle",
523 characterId: session.characterId
524 });
525 break;
526 case MessageType.cauldronCreateDye:
527 requirePlaying(session);
528 simulation.enqueue(session.id, {
529 type: "cauldron-create-dye",
530 characterId: session.characterId,
531 confirmOverflow: !!message.confirmOverflow,
532 flowers: Array.isArray(message.flowers) ? message.flowers : []
533 });
534 break;
535 case MessageType.cauldronClear:
536 requirePlaying(session);
537 simulation.enqueue(session.id, {
538 type: "cauldron-clear",
539 characterId: session.characterId
540 });
541 break;
542 case MessageType.cauldronClearDye:
543 requirePlaying(session);
544 simulation.enqueue(session.id, {
545 type: "cauldron-clear-dye",
546 characterId: session.characterId
547 });
548 break;
549 case MessageType.cauldronSaveRecipe:
550 requirePlaying(session);
551 simulation.enqueue(session.id, {
552 type: "cauldron-save-recipe",
553 characterId: session.characterId
554 });
555 break;
556 case MessageType.cauldronClose:
557 requirePlaying(session);
558 simulation.enqueue(session.id, {
559 type: "cauldron-close",
560 characterId: session.characterId
561 });
562 break;
563 case MessageType.bankDeposit:
564 requirePlaying(session);
565 simulation.enqueue(session.id, {
566 type: "bank-deposit",
567 characterId: session.characterId,
568 slotIndex: message.slotIndex | 0,
569 quantity: message.quantity ?? null
570 });
571 break;
572 case MessageType.bankWithdraw:
573 requirePlaying(session);
574 simulation.enqueue(session.id, {
575 type: "bank-withdraw",
576 characterId: session.characterId,
577 slotIndex: message.slotIndex | 0,
578 quantity: message.quantity ?? null
579 });
580 break;
581 case MessageType.getBlankCheques:
582 requirePlaying(session);
583 simulation.enqueue(session.id, {
584 type: "get-blank-cheques",
585 characterId: session.characterId
586 });
587 break;
588 case MessageType.returnBlankCheques:
589 requirePlaying(session);
590 simulation.enqueue(session.id, {
591 type: "return-blank-cheques",
592 characterId: session.characterId,
593 slotIndex: message.slotIndex | 0,
594 quantity: message.quantity ?? null
595 });
596 break;
597 case MessageType.writeCheque:
598 requirePlaying(session);
599 simulation.enqueue(session.id, {
600 type: "write-cheque",
601 characterId: session.characterId,
602 slotIndex: message.slotIndex | 0,
603 vaultSlotIndex: message.vaultSlotIndex | 0,
604 quantity: message.quantity ?? 1
605 });
606 break;
607 case MessageType.redeemCheque:
608 requirePlaying(session);
609 simulation.enqueue(session.id, {
610 type: "redeem-cheque",
611 characterId: session.characterId,
612 slotIndex: message.slotIndex | 0
613 });
614 break;
615 case MessageType.claimInheritance:
616 requirePlaying(session);
617 {
618 const inheritance = stateDb.getInheritance(session.account.account_id);
619 simulation.enqueue(session.id, {
620 type: "claim-inheritance",
621 characterId: session.characterId,
622 stacks: (inheritance.slots ?? []).filter(Boolean)
623 });
624 }
625 break;
626 case MessageType.attack:
627 requirePlaying(session);
628 simulation.enqueue(session.id, {
629 type: "attack",
630 characterId: session.characterId,
631 targetEntityId: message.targetEntityId | 0
632 });
633 break;
634 case MessageType.cancelAttack:
635 requirePlaying(session);
636 simulation.enqueue(session.id, {
637 type: "cancel-attack",
638 characterId: session.characterId
639 });
640 break;
641 case MessageType.setSpellFavorite:
642 requirePlaying(session);
643 simulation.enqueue(session.id, {
644 type: "set-spell-favorite",
645 characterId: session.characterId,
646 spellId: message.spellId
647 });
648 break;
649 case MessageType.setSpellAutoCast:
650 requirePlaying(session);
651 simulation.enqueue(session.id, {
652 type: "set-spell-autocast",
653 characterId: session.characterId,
654 enabled: !!message.enabled
655 });
656 break;
657 case MessageType.armSpell:
658 requirePlaying(session);
659 simulation.enqueue(session.id, {
660 type: "arm-spell",
661 characterId: session.characterId,
662 spellId: message.spellId
663 });
664 break;
665 case MessageType.cancelArmSpell:
666 requirePlaying(session);
667 simulation.enqueue(session.id, {
668 type: "cancel-arm-spell",
669 characterId: session.characterId
670 });
671 break;
672 case MessageType.castSpellTile:
673 requirePlaying(session);
674 simulation.enqueue(session.id, {
675 type: "cast-spell-tile",
676 characterId: session.characterId,
677 spellId: message.spellId,
678 tileX: message.tileX | 0,
679 tileY: message.tileY | 0
680 });
681 break;
682 case MessageType.castSpellEntity:
683 requirePlaying(session);
684 simulation.enqueue(session.id, {
685 type: "cast-spell-entity",
686 characterId: session.characterId,
687 spellId: message.spellId,
688 targetEntityId: message.targetEntityId | 0
689 });
690 break;
691 case MessageType.readSpellbook:
692 requirePlaying(session);
693 simulation.enqueue(session.id, {
694 type: "read-spellbook",
695 characterId: session.characterId,
696 slotIndex: message.slotIndex | 0
697 });
698 break;
699 case MessageType.interact:
700 requirePlaying(session);
701 simulation.enqueue(session.id, {
702 type: "interact",
703 characterId: session.characterId,
704 targetEntityId: message.targetEntityId | 0,
705 purpose: message.purpose === "shop" || message.purpose === "talk"
706 ? message.purpose
707 : null
708 });
709 break;
710 case MessageType.buyFromShop:
711 requirePlaying(session);
712 simulation.enqueue(session.id, {
713 type: "buy-from-shop",
714 characterId: session.characterId,
715 npcEntityId: message.npcEntityId | 0,
716 itemId: message.itemId | 0,
717 quantity: message.quantity | 0 || 1,
718 listingId: typeof message.listingId === "string" ? message.listingId : null,
719 source: typeof message.source === "string" ? message.source : null
720 });
721 break;
722 case MessageType.sellToShop:
723 requirePlaying(session);
724 simulation.enqueue(session.id, {
725 type: "sell-to-shop",
726 characterId: session.characterId,
727 npcEntityId: message.npcEntityId | 0,
728 slotIndex: message.slotIndex | 0,
729 quantity: message.quantity | 0 || 1
730 });
731 break;
732 case MessageType.closeShop:
733 requirePlaying(session);
734 simulation.enqueue(session.id, {
735 type: "close-shop",
736 characterId: session.characterId,
737 npcEntityId: message.npcEntityId | 0
738 });
739 break;
740 case MessageType.openMarket:
741 requirePlaying(session);
742 simulation.enqueue(session.id, {
743 type: "open-market",
744 characterId: session.characterId
745 });
746 break;
747 case MessageType.closeMarket:
748 requirePlaying(session);
749 simulation.enqueue(session.id, {
750 type: "close-market",
751 characterId: session.characterId
752 });
753 break;
754 case MessageType.placeMarketSell:
755 requirePlaying(session);
756 simulation.enqueue(session.id, {
757 type: "place-market-sell",
758 characterId: session.characterId,
759 slotIndex: message.slotIndex | 0,
760 quantity: message.quantity | 0 || 1,
761 minUnitPrice: message.minUnitPrice | 0
762 });
763 break;
764 case MessageType.placeMarketBuy:
765 requirePlaying(session);
766 simulation.enqueue(session.id, {
767 type: "place-market-buy",
768 characterId: session.characterId,
769 itemId: message.itemId | 0,
770 quantity: message.quantity | 0 || 1,
771 maxUnitPrice: message.maxUnitPrice | 0
772 });
773 break;
774 case MessageType.cancelMarketOrder:
775 requirePlaying(session);
776 simulation.enqueue(session.id, {
777 type: "cancel-market-order",
778 characterId: session.characterId,
779 orderId: message.orderId | 0
780 });
781 break;
782 case MessageType.follow:
783 requirePlaying(session);
784 simulation.enqueue(session.id, {
785 type: "follow",
786 characterId: session.characterId,
787 targetEntityId: message.targetEntityId | 0
788 });
789 break;
790 case MessageType.cancelFollow:
791 requirePlaying(session);
792 simulation.enqueue(session.id, {
793 type: "cancel-follow",
794 characterId: session.characterId
795 });
796 break;
797 case MessageType.sendPigeon:
798 requirePlaying(session);
799 {
800 const result = simulation.dispatchPigeon({
801 characterId: session.characterId,
802 destination: message.destination,
803 cargo: message.cargo
804 });
805 send(session, {
806 type: MessageType.pigeonDispatched,
807 courierId: result.transit.courierId,
808 destinationKind: result.transit.destinationKind,
809 destinationCharacterId: result.transit.destinationCharacterId
810 });
811 send(session, { type: MessageType.inventory, ...result.bag });
812 }
813 break;
814 case MessageType.searchCharacter:
815 requirePlaying(session);
816 {
817 const character = friends.findByFullName(message.firstName, message.lastName);
818 send(session, {
819 type: MessageType.characterSearchResult,
820 character: character ?? null
821 });
822 }
823 break;
824 case MessageType.writeLetter:
825 requirePlaying(session);
826 simulation.enqueue(session.id, {
827 type: "write-letter",
828 characterId: session.characterId,
829 slotIndex: message.slotIndex,
830 body: message.body
831 });
832 break;
833 case MessageType.editLetter:
834 requirePlaying(session);
835 simulation.enqueue(session.id, {
836 type: "edit-letter",
837 characterId: session.characterId,
838 slotIndex: message.slotIndex,
839 body: message.body
840 });
841 break;
842 case MessageType.openLetter:
843 requirePlaying(session);
844 simulation.enqueue(session.id, {
845 type: "open-letter",
846 characterId: session.characterId,
847 slotIndex: message.slotIndex
848 });
849 break;
850 case MessageType.editorLoadChunk:
851 requireAdmin(session);
852 send(session, {
853 type: MessageType.editorChunk,
854 ...editor.loadChunk(message.chunkX | 0, message.chunkY | 0, message.dimensionId)
855 });
856 break;
857 case MessageType.editorSaveChunk:
858 requireAdmin(session);
859 send(session, {
860 type: MessageType.editorChunk,
861 ...editor.saveChunk(
862 message.chunkX | 0,
863 message.chunkY | 0,
864 message.draft,
865 session.authSubject,
866 message.dimensionId
867 )
868 });
869 break;
870 case MessageType.editorListDimensions:
871 case "EDITOR_LIST_DIMENSIONS":
872 requireAdmin(session);
873 try
874 {
875 send(session, { type: MessageType.editorDimensions, ...editor.listDimensions() });
876 }
877 catch (err)
878 {
879 send(session, { type: MessageType.error, message: err.userFacing ? err.message : "Failed to list dimensions." });
880 }
881 break;
882 case MessageType.editorCreateDimension:
883 case "EDITOR_CREATE_DIMENSION":
884 requireAdmin(session);
885 send(session, {
886 type: MessageType.editorDimensions,
887 ...editor.createDimension(message.dimensionId, message.displayName, session.authSubject)
888 });
889 break;
890 case MessageType.editorSaveDimension:
891 case "EDITOR_SAVE_DIMENSION":
892 requireAdmin(session);
893 send(session, {
894 type: MessageType.editorDimensions,
895 ...editor.saveDimension(message.dimension ?? message, session.authSubject)
896 });
897 break;
898 case MessageType.editorSoftDeleteDimension:
899 case "EDITOR_SOFT_DELETE_DIMENSION":
900 requireAdmin(session);
901 send(session, {
902 type: MessageType.editorDimensions,
903 ...editor.softDeleteDimension(message.dimensionId, session.authSubject)
904 });
905 break;
906 case MessageType.editorCancelDimensionDeletion:
907 case "EDITOR_CANCEL_DIMENSION_DELETION":
908 requireAdmin(session);
909 send(session, {
910 type: MessageType.editorDimensions,
911 ...editor.cancelDimensionDeletion(message.dimensionId, session.authSubject)
912 });
913 break;
914 case MessageType.editorLoadSettings:
915 requireAdmin(session);
916 send(session, {
917 type: MessageType.editorSettings,
918 ...editor.loadSettings(),
919 itemLastSales: simulation.itemLastSalesSnapshot?.() ?? {}
920 });
921 break;
922 case MessageType.editorLoadGameAdmins:
923 requireAdmin(session);
924 send(session, {
925 type: MessageType.editorGameAdmins,
926 admins: listPublicGameAdmins()
927 });
928 break;
929 case MessageType.editorGrantGameAdmin:
930 requireAdmin(session);
931 {
932 const updated = stateDb.grantGameAdminByUsername(message.username);
933 refreshAccountAdminSessions(updated.auth_subject);
934 send(session, {
935 type: MessageType.editorGameAdmins,
936 admins: listPublicGameAdmins()
937 });
938 }
939 break;
940 case MessageType.editorRevokeGameAdmin:
941 requireAdmin(session);
942 {
943 const target = String(message.authSubject ?? "").trim();
944 if (!target)
945 { throw userError("Admin account is required."); }
946 if (target === session.authSubject && !message.confirmSelf)
947 { throw userError("Confirm removing your own admin access."); }
948 const updated = stateDb.setGameAdmin(target, false);
949 refreshAccountAdminSessions(updated.auth_subject);
950 send(session, {
951 type: MessageType.editorGameAdmins,
952 admins: listPublicGameAdmins()
953 });
954 }
955 break;
956 case MessageType.editorConsoleSubscribe:
957 requireAdmin(session);
958 session.consoleSubscribed = true;
959 send(session, {
960 type: MessageType.editorConsoleSnapshot,
961 lines: getConsoleSnapshot(800)
962 });
963 break;
964 case MessageType.editorSaveSettings:
965 requireAdmin(session);
966 {
967 const saved = editor.saveSettings(message.settings ?? {}, session.authSubject);
968 simulation.applySettings(saved.settings);
969 broadcastStatus();
970 broadcastSettings(saved);
971 }
972 break;
973 case MessageType.editorApplyRevision:
974 requireAdmin(session);
975 if (!editor.revisionStatus().pendingRevisionId)
976 {
977 send(session, { type: MessageType.error, message: "Nothing pending to apply." });
978 break;
979 }
980 {
981 const appliedRevisionId = editor.applyPendingRevision();
982 simulation.reloadWorld();
983 for (const other of sessions.values())
984 {
985 if (other.entityId)
986 { syncSubscriptions(other, true); }
987 }
988 broadcastStatus();
989 send(session, {
990 type: MessageType.editorRevisionApplied,
991 ...editor.revisionStatus(),
992 appliedRevisionId
993 });
994 }
995 break;
996 case MessageType.editorRestartNow:
997 requireAdmin(session);
998 deploy?.requestRestartNow?.("admin-editor");
999 break;
1000 case MessageType.editorLoadQuests:
1001 requireAdmin(session);
1002 send(session, { type: MessageType.editorQuests, ...editor.loadQuests() });
1003 break;
1004 case MessageType.editorSaveQuest:
1005 requireAdmin(session);
1006 send(session, {
1007 type: MessageType.editorQuests,
1008 ...editor.saveQuest(message.quest ?? message, session.authSubject)
1009 });
1010 break;
1011 case MessageType.editorDeleteQuest:
1012 requireAdmin(session);
1013 send(session, {
1014 type: MessageType.editorQuests,
1015 ...editor.deleteQuest(message.questId, session.authSubject)
1016 });
1017 break;
1018 case MessageType.editorLoadDialogues:
1019 requireAdmin(session);
1020 send(session, { type: MessageType.editorDialogues, ...editor.loadDialogues() });
1021 break;
1022 case MessageType.editorSaveDialogue:
1023 requireAdmin(session);
1024 send(session, {
1025 type: MessageType.editorDialogues,
1026 ...editor.saveDialogue(message.dialogue ?? message, session.authSubject)
1027 });
1028 break;
1029 case MessageType.editorDeleteDialogue:
1030 requireAdmin(session);
1031 send(session, {
1032 type: MessageType.editorDialogues,
1033 ...editor.deleteDialogue(message.dialogueId, session.authSubject)
1034 });
1035 break;
1036 case MessageType.dialogueChoose:
1037 requirePlaying(session);
1038 simulation.enqueue(session.id, {
1039 type: "dialogue-choose",
1040 characterId: session.characterId,
1041 trigger: String(message.trigger ?? "")
1042 });
1043 break;
1044 case MessageType.dialogueAdvance:
1045 requirePlaying(session);
1046 simulation.enqueue(session.id, {
1047 type: "dialogue-advance",
1048 characterId: session.characterId
1049 });
1050 break;
1051 case MessageType.closeDialogue:
1052 requirePlaying(session);
1053 simulation.enqueue(session.id, {
1054 type: "close-dialogue",
1055 characterId: session.characterId
1056 });
1057 break;
1058 case MessageType.requestQuests:
1059 requirePlaying(session);
1060 simulation.enqueue(session.id, {
1061 type: "request-quests",
1062 characterId: session.characterId
1063 });
1064 break;
1065 case MessageType.setGraphicsSettings:
1066 {
1067 const next = normalizeGraphicsSettings({
1068 viewDistance: message.viewDistance ?? session.viewDistance
1069 });
1070 const changed = next.viewDistance !== session.viewDistance;
1071 session.viewDistance = next.viewDistance;
1072 if (changed && session.entityId)
1073 { syncSubscriptions(session, true); }
1074 }
1075 break;
1076 default:
1077 send(session, { type: MessageType.error, message: `Unknown message ${message.type}` });
1078 }
1079 }
1080
1081 function enterWorld (session, characterId)
1082 {
1083 if (draining || deploy?.isDraining?.())
1084 {
1085 const error = new Error("The server is restarting for an update. Please try again in a moment.");
1086 error.userFacing = true;
1087 throw error;
1088 }
1089 leaveWorld(session);
1090 const character = characters.getOwned(session.account.account_id, characterId);
1091 if (character.deletion_scheduled_at)
1092 {
1093 const error = new Error("That character is marked for deletion.");
1094 error.userFacing = true;
1095 throw error;
1096 }
1097 const targetCharacterId = character.character_id;
1098 let handoffEntityId = null;
1099 for (const other of [...sessions.values()])
1100 {
1101 if (other === session || other.account.account_id !== session.account.account_id || !other.characterId)
1102 { continue; }
1103 const sameCharacter = other.characterId === targetCharacterId;
1104 if (sameCharacter && simulation.isCharacterOnline(targetCharacterId))
1105 { handoffEntityId = simulation.entityForCharacter(targetCharacterId); }
1106 disconnectPlayingSession(other, {
1107 despawn: !sameCharacter,
1108 reason: sameCharacter
1109 ? "This character was opened in another window."
1110 : "Logged in from another window."
1111 });
1112 }
1113 session.characterId = targetCharacterId;
1114 if (handoffEntityId != null)
1115 {
1116 const entityId = simulation.reattachCharacterSession(targetCharacterId, session.id);
1117 if (!entityId)
1118 {
1119 const error = new Error("Could not resume that character. Please try again.");
1120 error.userFacing = true;
1121 throw error;
1122 }
1123 session.entityId = entityId;
1124 }
1125 else
1126 { session.entityId = simulation.spawnCharacter(session.id, character); }
1127 sendEnterWorld(session, character);
1128 }
1129
1130 function sendEnterWorld (session, character)
1131 {
1132 const spawned = simulation.entityRecord(session.entityId);
1133 const enterDim = normalizeDimensionId(spawned.dimensionId ?? OVERWORLD_ID);
1134 const dimRecord = simulation.getDimensionRecord?.(enterDim);
1135 send(session, {
1136 type: MessageType.enterWorld,
1137 entityId: session.entityId,
1138 characterId: session.characterId,
1139 accountId: session.account?.account_id ?? null,
1140 tileX: spawned.tileX,
1141 tileY: spawned.tileY,
1142 dimensionId: enterDim,
1143 lightingMode: dimRecord?.lightingMode ?? "dayNight",
1144 seasonMode: dimRecord?.seasonMode ?? "auto",
1145 gait: spawned.gait,
1146 sex: spawned.sex,
1147 firstName: spawned.firstName,
1148 lastName: spawned.lastName,
1149 layers: spawned.layers ?? [],
1150 health: spawned.health,
1151 maxHealth: spawned.maxHealth,
1152 skullValue: spawned.skullValue | 0,
1153 settings: simulation.settings,
1154 worldTime: simulation.worldTime(),
1155 restartStatus: deploy?.getStatus?.() ?? { scheduled: false }
1156 });
1157 syncSubscriptions(session, true);
1158 send(session, { type: MessageType.friends, ...friends.snapshot(session.characterId) });
1159 const bag = simulation.bagOf(session.entityId);
1160 if (bag)
1161 { send(session, { type: MessageType.inventory, ...bag }); }
1162 const skills = simulation.skillsOf(session.entityId);
1163 if (skills)
1164 { send(session, { type: MessageType.skills, skills: publicSkillsView(skills) }); }
1165 const spellView = simulation.spellsOf(session.entityId);
1166 if (spellView)
1167 {
1168 send(session, {
1169 type: MessageType.spells,
1170 spells: spellView.spells,
1171 autoCast: spellView.autoCast,
1172 armedSpellId: spellView.armedSpellId ?? null
1173 });
1174 }
1175 const stamina = simulation.staminaOf(session.entityId);
1176 if (stamina)
1177 {
1178 send(session, {
1179 type: MessageType.stamina,
1180 current: stamina.current,
1181 max: stamina.max,
1182 gait: stamina.gait
1183 });
1184 }
1185 if (character.is_dead)
1186 {
1187 send(session, {
1188 type: MessageType.playerDied,
1189 entityId: session.entityId,
1190 characterId: session.characterId
1191 });
1192 }
1193 publishReplication(simulation.drainReplication());
1194 }
1195
1196 function disconnectPlayingSession (session, { despawn = true, reason = "Logged in from another window." } = {})
1197 {
1198 send(session, { type: MessageType.forceLogout, reason });
1199 const characterId = session.characterId;
1200 session.characterId = null;
1201 session.entityId = null;
1202 session.entitySubscribed.clear();
1203 session.staticSubscribed.clear();
1204 if (despawn && characterId)
1205 {
1206 simulation.despawnCharacter(characterId);
1207 publishReplication(simulation.drainReplication());
1208 }
1209 session.suppressLeaveWorldOnClose = true;
1210 if (session.socket.readyState === 1)
1211 { session.socket.close(4000, "Logged in elsewhere"); }
1212 }
1213
1214 function leaveWorld (session)
1215 {
1216 if (session.characterId)
1217 { simulation.despawnCharacter(session.characterId); }
1218 publishReplication(simulation.drainReplication());
1219 session.characterId = null;
1220 session.entityId = null;
1221 session.entitySubscribed.clear();
1222 session.staticSubscribed.clear();
1223 }
1224
1225 function syncSubscriptions (session, forceSnapshots)
1226 {
1227 if (!session.entityId)
1228 { return; }
1229 const position = simulation.positionOf(session.entityId);
1230 if (!position)
1231 { return; }
1232
1233 const dimensionId = normalizeDimensionId(position.dimensionId ?? OVERWORLD_ID);
1234 const centerChunkX = tileToChunk(position.tileX);
1235 const centerChunkY = tileToChunk(position.tileY);
1236 const mapRadius = staticChunkRadiusForViewDistance(
1237 session.viewDistance,
1238 STATIC_CHUNK_RADIUS,
1239 VISIBLE_CHUNK_RADIUS
1240 );
1241 const entityCoords = visibleChunkCoords(centerChunkX, centerChunkY, VISIBLE_CHUNK_RADIUS);
1242 const staticCoords = visibleChunkCoords(centerChunkX, centerChunkY, mapRadius);
1243 const entityNext = new Set(entityCoords.map((coord) => chunkKey(coord.chunkX, coord.chunkY, dimensionId)));
1244 const staticNext = new Set(staticCoords.map((coord) => chunkKey(coord.chunkX, coord.chunkY, dimensionId)));
1245
1246 for (const key of session.staticSubscribed)
1247 {
1248 if (!staticNext.has(key))
1249 {
1250 const { chunkX, chunkY } = parseChunkKey(key);
1251 send(session, { type: MessageType.unsubscribeChunk, chunkX, chunkY });
1252 }
1253 }
1254
1255 const snapshots = simulation.snapshotsForView(session.entityId, mapRadius);
1256 for (const snapshot of snapshots)
1257 {
1258 const key = chunkKey(snapshot.chunkX, snapshot.chunkY, dimensionId);
1259 const entityChanged = entityNext.has(key) !== session.entitySubscribed.has(key);
1260 if (forceSnapshots || !session.staticSubscribed.has(key) || entityChanged)
1261 {
1262 const groundItems = (snapshot.groundItems ?? []).filter((item) =>
1263 canCharacterSeeGroundItem(item, session.characterId)
1264 );
1265 send(session, { type: MessageType.chunkSnapshot, ...snapshot, groundItems });
1266 }
1267 }
1268 session.entitySubscribed = entityNext;
1269 session.staticSubscribed = staticNext;
1270 }
1271
1272 function requirePlaying (session)
1273 {
1274 if (!session.characterId)
1275 {
1276 const error = new Error("Select a character first.");
1277 error.userFacing = true;
1278 throw error;
1279 }
1280 }
1281
1282 function userError (message)
1283 {
1284 const error = new Error(message);
1285 error.userFacing = true;
1286 return error;
1287 }
1288
1289 function listPublicGameAdmins ()
1290 {
1291 return stateDb.listGameAdmins().map((row) => ({
1292 authSubject: row.auth_subject,
1293 username: row.username ?? null,
1294 email: row.email ?? null
1295 }));
1296 }
1297
1298 function refreshAccountAdminSessions (authSubject)
1299 {
1300 const account = stateDb.getAccountBySubject(authSubject);
1301 if (!account)
1302 { return; }
1303 for (const session of sessions.values())
1304 {
1305 if (session.authSubject !== authSubject)
1306 { continue; }
1307 session.account = account;
1308 send(session, {
1309 type: MessageType.session,
1310 accountId: account.account_id,
1311 authSubject: account.auth_subject,
1312 username: session.username ?? account.username ?? null,
1313 email: account.email ?? null,
1314 isAdmin: !!account.is_admin,
1315 characters: characters.list(account.account_id)
1316 });
1317 }
1318 }
1319
1320 function requireAdmin (session)
1321 {
1322 if (!session.account.is_admin)
1323 {
1324 const error = new Error("Admin only.");
1325 error.userFacing = true;
1326 throw error;
1327 }
1328 }
1329
1330 function broadcastStatus ()
1331 {
1332 const worldTime = simulation.worldTime();
1333 const restartStatus = deploy?.getStatus?.() ?? { scheduled: false };
1334 for (const session of sessions.values())
1335 {
1336 if (session.entityId)
1337 {
1338 send(session, {
1339 type: MessageType.worldStatus,
1340 worldTime,
1341 settings: simulation.settings,
1342 activeRevisionId: simulation.activeRevisionId,
1343 restartStatus
1344 });
1345 }
1346 }
1347 }
1348
1349 function broadcastRestartStatus ()
1350 {
1351 const restartStatus = deploy?.getStatus?.() ?? { scheduled: false };
1352 for (const session of sessions.values())
1353 {
1354 if (session.entityId)
1355 { send(session, { type: MessageType.restartStatus, restartStatus }); }
1356 }
1357 }
1358
1359 function pushFriends (...refs)
1360 {
1361 const accountIds = new Set();
1362 for (const ref of refs)
1363 {
1364 if (ref == null)
1365 { continue; }
1366 if (typeof ref === "object" && ref.accountId != null)
1367 {
1368 accountIds.add(ref.accountId | 0);
1369 continue;
1370 }
1371 const asNumber = Number(ref);
1372 if (!asNumber)
1373 { continue; }
1374 // Heuristic: character ids from messages; also accept bare account ids from panel.
1375 const character = stateDb.getCharacter(asNumber);
1376 if (character)
1377 { accountIds.add(character.account_id | 0); }
1378 else if (stateDb.getAccount(asNumber))
1379 { accountIds.add(asNumber); }
1380 }
1381 for (const session of sessions.values())
1382 {
1383 if (!session.characterId)
1384 { continue; }
1385 const accountId = session.account?.account_id | 0;
1386 if (!accountIds.has(accountId))
1387 { continue; }
1388 send(session, { type: MessageType.friends, ...friends.snapshot(session.characterId) });
1389 }
1390 }
1391
1392 function broadcastSettings (payload)
1393 {
1394 for (const session of sessions.values())
1395 {
1396 if (session.account.is_admin)
1397 { send(session, { type: MessageType.editorSettings, ...payload }); }
1398 }
1399 }
1400
1401 function onTickResult (result)
1402 {
1403 publishReplication(result.replication ?? []);
1404 for (const event of result.events)
1405 {
1406 if (event.type === "command-error")
1407 {
1408 const session = sessions.get(event.sessionId);
1409 if (session)
1410 { send(session, { type: MessageType.error, message: event.message }); }
1411 continue;
1412 }
1413 if (event.type === "inventory")
1414 {
1415 const session = event.sessionId != null
1416 ? sessions.get(event.sessionId)
1417 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1418 if (!session)
1419 { continue; }
1420 send(session, {
1421 type: MessageType.inventory,
1422 inventory: event.inventory,
1423 equipment: event.equipment,
1424 vault: event.vault,
1425 vaultReserved: event.vaultReserved
1426 });
1427 if (event.bank)
1428 {
1429 send(session, {
1430 type: MessageType.bankSnapshot,
1431 vault: event.vault,
1432 vaultReserved: event.vaultReserved,
1433 inheritance: stateDb.getInheritance(session.account.account_id)
1434 });
1435 }
1436 if (event.cauldron != null)
1437 {
1438 send(session, {
1439 type: MessageType.cauldronSnapshot,
1440 open: !!event.cauldron,
1441 state: event.cauldronState ?? null,
1442 alchemyResult: event.alchemyResult ?? null,
1443 dyeConfirm: event.dyeConfirm ?? null
1444 });
1445 }
1446 continue;
1447 }
1448 if (event.type === "skills")
1449 {
1450 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1451 if (!session)
1452 { continue; }
1453 send(session, { type: MessageType.skills, skills: event.skills ?? [] });
1454 continue;
1455 }
1456 if (event.type === "spells")
1457 {
1458 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1459 if (!session)
1460 { continue; }
1461 send(session, {
1462 type: MessageType.spellsUpdated,
1463 spells: event.spells ?? [],
1464 autoCast: !!event.autoCast,
1465 armedSpellId: event.armedSpellId ?? null
1466 });
1467 continue;
1468 }
1469 if (event.type === "spell-armed")
1470 {
1471 const session = [...sessions.values()].find((entry) => entry.entityId === event.entityId);
1472 if (!session)
1473 { continue; }
1474 send(session, {
1475 type: MessageType.spellArmed,
1476 spellId: event.spellId
1477 });
1478 continue;
1479 }
1480 if (event.type === "spell-disarmed")
1481 {
1482 const session = [...sessions.values()].find((entry) => entry.entityId === event.entityId);
1483 if (!session)
1484 { continue; }
1485 send(session, { type: MessageType.spellDisarmed });
1486 continue;
1487 }
1488 if (event.type === "stamina")
1489 {
1490 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1491 if (!session)
1492 { continue; }
1493 send(session, {
1494 type: MessageType.stamina,
1495 current: event.current,
1496 max: event.max,
1497 gait: event.gait
1498 });
1499 continue;
1500 }
1501 if (event.type === "status-effects")
1502 {
1503 const session = event.sessionId != null
1504 ? sessions.get(event.sessionId)
1505 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1506 if (!session)
1507 { continue; }
1508 send(session, {
1509 type: MessageType.statusEffects,
1510 effects: event.effects ?? [],
1511 blind: !!event.blind
1512 });
1513 continue;
1514 }
1515 if (event.type === "toast")
1516 {
1517 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1518 if (session)
1519 { send(session, { type: MessageType.toast, message: event.message }); }
1520 continue;
1521 }
1522 if (event.type === "quests-snapshot")
1523 {
1524 const session = event.sessionId != null
1525 ? sessions.get(event.sessionId)
1526 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1527 if (session)
1528 {
1529 send(session, {
1530 type: MessageType.questsSnapshot,
1531 quests: event.quests ?? []
1532 });
1533 }
1534 continue;
1535 }
1536 if (event.type === "quest-step-complete")
1537 {
1538 const session = event.sessionId != null
1539 ? sessions.get(event.sessionId)
1540 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1541 if (session)
1542 {
1543 send(session, {
1544 type: MessageType.questStepComplete,
1545 questId: event.questId,
1546 title: event.title
1547 });
1548 }
1549 continue;
1550 }
1551 if (event.type === "dialogue-step")
1552 {
1553 const session = event.sessionId != null
1554 ? sessions.get(event.sessionId)
1555 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1556 if (session)
1557 {
1558 send(session, {
1559 type: MessageType.dialogueStep,
1560 dialogueId: event.dialogueId,
1561 stepId: event.stepId,
1562 label: event.label,
1563 npcEntityId: event.npcEntityId ?? null,
1564 lines: event.lines ?? []
1565 });
1566 }
1567 continue;
1568 }
1569 if (event.type === "dialogue-choices")
1570 {
1571 const session = event.sessionId != null
1572 ? sessions.get(event.sessionId)
1573 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1574 if (session)
1575 {
1576 send(session, {
1577 type: MessageType.dialogueChoices,
1578 dialogueId: event.dialogueId,
1579 stepId: event.stepId,
1580 npcEntityId: event.npcEntityId ?? null,
1581 triggers: event.triggers ?? []
1582 });
1583 }
1584 continue;
1585 }
1586 if (event.type === "dialogue-close")
1587 {
1588 const session = event.sessionId != null
1589 ? sessions.get(event.sessionId)
1590 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1591 if (session)
1592 {
1593 send(session, {
1594 type: MessageType.dialogueClose,
1595 reason: event.reason ?? null
1596 });
1597 }
1598 continue;
1599 }
1600 if (event.type === "pigeon-delivered")
1601 {
1602 for (const session of sessions.values())
1603 {
1604 if (session.characterId === event.senderCharacterId
1605 || session.characterId === event.destinationCharacterId)
1606 {
1607 send(session, {
1608 type: MessageType.pigeonDelivered,
1609 courierId: event.courierId,
1610 destinationKind: event.destinationKind,
1611 cargo: event.cargo
1612 });
1613 }
1614 }
1615 continue;
1616 }
1617 if (event.type === "player-died")
1618 {
1619 const session = sessions.get(event.sessionId);
1620 if (session)
1621 {
1622 send(session, {
1623 type: MessageType.playerDied,
1624 entityId: event.entityId,
1625 characterId: event.characterId
1626 });
1627 }
1628 continue;
1629 }
1630 if (event.type === "player-respawned")
1631 {
1632 const session = sessions.get(event.sessionId);
1633 if (session)
1634 {
1635 send(session, {
1636 type: MessageType.playerRespawned,
1637 entityId: event.entityId,
1638 characterId: event.characterId,
1639 tileX: event.tileX,
1640 tileY: event.tileY,
1641 health: event.health,
1642 maxHealth: event.maxHealth,
1643 stamina: event.stamina,
1644 maxStamina: event.maxStamina,
1645 skullValue: event.skullValue | 0
1646 });
1647 }
1648 continue;
1649 }
1650 if (event.type === "dimension-changed")
1651 {
1652 const session = sessions.get(event.sessionId);
1653 if (session)
1654 {
1655 session.entitySubscribed.clear();
1656 session.staticSubscribed.clear();
1657 send(session, {
1658 type: MessageType.dimensionChanged,
1659 dimensionId: event.dimensionId,
1660 tileX: event.tileX,
1661 tileY: event.tileY,
1662 lightingMode: event.lightingMode,
1663 seasonMode: event.seasonMode
1664 });
1665 syncSubscriptions(session, true);
1666 }
1667 continue;
1668 }
1669 if (event.type === "combat-no-arrows")
1670 {
1671 const session = sessions.get(event.sessionId);
1672 if (session)
1673 { send(session, { type: MessageType.combatNoArrows }); }
1674 continue;
1675 }
1676 if (event.type === "craft-result")
1677 {
1678 const session = sessions.get(event.sessionId);
1679 if (session)
1680 {
1681 send(session, {
1682 type: MessageType.craftResult,
1683 recipeId: event.recipeId,
1684 ok: !!event.ok,
1685 error: event.error ?? null,
1686 burned: !!event.burned,
1687 continuing: !!event.continuing
1688 });
1689 }
1690 continue;
1691 }
1692 if (event.type === "station-open")
1693 {
1694 const session = sessions.get(event.sessionId);
1695 if (session)
1696 {
1697 send(session, {
1698 type: MessageType.stationOpen,
1699 stationId: event.stationId
1700 });
1701 }
1702 continue;
1703 }
1704 if (event.type === "shop-open")
1705 {
1706 const session = sessions.get(event.sessionId);
1707 if (session)
1708 {
1709 send(session, {
1710 type: MessageType.shopOpen,
1711 npcEntityId: event.npcEntityId,
1712 displayName: event.displayName,
1713 sex: event.sex === "female" ? "female" : "male",
1714 buysItems: !!event.buysItems,
1715 stock: event.stock ?? []
1716 });
1717 }
1718 continue;
1719 }
1720 if (event.type === "shop-closed")
1721 {
1722 const session = sessions.get(event.sessionId);
1723 if (session)
1724 {
1725 send(session, {
1726 type: MessageType.shopClosed,
1727 npcEntityId: event.npcEntityId
1728 });
1729 }
1730 continue;
1731 }
1732 if (event.type === "market-open")
1733 {
1734 const session = sessions.get(event.sessionId);
1735 if (session)
1736 {
1737 send(session, {
1738 type: MessageType.marketOpen,
1739 displayName: event.displayName,
1740 orders: event.orders ?? [],
1741 catalog: event.catalog ?? []
1742 });
1743 }
1744 continue;
1745 }
1746 if (event.type === "market-closed")
1747 {
1748 const session = sessions.get(event.sessionId);
1749 if (session)
1750 { send(session, { type: MessageType.marketClosed }); }
1751 continue;
1752 }
1753 if (event.type === "bounty-snapshot")
1754 {
1755 const session = sessions.get(event.sessionId);
1756 if (session)
1757 {
1758 send(session, {
1759 type: MessageType.bountySnapshot,
1760 myAmountCopper: event.myAmountCopper | 0,
1761 myAmountLabel: event.myAmountLabel ?? "",
1762 message: event.message ?? "",
1763 raised: event.raised ?? null
1764 });
1765 }
1766 continue;
1767 }
1768 if (event.type === "bounty-closed")
1769 {
1770 const session = sessions.get(event.sessionId);
1771 if (session)
1772 { send(session, { type: MessageType.closeBounty }); }
1773 continue;
1774 }
1775 if (event.type === "character-bounty")
1776 {
1777 const session = sessions.get(event.sessionId);
1778 if (session)
1779 {
1780 send(session, {
1781 type: MessageType.characterBounty,
1782 target: event.target ?? null
1783 });
1784 }
1785 continue;
1786 }
1787 if (event.type === "barber-snapshot")
1788 {
1789 const session = sessions.get(event.sessionId);
1790 if (session)
1791 {
1792 send(session, {
1793 type: MessageType.barberSnapshot,
1794 sex: event.sex,
1795 styles: event.styles ?? [],
1796 hair: event.hair ?? null,
1797 message: event.message ?? ""
1798 });
1799 }
1800 continue;
1801 }
1802 if (event.type === "barber-closed")
1803 {
1804 const session = sessions.get(event.sessionId);
1805 if (session)
1806 { send(session, { type: MessageType.closeBarber }); }
1807 continue;
1808 }
1809 if (event.type === "market-trade")
1810 {
1811 for (const session of sessions.values())
1812 {
1813 if (
1814 session.characterId === event.buyerCharacterId
1815 || session.characterId === event.sellerCharacterId
1816 )
1817 {
1818 send(session, {
1819 type: MessageType.marketTrade,
1820 itemId: event.itemId,
1821 quantity: event.quantity,
1822 unitPrice: event.unitPrice,
1823 triggeringSide: event.triggeringSide
1824 });
1825 }
1826 }
1827 continue;
1828 }
1829 if (event.type === "item-bubble")
1830 {
1831 broadcastItemBubble(
1832 sessions,
1833 simulation,
1834 event.entityId,
1835 event.itemId,
1836 event.quantity
1837 );
1838 continue;
1839 }
1840 if (event.type === "gather-swing" || event.type === "tile-shove")
1841 {
1842 publishEntity({
1843 ...event,
1844 type: event.type
1845 });
1846 continue;
1847 }
1848 if (event.type === "chunk-delta")
1849 {
1850 publishEntity(event);
1851 continue;
1852 }
1853 if (event.type === "gather-complete")
1854 {
1855 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1856 if (session)
1857 {
1858 send(session, {
1859 type: MessageType.gatherComplete,
1860 kind: event.kind,
1861 materialId: event.materialId,
1862 itemId: event.itemId
1863 });
1864 }
1865 continue;
1866 }
1867 if (event.type === "entity-move" || event.type === "ground-item-appear" || event.type === "ground-item-despawn" || event.type === "entity-appearance" || event.type === "entity-despawn" || event.type === "entity-spawn" || event.type === "entity-skull" || event.type === "combat-swing" || event.type === "combat-hit" || event.type === "combat-miss" || event.type === "combat-block" || event.type === "combat-projectile" || event.type === "spell-projectile" || event.type === "spell-fizzle" || event.type === "spell-cast-flash" || event.type === "spell-light-appear" || event.type === "spell-light-update" || event.type === "spell-light-remove" || event.type === "spell-dark-appear" || event.type === "spell-dark-update" || event.type === "spell-dark-remove" || event.type === "entity-health" || event.type === "gather-swing" || event.type === "tile-shove" || event.type === "chunk-delta" || event.type === "skill-level-up")
1868 { publishEntity(event); }
1869 }
1870 if (simulation.tickIndex % simulation.settings.simulationTickHz === 0)
1871 { broadcastStatus(); }
1872 }
1873
1874 function publishReplication (events)
1875 {
1876 for (const event of events ?? [])
1877 { publishEntity(event); }
1878 }
1879
1880 function publishEntity (event)
1881 {
1882 const toDim = normalizeDimensionId(event.dimensionId
1883 ?? simulation.entityRecord(event.entityId)?.dimensionId
1884 ?? OVERWORLD_ID);
1885 const fromDim = event.fromDimensionId != null
1886 ? normalizeDimensionId(event.fromDimensionId)
1887 : toDim;
1888 const fromKey = event.fromTileX != null
1889 ? chunkKey(tileToChunk(event.fromTileX), tileToChunk(event.fromTileY), fromDim)
1890 : null;
1891 const toKey = event.tileX != null
1892 ? chunkKey(tileToChunk(event.tileX), tileToChunk(event.tileY), toDim)
1893 : null;
1894 for (const session of sessions.values())
1895 {
1896 if (!session.entityId)
1897 { continue; }
1898 const seesFrom = fromKey ? session.entitySubscribed.has(fromKey) : false;
1899 const seesTo = session.entitySubscribed.has(toKey);
1900 const seesStaticTo = session.staticSubscribed.has(toKey);
1901 if (event.type === "entity-spawn")
1902 {
1903 if (session.entityId === event.entityId || !seesTo)
1904 { continue; }
1905 send(session, spawnPayload(event));
1906 continue;
1907 }
1908 if (event.type === "entity-despawn")
1909 {
1910 if (session.entityId === event.entityId || (!seesTo && !seesFrom))
1911 { continue; }
1912 send(session, { type: MessageType.entityDespawn, entityId: event.entityId });
1913 continue;
1914 }
1915 if (event.type === "entity-appearance")
1916 {
1917 if (!seesTo)
1918 { continue; }
1919 send(session, {
1920 type: MessageType.entityAppearance,
1921 entityId: event.entityId,
1922 sprite: event.sprite,
1923 layers: event.layers ?? [],
1924 lightRadiusTiles: event.lightRadiusTiles ?? 0
1925 });
1926 continue;
1927 }
1928 if (event.type === "entity-skull")
1929 {
1930 if (!seesTo && session.entityId !== event.entityId)
1931 { continue; }
1932 send(session, {
1933 type: MessageType.entitySkull,
1934 entityId: event.entityId,
1935 skullValue: event.skullValue | 0
1936 });
1937 continue;
1938 }
1939 if (event.type === "ground-item-appear")
1940 {
1941 if (!seesTo)
1942 { continue; }
1943 if (!canCharacterSeeGroundItem(event, session.characterId))
1944 { continue; }
1945 send(session, { type: MessageType.groundItemAppear, ...event, type: MessageType.groundItemAppear });
1946 continue;
1947 }
1948 if (event.type === "ground-item-despawn")
1949 {
1950 if (!seesTo)
1951 { continue; }
1952 if (!canCharacterSeeGroundItem(event, session.characterId))
1953 { continue; }
1954 send(session, { type: MessageType.groundItemDespawn, groundItemId: event.groundItemId });
1955 continue;
1956 }
1957 if (event.type === "combat-swing" || event.type === "combat-hit" || event.type === "combat-miss" || event.type === "combat-block")
1958 {
1959 if (!seesTo && !seesFrom)
1960 { continue; }
1961 const type = event.type === "combat-swing"
1962 ? MessageType.combatSwing
1963 : event.type === "combat-hit"
1964 ? MessageType.combatHit
1965 : event.type === "combat-block"
1966 ? MessageType.combatBlock
1967 : MessageType.combatMiss;
1968 send(session, {
1969 type,
1970 attackerId: event.attackerId,
1971 targetId: event.targetId,
1972 damage: event.damage,
1973 health: event.health,
1974 maxHealth: event.maxHealth,
1975 tileX: event.tileX,
1976 tileY: event.tileY,
1977 fromTileX: event.fromTileX,
1978 fromTileY: event.fromTileY
1979 });
1980 continue;
1981 }
1982 if (event.type === "combat-projectile")
1983 {
1984 if (!seesTo && !seesFrom)
1985 { continue; }
1986 send(session, {
1987 type: MessageType.combatProjectile,
1988 attackerId: event.attackerId,
1989 targetId: event.targetId,
1990 fromTileX: event.fromTileX,
1991 fromTileY: event.fromTileY,
1992 tileX: event.tileX,
1993 tileY: event.tileY,
1994 durationMs: event.durationMs ?? 400,
1995 trackTarget: event.trackTarget !== false,
1996 shaftTint: event.shaftTint ?? null,
1997 tipTint: event.tipTint ?? null
1998 });
1999 continue;
2000 }
2001 if (event.type === "spell-projectile")
2002 {
2003 if (!seesTo && !seesFrom)
2004 { continue; }
2005 send(session, {
2006 type: MessageType.spellProjectile,
2007 casterId: event.casterId,
2008 targetId: event.targetId ?? null,
2009 spellId: event.spellId,
2010 fromTileX: event.fromTileX,
2011 fromTileY: event.fromTileY,
2012 tileX: event.tileX,
2013 tileY: event.tileY,
2014 durationMs: event.durationMs ?? 2000,
2015 sprite: event.sprite ?? null
2016 });
2017 continue;
2018 }
2019 if (event.type === "spell-fizzle")
2020 {
2021 if (!seesTo && !seesFrom)
2022 { continue; }
2023 send(session, {
2024 type: MessageType.spellFizzle,
2025 casterId: event.casterId,
2026 spellId: event.spellId,
2027 fromTileX: event.fromTileX,
2028 fromTileY: event.fromTileY,
2029 tileX: event.tileX,
2030 tileY: event.tileY
2031 });
2032 continue;
2033 }
2034 if (event.type === "spell-cast-flash")
2035 {
2036 if (!seesTo)
2037 { continue; }
2038 send(session, {
2039 type: MessageType.spellCastFlash,
2040 casterId: event.casterId,
2041 tileX: event.tileX,
2042 tileY: event.tileY,
2043 radiusTiles: event.radiusTiles ?? 1,
2044 durationMs: event.durationMs ?? 500,
2045 tier: event.tier ?? 1
2046 });
2047 continue;
2048 }
2049 if (event.type === "spell-light-appear" || event.type === "spell-light-update"
2050 || event.type === "spell-dark-appear" || event.type === "spell-dark-update")
2051 {
2052 if (!seesTo)
2053 { continue; }
2054 const isDark = event.type.startsWith("spell-dark");
2055 const appear = event.type.endsWith("appear");
2056 send(session, {
2057 type: appear
2058 ? (isDark ? MessageType.spellDarkAppear : MessageType.spellLightAppear)
2059 : (isDark ? MessageType.spellDarkUpdate : MessageType.spellLightUpdate),
2060 tileX: event.tileX,
2061 tileY: event.tileY,
2062 ownerEntityId: event.ownerEntityId,
2063 remainingMs: event.remainingMs ?? 0,
2064 rangeTiles: event.rangeTiles ?? 0,
2065 intensity: event.intensity ?? 0,
2066 expiresAt: event.expiresAt ?? 0,
2067 kind: isDark ? "dark" : "light"
2068 });
2069 continue;
2070 }
2071 if (event.type === "spell-light-remove" || event.type === "spell-dark-remove")
2072 {
2073 if (!seesTo)
2074 { continue; }
2075 send(session, {
2076 type: event.type === "spell-dark-remove"
2077 ? MessageType.spellDarkRemove
2078 : MessageType.spellLightRemove,
2079 tileX: event.tileX,
2080 tileY: event.tileY
2081 });
2082 continue;
2083 }
2084 if (event.type === "entity-health")
2085 {
2086 if (!seesTo && !seesFrom)
2087 { continue; }
2088 send(session, {
2089 type: MessageType.entityHealth,
2090 entityId: event.entityId,
2091 health: event.health,
2092 maxHealth: event.maxHealth
2093 });
2094 continue;
2095 }
2096 if (event.type === "gather-swing" || event.type === "tile-shove")
2097 {
2098 if (!seesTo && !seesFrom)
2099 { continue; }
2100 if (event.type === "gather-swing")
2101 {
2102 send(session, {
2103 type: MessageType.gatherSwing,
2104 attackerId: event.attackerId,
2105 tileX: event.tileX,
2106 tileY: event.tileY,
2107 fromTileX: event.fromTileX,
2108 fromTileY: event.fromTileY,
2109 toolItemId: event.toolItemId ?? null
2110 });
2111 }
2112 else
2113 {
2114 send(session, {
2115 type: MessageType.tileShove,
2116 attackerId: event.attackerId,
2117 tileX: event.tileX,
2118 tileY: event.tileY,
2119 fromTileX: event.fromTileX,
2120 fromTileY: event.fromTileY
2121 });
2122 }
2123 continue;
2124 }
2125 if (event.type === "skill-level-up")
2126 {
2127 if (session.entityId !== event.entityId && !seesTo)
2128 { continue; }
2129 send(session, {
2130 type: MessageType.skillLevelUp,
2131 entityId: event.entityId,
2132 characterId: event.characterId,
2133 skillId: event.skillId,
2134 level: event.level,
2135 previousLevel: event.previousLevel,
2136 displayName: event.displayName,
2137 icon: event.icon
2138 });
2139 continue;
2140 }
2141 if (event.type === "chunk-delta")
2142 {
2143 if (!seesStaticTo)
2144 { continue; }
2145 send(session, {
2146 type: MessageType.chunkDelta,
2147 chunkX: event.chunkX,
2148 chunkY: event.chunkY,
2149 tiles: [{
2150 localX: event.localX,
2151 localY: event.localY,
2152 block: event.block
2153 }]
2154 });
2155 continue;
2156 }
2157 if (event.type !== "entity-move")
2158 { continue; }
2159 if (seesTo)
2160 {
2161 if (!seesFrom)
2162 { send(session, spawnPayload(event)); }
2163 else
2164 {
2165 send(session, {
2166 type: MessageType.entityMove,
2167 entityId: event.entityId,
2168 tileX: event.tileX,
2169 tileY: event.tileY,
2170 worldX: event.worldX,
2171 worldY: event.worldY,
2172 gait: event.gait,
2173 lerpMs: event.lerpMs,
2174 freeFlight: !!event.freeFlight
2175 });
2176 }
2177 }
2178 else if (seesFrom)
2179 { send(session, { type: MessageType.entityDespawn, entityId: event.entityId }); }
2180 if (session.entityId === event.entityId)
2181 {
2182 const crossedDimension = event.fromDimensionId != null
2183 && event.dimensionId != null
2184 && normalizeDimensionId(event.fromDimensionId) !== normalizeDimensionId(event.dimensionId);
2185 if (!crossedDimension)
2186 { syncSubscriptions(session, false); }
2187 }
2188 }
2189 }
2190
2191 function spawnPayload (event)
2192 {
2193 const record = simulation.entityRecord(event.entityId) ?? event;
2194 return {
2195 type: MessageType.entitySpawn,
2196 entityId: event.entityId,
2197 characterId: record.characterId ?? event.characterId ?? null,
2198 accountId: record.accountId ?? event.accountId ?? null,
2199 tileX: event.tileX ?? record.tileX,
2200 tileY: event.tileY ?? record.tileY,
2201 worldX: event.worldX ?? record.worldX,
2202 worldY: event.worldY ?? record.worldY,
2203 gait: event.gait ?? record.gait,
2204 sex: record.sex ?? event.sex ?? null,
2205 firstName: record.firstName ?? event.firstName ?? "",
2206 lastName: record.lastName ?? event.lastName ?? "",
2207 sprite: record.sprite ?? event.sprite ?? null,
2208 layers: record.layers ?? event.layers ?? [],
2209 mobTypeId: record.mobTypeId ?? event.mobTypeId ?? null,
2210 canFight: !!(record.canFight ?? event.canFight),
2211 hostile: !!(record.hostile ?? event.hostile),
2212 talkable: !!(record.talkable ?? event.talkable),
2213 hasDialogue: !!(record.hasDialogue ?? event.hasDialogue),
2214 hasShop: !!(record.hasShop ?? event.hasShop),
2215 untargetable: !!(record.untargetable ?? event.untargetable),
2216 freeFlight: !!(record.freeFlight ?? event.freeFlight),
2217 health: record.health ?? event.health,
2218 maxHealth: record.maxHealth ?? event.maxHealth,
2219 lightRadiusTiles: record.lightRadiusTiles ?? event.lightRadiusTiles ?? 0,
2220 skullValue: record.skullValue | 0
2221 };
2222 }
2223
2224 return {
2225 sessions,
2226 onTickResult,
2227 wss,
2228 broadcastRestartStatus,
2229 setDraining (value)
2230 {
2231 draining = !!value;
2232 },
2233 async shutdown ()
2234 {
2235 draining = true;
2236 await Promise.all([...sessions.values()].map(async (session) =>
2237 {
2238 await sendAsync(session, {
2239 type: MessageType.forceLogout,
2240 reason: "Server shutting down."
2241 });
2242 leaveWorld(session);
2243 await closeAsync(session, 1001, "Server shutting down.");
2244 }));
2245 sessions.clear();
2246 await simulation.shutdown();
2247 }
2248 };
2249}
2250
2251function send (session, payload)
2252{
2253 if (session.socket.readyState === 1)
2254 { session.socket.send(JSON.stringify(payload)); }
2255}
2256
2257function sendAsync (session, payload)
2258{
2259 return new Promise((resolve) =>
2260 {
2261 if (session.socket.readyState !== 1)
2262 {
2263 resolve();
2264 return;
2265 }
2266 session.socket.send(JSON.stringify(payload), () => resolve());
2267 });
2268}
2269
2270function closeAsync (session, code, reason)
2271{
2272 return new Promise((resolve) =>
2273 {
2274 if (session.socket.readyState !== 1)
2275 {
2276 resolve();
2277 return;
2278 }
2279 session.socket.once("close", resolve);
2280 try
2281 { session.socket.close(code, reason); }
2282 catch
2283 { resolve(); }
2284 });
2285}