BlueGit

timfa questward

Files

questward / server / src / gateway / websocket.js

websocket.js

websocket.js 72.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 { 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 === "quest-complete")
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.questComplete,
1795 questId: event.questId,
1796 title: event.title,
1797 xp: event.xp ?? [],
1798 items: event.items ?? []
1799 });
1800 }
1801 continue;
1802 }
1803 if (event.type === "dialogue-step")
1804 {
1805 const session = event.sessionId != null
1806 ? sessions.get(event.sessionId)
1807 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1808 if (session)
1809 {
1810 send(session, {
1811 type: MessageType.dialogueStep,
1812 dialogueId: event.dialogueId,
1813 stepId: event.stepId,
1814 label: event.label,
1815 npcEntityId: event.npcEntityId ?? null,
1816 lines: event.lines ?? []
1817 });
1818 }
1819 continue;
1820 }
1821 if (event.type === "dialogue-choices")
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.dialogueChoices,
1830 dialogueId: event.dialogueId,
1831 stepId: event.stepId,
1832 npcEntityId: event.npcEntityId ?? null,
1833 triggers: event.triggers ?? []
1834 });
1835 }
1836 continue;
1837 }
1838 if (event.type === "dialogue-item-rewards")
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.dialogueItemRewards,
1847 dialogueId: event.dialogueId,
1848 stepId: event.stepId,
1849 npcEntityId: event.npcEntityId ?? null,
1850 messages: event.messages ?? []
1851 });
1852 }
1853 continue;
1854 }
1855 if (event.type === "dialogue-close")
1856 {
1857 const session = event.sessionId != null
1858 ? sessions.get(event.sessionId)
1859 : [...sessions.values()].find((entry) => entry.characterId === event.characterId);
1860 if (session)
1861 {
1862 send(session, {
1863 type: MessageType.dialogueClose,
1864 reason: event.reason ?? null
1865 });
1866 }
1867 continue;
1868 }
1869 if (event.type === "pigeon-delivered")
1870 {
1871 for (const session of sessions.values())
1872 {
1873 if (session.characterId === event.senderCharacterId
1874 || session.characterId === event.destinationCharacterId)
1875 {
1876 send(session, {
1877 type: MessageType.pigeonDelivered,
1878 courierId: event.courierId,
1879 destinationKind: event.destinationKind,
1880 cargo: event.cargo
1881 });
1882 }
1883 }
1884 continue;
1885 }
1886 if (event.type === "player-died")
1887 {
1888 const session = sessions.get(event.sessionId);
1889 if (session)
1890 {
1891 send(session, {
1892 type: MessageType.playerDied,
1893 entityId: event.entityId,
1894 characterId: event.characterId
1895 });
1896 }
1897 continue;
1898 }
1899 if (event.type === "player-respawned")
1900 {
1901 const session = sessions.get(event.sessionId);
1902 if (session)
1903 {
1904 send(session, {
1905 type: MessageType.playerRespawned,
1906 entityId: event.entityId,
1907 characterId: event.characterId,
1908 tileX: event.tileX,
1909 tileY: event.tileY,
1910 health: event.health,
1911 maxHealth: event.maxHealth,
1912 stamina: event.stamina,
1913 maxStamina: event.maxStamina,
1914 skullValue: event.skullValue | 0
1915 });
1916 }
1917 continue;
1918 }
1919 if (event.type === "dimension-changed")
1920 {
1921 const session = sessions.get(event.sessionId);
1922 if (session)
1923 {
1924 session.entitySubscribed.clear();
1925 session.staticSubscribed.clear();
1926 send(session, {
1927 type: MessageType.dimensionChanged,
1928 dimensionId: event.dimensionId,
1929 tileX: event.tileX,
1930 tileY: event.tileY,
1931 lightingMode: event.lightingMode,
1932 seasonMode: event.seasonMode
1933 });
1934 syncSubscriptions(session, true);
1935 }
1936 continue;
1937 }
1938 if (event.type === "combat-no-arrows")
1939 {
1940 const session = sessions.get(event.sessionId);
1941 if (session)
1942 { send(session, { type: MessageType.combatNoArrows }); }
1943 continue;
1944 }
1945 if (event.type === "craft-result")
1946 {
1947 const session = sessions.get(event.sessionId);
1948 if (session)
1949 {
1950 send(session, {
1951 type: MessageType.craftResult,
1952 recipeId: event.recipeId,
1953 ok: !!event.ok,
1954 error: event.error ?? null,
1955 burned: !!event.burned,
1956 continuing: !!event.continuing
1957 });
1958 }
1959 continue;
1960 }
1961 if (event.type === "station-open")
1962 {
1963 const session = sessions.get(event.sessionId);
1964 if (session)
1965 {
1966 send(session, {
1967 type: MessageType.stationOpen,
1968 stationId: event.stationId
1969 });
1970 }
1971 continue;
1972 }
1973 if (event.type === "shop-open")
1974 {
1975 const session = sessions.get(event.sessionId);
1976 if (session)
1977 {
1978 send(session, {
1979 type: MessageType.shopOpen,
1980 npcEntityId: event.npcEntityId,
1981 displayName: event.displayName,
1982 sex: event.sex === "female" ? "female" : "male",
1983 buysItems: !!event.buysItems,
1984 stock: event.stock ?? []
1985 });
1986 }
1987 continue;
1988 }
1989 if (event.type === "shop-closed")
1990 {
1991 const session = sessions.get(event.sessionId);
1992 if (session)
1993 {
1994 send(session, {
1995 type: MessageType.shopClosed,
1996 npcEntityId: event.npcEntityId
1997 });
1998 }
1999 continue;
2000 }
2001 if (event.type === "market-open")
2002 {
2003 const session = sessions.get(event.sessionId);
2004 if (session)
2005 {
2006 send(session, {
2007 type: MessageType.marketOpen,
2008 displayName: event.displayName,
2009 orders: event.orders ?? [],
2010 catalog: event.catalog ?? []
2011 });
2012 }
2013 continue;
2014 }
2015 if (event.type === "market-closed")
2016 {
2017 const session = sessions.get(event.sessionId);
2018 if (session)
2019 { send(session, { type: MessageType.marketClosed }); }
2020 continue;
2021 }
2022 if (event.type === "bounty-snapshot")
2023 {
2024 const session = sessions.get(event.sessionId);
2025 if (session)
2026 {
2027 send(session, {
2028 type: MessageType.bountySnapshot,
2029 myAmountCopper: event.myAmountCopper | 0,
2030 myAmountLabel: event.myAmountLabel ?? "",
2031 nextDecayAt: event.nextDecayAt ?? null,
2032 payoffCoinsPerPoint: event.payoffCoinsPerPoint ?? 10,
2033 message: event.message ?? "",
2034 raised: event.raised ?? null,
2035 paidOff: event.paidOff ?? null
2036 });
2037 }
2038 continue;
2039 }
2040 if (event.type === "bounty-closed")
2041 {
2042 const session = sessions.get(event.sessionId);
2043 if (session)
2044 { send(session, { type: MessageType.closeBounty }); }
2045 continue;
2046 }
2047 if (event.type === "character-bounty")
2048 {
2049 const session = sessions.get(event.sessionId);
2050 if (session)
2051 {
2052 send(session, {
2053 type: MessageType.characterBounty,
2054 target: event.target ?? null
2055 });
2056 }
2057 continue;
2058 }
2059 if (event.type === "barber-snapshot")
2060 {
2061 const session = sessions.get(event.sessionId);
2062 if (session)
2063 {
2064 send(session, {
2065 type: MessageType.barberSnapshot,
2066 sex: event.sex,
2067 styles: event.styles ?? [],
2068 hair: event.hair ?? null,
2069 message: event.message ?? ""
2070 });
2071 }
2072 continue;
2073 }
2074 if (event.type === "barber-closed")
2075 {
2076 const session = sessions.get(event.sessionId);
2077 if (session)
2078 { send(session, { type: MessageType.closeBarber }); }
2079 continue;
2080 }
2081 if (event.type === "market-trade")
2082 {
2083 for (const session of sessions.values())
2084 {
2085 if (
2086 session.characterId === event.buyerCharacterId
2087 || session.characterId === event.sellerCharacterId
2088 )
2089 {
2090 send(session, {
2091 type: MessageType.marketTrade,
2092 itemId: event.itemId,
2093 quantity: event.quantity,
2094 unitPrice: event.unitPrice,
2095 triggeringSide: event.triggeringSide
2096 });
2097 }
2098 }
2099 continue;
2100 }
2101 if (event.type === "item-bubble")
2102 {
2103 broadcastItemBubble(
2104 sessions,
2105 simulation,
2106 event.entityId,
2107 event.itemId,
2108 event.quantity
2109 );
2110 continue;
2111 }
2112 if (event.type === "gather-swing" || event.type === "tile-shove")
2113 {
2114 publishEntity({
2115 ...event,
2116 type: event.type
2117 });
2118 continue;
2119 }
2120 if (event.type === "chunk-delta")
2121 {
2122 publishEntity(event);
2123 continue;
2124 }
2125 if (event.type === "gather-complete")
2126 {
2127 const session = [...sessions.values()].find((entry) => entry.characterId === event.characterId);
2128 if (session)
2129 {
2130 send(session, {
2131 type: MessageType.gatherComplete,
2132 kind: event.kind,
2133 materialId: event.materialId,
2134 itemId: event.itemId
2135 });
2136 }
2137 continue;
2138 }
2139 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")
2140 { publishEntity(event); }
2141 }
2142 if (simulation.tickIndex % simulation.settings.simulationTickHz === 0)
2143 { broadcastStatus(); }
2144 }
2145
2146 function publishReplication (events)
2147 {
2148 for (const event of events ?? [])
2149 { publishEntity(event); }
2150 }
2151
2152 function publishEntity (event)
2153 {
2154 const toDim = normalizeDimensionId(event.dimensionId
2155 ?? simulation.entityRecord(event.entityId)?.dimensionId
2156 ?? OVERWORLD_ID);
2157 const fromDim = event.fromDimensionId != null
2158 ? normalizeDimensionId(event.fromDimensionId)
2159 : toDim;
2160 const fromKey = event.fromTileX != null
2161 ? chunkKey(tileToChunk(event.fromTileX), tileToChunk(event.fromTileY), fromDim)
2162 : null;
2163 const toKey = event.tileX != null
2164 ? chunkKey(tileToChunk(event.tileX), tileToChunk(event.tileY), toDim)
2165 : null;
2166 for (const session of sessions.values())
2167 {
2168 if (!session.entityId)
2169 { continue; }
2170 const seesFrom = fromKey ? session.entitySubscribed.has(fromKey) : false;
2171 const seesTo = session.entitySubscribed.has(toKey);
2172 const seesStaticTo = session.staticSubscribed.has(toKey);
2173 if (event.type === "entity-spawn")
2174 {
2175 if (session.entityId === event.entityId || !seesTo)
2176 { continue; }
2177 send(session, spawnPayload(event));
2178 continue;
2179 }
2180 if (event.type === "entity-despawn")
2181 {
2182 if (session.entityId === event.entityId || (!seesTo && !seesFrom))
2183 { continue; }
2184 const payload = { type: MessageType.entityDespawn, entityId: event.entityId };
2185 if (event.cause)
2186 { payload.cause = event.cause; }
2187 send(session, payload);
2188 continue;
2189 }
2190 if (event.type === "entity-appearance")
2191 {
2192 if (!seesTo)
2193 { continue; }
2194 send(session, {
2195 type: MessageType.entityAppearance,
2196 entityId: event.entityId,
2197 sprite: event.sprite,
2198 layers: event.layers ?? [],
2199 lightRadiusTiles: event.lightRadiusTiles ?? 0
2200 });
2201 continue;
2202 }
2203 if (event.type === "entity-skull")
2204 {
2205 if (!seesTo && session.entityId !== event.entityId)
2206 { continue; }
2207 send(session, {
2208 type: MessageType.entitySkull,
2209 entityId: event.entityId,
2210 skullValue: event.skullValue | 0
2211 });
2212 continue;
2213 }
2214 if (event.type === "ground-item-appear")
2215 {
2216 if (!seesTo)
2217 { continue; }
2218 if (!canCharacterSeeGroundItem(event, session.characterId))
2219 { continue; }
2220 send(session, { type: MessageType.groundItemAppear, ...event, type: MessageType.groundItemAppear });
2221 continue;
2222 }
2223 if (event.type === "ground-item-despawn")
2224 {
2225 if (!seesTo)
2226 { continue; }
2227 if (!canCharacterSeeGroundItem(event, session.characterId))
2228 { continue; }
2229 send(session, { type: MessageType.groundItemDespawn, groundItemId: event.groundItemId });
2230 continue;
2231 }
2232 if (event.type === "combat-swing" || event.type === "combat-hit" || event.type === "combat-miss" || event.type === "combat-block")
2233 {
2234 if (!seesTo && !seesFrom)
2235 { continue; }
2236 const type = event.type === "combat-swing"
2237 ? MessageType.combatSwing
2238 : event.type === "combat-hit"
2239 ? MessageType.combatHit
2240 : event.type === "combat-block"
2241 ? MessageType.combatBlock
2242 : MessageType.combatMiss;
2243 send(session, {
2244 type,
2245 attackerId: event.attackerId,
2246 targetId: event.targetId,
2247 damage: event.damage,
2248 health: event.health,
2249 maxHealth: event.maxHealth,
2250 tileX: event.tileX,
2251 tileY: event.tileY,
2252 fromTileX: event.fromTileX,
2253 fromTileY: event.fromTileY
2254 });
2255 continue;
2256 }
2257 if (event.type === "combat-projectile")
2258 {
2259 if (!seesTo && !seesFrom)
2260 { continue; }
2261 send(session, {
2262 type: MessageType.combatProjectile,
2263 attackerId: event.attackerId,
2264 targetId: event.targetId,
2265 fromTileX: event.fromTileX,
2266 fromTileY: event.fromTileY,
2267 tileX: event.tileX,
2268 tileY: event.tileY,
2269 durationMs: event.durationMs ?? 400,
2270 trackTarget: event.trackTarget !== false,
2271 shaftTint: event.shaftTint ?? null,
2272 tipTint: event.tipTint ?? null
2273 });
2274 continue;
2275 }
2276 if (event.type === "spell-projectile")
2277 {
2278 if (!seesTo && !seesFrom)
2279 { continue; }
2280 send(session, {
2281 type: MessageType.spellProjectile,
2282 casterId: event.casterId,
2283 targetId: event.targetId ?? null,
2284 spellId: event.spellId,
2285 fromTileX: event.fromTileX,
2286 fromTileY: event.fromTileY,
2287 tileX: event.tileX,
2288 tileY: event.tileY,
2289 durationMs: event.durationMs ?? 2000,
2290 sprite: event.sprite ?? null
2291 });
2292 continue;
2293 }
2294 if (event.type === "spell-fizzle")
2295 {
2296 if (!seesTo && !seesFrom)
2297 { continue; }
2298 send(session, {
2299 type: MessageType.spellFizzle,
2300 casterId: event.casterId,
2301 spellId: event.spellId,
2302 fromTileX: event.fromTileX,
2303 fromTileY: event.fromTileY,
2304 tileX: event.tileX,
2305 tileY: event.tileY
2306 });
2307 continue;
2308 }
2309 if (event.type === "spell-cast-flash")
2310 {
2311 if (!seesTo)
2312 { continue; }
2313 send(session, {
2314 type: MessageType.spellCastFlash,
2315 casterId: event.casterId,
2316 tileX: event.tileX,
2317 tileY: event.tileY,
2318 radiusTiles: event.radiusTiles ?? 1,
2319 durationMs: event.durationMs ?? 500,
2320 tier: event.tier ?? 1
2321 });
2322 continue;
2323 }
2324 if (event.type === "spell-light-appear" || event.type === "spell-light-update"
2325 || event.type === "spell-dark-appear" || event.type === "spell-dark-update")
2326 {
2327 if (!seesTo)
2328 { continue; }
2329 const isDark = event.type.startsWith("spell-dark");
2330 const appear = event.type.endsWith("appear");
2331 send(session, {
2332 type: appear
2333 ? (isDark ? MessageType.spellDarkAppear : MessageType.spellLightAppear)
2334 : (isDark ? MessageType.spellDarkUpdate : MessageType.spellLightUpdate),
2335 tileX: event.tileX,
2336 tileY: event.tileY,
2337 ownerEntityId: event.ownerEntityId,
2338 remainingMs: event.remainingMs ?? 0,
2339 rangeTiles: event.rangeTiles ?? 0,
2340 intensity: event.intensity ?? 0,
2341 expiresAt: event.expiresAt ?? 0,
2342 kind: isDark ? "dark" : "light"
2343 });
2344 continue;
2345 }
2346 if (event.type === "spell-light-remove" || event.type === "spell-dark-remove")
2347 {
2348 if (!seesTo)
2349 { continue; }
2350 send(session, {
2351 type: event.type === "spell-dark-remove"
2352 ? MessageType.spellDarkRemove
2353 : MessageType.spellLightRemove,
2354 tileX: event.tileX,
2355 tileY: event.tileY
2356 });
2357 continue;
2358 }
2359 if (event.type === "entity-health")
2360 {
2361 if (!seesTo && !seesFrom)
2362 { continue; }
2363 send(session, {
2364 type: MessageType.entityHealth,
2365 entityId: event.entityId,
2366 health: event.health,
2367 maxHealth: event.maxHealth
2368 });
2369 continue;
2370 }
2371 if (event.type === "gather-swing" || event.type === "tile-shove")
2372 {
2373 if (!seesTo && !seesFrom)
2374 { continue; }
2375 if (event.type === "gather-swing")
2376 {
2377 send(session, {
2378 type: MessageType.gatherSwing,
2379 attackerId: event.attackerId,
2380 tileX: event.tileX,
2381 tileY: event.tileY,
2382 fromTileX: event.fromTileX,
2383 fromTileY: event.fromTileY,
2384 toolItemId: event.toolItemId ?? null
2385 });
2386 }
2387 else
2388 {
2389 send(session, {
2390 type: MessageType.tileShove,
2391 attackerId: event.attackerId,
2392 tileX: event.tileX,
2393 tileY: event.tileY,
2394 fromTileX: event.fromTileX,
2395 fromTileY: event.fromTileY
2396 });
2397 }
2398 continue;
2399 }
2400 if (event.type === "skill-level-up")
2401 {
2402 if (session.entityId !== event.entityId && !seesTo)
2403 { continue; }
2404 send(session, {
2405 type: MessageType.skillLevelUp,
2406 entityId: event.entityId,
2407 characterId: event.characterId,
2408 skillId: event.skillId,
2409 level: event.level,
2410 previousLevel: event.previousLevel,
2411 displayName: event.displayName,
2412 icon: event.icon
2413 });
2414 continue;
2415 }
2416 if (event.type === "chunk-delta")
2417 {
2418 if (!seesStaticTo)
2419 { continue; }
2420 send(session, {
2421 type: MessageType.chunkDelta,
2422 chunkX: event.chunkX,
2423 chunkY: event.chunkY,
2424 tiles: [{
2425 localX: event.localX,
2426 localY: event.localY,
2427 block: event.block
2428 }]
2429 });
2430 continue;
2431 }
2432 if (event.type !== "entity-move")
2433 { continue; }
2434 if (seesTo)
2435 {
2436 if (!seesFrom)
2437 { send(session, spawnPayload(event)); }
2438 else
2439 {
2440 send(session, {
2441 type: MessageType.entityMove,
2442 entityId: event.entityId,
2443 tileX: event.tileX,
2444 tileY: event.tileY,
2445 worldX: event.worldX,
2446 worldY: event.worldY,
2447 gait: event.gait,
2448 lerpMs: event.lerpMs,
2449 freeFlight: !!event.freeFlight
2450 });
2451 }
2452 }
2453 else if (seesFrom)
2454 { send(session, { type: MessageType.entityDespawn, entityId: event.entityId }); }
2455 if (session.entityId === event.entityId)
2456 {
2457 const crossedDimension = event.fromDimensionId != null
2458 && event.dimensionId != null
2459 && normalizeDimensionId(event.fromDimensionId) !== normalizeDimensionId(event.dimensionId);
2460 if (!crossedDimension)
2461 { syncSubscriptions(session, false); }
2462 }
2463 }
2464 }
2465
2466 function spawnPayload (event)
2467 {
2468 const record = simulation.entityRecord(event.entityId) ?? event;
2469 return {
2470 type: MessageType.entitySpawn,
2471 entityId: event.entityId,
2472 characterId: record.characterId ?? event.characterId ?? null,
2473 accountId: record.accountId ?? event.accountId ?? null,
2474 tileX: event.tileX ?? record.tileX,
2475 tileY: event.tileY ?? record.tileY,
2476 worldX: event.worldX ?? record.worldX,
2477 worldY: event.worldY ?? record.worldY,
2478 gait: event.gait ?? record.gait,
2479 sex: record.sex ?? event.sex ?? null,
2480 firstName: record.firstName ?? event.firstName ?? "",
2481 lastName: record.lastName ?? event.lastName ?? "",
2482 sprite: record.sprite ?? event.sprite ?? null,
2483 layers: record.layers ?? event.layers ?? [],
2484 mobTypeId: record.mobTypeId ?? event.mobTypeId ?? null,
2485 canFight: !!(record.canFight ?? event.canFight),
2486 aggressive: !!(record.aggressive ?? event.aggressive ?? record.hostile ?? event.hostile),
2487 hostile: !!(record.hostile ?? event.hostile ?? record.aggressive ?? event.aggressive),
2488 talkable: !!(record.talkable ?? event.talkable),
2489 hasDialogue: !!(record.hasDialogue ?? event.hasDialogue),
2490 hasShop: !!(record.hasShop ?? event.hasShop),
2491 untargetable: !!(record.untargetable ?? event.untargetable),
2492 freeFlight: !!(record.freeFlight ?? event.freeFlight),
2493 level: record.level ?? event.level ?? null,
2494 health: record.health ?? event.health,
2495 maxHealth: record.maxHealth ?? event.maxHealth,
2496 lightRadiusTiles: record.lightRadiusTiles ?? event.lightRadiusTiles ?? 0,
2497 skullValue: record.skullValue | 0
2498 };
2499 }
2500
2501 return {
2502 sessions,
2503 onTickResult,
2504 wss,
2505 broadcastRestartStatus,
2506 setDraining (value)
2507 {
2508 draining = !!value;
2509 },
2510 async shutdown ()
2511 {
2512 draining = true;
2513 await Promise.all([...sessions.values()].map(async (session) =>
2514 {
2515 await sendAsync(session, {
2516 type: MessageType.forceLogout,
2517 reason: "Server shutting down."
2518 });
2519 leaveWorld(session);
2520 await closeAsync(session, 1001, "Server shutting down.");
2521 }));
2522 sessions.clear();
2523 await simulation.shutdown();
2524 }
2525 };
2526}
2527
2528function send (session, payload)
2529{
2530 if (session.socket.readyState === 1)
2531 { session.socket.send(JSON.stringify(payload)); }
2532}
2533
2534function sendAsync (session, payload)
2535{
2536 return new Promise((resolve) =>
2537 {
2538 if (session.socket.readyState !== 1)
2539 {
2540 resolve();
2541 return;
2542 }
2543 session.socket.send(JSON.stringify(payload), () => resolve());
2544 });
2545}
2546
2547function closeAsync (session, code, reason)
2548{
2549 return new Promise((resolve) =>
2550 {
2551 if (session.socket.readyState !== 1)
2552 {
2553 resolve();
2554 return;
2555 }
2556 session.socket.once("close", resolve);
2557 try
2558 { session.socket.close(code, reason); }
2559 catch
2560 { resolve(); }
2561 });
2562}