import { CHUNK_SIZE } from "../../../shared/protocol/constants.js"; import { BlockType } from "../../../shared/definitions/tiles.js"; import { MobId, mobDefinition, mobSpriteName } from "../../../shared/definitions/mobs.js"; import { ItemId, itemDefinition } from "../../../shared/definitions/items.js"; import { insertStack, takeFromSlot, emptySlots } from "../../../shared/items/inventory.js"; import { advanceCourierFlight } from "../../../shared/courier/flight.js"; import { GAIT } from "../../../shared/protocol/constants.js"; import { decodeChunkBlob } from "../world/chunkData.js"; export class CourierService { constructor ({ stateDb, worldDb, simulation }) { this.stateDb = stateDb; this.worldDb = worldDb; this.simulation = simulation; this.bankTiles = []; this.refreshBankIndex(); } refreshBankIndex () { const revisionId = this.worldDb.getActiveRevisionId(); const banks = []; for (const coord of this.worldDb.listChunkCoords(revisionId)) { const row = this.worldDb.getChunkVersion(coord.chunk_x, coord.chunk_y, revisionId); if (!row) { continue; } const data = decodeChunkBlob(row.data_blob, this.simulation.settings.defaultGroundTypeId); for (let localY = 0; localY < CHUNK_SIZE; localY++) { for (let localX = 0; localX < CHUNK_SIZE; localX++) { const block = data.blocks[localY * CHUNK_SIZE + localX]; if (block?.typeId !== BlockType.bank) { continue; } banks.push({ tileX: coord.chunk_x * CHUNK_SIZE + localX, tileY: coord.chunk_y * CHUNK_SIZE + localY }); } } } this.bankTiles = banks; } nearestBank (tileX, tileY) { if (!this.bankTiles.length) { return null; } let best = null; let bestDist = Infinity; for (const bank of this.bankTiles) { const dist = Math.hypot(bank.tileX - tileX, bank.tileY - tileY); if (dist < bestDist) { bestDist = dist; best = bank; } } return best; } /** * Player dispatch: cargo is money or one inventory stack. * destination: { kind: "bank" } | { kind: "player", firstName, lastName } */ dispatchFromPlayer ({ characterId, originTileX, originTileY, destination, cargo }) { const onlineId = this.simulation.characterEntities.get(characterId); const bag = onlineId ? this.simulation.bagOf(onlineId) : this.stateDb.getBag(characterId); if (!bag) { const error = new Error("No bag."); error.userFacing = true; throw error; } let takenCargo; if (cargo?.kind === "money") { const amount = Math.max(0, cargo.amount | 0); if (amount <= 0 || amount > (bag.currency | 0)) { const error = new Error("Not enough coins."); error.userFacing = true; throw error; } bag.currency -= amount; takenCargo = { kind: "money", amount }; } else if (cargo?.kind === "item") { const slot = bag.inventory?.[cargo.slotIndex | 0]; if (slot?.itemId === ItemId.letter) { if (Number(slot.instance?.authorCharacterId) !== Number(characterId)) { const error = new Error("You can only send letters you wrote."); error.userFacing = true; throw error; } } const taken = takeFromSlot(bag.inventory, cargo.slotIndex | 0, cargo.quantity ?? null); if (!taken.ok || !taken.taken) { const error = new Error("That item is not available."); error.userFacing = true; throw error; } bag.inventory = taken.slots; const stack = taken.taken; if (stack.itemId === ItemId.letter && stack.instance) { stack.instance = { ...stack.instance, opened: false }; } takenCargo = { kind: "item", stack }; } else { const error = new Error("Pigeon cargo must be money or one item stack."); error.userFacing = true; throw error; } const dest = this.#resolveDestination(destination, originTileX, originTileY); this.#persistBag(characterId, bag); const transit = this.stateDb.insertCourierTransit({ senderCharacterId: characterId, destinationKind: dest.kind, destinationCharacterId: dest.characterId ?? null, cargo: takenCargo, originX: originTileX + 0.5, originY: originTileY + 0.5, destX: dest.tileX + 0.5, destY: dest.tileY + 0.5, traveled: 0, status: "in_transit", entityId: null }); return { transit, bag }; } /** Market / system dispatch already holding cargo (no bag take). */ dispatchHeldCargo ({ senderCharacterId, originTileX, originTileY, destination, cargo }) { const dest = this.#resolveDestination(destination, originTileX, originTileY); return this.stateDb.insertCourierTransit({ senderCharacterId, destinationKind: dest.kind, destinationCharacterId: dest.characterId ?? null, cargo, originX: originTileX + 0.5, originY: originTileY + 0.5, destX: dest.tileX + 0.5, destY: dest.tileY + 0.5, traveled: 0, status: "in_transit", entityId: null }); } step (now, dt) { const events = []; const settings = this.simulation.settings; for (const transit of this.stateDb.listActiveCourierTransits()) { this.#retargetPlayerDest(transit); const advanced = advanceCourierFlight({ originX: transit.originX, originY: transit.originY, destX: transit.destX, destY: transit.destY, traveled: transit.traveled, dt, settings }); transit.traveled = advanced.traveled; transit.updatedAt = now; if (advanced.arrived) { events.push(...this.#deliver(transit, now)); continue; } events.push(...this.#syncVisiblePigeon(transit, advanced, now)); this.stateDb.updateCourierTransit(transit); } return events; } #retargetPlayerDest (transit) { if (transit.destinationKind !== "player" || !transit.destinationCharacterId) { return; } const onlineId = this.simulation.characterEntities.get(transit.destinationCharacterId); if (onlineId) { const pos = this.simulation.positionOf(onlineId); if (pos) { transit.destX = pos.tileX + 0.5; transit.destY = pos.tileY + 0.5; } return; } const character = this.stateDb.getCharacter(transit.destinationCharacterId); if (character) { transit.destX = character.tile_x + 0.5; transit.destY = character.tile_y + 0.5; } } #resolveDestination (destination, originTileX, originTileY) { if (destination?.kind === "player") { const character = this.stateDb.getCharacterByName(destination.firstName, destination.lastName); if (!character) { const error = new Error("No character with that name."); error.userFacing = true; throw error; } const onlineId = this.simulation.characterEntities.get(character.character_id); const pos = onlineId ? this.simulation.positionOf(onlineId) : null; return { kind: "player", characterId: character.character_id, tileX: pos?.tileX ?? character.tile_x, tileY: pos?.tileY ?? character.tile_y }; } if (destination?.kind === "bank") { const bank = this.nearestBank(originTileX, originTileY); if (!bank) { const error = new Error("No bank exists in the world yet."); error.userFacing = true; throw error; } return { kind: "bank", tileX: bank.tileX, tileY: bank.tileY }; } const error = new Error("Pigeon destination must be bank or player."); error.userFacing = true; throw error; } #syncVisiblePigeon (transit, advanced, now) { const events = []; const tileX = Math.floor(advanced.x); const tileY = Math.floor(advanced.y); if (!this.simulation.chunkIsSimulating(tileX, tileY)) { if (transit.entityId) { this.simulation.despawnEntity(transit.entityId); events.push({ type: "entity-despawn", entityId: transit.entityId, tileX, tileY }); transit.entityId = null; } return events; } if (!transit.entityId || !this.simulation.entityRecord(transit.entityId)) { transit.entityId = null; const def = mobDefinition(MobId.pigeon); const entityId = this.simulation.spawnEntity({ position: { tileX, tileY }, movement: { gait: GAIT.walk, walkCarry: 0 }, path: { tiles: [] }, flight: { x: advanced.x, y: advanced.y, targetX: transit.destX, targetY: transit.destY, speed: advanced.speed, nextPickAt: now + 60_000, lastAt: now, courierId: transit.courierId }, appearance: { sex: def.sex, firstName: def.displayName, lastName: "", sprite: mobSpriteName(MobId.pigeon) }, creature: { mobTypeId: MobId.pigeon }, health: { current: 1, max: 1 } }, { requireResident: true }); if (entityId != null) { transit.entityId = entityId; } return events; } const moved = this.simulation.updateCourierFlight(transit.entityId, { x: advanced.x, y: advanced.y, targetX: transit.destX, targetY: transit.destY, speed: advanced.speed, lastAt: now, courierId: transit.courierId }, now); if (moved?.despawned) { transit.entityId = null; events.push({ type: "entity-despawn", entityId: moved.entityId, tileX, tileY }); } else if (moved?.event) { events.push(moved.event); } return events; } #deliver (transit, now) { const events = []; if (transit.entityId) { this.simulation.despawnEntity(transit.entityId); events.push({ type: "entity-despawn", entityId: transit.entityId, tileX: Math.floor(transit.destX), tileY: Math.floor(transit.destY) }); transit.entityId = null; } if (transit.destinationKind === "bank") { this.#creditVault(transit.senderCharacterId, transit.cargo); } else if (transit.destinationKind === "player") { const delivered = this.#tryDeliverToPlayer(transit.destinationCharacterId, transit.cargo); if (!delivered) { const bank = this.nearestBank(Math.floor(transit.destX), Math.floor(transit.destY)) ?? this.nearestBank(Math.floor(transit.originX), Math.floor(transit.originY)); if (bank) { transit.originX = transit.destX; transit.originY = transit.destY; transit.destX = bank.tileX + 0.5; transit.destY = bank.tileY + 0.5; transit.traveled = 0; transit.destinationKind = "bank"; transit.updatedAt = now; this.stateDb.updateCourierTransit(transit); events.push({ type: "pigeon-reroute-bank", courierId: transit.courierId, characterId: transit.destinationCharacterId }); return events; } this.#creditVault(transit.destinationCharacterId, transit.cargo); } } transit.status = "delivered"; transit.traveled = Math.hypot(transit.destX - transit.originX, transit.destY - transit.originY); transit.updatedAt = now; this.stateDb.updateCourierTransit(transit); events.push({ type: "pigeon-delivered", courierId: transit.courierId, senderCharacterId: transit.senderCharacterId, destinationKind: transit.destinationKind, destinationCharacterId: transit.destinationCharacterId, cargo: transit.cargo }); return events; } #tryDeliverToPlayer (characterId, cargo) { const onlineId = this.simulation.characterEntities.get(characterId); if (onlineId) { if (cargo.kind === "money") { const bag = this.simulation.bagOf(onlineId); if (!bag) { return false; } bag.currency = (bag.currency | 0) + (cargo.amount | 0); this.#persistBag(characterId, bag); return true; } if (cargo.kind === "item") { const bag = this.simulation.bagOf(onlineId); if (!bag) { return false; } const def = itemDefinition(cargo.stack.itemId); const result = insertStack(bag.inventory, cargo.stack, def); if (!result.ok || result.remainder) { return false; } bag.inventory = result.slots; this.#persistBag(characterId, bag); return true; } } if (cargo.kind === "money") { this.#creditVault(characterId, cargo); return true; } return false; } #creditVault (characterId, cargo) { const onlineId = this.simulation.characterEntities.get(characterId); const bag = onlineId ? this.simulation.bagOf(onlineId) : this.stateDb.getBag(characterId); if (!bag) { return; } if (cargo.kind === "money") { bag.vaultCurrency = (bag.vaultCurrency | 0) + (cargo.amount | 0); this.#persistBag(characterId, bag); return; } if (cargo.kind === "item") { const def = itemDefinition(cargo.stack.itemId); const result = insertStack(bag.vault ?? emptySlots(), cargo.stack, def); bag.vault = result.ok ? result.slots : [...(bag.vault ?? []), cargo.stack]; this.#persistBag(characterId, bag); } } #persistBag (characterId, bag) { this.stateDb.saveBag(characterId, bag); const onlineId = this.simulation.characterEntities.get(characterId); if (onlineId) { this.simulation.applyBag(onlineId, bag); this.simulation.pushInventory(characterId, bag); } } }