BlueGit

timfa questward

Files

questward / server / src / gateway / websocket.js

websocket.js

websocket.js 72.0 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 { publicSkillsPayload } 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, gifts, 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.payBounty:
332 requirePlaying(session);
333 simulation.enqueue(session.id, {
334 type: "pay-bounty",
335 characterId: session.characterId,
336 amountCopper: message.amountCopper
337 });
338 break;
339 case MessageType.getCharacterBounty:
340 requirePlaying(session);
341 simulation.enqueue(session.id, {
342 type: "get-character-bounty",
343 characterId: session.characterId,
344 targetCharacterId: message.characterId,
345 firstName: message.firstName,
346 lastName: message.lastName
347 });
348 break;
349 case MessageType.closeBounty:
350 requirePlaying(session);
351 simulation.enqueue(session.id, {
352 type: "close-bounty",
353 characterId: session.characterId
354 });
355 break;
356 case MessageType.openBarber:
357 requirePlaying(session);
358 simulation.enqueue(session.id, {
359 type: "open-barber",
360 characterId: session.characterId
361 });
362 break;
363 case MessageType.setHair:
364 requirePlaying(session);
365 simulation.enqueue(session.id, {
366 type: "set-hair",
367 characterId: session.characterId,
368 hair: message.hair ?? null
369 });
370 break;
371 case MessageType.closeBarber:
372 requirePlaying(session);
373 simulation.enqueue(session.id, {
374 type: "close-barber",
375 characterId: session.characterId
376 });
377 break;
378 case MessageType.openCauldron:
379 requirePlaying(session);
380 simulation.enqueue(session.id, {
381 type: "open-cauldron",
382 characterId: session.characterId
383 });
384 break;
385 case MessageType.openFurnace:
386 requirePlaying(session);
387 simulation.enqueue(session.id, {
388 type: "open-station",
389 characterId: session.characterId,
390 stationId: CraftingStationId.furnace
391 });
392 break;
393 case MessageType.openStation:
394 {
395 requirePlaying(session);
396 const stationId = typeof message.stationId === "string"
397 ? message.stationId
398 : null;
399 if (!stationId || !craftingStationDefinition(stationId))
400 { break; }
401 simulation.enqueue(session.id, {
402 type: "open-station",
403 characterId: session.characterId,
404 stationId
405 });
406 break;
407 }
408 case MessageType.mine:
409 requirePlaying(session);
410 simulation.enqueue(session.id, {
411 type: "mine",
412 characterId: session.characterId,
413 tileX: message.tileX | 0,
414 tileY: message.tileY | 0
415 });
416 break;
417 case MessageType.chop:
418 requirePlaying(session);
419 simulation.enqueue(session.id, {
420 type: "chop",
421 characterId: session.characterId,
422 tileX: message.tileX | 0,
423 tileY: message.tileY | 0
424 });
425 break;
426 case MessageType.pick:
427 requirePlaying(session);
428 simulation.enqueue(session.id, {
429 type: "pick",
430 characterId: session.characterId,
431 tileX: message.tileX | 0,
432 tileY: message.tileY | 0
433 });
434 break;
435 case MessageType.cancelGather:
436 requirePlaying(session);
437 simulation.enqueue(session.id, {
438 type: "cancel-gather",
439 characterId: session.characterId
440 });
441 break;
442 case MessageType.startCraft:
443 requirePlaying(session);
444 simulation.enqueue(session.id, {
445 type: "start-craft",
446 characterId: session.characterId,
447 stationId: message.stationId,
448 recipeId: message.recipeId,
449 clothTier: message.clothTier ?? null,
450 dyeSlotIndex: message.dyeSlotIndex ?? null,
451 batchCount: message.batchCount ?? null,
452 batchAll: !!message.batchAll
453 });
454 break;
455 case MessageType.startFire:
456 requirePlaying(session);
457 simulation.enqueue(session.id, {
458 type: "start-fire",
459 characterId: session.characterId,
460 groundItemId: message.groundItemId | 0
461 });
462 break;
463 case MessageType.debarkLog:
464 requirePlaying(session);
465 simulation.enqueue(session.id, {
466 type: "debark-log",
467 characterId: session.characterId,
468 groundItemId: message.groundItemId | 0
469 });
470 break;
471 case MessageType.shear:
472 requirePlaying(session);
473 simulation.enqueue(session.id, {
474 type: "shear",
475 characterId: session.characterId,
476 targetEntityId: message.targetEntityId | 0
477 });
478 break;
479 case MessageType.startFish:
480 requirePlaying(session);
481 simulation.enqueue(session.id, {
482 type: "start-fish",
483 characterId: session.characterId,
484 tileX: message.tileX | 0,
485 tileY: message.tileY | 0
486 });
487 break;
488 case MessageType.cancelCraft:
489 requirePlaying(session);
490 simulation.enqueue(session.id, {
491 type: "cancel-craft",
492 characterId: session.characterId
493 });
494 break;
495 case MessageType.cauldronSetSlot:
496 requirePlaying(session);
497 simulation.enqueue(session.id, {
498 type: "cauldron-set-slot",
499 characterId: session.characterId,
500 slotIndex: message.slotIndex | 0,
501 itemId: message.itemId | 0,
502 quantity: message.quantity | 0,
503 instance: message.instance ?? null
504 });
505 break;
506 case MessageType.cauldronSetDyeSlot:
507 requirePlaying(session);
508 simulation.enqueue(session.id, {
509 type: "cauldron-set-dye-slot",
510 characterId: session.characterId,
511 slotIndex: message.slotIndex | 0,
512 itemId: message.itemId | 0,
513 quantity: message.quantity | 0,
514 instance: message.instance ?? null
515 });
516 break;
517 case MessageType.cauldronInsert:
518 requirePlaying(session);
519 simulation.enqueue(session.id, {
520 type: "cauldron-insert",
521 characterId: session.characterId,
522 itemId: message.itemId | 0,
523 quantity: message.quantity | 0,
524 instance: message.instance ?? null
525 });
526 break;
527 case MessageType.cauldronAction:
528 requirePlaying(session);
529 simulation.enqueue(session.id, {
530 type: "cauldron-action",
531 characterId: session.characterId,
532 action: message.action
533 });
534 break;
535 case MessageType.cauldronBottle:
536 requirePlaying(session);
537 simulation.enqueue(session.id, {
538 type: "cauldron-bottle",
539 characterId: session.characterId
540 });
541 break;
542 case MessageType.cauldronCreateDye:
543 requirePlaying(session);
544 simulation.enqueue(session.id, {
545 type: "cauldron-create-dye",
546 characterId: session.characterId,
547 confirmOverflow: !!message.confirmOverflow,
548 flowers: Array.isArray(message.flowers) ? message.flowers : []
549 });
550 break;
551 case MessageType.cauldronClear:
552 requirePlaying(session);
553 simulation.enqueue(session.id, {
554 type: "cauldron-clear",
555 characterId: session.characterId
556 });
557 break;
558 case MessageType.cauldronClearDye:
559 requirePlaying(session);
560 simulation.enqueue(session.id, {
561 type: "cauldron-clear-dye",
562 characterId: session.characterId
563 });
564 break;
565 case MessageType.cauldronSaveRecipe:
566 requirePlaying(session);
567 simulation.enqueue(session.id, {
568 type: "cauldron-save-recipe",
569 characterId: session.characterId
570 });
571 break;
572 case MessageType.cauldronClose:
573 requirePlaying(session);
574 simulation.enqueue(session.id, {
575 type: "cauldron-close",
576 characterId: session.characterId
577 });
578 break;
579 case MessageType.bankDeposit:
580 requirePlaying(session);
581 simulation.enqueue(session.id, {
582 type: "bank-deposit",
583 characterId: session.characterId,
584 slotIndex: message.slotIndex | 0,
585 quantity: message.quantity ?? null
586 });
587 break;
588 case MessageType.bankWithdraw:
589 requirePlaying(session);
590 simulation.enqueue(session.id, {
591 type: "bank-withdraw",
592 characterId: session.characterId,
593 slotIndex: message.slotIndex | 0,
594 quantity: message.quantity ?? null
595 });
596 break;
597 case MessageType.getBlankCheques:
598 requirePlaying(session);
599 simulation.enqueue(session.id, {
600 type: "get-blank-cheques",
601 characterId: session.characterId
602 });
603 break;
604 case MessageType.returnBlankCheques:
605 requirePlaying(session);
606 simulation.enqueue(session.id, {
607 type: "return-blank-cheques",
608 characterId: session.characterId,
609 slotIndex: message.slotIndex | 0,
610 quantity: message.quantity ?? null
611 });
612 break;
613 case MessageType.writeCheque:
614 requirePlaying(session);
615 simulation.enqueue(session.id, {
616 type: "write-cheque",
617 characterId: session.characterId,
618 slotIndex: message.slotIndex | 0,
619 vaultSlotIndex: message.vaultSlotIndex | 0,
620 quantity: message.quantity ?? 1
621 });
622 break;
623 case MessageType.redeemCheque:
624 requirePlaying(session);
625 simulation.enqueue(session.id, {
626 type: "redeem-cheque",
627 characterId: session.characterId,
628 slotIndex: message.slotIndex | 0
629 });
630 break;
631 case MessageType.claimInheritance:
632 requirePlaying(session);
633 {
634 const inheritance = stateDb.getInheritance(session.account.account_id);
635 simulation.enqueue(session.id, {
636 type: "claim-inheritance",
637 characterId: session.characterId,
638 stacks: (inheritance.slots ?? []).filter(Boolean)
639 });
640 }
641 break;
642 case MessageType.attack:
643 requirePlaying(session);
644 simulation.enqueue(session.id, {
645 type: "attack",
646 characterId: session.characterId,
647 targetEntityId: message.targetEntityId | 0
648 });
649 break;
650 case MessageType.cancelAttack:
651 requirePlaying(session);
652 simulation.enqueue(session.id, {
653 type: "cancel-attack",
654 characterId: session.characterId
655 });
656 break;
657 case MessageType.setSpellFavorite:
658 requirePlaying(session);
659 simulation.enqueue(session.id, {
660 type: "set-spell-favorite",
661 characterId: session.characterId,
662 spellId: message.spellId
663 });
664 break;
665 case MessageType.reorderSpellFavorites:
666 requirePlaying(session);
667 simulation.enqueue(session.id, {
668 type: "reorder-spell-favorites",
669 characterId: session.characterId,
670 favoriteSpellIds: Array.isArray(message.favoriteSpellIds)
671 ? message.favoriteSpellIds
672 : (message.favorites ?? [])
673 });
674 break;
675 case MessageType.setSpellAutoCast:
676 requirePlaying(session);
677 simulation.enqueue(session.id, {
678 type: "set-spell-autocast",
679 characterId: session.characterId,
680 enabled: !!message.enabled
681 });
682 break;
683 case MessageType.armSpell:
684 requirePlaying(session);
685 simulation.enqueue(session.id, {
686 type: "arm-spell",
687 characterId: session.characterId,
688 spellId: message.spellId
689 });
690 break;
691 case MessageType.cancelArmSpell:
692 requirePlaying(session);
693 simulation.enqueue(session.id, {
694 type: "cancel-arm-spell",
695 characterId: session.characterId
696 });
697 break;
698 case MessageType.castSpellTile:
699 requirePlaying(session);
700 simulation.enqueue(session.id, {
701 type: "cast-spell-tile",
702 characterId: session.characterId,
703 spellId: message.spellId,
704 tileX: message.tileX | 0,
705 tileY: message.tileY | 0
706 });
707 break;
708 case MessageType.castSpellEntity:
709 requirePlaying(session);
710 simulation.enqueue(session.id, {
711 type: "cast-spell-entity",
712 characterId: session.characterId,
713 spellId: message.spellId,
714 targetEntityId: message.targetEntityId | 0
715 });
716 break;
717 case MessageType.readSpellbook:
718 requirePlaying(session);
719 simulation.enqueue(session.id, {
720 type: "read-spellbook",
721 characterId: session.characterId,
722 slotIndex: message.slotIndex | 0
723 });
724 break;
725 case MessageType.interact:
726 requirePlaying(session);
727 simulation.enqueue(session.id, {
728 type: "interact",
729 characterId: session.characterId,
730 targetEntityId: message.targetEntityId | 0,
731 purpose: message.purpose === "shop" || message.purpose === "talk"
732 ? message.purpose
733 : null
734 });
735 break;
736 case MessageType.buyFromShop:
737 requirePlaying(session);
738 simulation.enqueue(session.id, {
739 type: "buy-from-shop",
740 characterId: session.characterId,
741 npcEntityId: message.npcEntityId | 0,
742 itemId: message.itemId | 0,
743 quantity: message.quantity | 0 || 1,
744 listingId: typeof message.listingId === "string" ? message.listingId : null,
745 source: typeof message.source === "string" ? message.source : null
746 });
747 break;
748 case MessageType.sellToShop:
749 requirePlaying(session);
750 simulation.enqueue(session.id, {
751 type: "sell-to-shop",
752 characterId: session.characterId,
753 npcEntityId: message.npcEntityId | 0,
754 slotIndex: message.slotIndex | 0,
755 quantity: message.quantity | 0 || 1
756 });
757 break;
758 case MessageType.closeShop:
759 requirePlaying(session);
760 simulation.enqueue(session.id, {
761 type: "close-shop",
762 characterId: session.characterId,
763 npcEntityId: message.npcEntityId | 0
764 });
765 break;
766 case MessageType.openMarket:
767 requirePlaying(session);
768 simulation.enqueue(session.id, {
769 type: "open-market",
770 characterId: session.characterId
771 });
772 break;
773 case MessageType.closeMarket:
774 requirePlaying(session);
775 simulation.enqueue(session.id, {
776 type: "close-market",
777 characterId: session.characterId
778 });
779 break;
780 case MessageType.placeMarketSell:
781 requirePlaying(session);
782 simulation.enqueue(session.id, {
783 type: "place-market-sell",
784 characterId: session.characterId,
785 slotIndex: message.slotIndex | 0,
786 quantity: message.quantity | 0 || 1,
787 minUnitPrice: message.minUnitPrice | 0
788 });
789 break;
790 case MessageType.placeMarketBuy:
791 requirePlaying(session);
792 simulation.enqueue(session.id, {
793 type: "place-market-buy",
794 characterId: session.characterId,
795 itemId: message.itemId | 0,
796 listingKey: message.listingKey ?? null,
797 quantity: message.quantity | 0 || 1,
798 maxUnitPrice: message.maxUnitPrice | 0
799 });
800 break;
801 case MessageType.cancelMarketOrder:
802 requirePlaying(session);
803 simulation.enqueue(session.id, {
804 type: "cancel-market-order",
805 characterId: session.characterId,
806 orderId: message.orderId | 0
807 });
808 break;
809 case MessageType.follow:
810 requirePlaying(session);
811 simulation.enqueue(session.id, {
812 type: "follow",
813 characterId: session.characterId,
814 targetEntityId: message.targetEntityId | 0
815 });
816 break;
817 case MessageType.cancelFollow:
818 requirePlaying(session);
819 simulation.enqueue(session.id, {
820 type: "cancel-follow",
821 characterId: session.characterId
822 });
823 break;
824 case MessageType.jewelryTeleport:
825 requirePlaying(session);
826 simulation.enqueue(session.id, {
827 type: "jewelry-teleport",
828 characterId: session.characterId,
829 destination: message.destination === "bank" ? "bank" : "church"
830 });
831 break;
832 case MessageType.tradeRequest:
833 requirePlaying(session);
834 simulation.enqueue(session.id, {
835 type: "trade-request",
836 characterId: session.characterId,
837 targetEntityId: message.targetEntityId | 0
838 });
839 break;
840 case MessageType.tradeRespondInvite:
841 requirePlaying(session);
842 simulation.enqueue(session.id, {
843 type: "trade-respond-invite",
844 characterId: session.characterId,
845 inviteId: message.inviteId,
846 accept: !!message.accept
847 });
848 break;
849 case MessageType.tradeOfferSet:
850 requirePlaying(session);
851 simulation.enqueue(session.id, {
852 type: "trade-offer-set",
853 characterId: session.characterId,
854 bagSlotIndex: message.bagSlotIndex | 0,
855 quantity: message.quantity | 0 || 1
856 });
857 break;
858 case MessageType.tradeOfferRemove:
859 requirePlaying(session);
860 simulation.enqueue(session.id, {
861 type: "trade-offer-remove",
862 characterId: session.characterId,
863 bagSlotIndex: message.bagSlotIndex | 0
864 });
865 break;
866 case MessageType.tradeAccept:
867 requirePlaying(session);
868 simulation.enqueue(session.id, {
869 type: "trade-accept",
870 characterId: session.characterId
871 });
872 break;
873 case MessageType.tradeCancel:
874 requirePlaying(session);
875 simulation.enqueue(session.id, {
876 type: "trade-cancel",
877 characterId: session.characterId
878 });
879 break;
880 case MessageType.sendPigeon:
881 requirePlaying(session);
882 {
883 const result = simulation.dispatchPigeon({
884 characterId: session.characterId,
885 destination: message.destination,
886 cargo: message.cargo
887 });
888 send(session, {
889 type: MessageType.pigeonDispatched,
890 courierId: result.transit.courierId,
891 destinationKind: result.transit.destinationKind,
892 destinationCharacterId: result.transit.destinationCharacterId
893 });
894 send(session, { type: MessageType.inventory, ...result.bag });
895 }
896 break;
897 case MessageType.searchCharacter:
898 requirePlaying(session);
899 {
900 const character = friends.findByFullName(message.firstName, message.lastName);
901 send(session, {
902 type: MessageType.characterSearchResult,
903 character: character ?? null
904 });
905 }
906 break;
907 case MessageType.writeLetter:
908 requirePlaying(session);
909 simulation.enqueue(session.id, {
910 type: "write-letter",
911 characterId: session.characterId,
912 slotIndex: message.slotIndex,
913 body: message.body
914 });
915 break;
916 case MessageType.editLetter:
917 requirePlaying(session);
918 simulation.enqueue(session.id, {
919 type: "edit-letter",
920 characterId: session.characterId,
921 slotIndex: message.slotIndex,
922 body: message.body
923 });
924 break;
925 case MessageType.openLetter:
926 requirePlaying(session);
927 simulation.enqueue(session.id, {
928 type: "open-letter",
929 characterId: session.characterId,
930 slotIndex: message.slotIndex
931 });
932 break;
933 case MessageType.editorLoadChunk:
934 requireAdmin(session);
935 send(session, {
936 type: MessageType.editorChunk,
937 ...editor.loadChunk(message.chunkX | 0, message.chunkY | 0, message.dimensionId)
938 });
939 break;
940 case MessageType.editorSaveChunk:
941 requireAdmin(session);
942 send(session, {
943 type: MessageType.editorChunk,
944 ...editor.saveChunk(
945 message.chunkX | 0,
946 message.chunkY | 0,
947 message.draft,
948 session.authSubject,
949 message.dimensionId
950 )
951 });
952 break;
953 case MessageType.editorListDimensions:
954 case "EDITOR_LIST_DIMENSIONS":
955 requireAdmin(session);
956 try
957 {
958 send(session, { type: MessageType.editorDimensions, ...editor.listDimensions() });
959 }
960 catch (err)
961 {
962 send(session, { type: MessageType.error, message: err.userFacing ? err.message : "Failed to list dimensions." });
963 }
964 break;
965 case MessageType.editorCreateDimension:
966 case "EDITOR_CREATE_DIMENSION":
967 requireAdmin(session);
968 send(session, {
969 type: MessageType.editorDimensions,
970 ...editor.createDimension(message.dimensionId, message.displayName, session.authSubject)
971 });
972 break;
973 case MessageType.editorSaveDimension:
974 case "EDITOR_SAVE_DIMENSION":
975 requireAdmin(session);
976 send(session, {
977 type: MessageType.editorDimensions,
978 ...editor.saveDimension(message.dimension ?? message, session.authSubject)
979 });
980 break;
981 case MessageType.editorSoftDeleteDimension:
982 case "EDITOR_SOFT_DELETE_DIMENSION":
983 requireAdmin(session);
984 send(session, {
985 type: MessageType.editorDimensions,
986 ...editor.softDeleteDimension(message.dimensionId, session.authSubject)
987 });
988 break;
989 case MessageType.editorCancelDimensionDeletion:
990 case "EDITOR_CANCEL_DIMENSION_DELETION":
991 requireAdmin(session);
992 send(session, {
993 type: MessageType.editorDimensions,
994 ...editor.cancelDimensionDeletion(message.dimensionId, session.authSubject)
995 });
996 break;
997 case MessageType.editorLoadSettings:
998 requireAdmin(session);
999 send(session, {
1000 type: MessageType.editorSettings,
1001 ...editor.loadSettings(),
1002 itemLastSales: simulation.itemLastSalesSnapshot?.() ?? {}
1003 });
1004 break;
1005 case MessageType.editorLoadGameAdmins:
1006 requireAdmin(session);
1007 send(session, {
1008 type: MessageType.editorGameAdmins,
1009 admins: listPublicGameAdmins()
1010 });
1011 break;
1012 case MessageType.editorGrantGameAdmin:
1013 requireAdmin(session);
1014 {
1015 const updated = stateDb.grantGameAdminByUsername(message.username);
1016 refreshAccountAdminSessions(updated.auth_subject);
1017 send(session, {
1018 type: MessageType.editorGameAdmins,
1019 admins: listPublicGameAdmins()
1020 });
1021 }
1022 break;
1023 case MessageType.editorRevokeGameAdmin:
1024 requireAdmin(session);
1025 {
1026 const target = String(message.authSubject ?? "").trim();
1027 if (!target)
1028 { throw userError("Admin account is required."); }
1029 if (target === session.authSubject && !message.confirmSelf)
1030 { throw userError("Confirm removing your own admin access."); }
1031 const updated = stateDb.setGameAdmin(target, false);
1032 refreshAccountAdminSessions(updated.auth_subject);
1033 send(session, {
1034 type: MessageType.editorGameAdmins,
1035 admins: listPublicGameAdmins()
1036 });
1037 }
1038 break;
1039 case MessageType.editorConsoleSubscribe:
1040 requireAdmin(session);
1041 session.consoleSubscribed = true;
1042 send(session, {
1043 type: MessageType.editorConsoleSnapshot,
1044 lines: getConsoleSnapshot(800)
1045 });
1046 break;
1047 case MessageType.editorSaveSettings:
1048 requireAdmin(session);
1049 {
1050 const saved = editor.saveSettings(message.settings ?? {}, session.authSubject);
1051 simulation.applySettings(saved.settings, {
1052 grantInitialQuests: Object.prototype.hasOwnProperty.call(saved.changed ?? {}, "initialQuests")
1053 });
1054 broadcastStatus();
1055 broadcastSettings(saved);
1056 }
1057 break;
1058 case MessageType.editorApplyRevision:
1059 requireAdmin(session);
1060 if (!editor.revisionStatus().pendingRevisionId)
1061 {
1062 send(session, { type: MessageType.error, message: "Nothing pending to apply." });
1063 break;
1064 }
1065 {
1066 const appliedRevisionId = editor.applyPendingRevision();
1067 simulation.reloadWorld();
1068 for (const other of sessions.values())
1069 {
1070 if (other.entityId)
1071 { syncSubscriptions(other, true); }
1072 }
1073 broadcastStatus();
1074 send(session, {
1075 type: MessageType.editorRevisionApplied,
1076 ...editor.revisionStatus(),
1077 appliedRevisionId
1078 });
1079 }
1080 break;
1081 case MessageType.editorRestartNow:
1082 requireAdmin(session);
1083 deploy?.requestRestartNow?.("admin-editor");
1084 break;
1085 case MessageType.editorLoadQuests:
1086 requireAdmin(session);
1087 send(session, { type: MessageType.editorQuests, ...editor.loadQuests() });
1088 break;
1089 case MessageType.editorSaveQuest:
1090 requireAdmin(session);
1091 send(session, {
1092 type: MessageType.editorQuests,
1093 ...editor.saveQuest(message.quest ?? message, session.authSubject)
1094 });
1095 break;
1096 case MessageType.editorDeleteQuest:
1097 requireAdmin(session);
1098 send(session, {
1099 type: MessageType.editorQuests,
1100 ...editor.deleteQuest(message.questId, session.authSubject)
1101 });
1102 break;
1103 case MessageType.editorLoadDialogues:
1104 requireAdmin(session);
1105 send(session, { type: MessageType.editorDialogues, ...editor.loadDialogues() });
1106 break;
1107 case MessageType.editorSaveDialogue:
1108 requireAdmin(session);
1109 send(session, {
1110 type: MessageType.editorDialogues,
1111 ...editor.saveDialogue(message.dialogue ?? message, session.authSubject)
1112 });
1113 break;
1114 case MessageType.editorDeleteDialogue:
1115 requireAdmin(session);
1116 send(session, {
1117 type: MessageType.editorDialogues,
1118 ...editor.deleteDialogue(message.dialogueId, session.authSubject)
1119 });
1120 break;
1121 case MessageType.editorSearchGiftCharacters:
1122 requireAdmin(session);
1123 send(session, {
1124 type: MessageType.editorGiftCharacters,
1125 query: String(message.query ?? ""),
1126 ...gifts.search(message.query)
1127 });
1128 break;
1129 case MessageType.editorSendGift:
1130 requireAdmin(session);
1131 send(session, {
1132 type: MessageType.editorGiftSent,
1133 ...gifts.sendGift({
1134 characterId: message.characterId,
1135 message: message.message,
1136 items: message.items
1137 })
1138 });
1139 break;
1140 case MessageType.dialogueChoose:
1141 requirePlaying(session);
1142 simulation.enqueue(session.id, {
1143 type: "dialogue-choose",
1144 characterId: session.characterId,
1145 trigger: String(message.trigger ?? "")
1146 });
1147 break;
1148 case MessageType.dialogueAdvance:
1149 requirePlaying(session);
1150 simulation.enqueue(session.id, {
1151 type: "dialogue-advance",
1152 characterId: session.characterId
1153 });
1154 break;
1155 case MessageType.closeDialogue:
1156 requirePlaying(session);
1157 simulation.enqueue(session.id, {
1158 type: "close-dialogue",
1159 characterId: session.characterId
1160 });
1161 break;
1162 case MessageType.requestQuests:
1163 requirePlaying(session);
1164 simulation.enqueue(session.id, {
1165 type: "request-quests",
1166 characterId: session.characterId
1167 });
1168 break;
1169 case MessageType.setGraphicsSettings:
1170 {
1171 const next = normalizeGraphicsSettings({
1172 viewDistance: message.viewDistance ?? session.viewDistance
1173 });
1174 const changed = next.viewDistance !== session.viewDistance;
1175 session.viewDistance = next.viewDistance;
1176 if (changed && session.entityId)
1177 { syncSubscriptions(session, true); }
1178 }
1179 break;
1180 default:
1181 send(session, { type: MessageType.error, message: `Unknown message ${message.type}` });
1182 }
1183 }
1184
1185 function enterWorld (session, characterId)
1186 {
1187 if (draining || deploy?.isDraining?.())
1188 {
1189 const error = new Error("The server is restarting for an update. Please try again in a moment.");
1190 error.userFacing = true;
1191 throw error;
1192 }
1193 leaveWorld(session);
1194 const character = characters.getOwned(session.account.account_id, characterId);
1195 if (character.deletion_scheduled_at)
1196 {
1197 const error = new Error("That character is marked for deletion.");
1198 error.userFacing = true;
1199 throw error;
1200 }
1201 const targetCharacterId = character.character_id;
1202 let handoffEntityId = null;
1203 for (const other of [...sessions.values()])
1204 {
1205 if (other === session || other.account.account_id !== session.account.account_id || !other.characterId)
1206 { continue; }
1207 const sameCharacter = other.characterId === targetCharacterId;
1208 if (sameCharacter && simulation.isCharacterInWorld(targetCharacterId))
1209 { handoffEntityId = simulation.entityForCharacter(targetCharacterId); }
1210 disconnectPlayingSession(other, {
1211 despawn: !sameCharacter,
1212 reason: sameCharacter
1213 ? "This character was opened in another window."
1214 : "Logged in from another window."
1215 });
1216 }
1217 session.characterId = targetCharacterId;
1218 if (handoffEntityId == null && simulation.isCharacterInWorld(targetCharacterId))
1219 { handoffEntityId = simulation.entityForCharacter(targetCharacterId); }
1220 if (handoffEntityId != null)
1221 {
1222 const entityId = simulation.reattachCharacterSession(targetCharacterId, session.id);
1223 if (!entityId)
1224 {
1225 const error = new Error("Could not resume that character. Please try again.");
1226 error.userFacing = true;
1227 throw error;
1228 }
1229 session.entityId = entityId;
1230 }
1231 else
1232 { session.entityId = simulation.spawnCharacter(session.id, character); }
1233 sendEnterWorld(session, character);
1234 notifyFriendPresence(session.account?.account_id);
1235 }
1236
1237 function sendEnterWorld (session, character)
1238 {
1239 const spawned = simulation.entityRecord(session.entityId);
1240 const enterDim = normalizeDimensionId(spawned.dimensionId ?? OVERWORLD_ID);
1241 const dimRecord = simulation.getDimensionRecord?.(enterDim);
1242 send(session, {
1243 type: MessageType.enterWorld,
1244 entityId: session.entityId,
1245 characterId: session.characterId,
1246 accountId: session.account?.account_id ?? null,
1247 tileX: spawned.tileX,
1248 tileY: spawned.tileY,
1249 dimensionId: enterDim,
1250 lightingMode: dimRecord?.lightingMode ?? "dayNight",
1251 seasonMode: dimRecord?.seasonMode ?? "auto",
1252 gait: spawned.gait,
1253 sex: spawned.sex,
1254 firstName: spawned.firstName,
1255 lastName: spawned.lastName,
1256 layers: spawned.layers ?? [],
1257 health: spawned.health,
1258 maxHealth: spawned.maxHealth,
1259 skullValue: spawned.skullValue | 0,
1260 settings: simulation.settings,
1261 worldTime: simulation.worldTime(),
1262 restartStatus: deploy?.getStatus?.() ?? { scheduled: false }
1263 });
1264 syncSubscriptions(session, true);
1265 send(session, { type: MessageType.friends, ...friendsPayload(session.characterId) });
1266 const bag = simulation.bagOf(session.entityId);
1267 if (bag)
1268 { send(session, { type: MessageType.inventory, ...bag }); }
1269 const skills = simulation.skillsOf(session.entityId);
1270 if (skills)
1271 { send(session, { type: MessageType.skills, ...publicSkillsPayload(skills) }); }
1272 const spellView = simulation.spellsOf(session.entityId);
1273 if (spellView)
1274 {
1275 send(session, {
1276 type: MessageType.spells,
1277 spells: spellView.spells,
1278 favorites: spellView.favorites ?? [],
1279 autoCast: spellView.autoCast,
1280 armedSpellId: spellView.armedSpellId ?? null
1281 });
1282 }
1283 const stamina = simulation.staminaOf(session.entityId);
1284 if (stamina)
1285 {
1286 send(session, {
1287 type: MessageType.stamina,
1288 current: stamina.current,
1289 max: stamina.max,
1290 gait: stamina.gait
1291 });
1292 }
1293 if (character.is_dead)
1294 {
1295 send(session, {
1296 type: MessageType.playerDied,
1297 entityId: session.entityId,
1298 characterId: session.characterId
1299 });
1300 }
1301 publishReplication(simulation.drainReplication());
1302 }
1303
1304 function disconnectPlayingSession (session, { despawn = true, reason = "Logged in from another window." } = {})
1305 {
1306 send(session, { type: MessageType.forceLogout, reason });
1307 const characterId = session.characterId;
1308 const accountId = session.account?.account_id | 0;
1309 session.characterId = null;
1310 session.entityId = null;
1311 session.entitySubscribed.clear();
1312 session.staticSubscribed.clear();
1313 if (despawn && characterId)
1314 {
1315 const stayed = simulation.beginCombatLogout(characterId);
1316 if (!stayed)
1317 { simulation.despawnCharacter(characterId); }
1318 publishReplication(simulation.drainReplication());
1319 }
1320 session.suppressLeaveWorldOnClose = true;
1321 if (session.socket.readyState === 1)
1322 { session.socket.close(4000, "Logged in elsewhere"); }
1323 if (accountId)
1324 { notifyFriendPresence(accountId); }
1325 }
1326
1327 function leaveWorld (session)
1328 {
1329 const accountId = session.account?.account_id | 0;
1330 if (session.characterId)
1331 {
1332 const stayed = simulation.beginCombatLogout(session.characterId);
1333 if (!stayed)
1334 { simulation.despawnCharacter(session.characterId); }
1335 }
1336 publishReplication(simulation.drainReplication());
1337 session.characterId = null;
1338 session.entityId = null;
1339 session.entitySubscribed.clear();
1340 session.staticSubscribed.clear();
1341 if (accountId)
1342 { notifyFriendPresence(accountId); }
1343 }
1344
1345 function syncSubscriptions (session, forceSnapshots)
1346 {
1347 if (!session.entityId)
1348 { return; }
1349 const position = simulation.positionOf(session.entityId);
1350 if (!position)
1351 { return; }
1352
1353 const dimensionId = normalizeDimensionId(position.dimensionId ?? OVERWORLD_ID);
1354 const centerChunkX = tileToChunk(position.tileX);
1355 const centerChunkY = tileToChunk(position.tileY);
1356 const mapRadius = staticChunkRadiusForViewDistance(
1357 session.viewDistance,
1358 STATIC_CHUNK_RADIUS,
1359 VISIBLE_CHUNK_RADIUS
1360 );
1361 const entityCoords = visibleChunkCoords(centerChunkX, centerChunkY, VISIBLE_CHUNK_RADIUS);
1362 const staticCoords = visibleChunkCoords(centerChunkX, centerChunkY, mapRadius);
1363 const entityNext = new Set(entityCoords.map((coord) => chunkKey(coord.chunkX, coord.chunkY, dimensionId)));
1364 const staticNext = new Set(staticCoords.map((coord) => chunkKey(coord.chunkX, coord.chunkY, dimensionId)));
1365
1366 for (const key of session.staticSubscribed)
1367 {
1368 if (!staticNext.has(key))
1369 {
1370 const { chunkX, chunkY } = parseChunkKey(key);
1371 send(session, { type: MessageType.unsubscribeChunk, chunkX, chunkY });
1372 }
1373 }
1374
1375 const snapshots = simulation.snapshotsForView(session.entityId, mapRadius);
1376 for (const snapshot of snapshots)
1377 {
1378 const key = chunkKey(snapshot.chunkX, snapshot.chunkY, dimensionId);
1379 const entityChanged = entityNext.has(key) !== session.entitySubscribed.has(key);
1380 if (forceSnapshots || !session.staticSubscribed.has(key) || entityChanged)
1381 {
1382 const groundItems = (snapshot.groundItems ?? []).filter((item) =>
1383 canCharacterSeeGroundItem(item, session.characterId)
1384 );
1385 send(session, { type: MessageType.chunkSnapshot, ...snapshot, groundItems });
1386 }
1387 }
1388 session.entitySubscribed = entityNext;
1389 session.staticSubscribed = staticNext;
1390 }
1391
1392 function requirePlaying (session)
1393 {
1394 if (!session.characterId)
1395 {
1396 const error = new Error("Select a character first.");
1397 error.userFacing = true;
1398 throw error;
1399 }
1400 }
1401
1402 function userError (message)
1403 {
1404 const error = new Error(message);
1405 error.userFacing = true;
1406 return error;
1407 }
1408
1409 function listPublicGameAdmins ()
1410 {
1411 return stateDb.listGameAdmins().map((row) => ({
1412 authSubject: row.auth_subject,
1413 username: row.username ?? null,
1414 email: row.email ?? null
1415 }));
1416 }
1417
1418 function refreshAccountAdminSessions (authSubject)
1419 {
1420 const account = stateDb.getAccountBySubject(authSubject);
1421 if (!account)
1422 { return; }
1423 for (const session of sessions.values())
1424 {
1425 if (session.authSubject !== authSubject)
1426 { continue; }
1427 session.account = account;
1428 send(session, {
1429 type: MessageType.session,
1430 accountId: account.account_id,
1431 authSubject: account.auth_subject,
1432 username: session.username ?? account.username ?? null,
1433 email: account.email ?? null,
1434 isAdmin: !!account.is_admin,
1435 characters: characters.list(account.account_id)
1436 });
1437 }
1438 }
1439
1440 function requireAdmin (session)
1441 {
1442 if (!session.account.is_admin)
1443 {
1444 const error = new Error("Admin only.");
1445 error.userFacing = true;
1446 throw error;
1447 }
1448 }
1449
1450 function broadcastStatus ()
1451 {
1452 const worldTime = simulation.worldTime();
1453 const restartStatus = deploy?.getStatus?.() ?? { scheduled: false };
1454 for (const session of sessions.values())
1455 {
1456 if (session.entityId)
1457 {
1458 send(session, {
1459 type: MessageType.worldStatus,
1460 worldTime,
1461 settings: simulation.settings,
1462 activeRevisionId: simulation.activeRevisionId,
1463 restartStatus
1464 });
1465 }
1466 }
1467 }
1468
1469 function broadcastRestartStatus ()
1470 {
1471 const restartStatus = deploy?.getStatus?.() ?? { scheduled: false };
1472 for (const session of sessions.values())
1473 {
1474 if (session.entityId)
1475 { send(session, { type: MessageType.restartStatus, restartStatus }); }
1476 }
1477 }
1478
1479 function onlinePresenceByAccount ()
1480 {
1481 const byAccount = new Map();
1482 for (const entry of sessions.values())
1483 {
1484 if (!entry.characterId || !entry.entityId)
1485 { continue; }
1486 const accountId = entry.account?.account_id | 0;
1487 if (!accountId)
1488 { continue; }
1489 const row = stateDb.getCharacter(entry.characterId);
1490 if (!row)
1491 { continue; }
1492 byAccount.set(accountId, {
1493 characterId: row.character_id,
1494 firstName: row.first_name,
1495 lastName: row.last_name
1496 });
1497 }
1498 return byAccount;
1499 }
1500
1501 function friendsPayload (characterId)
1502 {
1503 const snap = friends.snapshot(characterId);
1504 const presence = onlinePresenceByAccount();
1505 for (const account of snap.friends ?? [])
1506 {
1507 const playingAs = presence.get(account.accountId | 0) ?? null;
1508 account.online = !!playingAs;
1509 account.playingAs = playingAs;
1510 }
1511 return snap;
1512 }
1513
1514 /** Refresh friends panels for an account and everyone friended with them. */
1515 function notifyFriendPresence (accountId)
1516 {
1517 const id = accountId | 0;
1518 if (!id)
1519 { return; }
1520 const refs = [id];
1521 for (const row of stateDb.listAccountFriendRecords(id))
1522 { refs.push(row.account_id); }
1523 pushFriends(...refs);
1524 }
1525
1526 function pushFriends (...refs)
1527 {
1528 const accountIds = new Set();
1529 for (const ref of refs)
1530 {
1531 if (ref == null)
1532 { continue; }
1533 if (typeof ref === "object" && ref.accountId != null)
1534 {
1535 accountIds.add(ref.accountId | 0);
1536 continue;
1537 }
1538 const asNumber = Number(ref);
1539 if (!asNumber)
1540 { continue; }
1541 // Heuristic: character ids from messages; also accept bare account ids from panel.
1542 const character = stateDb.getCharacter(asNumber);
1543 if (character)
1544 { accountIds.add(character.account_id | 0); }
1545 else if (stateDb.getAccount(asNumber))
1546 { accountIds.add(asNumber); }
1547 }
1548 for (const session of sessions.values())
1549 {
1550 if (!session.characterId)
1551 { continue; }
1552 const accountId = session.account?.account_id | 0;
1553 if (!accountIds.has(accountId))
1554 { continue; }
1555 send(session, { type: MessageType.friends, ...friendsPayload(session.characterId) });
1556 }
1557 }
1558
1559 function broadcastSettings (payload)
1560 {
1561 for (const session of sessions.values())
1562 {
1563 if (session.account.is_admin)
1564 { send(session, { type: MessageType.editorSettings, ...payload }); }
1565 }
1566 }
1567
1568 function onTickResult (result)
1569 {
1570 publishReplication(result.replication ?? []);
1571 for (const event of result.events)
1572 {
1573 if (event.type === "command-error")
1574 {
1575 const session = sessions.get(event.sessionId);
1576 if (session)
1577 { send(session, { type: MessageType.error, message: event.message }); }
1578 continue;
1579 }
1580 if (event.type === "inventory")
1581 {
1582 const session = event.sessionId != null
1583 ? sessions.get(event.sessionId)
1584 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1585 if (!session)
1586 { continue; }
1587 send(session, {
1588 type: MessageType.inventory,
1589 inventory: event.inventory,
1590 equipment: event.equipment,
1591 vault: event.vault,
1592 vaultReserved: event.vaultReserved
1593 });
1594 if (event.bank)
1595 {
1596 send(session, {
1597 type: MessageType.bankSnapshot,
1598 vault: event.vault,
1599 vaultReserved: event.vaultReserved,
1600 inheritance: stateDb.getInheritance(session.account.account_id)
1601 });
1602 }
1603 if (event.cauldron != null)
1604 {
1605 send(session, {
1606 type: MessageType.cauldronSnapshot,
1607 open: !!event.cauldron,
1608 state: event.cauldronState ?? null,
1609 alchemyResult: event.alchemyResult ?? null,
1610 dyeConfirm: event.dyeConfirm ?? null
1611 });
1612 }
1613 continue;
1614 }
1615 if (event.type === "skills")
1616 {
1617 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1618 if (!session)
1619 { continue; }
1620 send(session, {
1621 type: MessageType.skills,
1622 skills: event.skills ?? [],
1623 combatLevel: event.combatLevel ?? 0
1624 });
1625 continue;
1626 }
1627 if (event.type === "spells")
1628 {
1629 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1630 if (!session)
1631 { continue; }
1632 send(session, {
1633 type: MessageType.spellsUpdated,
1634 spells: event.spells ?? [],
1635 favorites: event.favorites ?? [],
1636 autoCast: !!event.autoCast,
1637 armedSpellId: event.armedSpellId ?? null
1638 });
1639 continue;
1640 }
1641 if (event.type === "spell-armed")
1642 {
1643 const session = [...sessions.values()].find((entry) => entry.entityId === event.entityId);
1644 if (!session)
1645 { continue; }
1646 send(session, {
1647 type: MessageType.spellArmed,
1648 spellId: event.spellId
1649 });
1650 continue;
1651 }
1652 if (event.type === "spell-disarmed")
1653 {
1654 const session = [...sessions.values()].find((entry) => entry.entityId === event.entityId);
1655 if (!session)
1656 { continue; }
1657 send(session, { type: MessageType.spellDisarmed });
1658 continue;
1659 }
1660 if (event.type === "stamina")
1661 {
1662 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1663 if (!session)
1664 { continue; }
1665 send(session, {
1666 type: MessageType.stamina,
1667 current: event.current,
1668 max: event.max,
1669 gait: event.gait
1670 });
1671 continue;
1672 }
1673 if (event.type === "status-effects")
1674 {
1675 const session = event.sessionId != null
1676 ? sessions.get(event.sessionId)
1677 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1678 if (!session)
1679 { continue; }
1680 send(session, {
1681 type: MessageType.statusEffects,
1682 effects: event.effects ?? [],
1683 blind: !!event.blind
1684 });
1685 continue;
1686 }
1687 if (event.type === "toast")
1688 {
1689 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1690 if (session)
1691 { send(session, { type: MessageType.toast, message: event.message }); }
1692 continue;
1693 }
1694 if (event.type === "trade-invite")
1695 {
1696 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1697 if (session)
1698 {
1699 send(session, {
1700 type: MessageType.tradeInvite,
1701 inviteId: event.inviteId,
1702 fromCharacterId: event.fromCharacterId,
1703 fromEntityId: event.fromEntityId,
1704 fromName: event.fromName,
1705 expiresAt: event.expiresAt
1706 });
1707 }
1708 continue;
1709 }
1710 if (event.type === "trade-invite-expired")
1711 {
1712 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1713 if (session)
1714 { send(session, { type: MessageType.tradeInviteExpired, inviteId: event.inviteId }); }
1715 continue;
1716 }
1717 if (event.type === "trade-open")
1718 {
1719 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1720 if (session)
1721 {
1722 send(session, {
1723 type: MessageType.tradeOpen,
1724 partnerCharacterId: event.partnerCharacterId,
1725 partnerEntityId: event.partnerEntityId,
1726 partnerName: event.partnerName,
1727 youAccepted: event.youAccepted,
1728 theyAccepted: event.theyAccepted,
1729 yourOffer: event.yourOffer,
1730 theirOffer: event.theirOffer
1731 });
1732 }
1733 continue;
1734 }
1735 if (event.type === "trade-state")
1736 {
1737 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1738 if (session)
1739 {
1740 send(session, {
1741 type: MessageType.tradeState,
1742 youAccepted: event.youAccepted,
1743 theyAccepted: event.theyAccepted,
1744 yourOffer: event.yourOffer,
1745 theirOffer: event.theirOffer
1746 });
1747 }
1748 continue;
1749 }
1750 if (event.type === "trade-closed")
1751 {
1752 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1753 if (session)
1754 { send(session, { type: MessageType.tradeClosed }); }
1755 continue;
1756 }
1757 if (event.type === "quests-snapshot")
1758 {
1759 const session = event.sessionId != null
1760 ? sessions.get(event.sessionId)
1761 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1762 if (session)
1763 {
1764 send(session, {
1765 type: MessageType.questsSnapshot,
1766 quests: event.quests ?? []
1767 });
1768 }
1769 continue;
1770 }
1771 if (event.type === "quest-step-complete")
1772 {
1773 const session = event.sessionId != null
1774 ? sessions.get(event.sessionId)
1775 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1776 if (session)
1777 {
1778 send(session, {
1779 type: MessageType.questStepComplete,
1780 questId: event.questId,
1781 title: event.title
1782 });
1783 }
1784 continue;
1785 }
1786 if (event.type === "dialogue-step")
1787 {
1788 const session = event.sessionId != null
1789 ? sessions.get(event.sessionId)
1790 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1791 if (session)
1792 {
1793 send(session, {
1794 type: MessageType.dialogueStep,
1795 dialogueId: event.dialogueId,
1796 stepId: event.stepId,
1797 label: event.label,
1798 npcEntityId: event.npcEntityId ?? null,
1799 lines: event.lines ?? []
1800 });
1801 }
1802 continue;
1803 }
1804 if (event.type === "dialogue-choices")
1805 {
1806 const session = event.sessionId != null
1807 ? sessions.get(event.sessionId)
1808 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1809 if (session)
1810 {
1811 send(session, {
1812 type: MessageType.dialogueChoices,
1813 dialogueId: event.dialogueId,
1814 stepId: event.stepId,
1815 npcEntityId: event.npcEntityId ?? null,
1816 triggers: event.triggers ?? []
1817 });
1818 }
1819 continue;
1820 }
1821 if (event.type === "dialogue-item-rewards")
1822 {
1823 const session = event.sessionId != null
1824 ? sessions.get(event.sessionId)
1825 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1826 if (session)
1827 {
1828 send(session, {
1829 type: MessageType.dialogueItemRewards,
1830 dialogueId: event.dialogueId,
1831 stepId: event.stepId,
1832 npcEntityId: event.npcEntityId ?? null,
1833 messages: event.messages ?? []
1834 });
1835 }
1836 continue;
1837 }
1838 if (event.type === "dialogue-close")
1839 {
1840 const session = event.sessionId != null
1841 ? sessions.get(event.sessionId)
1842 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1843 if (session)
1844 {
1845 send(session, {
1846 type: MessageType.dialogueClose,
1847 reason: event.reason ?? null
1848 });
1849 }
1850 continue;
1851 }
1852 if (event.type === "pigeon-delivered")
1853 {
1854 for (const session of sessions.values())
1855 {
1856 if (session.characterId === event.senderCharacterId
1857 || session.characterId === event.destinationCharacterId)
1858 {
1859 send(session, {
1860 type: MessageType.pigeonDelivered,
1861 courierId: event.courierId,
1862 destinationKind: event.destinationKind,
1863 cargo: event.cargo
1864 });
1865 }
1866 }
1867 continue;
1868 }
1869 if (event.type === "player-died")
1870 {
1871 const session = sessions.get(event.sessionId);
1872 if (session)
1873 {
1874 send(session, {
1875 type: MessageType.playerDied,
1876 entityId: event.entityId,
1877 characterId: event.characterId
1878 });
1879 }
1880 continue;
1881 }
1882 if (event.type === "player-respawned")
1883 {
1884 const session = sessions.get(event.sessionId);
1885 if (session)
1886 {
1887 send(session, {
1888 type: MessageType.playerRespawned,
1889 entityId: event.entityId,
1890 characterId: event.characterId,
1891 tileX: event.tileX,
1892 tileY: event.tileY,
1893 health: event.health,
1894 maxHealth: event.maxHealth,
1895 stamina: event.stamina,
1896 maxStamina: event.maxStamina,
1897 skullValue: event.skullValue | 0
1898 });
1899 }
1900 continue;
1901 }
1902 if (event.type === "dimension-changed")
1903 {
1904 const session = sessions.get(event.sessionId);
1905 if (session)
1906 {
1907 session.entitySubscribed.clear();
1908 session.staticSubscribed.clear();
1909 send(session, {
1910 type: MessageType.dimensionChanged,
1911 dimensionId: event.dimensionId,
1912 tileX: event.tileX,
1913 tileY: event.tileY,
1914 lightingMode: event.lightingMode,
1915 seasonMode: event.seasonMode
1916 });
1917 syncSubscriptions(session, true);
1918 }
1919 continue;
1920 }
1921 if (event.type === "combat-no-arrows")
1922 {
1923 const session = sessions.get(event.sessionId);
1924 if (session)
1925 { send(session, { type: MessageType.combatNoArrows }); }
1926 continue;
1927 }
1928 if (event.type === "craft-result")
1929 {
1930 const session = sessions.get(event.sessionId);
1931 if (session)
1932 {
1933 send(session, {
1934 type: MessageType.craftResult,
1935 recipeId: event.recipeId,
1936 ok: !!event.ok,
1937 error: event.error ?? null,
1938 burned: !!event.burned,
1939 continuing: !!event.continuing
1940 });
1941 }
1942 continue;
1943 }
1944 if (event.type === "station-open")
1945 {
1946 const session = sessions.get(event.sessionId);
1947 if (session)
1948 {
1949 send(session, {
1950 type: MessageType.stationOpen,
1951 stationId: event.stationId
1952 });
1953 }
1954 continue;
1955 }
1956 if (event.type === "shop-open")
1957 {
1958 const session = sessions.get(event.sessionId);
1959 if (session)
1960 {
1961 send(session, {
1962 type: MessageType.shopOpen,
1963 npcEntityId: event.npcEntityId,
1964 displayName: event.displayName,
1965 sex: event.sex === "female" ? "female" : "male",
1966 buysItems: !!event.buysItems,
1967 stock: event.stock ?? []
1968 });
1969 }
1970 continue;
1971 }
1972 if (event.type === "shop-closed")
1973 {
1974 const session = sessions.get(event.sessionId);
1975 if (session)
1976 {
1977 send(session, {
1978 type: MessageType.shopClosed,
1979 npcEntityId: event.npcEntityId
1980 });
1981 }
1982 continue;
1983 }
1984 if (event.type === "market-open")
1985 {
1986 const session = sessions.get(event.sessionId);
1987 if (session)
1988 {
1989 send(session, {
1990 type: MessageType.marketOpen,
1991 displayName: event.displayName,
1992 orders: event.orders ?? [],
1993 catalog: event.catalog ?? []
1994 });
1995 }
1996 continue;
1997 }
1998 if (event.type === "market-closed")
1999 {
2000 const session = sessions.get(event.sessionId);
2001 if (session)
2002 { send(session, { type: MessageType.marketClosed }); }
2003 continue;
2004 }
2005 if (event.type === "bounty-snapshot")
2006 {
2007 const session = sessions.get(event.sessionId);
2008 if (session)
2009 {
2010 send(session, {
2011 type: MessageType.bountySnapshot,
2012 myAmountCopper: event.myAmountCopper | 0,
2013 myAmountLabel: event.myAmountLabel ?? "",
2014 nextDecayAt: event.nextDecayAt ?? null,
2015 payoffCoinsPerPoint: event.payoffCoinsPerPoint ?? 10,
2016 message: event.message ?? "",
2017 raised: event.raised ?? null,
2018 paidOff: event.paidOff ?? null
2019 });
2020 }
2021 continue;
2022 }
2023 if (event.type === "bounty-closed")
2024 {
2025 const session = sessions.get(event.sessionId);
2026 if (session)
2027 { send(session, { type: MessageType.closeBounty }); }
2028 continue;
2029 }
2030 if (event.type === "character-bounty")
2031 {
2032 const session = sessions.get(event.sessionId);
2033 if (session)
2034 {
2035 send(session, {
2036 type: MessageType.characterBounty,
2037 target: event.target ?? null
2038 });
2039 }
2040 continue;
2041 }
2042 if (event.type === "barber-snapshot")
2043 {
2044 const session = sessions.get(event.sessionId);
2045 if (session)
2046 {
2047 send(session, {
2048 type: MessageType.barberSnapshot,
2049 sex: event.sex,
2050 styles: event.styles ?? [],
2051 hair: event.hair ?? null,
2052 message: event.message ?? ""
2053 });
2054 }
2055 continue;
2056 }
2057 if (event.type === "barber-closed")
2058 {
2059 const session = sessions.get(event.sessionId);
2060 if (session)
2061 { send(session, { type: MessageType.closeBarber }); }
2062 continue;
2063 }
2064 if (event.type === "market-trade")
2065 {
2066 for (const session of sessions.values())
2067 {
2068 if (
2069 session.characterId === event.buyerCharacterId
2070 || session.characterId === event.sellerCharacterId
2071 )
2072 {
2073 send(session, {
2074 type: MessageType.marketTrade,
2075 itemId: event.itemId,
2076 quantity: event.quantity,
2077 unitPrice: event.unitPrice,
2078 triggeringSide: event.triggeringSide
2079 });
2080 }
2081 }
2082 continue;
2083 }
2084 if (event.type === "item-bubble")
2085 {
2086 broadcastItemBubble(
2087 sessions,
2088 simulation,
2089 event.entityId,
2090 event.itemId,
2091 event.quantity
2092 );
2093 continue;
2094 }
2095 if (event.type === "gather-swing" || event.type === "tile-shove")
2096 {
2097 publishEntity({
2098 ...event,
2099 type: event.type
2100 });
2101 continue;
2102 }
2103 if (event.type === "chunk-delta")
2104 {
2105 publishEntity(event);
2106 continue;
2107 }
2108 if (event.type === "gather-complete")
2109 {
2110 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
2111 if (session)
2112 {
2113 send(session, {
2114 type: MessageType.gatherComplete,
2115 kind: event.kind,
2116 materialId: event.materialId,
2117 itemId: event.itemId
2118 });
2119 }
2120 continue;
2121 }
2122 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")
2123 { publishEntity(event); }
2124 }
2125 if (simulation.tickIndex % simulation.settings.simulationTickHz === 0)
2126 { broadcastStatus(); }
2127 }
2128
2129 function publishReplication (events)
2130 {
2131 for (const event of events ?? [])
2132 { publishEntity(event); }
2133 }
2134
2135 function publishEntity (event)
2136 {
2137 const toDim = normalizeDimensionId(event.dimensionId
2138 ?? simulation.entityRecord(event.entityId)?.dimensionId
2139 ?? OVERWORLD_ID);
2140 const fromDim = event.fromDimensionId != null
2141 ? normalizeDimensionId(event.fromDimensionId)
2142 : toDim;
2143 const fromKey = event.fromTileX != null
2144 ? chunkKey(tileToChunk(event.fromTileX), tileToChunk(event.fromTileY), fromDim)
2145 : null;
2146 const toKey = event.tileX != null
2147 ? chunkKey(tileToChunk(event.tileX), tileToChunk(event.tileY), toDim)
2148 : null;
2149 for (const session of sessions.values())
2150 {
2151 if (!session.entityId)
2152 { continue; }
2153 const seesFrom = fromKey ? session.entitySubscribed.has(fromKey) : false;
2154 const seesTo = session.entitySubscribed.has(toKey);
2155 const seesStaticTo = session.staticSubscribed.has(toKey);
2156 if (event.type === "entity-spawn")
2157 {
2158 if (session.entityId === event.entityId || !seesTo)
2159 { continue; }
2160 send(session, spawnPayload(event));
2161 continue;
2162 }
2163 if (event.type === "entity-despawn")
2164 {
2165 if (session.entityId === event.entityId || (!seesTo && !seesFrom))
2166 { continue; }
2167 const payload = { type: MessageType.entityDespawn, entityId: event.entityId };
2168 if (event.cause)
2169 { payload.cause = event.cause; }
2170 send(session, payload);
2171 continue;
2172 }
2173 if (event.type === "entity-appearance")
2174 {
2175 if (!seesTo)
2176 { continue; }
2177 send(session, {
2178 type: MessageType.entityAppearance,
2179 entityId: event.entityId,
2180 sprite: event.sprite,
2181 layers: event.layers ?? [],
2182 lightRadiusTiles: event.lightRadiusTiles ?? 0
2183 });
2184 continue;
2185 }
2186 if (event.type === "entity-skull")
2187 {
2188 if (!seesTo && session.entityId !== event.entityId)
2189 { continue; }
2190 send(session, {
2191 type: MessageType.entitySkull,
2192 entityId: event.entityId,
2193 skullValue: event.skullValue | 0
2194 });
2195 continue;
2196 }
2197 if (event.type === "ground-item-appear")
2198 {
2199 if (!seesTo)
2200 { continue; }
2201 if (!canCharacterSeeGroundItem(event, session.characterId))
2202 { continue; }
2203 send(session, { type: MessageType.groundItemAppear, ...event, type: MessageType.groundItemAppear });
2204 continue;
2205 }
2206 if (event.type === "ground-item-despawn")
2207 {
2208 if (!seesTo)
2209 { continue; }
2210 if (!canCharacterSeeGroundItem(event, session.characterId))
2211 { continue; }
2212 send(session, { type: MessageType.groundItemDespawn, groundItemId: event.groundItemId });
2213 continue;
2214 }
2215 if (event.type === "combat-swing" || event.type === "combat-hit" || event.type === "combat-miss" || event.type === "combat-block")
2216 {
2217 if (!seesTo && !seesFrom)
2218 { continue; }
2219 const type = event.type === "combat-swing"
2220 ? MessageType.combatSwing
2221 : event.type === "combat-hit"
2222 ? MessageType.combatHit
2223 : event.type === "combat-block"
2224 ? MessageType.combatBlock
2225 : MessageType.combatMiss;
2226 send(session, {
2227 type,
2228 attackerId: event.attackerId,
2229 targetId: event.targetId,
2230 damage: event.damage,
2231 health: event.health,
2232 maxHealth: event.maxHealth,
2233 tileX: event.tileX,
2234 tileY: event.tileY,
2235 fromTileX: event.fromTileX,
2236 fromTileY: event.fromTileY
2237 });
2238 continue;
2239 }
2240 if (event.type === "combat-projectile")
2241 {
2242 if (!seesTo && !seesFrom)
2243 { continue; }
2244 send(session, {
2245 type: MessageType.combatProjectile,
2246 attackerId: event.attackerId,
2247 targetId: event.targetId,
2248 fromTileX: event.fromTileX,
2249 fromTileY: event.fromTileY,
2250 tileX: event.tileX,
2251 tileY: event.tileY,
2252 durationMs: event.durationMs ?? 400,
2253 trackTarget: event.trackTarget !== false,
2254 shaftTint: event.shaftTint ?? null,
2255 tipTint: event.tipTint ?? null
2256 });
2257 continue;
2258 }
2259 if (event.type === "spell-projectile")
2260 {
2261 if (!seesTo && !seesFrom)
2262 { continue; }
2263 send(session, {
2264 type: MessageType.spellProjectile,
2265 casterId: event.casterId,
2266 targetId: event.targetId ?? null,
2267 spellId: event.spellId,
2268 fromTileX: event.fromTileX,
2269 fromTileY: event.fromTileY,
2270 tileX: event.tileX,
2271 tileY: event.tileY,
2272 durationMs: event.durationMs ?? 2000,
2273 sprite: event.sprite ?? null
2274 });
2275 continue;
2276 }
2277 if (event.type === "spell-fizzle")
2278 {
2279 if (!seesTo && !seesFrom)
2280 { continue; }
2281 send(session, {
2282 type: MessageType.spellFizzle,
2283 casterId: event.casterId,
2284 spellId: event.spellId,
2285 fromTileX: event.fromTileX,
2286 fromTileY: event.fromTileY,
2287 tileX: event.tileX,
2288 tileY: event.tileY
2289 });
2290 continue;
2291 }
2292 if (event.type === "spell-cast-flash")
2293 {
2294 if (!seesTo)
2295 { continue; }
2296 send(session, {
2297 type: MessageType.spellCastFlash,
2298 casterId: event.casterId,
2299 tileX: event.tileX,
2300 tileY: event.tileY,
2301 radiusTiles: event.radiusTiles ?? 1,
2302 durationMs: event.durationMs ?? 500,
2303 tier: event.tier ?? 1
2304 });
2305 continue;
2306 }
2307 if (event.type === "spell-light-appear" || event.type === "spell-light-update"
2308 || event.type === "spell-dark-appear" || event.type === "spell-dark-update")
2309 {
2310 if (!seesTo)
2311 { continue; }
2312 const isDark = event.type.startsWith("spell-dark");
2313 const appear = event.type.endsWith("appear");
2314 send(session, {
2315 type: appear
2316 ? (isDark ? MessageType.spellDarkAppear : MessageType.spellLightAppear)
2317 : (isDark ? MessageType.spellDarkUpdate : MessageType.spellLightUpdate),
2318 tileX: event.tileX,
2319 tileY: event.tileY,
2320 ownerEntityId: event.ownerEntityId,
2321 remainingMs: event.remainingMs ?? 0,
2322 rangeTiles: event.rangeTiles ?? 0,
2323 intensity: event.intensity ?? 0,
2324 expiresAt: event.expiresAt ?? 0,
2325 kind: isDark ? "dark" : "light"
2326 });
2327 continue;
2328 }
2329 if (event.type === "spell-light-remove" || event.type === "spell-dark-remove")
2330 {
2331 if (!seesTo)
2332 { continue; }
2333 send(session, {
2334 type: event.type === "spell-dark-remove"
2335 ? MessageType.spellDarkRemove
2336 : MessageType.spellLightRemove,
2337 tileX: event.tileX,
2338 tileY: event.tileY
2339 });
2340 continue;
2341 }
2342 if (event.type === "entity-health")
2343 {
2344 if (!seesTo && !seesFrom)
2345 { continue; }
2346 send(session, {
2347 type: MessageType.entityHealth,
2348 entityId: event.entityId,
2349 health: event.health,
2350 maxHealth: event.maxHealth
2351 });
2352 continue;
2353 }
2354 if (event.type === "gather-swing" || event.type === "tile-shove")
2355 {
2356 if (!seesTo && !seesFrom)
2357 { continue; }
2358 if (event.type === "gather-swing")
2359 {
2360 send(session, {
2361 type: MessageType.gatherSwing,
2362 attackerId: event.attackerId,
2363 tileX: event.tileX,
2364 tileY: event.tileY,
2365 fromTileX: event.fromTileX,
2366 fromTileY: event.fromTileY,
2367 toolItemId: event.toolItemId ?? null
2368 });
2369 }
2370 else
2371 {
2372 send(session, {
2373 type: MessageType.tileShove,
2374 attackerId: event.attackerId,
2375 tileX: event.tileX,
2376 tileY: event.tileY,
2377 fromTileX: event.fromTileX,
2378 fromTileY: event.fromTileY
2379 });
2380 }
2381 continue;
2382 }
2383 if (event.type === "skill-level-up")
2384 {
2385 if (session.entityId !== event.entityId && !seesTo)
2386 { continue; }
2387 send(session, {
2388 type: MessageType.skillLevelUp,
2389 entityId: event.entityId,
2390 characterId: event.characterId,
2391 skillId: event.skillId,
2392 level: event.level,
2393 previousLevel: event.previousLevel,
2394 displayName: event.displayName,
2395 icon: event.icon
2396 });
2397 continue;
2398 }
2399 if (event.type === "chunk-delta")
2400 {
2401 if (!seesStaticTo)
2402 { continue; }
2403 send(session, {
2404 type: MessageType.chunkDelta,
2405 chunkX: event.chunkX,
2406 chunkY: event.chunkY,
2407 tiles: [{
2408 localX: event.localX,
2409 localY: event.localY,
2410 block: event.block
2411 }]
2412 });
2413 continue;
2414 }
2415 if (event.type !== "entity-move")
2416 { continue; }
2417 if (seesTo)
2418 {
2419 if (!seesFrom)
2420 { send(session, spawnPayload(event)); }
2421 else
2422 {
2423 send(session, {
2424 type: MessageType.entityMove,
2425 entityId: event.entityId,
2426 tileX: event.tileX,
2427 tileY: event.tileY,
2428 worldX: event.worldX,
2429 worldY: event.worldY,
2430 gait: event.gait,
2431 lerpMs: event.lerpMs,
2432 freeFlight: !!event.freeFlight
2433 });
2434 }
2435 }
2436 else if (seesFrom)
2437 { send(session, { type: MessageType.entityDespawn, entityId: event.entityId }); }
2438 if (session.entityId === event.entityId)
2439 {
2440 const crossedDimension = event.fromDimensionId != null
2441 && event.dimensionId != null
2442 && normalizeDimensionId(event.fromDimensionId) !== normalizeDimensionId(event.dimensionId);
2443 if (!crossedDimension)
2444 { syncSubscriptions(session, false); }
2445 }
2446 }
2447 }
2448
2449 function spawnPayload (event)
2450 {
2451 const record = simulation.entityRecord(event.entityId) ?? event;
2452 return {
2453 type: MessageType.entitySpawn,
2454 entityId: event.entityId,
2455 characterId: record.characterId ?? event.characterId ?? null,
2456 accountId: record.accountId ?? event.accountId ?? null,
2457 tileX: event.tileX ?? record.tileX,
2458 tileY: event.tileY ?? record.tileY,
2459 worldX: event.worldX ?? record.worldX,
2460 worldY: event.worldY ?? record.worldY,
2461 gait: event.gait ?? record.gait,
2462 sex: record.sex ?? event.sex ?? null,
2463 firstName: record.firstName ?? event.firstName ?? "",
2464 lastName: record.lastName ?? event.lastName ?? "",
2465 sprite: record.sprite ?? event.sprite ?? null,
2466 layers: record.layers ?? event.layers ?? [],
2467 mobTypeId: record.mobTypeId ?? event.mobTypeId ?? null,
2468 canFight: !!(record.canFight ?? event.canFight),
2469 aggressive: !!(record.aggressive ?? event.aggressive ?? record.hostile ?? event.hostile),
2470 hostile: !!(record.hostile ?? event.hostile ?? record.aggressive ?? event.aggressive),
2471 talkable: !!(record.talkable ?? event.talkable),
2472 hasDialogue: !!(record.hasDialogue ?? event.hasDialogue),
2473 hasShop: !!(record.hasShop ?? event.hasShop),
2474 untargetable: !!(record.untargetable ?? event.untargetable),
2475 freeFlight: !!(record.freeFlight ?? event.freeFlight),
2476 level: record.level ?? event.level ?? null,
2477 health: record.health ?? event.health,
2478 maxHealth: record.maxHealth ?? event.maxHealth,
2479 lightRadiusTiles: record.lightRadiusTiles ?? event.lightRadiusTiles ?? 0,
2480 skullValue: record.skullValue | 0
2481 };
2482 }
2483
2484 return {
2485 sessions,
2486 onTickResult,
2487 wss,
2488 broadcastRestartStatus,
2489 setDraining (value)
2490 {
2491 draining = !!value;
2492 },
2493 async shutdown ()
2494 {
2495 draining = true;
2496 await Promise.all([...sessions.values()].map(async (session) =>
2497 {
2498 await sendAsync(session, {
2499 type: MessageType.forceLogout,
2500 reason: "Server shutting down."
2501 });
2502 leaveWorld(session);
2503 await closeAsync(session, 1001, "Server shutting down.");
2504 }));
2505 sessions.clear();
2506 await simulation.shutdown();
2507 }
2508 };
2509}
2510
2511function send (session, payload)
2512{
2513 if (session.socket.readyState === 1)
2514 { session.socket.send(JSON.stringify(payload)); }
2515}
2516
2517function sendAsync (session, payload)
2518{
2519 return new Promise((resolve) =>
2520 {
2521 if (session.socket.readyState !== 1)
2522 {
2523 resolve();
2524 return;
2525 }
2526 session.socket.send(JSON.stringify(payload), () => resolve());
2527 });
2528}
2529
2530function closeAsync (session, code, reason)
2531{
2532 return new Promise((resolve) =>
2533 {
2534 if (session.socket.readyState !== 1)
2535 {
2536 resolve();
2537 return;
2538 }
2539 session.socket.once("close", resolve);
2540 try
2541 { session.socket.close(code, reason); }
2542 catch
2543 { resolve(); }
2544 });
2545}