@v12-engine/engine 0.1.0 → 0.4.0

package/dist/server/match.js

@@ -0,0 +1,267 @@
+import { commandRejected, pauseAsked } from "../engineEvents.js";
+import { errorFields } from "../log.js";
+import { SessionHost } from "../session/remote.js";
+import { writeResult } from "./ops.js";
+//#region src/server/match.ts
+/**
+* A server's game (`Match`): its world and the host that sends it, a pause, what a cheating client gets, the end of a
+* game everyone left, and its result told and kept (design review E12). The server makes one when its lobby starts a
+* game, seats the connections at it, and lets go of it back in the lobby
+*/
+/**
+* A game a server runs, from its world made to its result kept
+*
+* @internal
+*/
+var Match = class Match {
+	server;
+	world;
+	host;
+	/** Who paused the game: an admin, or a player (with a pause of theirs, for so long at most). Nobody while it runs */
+	pausedBy;
+	/** What the players are told of a game that did not end by its rules: an error thrown out of a tick, a cheat, the server stopping */
+	failed;
+	hooks;
+	resumeTimer;
+	/** Counts down to the end of a game every player has left */
+	abandoned;
+	watcher;
+	statsTimer;
+	constructor(server, world, host) {
+		this.server = server;
+		this.world = world;
+		this.host = host;
+		this.hooks = server.options.mode.rules.server ?? {};
+	}
+	/**
+	* Makes the world of a game with these settings, the computer in the seats that are its, and its host: the game's
+	* `onGameStart` told. Nobody is connected to it yet, and it does not run until `run`
+	*/
+	static async make(server, settings) {
+		const { mode } = server.options;
+		const { seats } = server;
+		const world = await mode.makeWorld({ ...settings }, {
+			log: server.logger,
+			seats: Object.fromEntries(seats.map((seat) => [seat.player, { ...seat.settings }])),
+			...server.navigation && { navigation: server.navigation }
+		});
+		world.errorPolicy ??= "end";
+		server.fill();
+		const modeSeats = seats.map((seat) => seat.mode);
+		for (const seat of seats) {
+			if (!seat.ai || !mode.ai) continue;
+			const seatSettings = { ...seat.settings };
+			const brain = typeof mode.brain === "function" ? mode.brain(seat.mode, modeSeats, seatSettings) : mode.brain;
+			world.computers.seat(seat.player, {
+				...mode.ai(seat.mode, modeSeats, seatSettings),
+				brain
+			});
+		}
+		let match;
+		world.events.on(commandRejected, ({ player, type, kind, reason }) => match.cheated(player, kind, reason, type));
+		world.events.on(pauseAsked, ({ player, seconds }) => match.pause(true, {
+			player,
+			seconds
+		}));
+		const host = new SessionHost(world, {
+			sendRate: server.options.sendRate,
+			ownsWorld: true,
+			dropSilentAfter: server.options.dropSilentAfter,
+			keptBytes: server.options.keptBytes,
+			onError: (error) => {
+				server.logger.error("server", "stepping the game threw: the game ends", {
+					error: errorFields(error),
+					game: mode.rules.id
+				});
+				if (match) match.failed = "The game stopped: an error on the server";
+				server.end();
+			},
+			onSlowTick: (ms, tick) => {
+				if (tick % 30 === 0) server.logger.warn("server", `tick ${tick} took ${ms.toFixed(1)} ms`, {
+					ms,
+					tick
+				});
+			}
+		});
+		match = new Match(server, world, host);
+		match.hooks.onGameStart?.(world, seats.map((seat) => server.publicSeat(seat)), { ...settings });
+		return match;
+	}
+	/** Runs it, those seated connected to it: its ticks, the line of its time every `stats` seconds, and the look out for its end */
+	run() {
+		const { server, host, world } = this;
+		host.start();
+		server.logger.info("server", `the game started: ${server.seats.map((seat) => `${seat.name}${seat.ai ? " (computer)" : ""}`).join(", ")}`);
+		if (server.options.stats) {
+			host.takeTiming();
+			this.statsTimer = setInterval(() => this.printStats(), server.options.stats * 1e3);
+		}
+		this.watcher = setInterval(() => {
+			if (world.winner !== null || world.failure) server.end();
+		}, 250);
+	}
+	/** A seat's client sent what an honest one never does: counted, said, and answered as the game says (`onCheat`) */
+	cheated(player, kind, reason, type) {
+		const { server } = this;
+		const seat = server.seats.find((each) => each.player === player);
+		if (!seat || seat.ai || !seat.connection) return;
+		const { kickAfter = 20, seconds = 10 } = server.options.cheating ?? {};
+		const now = performance.now();
+		const { cheats } = seat;
+		cheats.at = cheats.at.filter((at) => now - at < seconds * 1e3);
+		cheats.at.push(now);
+		cheats.total++;
+		const report = {
+			seat: server.publicSeat(seat),
+			address: seat.connection.address,
+			kind,
+			reason,
+			...type !== void 0 && { type },
+			recent: cheats.at.length,
+			total: cheats.total
+		};
+		let answer;
+		try {
+			answer = server.options.onCheat ? server.options.onCheat(report) : cheats.at.length >= kickAfter ? "kick" : "warn";
+		} catch (error) {
+			server.logger.error("server", "onCheat threw: a warning, as without it", { error: errorFields(error) });
+			answer = "warn";
+		}
+		const fields = {
+			name: seat.name,
+			player: seat.player,
+			address: report.address,
+			reason,
+			type,
+			recent: report.recent,
+			total: report.total
+		};
+		const said = `${seat.name} sent what their client never does: ${reason} (${report.recent} in ${seconds} s, ${report.total} in all)`;
+		if (answer === "ignore" || answer === void 0) return server.logger.debug("server", said, fields);
+		server.logger.warn("server", said, fields);
+		if (answer === "kick") server.kick(seat.player, "sent what the game does not let a player send");
+		else if (answer === "end") {
+			this.failed = `The game ended: ${seat.name} sent what the game does not let a player send`;
+			server.end();
+		}
+	}
+	/**
+	* Pauses the game for everyone, or lets it go on. A player's pause (`by`, from the `pause` command) ends by itself
+	* after its seconds, or when a seated player says `resume`; an admin's, when the admin says so. A player's pause is
+	* refused while an admin's holds: its timer would end the admin's
+	*/
+	pause(paused, by) {
+		const { server, world } = this;
+		if (paused && by && this.pausedBy === "admin") return;
+		this.unpause();
+		this.host.speed = paused ? 0 : 1;
+		if (paused) {
+			this.pausedBy = by?.player ?? "admin";
+			if (by) this.resumeTimer = setTimeout(() => this.pause(false), by.seconds * 1e3);
+		}
+		for (const seat of server.seats) if (!seat.ai) world.message(seat.player, { key: paused ? "gamePaused" : "gameResumed" }, "info");
+		server.tellAll({
+			type: "paused",
+			paused,
+			...paused && by && {
+				player: by.player,
+				seconds: by.seconds
+			}
+		});
+		const who = by ? server.seats.find((seat) => seat.player === by.player)?.name : void 0;
+		server.logger.info("server", paused ? `paused${who ? ` by ${who}, ${by.seconds} s at most` : ""}` : "resumed");
+	}
+	/** No pause on: its timer stopped */
+	unpause() {
+		clearTimeout(this.resumeTimer);
+		this.resumeTimer = void 0;
+		this.pausedBy = void 0;
+	}
+	/**
+	* Every player left the game: it ends after a while (`abandonAfter`), unless one comes back. Nobody else would end it:
+	* the host stops with nobody to send to, the world with it, and no winner is ever decided
+	*/
+	abandon() {
+		const after = this.server.options.abandonAfter ?? 60;
+		if (!Number.isFinite(after) || this.abandoned !== void 0) return;
+		this.server.logger.info("server", `everyone left: the game ends in ${after} seconds unless someone comes back`);
+		this.abandoned = setTimeout(() => {
+			this.abandoned = void 0;
+			if (!this.server.seats.some((each) => each.connected)) this.server.end();
+		}, after * 1e3);
+	}
+	/** Someone came back to the game, or it ended: it is not abandoned */
+	keep() {
+		clearTimeout(this.abandoned);
+		this.abandoned = void 0;
+	}
+	/**
+	* A line of where the host's time went since the last one: ticks a second against the game's rate, how long a tick
+	* of the simulation takes on average and at most, against the time a tick lasts, and the same for sending
+	*/
+	printStats() {
+		const { host, world, server } = this;
+		const timing = host.takeTiming();
+		const budget = 1e3 / world.tickRate;
+		const average = (total, count) => count ? total / count : 0;
+		const tick = average(timing.tickTime, timing.ticks);
+		const send = average(timing.sendTime, timing.sends);
+		const busy = (timing.tickTime + timing.sendTime) / (timing.seconds * 1e3) * 100;
+		server.logger.info("server", [
+			`ticks ${(timing.ticks / timing.seconds).toFixed(1)}/s of ${world.tickRate}`,
+			`step avg ${tick.toFixed(2)} ms, max ${timing.tickMax.toFixed(2)} ms (${(tick / budget * 100).toFixed(1)}% of ${budget.toFixed(1)} ms)`,
+			`send avg ${send.toFixed(2)} ms, max ${timing.sendMax.toFixed(2)} ms, ${(timing.sends / timing.seconds).toFixed(1)}/s`,
+			`busy ${busy.toFixed(1)}%`,
+			`${world.entities.size} entities, ${server.seats.filter((seat) => seat.connected).length} players and ${server.watching} watching`
+		].join(" | "));
+	}
+	/** Its timers stopped: no pause, no end looked out for or counted down to, no line of its time */
+	stop() {
+		this.keep();
+		this.unpause();
+		clearInterval(this.watcher);
+		clearInterval(this.statsTimer);
+	}
+	/** The game is over: its timers stopped, the result told to everyone and kept. The game goes on being shown */
+	async end() {
+		const { server, world } = this;
+		const { options } = server;
+		this.stop();
+		const result = {
+			game: options.mode.rules.id,
+			mode: options.mode.id,
+			winner: world.winner,
+			duration: world.time,
+			...(world.failure || this.failed) && { failed: world.failure?.message ?? this.failed },
+			seats: server.seats.map((seat) => {
+				const team = world.player(seat.player).team;
+				return {
+					...server.publicSeat(seat),
+					outcome: world.winner === null ? "none" : world.winner === team ? "victory" : "defeat"
+				};
+			})
+		};
+		this.hooks.onGameEnd?.(world, result);
+		server.tellAll({
+			type: "result",
+			result
+		});
+		server.logger.info("server", `the game ended: ${result.seats.map((seat) => `${seat.name} ${seat.outcome}`).join(", ")}`);
+		try {
+			if (this.hooks.saveResult) await this.hooks.saveResult(result);
+			else if (options.resultsDir) await writeResult(options.resultsDir, result);
+		} catch (error) {
+			server.logger.error("server", "the result could not be kept", { error: errorFields(error) });
+		}
+		try {
+			await options.ratings?.record(result);
+		} catch (error) {
+			server.logger.error("server", "the ratings could not be kept", { error: errorFields(error) });
+		}
+		return result;
+	}
+};
+//#endregion
+export { Match };
+
+//# sourceMappingURL=match.js.map

package/dist/server/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","names":["commandRejectedEvent"],"sources":["../../src/server/match.ts"],"sourcesContent":["/**\n * A server's game (`Match`): its world and the host that sends it, a pause, what a cheating client gets, the end of a\n * game everyone left, and its result told and kept (design review E12). The server makes one when its lobby starts a\n * game, seats the connections at it, and lets go of it back in the lobby\n */\nimport { commandRejected as commandRejectedEvent, pauseAsked } from '#engine/engineEvents'\nimport type { PlayerId } from '#engine/entity'\nimport type { RejectedKind } from '#engine/errors'\nimport type { GameResult, ServerHooks, ServerSeat } from '#engine/game'\nimport { errorFields, type Logger } from '#engine/log'\nimport type { NavigationBuilds } from '#engine/navigation/builds'\nimport { SessionHost } from '#engine/session/remote'\nimport type { World } from '#engine/world'\nimport type { LobbyServerMessage } from '../session/wire'\nimport type { CheatAnswer, CheatReport, GameServerOptions } from './gameServer'\nimport { writeResult } from './ops'\nimport type { Seat } from './seat'\n\n/** What a game reads of the server it is played on */\nexport interface MatchContext {\n\treadonly options: GameServerOptions\n\treadonly logger: Logger\n\treadonly seats: readonly Seat[]\n\t/** Who builds the navigation of its world, where the server says */\n\treadonly navigation?: NavigationBuilds\n\t/** How many watch now: for the line of where the host's time goes */\n\treadonly watching: number\n\tpublicSeat(seat: Seat): ServerSeat\n\t/** What nobody joined is the computer's: once the world is made, before the computers sit */\n\tfill(): void\n\t/** Tells everyone connected */\n\ttellAll(message: LobbyServerMessage): void\n\tkick(player: PlayerId, reason: string): void\n\t/** The game is over: the server ends it (`GameServer.endGame`) */\n\tend(): void\n}\n\n/**\n * A game a server runs, from its world made to its result kept\n *\n * @internal\n */\nexport class Match {\n\t/** Who paused the game: an admin, or a player (with a pause of theirs, for so long at most). Nobody while it runs */\n\tpausedBy?: PlayerId | 'admin'\n\t/** What the players are told of a game that did not end by its rules: an error thrown out of a tick, a cheat, the server stopping */\n\tfailed?: string\n\tprivate readonly hooks: ServerHooks\n\tprivate resumeTimer?: ReturnType<typeof setTimeout>\n\t/** Counts down to the end of a game every player has left */\n\tprivate abandoned?: ReturnType<typeof setTimeout>\n\tprivate watcher?: ReturnType<typeof setInterval>\n\tprivate statsTimer?: ReturnType<typeof setInterval>\n\n\tprivate constructor(\n\t\tprivate readonly server: MatchContext,\n\t\treadonly world: World,\n\t\treadonly host: SessionHost\n\t) {\n\t\tthis.hooks = server.options.mode.rules.server ?? {}\n\t}\n\n\t/**\n\t * Makes the world of a game with these settings, the computer in the seats that are its, and its host: the game's\n\t * `onGameStart` told. Nobody is connected to it yet, and it does not run until `run`\n\t */\n\tstatic async make(server: MatchContext, settings: Record<string, string>): Promise<Match> {\n\t\tconst { mode } = server.options\n\t\tconst { seats } = server\n\t\tconst world = await mode.makeWorld(\n\t\t\t{ ...settings },\n\t\t\t{\n\t\t\t\tlog: server.logger,\n\t\t\t\tseats: Object.fromEntries(seats.map((seat) => [seat.player, { ...seat.settings }])),\n\t\t\t\t...(server.navigation && { navigation: server.navigation })\n\t\t\t}\n\t\t)\n\t\t// a part of the game that throws ends this game, and no other, unless the game says otherwise (`Rules.onError`)\n\t\tworld.errorPolicy ??= 'end'\n\t\tserver.fill()\n\t\tconst modeSeats = seats.map((seat) => seat.mode)\n\t\tfor (const seat of seats) {\n\t\t\tif (!seat.ai || !mode.ai) continue\n\t\t\tconst seatSettings = { ...seat.settings }\n\t\t\t// the brain the mode says, else the first the game lists; remembered by the world, so a\n\t\t\t// save of the game has its computers back (`core.computers`)\n\t\t\tconst brain = typeof mode.brain === 'function' ? mode.brain(seat.mode, modeSeats, seatSettings) : mode.brain\n\t\t\tworld.computers.seat(seat.player, { ...mode.ai(seat.mode, modeSeats, seatSettings), brain })\n\t\t}\n\t\tlet match: Match | undefined\n\t\tworld.events.on(commandRejectedEvent, ({ player, type, kind, reason }) => match!.cheated(player, kind, reason, type))\n\t\t// a player asked for a pause, and the rules let them: the host stops until it is over\n\t\tworld.events.on(pauseAsked, ({ player, seconds }) => match!.pause(true, { player, seconds }))\n\t\tconst host = new SessionHost(world, {\n\t\t\tsendRate: server.options.sendRate,\n\t\t\t// the game's world goes with it: back to the lobby, or the server closed\n\t\t\townsWorld: true,\n\t\t\tdropSilentAfter: server.options.dropSilentAfter,\n\t\t\tkeptBytes: server.options.keptBytes,\n\t\t\t// whatever is thrown out of a tick all the same (a game that asks for `throw`, a fault of the engine's)\n\t\t\tonError: (error) => {\n\t\t\t\tserver.logger.error('server', 'stepping the game threw: the game ends', { error: errorFields(error), game: mode.rules.id })\n\t\t\t\tif (match) match.failed = 'The game stopped: an error on the server'\n\t\t\t\tserver.end()\n\t\t\t},\n\t\t\tonSlowTick: (ms, tick) => {\n\t\t\t\tif (tick % 30 === 0) server.logger.warn('server', `tick ${tick} took ${ms.toFixed(1)} ms`, { ms, tick })\n\t\t\t}\n\t\t})\n\t\tmatch = new Match(server, world, host)\n\t\tmatch.hooks.onGameStart?.(\n\t\t\tworld,\n\t\t\tseats.map((seat) => server.publicSeat(seat)),\n\t\t\t{ ...settings }\n\t\t)\n\t\treturn match\n\t}\n\n\t/** Runs it, those seated connected to it: its ticks, the line of its time every `stats` seconds, and the look out for its end */\n\trun(): void {\n\t\tconst { server, host, world } = this\n\t\thost.start()\n\t\tserver.logger.info('server', `the game started: ${server.seats.map((seat) => `${seat.name}${seat.ai ? ' (computer)' : ''}`).join(', ')}`)\n\t\tif (server.options.stats) {\n\t\t\thost.takeTiming()\n\t\t\tthis.statsTimer = setInterval(() => this.printStats(), server.options.stats * 1000)\n\t\t}\n\t\tthis.watcher = setInterval(() => {\n\t\t\tif (world.winner !== null || world.failure) server.end()\n\t\t}, 250)\n\t}\n\n\t/** A seat's client sent what an honest one never does: counted, said, and answered as the game says (`onCheat`) */\n\tprivate cheated(player: PlayerId | undefined, kind: RejectedKind, reason: string, type?: string): void {\n\t\tconst { server } = this\n\t\tconst seat = server.seats.find((each) => each.player === player)\n\t\tif (!seat || seat.ai || !seat.connection) return\n\t\tconst { kickAfter = 20, seconds = 10 } = server.options.cheating ?? {}\n\t\tconst now = performance.now()\n\t\tconst { cheats } = seat\n\t\tcheats.at = cheats.at.filter((at) => now - at < seconds * 1000)\n\t\tcheats.at.push(now)\n\t\tcheats.total++\n\t\tconst report: CheatReport = {\n\t\t\tseat: server.publicSeat(seat),\n\t\t\taddress: seat.connection.address,\n\t\t\tkind,\n\t\t\treason,\n\t\t\t...(type !== undefined && { type }),\n\t\t\trecent: cheats.at.length,\n\t\t\ttotal: cheats.total\n\t\t}\n\t\tlet answer: CheatAnswer | void\n\t\ttry {\n\t\t\tanswer = server.options.onCheat ? server.options.onCheat(report) : cheats.at.length >= kickAfter ? 'kick' : 'warn'\n\t\t} catch (error) {\n\t\t\tserver.logger.error('server', 'onCheat threw: a warning, as without it', { error: errorFields(error) })\n\t\t\tanswer = 'warn'\n\t\t}\n\t\tconst fields = { name: seat.name, player: seat.player, address: report.address, reason, type, recent: report.recent, total: report.total }\n\t\tconst said = `${seat.name} sent what their client never does: ${reason} (${report.recent} in ${seconds} s, ${report.total} in all)`\n\t\tif (answer === 'ignore' || answer === undefined) return server.logger.debug('server', said, fields)\n\t\tserver.logger.warn('server', said, fields)\n\t\tif (answer === 'kick') server.kick(seat.player, 'sent what the game does not let a player send')\n\t\telse if (answer === 'end') {\n\t\t\tthis.failed = `The game ended: ${seat.name} sent what the game does not let a player send`\n\t\t\tserver.end()\n\t\t}\n\t}\n\n\t/**\n\t * Pauses the game for everyone, or lets it go on. A player's pause (`by`, from the `pause` command) ends by itself\n\t * after its seconds, or when a seated player says `resume`; an admin's, when the admin says so. A player's pause is\n\t * refused while an admin's holds: its timer would end the admin's\n\t */\n\tpause(paused: boolean, by?: { player: PlayerId; seconds: number }): void {\n\t\tconst { server, world } = this\n\t\tif (paused && by && this.pausedBy === 'admin') return\n\t\tthis.unpause()\n\t\tthis.host.speed = paused ? 0 : 1\n\t\tif (paused) {\n\t\t\tthis.pausedBy = by?.player ?? 'admin'\n\t\t\tif (by) this.resumeTimer = setTimeout(() => this.pause(false), by.seconds * 1000)\n\t\t}\n\t\tfor (const seat of server.seats) if (!seat.ai) world.message(seat.player, { key: paused ? 'gamePaused' : 'gameResumed' }, 'info')\n\t\t// paused, no tick goes by that would carry the message: it is told on the side too\n\t\tserver.tellAll({ type: 'paused', paused, ...(paused && by && { player: by.player, seconds: by.seconds }) })\n\t\tconst who = by ? server.seats.find((seat) => seat.player === by.player)?.name : undefined\n\t\tserver.logger.info('server', paused ? `paused${who ? ` by ${who}, ${by!.seconds} s at most` : ''}` : 'resumed')\n\t}\n\n\t/** No pause on: its timer stopped */\n\tprivate unpause(): void {\n\t\tclearTimeout(this.resumeTimer)\n\t\tthis.resumeTimer = undefined\n\t\tthis.pausedBy = undefined\n\t}\n\n\t/**\n\t * Every player left the game: it ends after a while (`abandonAfter`), unless one comes back. Nobody else would end it:\n\t * the host stops with nobody to send to, the world with it, and no winner is ever decided\n\t */\n\tabandon(): void {\n\t\tconst after = this.server.options.abandonAfter ?? 60\n\t\tif (!Number.isFinite(after) || this.abandoned !== undefined) return\n\t\tthis.server.logger.info('server', `everyone left: the game ends in ${after} seconds unless someone comes back`)\n\t\tthis.abandoned = setTimeout(() => {\n\t\t\tthis.abandoned = undefined\n\t\t\tif (!this.server.seats.some((each) => each.connected)) this.server.end()\n\t\t}, after * 1000)\n\t}\n\n\t/** Someone came back to the game, or it ended: it is not abandoned */\n\tkeep(): void {\n\t\tclearTimeout(this.abandoned)\n\t\tthis.abandoned = undefined\n\t}\n\n\t/**\n\t * A line of where the host's time went since the last one: ticks a second against the game's rate, how long a tick\n\t * of the simulation takes on average and at most, against the time a tick lasts, and the same for sending\n\t */\n\tprivate printStats(): void {\n\t\tconst { host, world, server } = this\n\t\tconst timing = host.takeTiming()\n\t\tconst budget = 1000 / world.tickRate\n\t\tconst average = (total: number, count: number) => (count ? total / count : 0)\n\t\tconst tick = average(timing.tickTime, timing.ticks)\n\t\tconst send = average(timing.sendTime, timing.sends)\n\t\tconst busy = ((timing.tickTime + timing.sendTime) / (timing.seconds * 1000)) * 100\n\t\tserver.logger.info(\n\t\t\t'server',\n\t\t\t[\n\t\t\t\t`ticks ${(timing.ticks / timing.seconds).toFixed(1)}/s of ${world.tickRate}`,\n\t\t\t\t`step avg ${tick.toFixed(2)} ms, max ${timing.tickMax.toFixed(2)} ms (${((tick / budget) * 100).toFixed(1)}% of ${budget.toFixed(1)} ms)`,\n\t\t\t\t`send avg ${send.toFixed(2)} ms, max ${timing.sendMax.toFixed(2)} ms, ${(timing.sends / timing.seconds).toFixed(1)}/s`,\n\t\t\t\t`busy ${busy.toFixed(1)}%`,\n\t\t\t\t`${world.entities.size} entities, ${server.seats.filter((seat) => seat.connected).length} players and ${server.watching} watching`\n\t\t\t].join(' | ')\n\t\t)\n\t}\n\n\t/** Its timers stopped: no pause, no end looked out for or counted down to, no line of its time */\n\tstop(): void {\n\t\tthis.keep()\n\t\tthis.unpause()\n\t\tclearInterval(this.watcher)\n\t\tclearInterval(this.statsTimer)\n\t}\n\n\t/** The game is over: its timers stopped, the result told to everyone and kept. The game goes on being shown */\n\tasync end(): Promise<GameResult> {\n\t\tconst { server, world } = this\n\t\tconst { options } = server\n\t\tthis.stop()\n\t\tconst result: GameResult = {\n\t\t\tgame: options.mode.rules.id,\n\t\t\tmode: options.mode.id,\n\t\t\twinner: world.winner,\n\t\t\tduration: world.time,\n\t\t\t...((world.failure || this.failed) && { failed: world.failure?.message ?? this.failed }),\n\t\t\tseats: server.seats.map((seat) => {\n\t\t\t\tconst team = world.player(seat.player).team\n\t\t\t\treturn {\n\t\t\t\t\t...server.publicSeat(seat),\n\t\t\t\t\toutcome: world.winner === null ? 'none' : world.winner === team ? 'victory' : 'defeat'\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t\tthis.hooks.onGameEnd?.(world, result)\n\t\tserver.tellAll({ type: 'result', result })\n\t\tserver.logger.info('server', `the game ended: ${result.seats.map((seat) => `${seat.name} ${seat.outcome}`).join(', ')}`)\n\t\ttry {\n\t\t\tif (this.hooks.saveResult) await this.hooks.saveResult(result)\n\t\t\telse if (options.resultsDir) await writeResult(options.resultsDir, result)\n\t\t} catch (error) {\n\t\t\tserver.logger.error('server', 'the result could not be kept', { error: errorFields(error) })\n\t\t}\n\t\ttry {\n\t\t\tawait options.ratings?.record(result)\n\t\t} catch (error) {\n\t\t\tserver.logger.error('server', 'the ratings could not be kept', { error: errorFields(error) })\n\t\t}\n\t\treturn result\n\t}\n}\n"],"mappings":"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"}

package/dist/server/mode.d.ts

@@ -1,9 +1,10 @@
 import type { Logger } from '#engine/log';
 import type { NavigationBuilds } from '#engine/navigation/builds';
+import { type Game } from '#engine/createGame';
 import type { BrainDef } from '#engine/ai/brain';
 import type { AiOptions } from '#engine/ai/options';
 import type { PlayerId } from '#engine/entity';
-import { type GameModule, type ServerHooks } from '#engine/game';
+import { type Rules, type ServerHooks } from '#engine/game';
 import { type GeneratorOptions, type MapGenerator } from '#engine/generate';
 import { type GameMap } from '#engine/map';
 import type { Vec2 } from '#engine/math';
@@ -14,7 +15,9 @@ import type { World } from '#engine/world';
  * @beta
  */
 export interface ModeSeat {
+    /** The world's player this seat plays */
     player: PlayerId;
+    /** The seat's default name, shown in the lobby */
     name: string;
     /** Where it starts, for a computer player to know where its opponents are */
     base?: Vec2;
@@ -35,12 +38,16 @@ export interface ModeSeat {
  * What a server runs: a game module, the seats of a game of it, and how its world is made. Each game starts from a
  * world made anew, with the lobby's settings
  *
- * @beta
+ * @public
  */
 export interface GameMode {
+    /** The id of the mode, used to name the game it runs */
     id: string;
+    /** The mode's name as shown to players */
     name: string;
-    game: GameModule;
+    /** The game's rules each world of the mode is made with */
+    rules: Rules;
+    /** The seats of a game of this mode, in the order the lobby lists them */
     seats: ModeSeat[];
     /**
      * What can be chosen for each seat in the lobby, in place of what the game offers (`seatSettingsOf(game)`): the races
@@ -64,7 +71,7 @@ export interface GameMode {
      */
     ai?(seat: ModeSeat, seats: readonly ModeSeat[], settings: Readonly<Record<string, string>>): AiOptions;
     /**
-     * Which brain plays a seat of the computer (`defineBrain`), or its id (one the game lists in `GameModule.brains`, or
+     * Which brain plays a seat of the computer (`defineBrain`), or its id (one the game lists in `Rules.brains`, or
      * the engine's `core.melee`): one for every seat, or one by seat, with what was chosen for it in the lobby. The first
      * brain the game lists when left out
      */
@@ -136,17 +143,18 @@ export interface MapModeOptions {
      * What the game does once a world is made from the map, before anyone plays (the game's `start`, as a page or
      * `startServer` runs it): the units at each start, the first wave sent. Nothing when left out
      */
-    start?: (world: World, context: {
+    onStart?: (world: World, context: {
         map: GameMap;
         settings: Record<string, string>;
     }) => void | Promise<void>;
 }
 /**
- * A game on a map of it: a seat for each player the map has a start for, and a world made from the map for each game
+ * A game on a map of it: a seat for each player the map has a start for, and a world made from the map for each game.
+ * The game (`createGame`) or its module (`Rules`): a game's start (`Game.onStart`) runs where `onStart` is left out
  *
- * @beta
+ * @public
  */
-export declare function mapMode(game: GameModule, map: GameMap, options?: MapModeOptions): GameMode;
+export declare function mapMode(source: Game<unknown> | Rules, map: GameMap, options?: MapModeOptions): GameMode;
 /**
  * How a mode on a generated map is made (`generatedMode`): the generator's options (the seed a new one each time
  * when left out), and what a mode on a map takes
@@ -154,6 +162,7 @@ export declare function mapMode(game: GameModule, map: GameMap, options?: MapMod
  * @beta
  */
 export interface GeneratedModeOptions extends Omit<GeneratorOptions, 'seed'>, MapModeOptions {
+    /** The generator's seed; a new one each time when left out */
     seed?: number;
 }
 /**
@@ -163,6 +172,6 @@ export interface GeneratedModeOptions extends Omit<GeneratorOptions, 'seed'>, Ma
  *
  * @beta
  */
-export declare function generatedMode(game: GameModule, generator: MapGenerator, options: GeneratedModeOptions): GameMode & {
+export declare function generatedMode(source: Game<unknown> | Rules, generator: MapGenerator, options: GeneratedModeOptions): GameMode & {
     map: GameMap;
 };

package/dist/server/mode.js

@@ -0,0 +1,220 @@
+import { PLAYER_COLORS } from "../map/types.js";
+import { createRegistry, createWorldFromMap } from "../game.js";
+import { randomSeed } from "../session/seed.js";
+import { generateMap } from "../generate.js";
+import { rulesOf, startOf } from "../createGame.js";
+import { seatSettingsOf } from "./seatSettings.js";
+//#region src/server/mode.ts
+/**
+* A computer player that goes for everyone else's base: what a seat of the computer does when the server says nothing
+* else. As hard as its seat's `difficulty` says and of the `personality` it says, where the game offers them to choose
+* (`ServerHooks.seatSettings`, `seatSettingsOf`); a name the game does not have is left to the defaults
+*
+* @beta
+*/
+var againstTheRest = (seat, seats, settings = {}) => ({
+	enemyBases: seats.filter((other) => other !== seat && other.base).map((other) => other.base),
+	...settings.difficulty && { difficulty: settings.difficulty },
+	...settings.personality && { personality: settings.personality }
+});
+/**
+* The race chosen for each seat in the lobby, by player: none where nobody chose one, or the game has no races
+*
+* @beta
+*/
+function racesOfSeats(seats) {
+	if (!seats) return void 0;
+	const races = {};
+	for (const [player, settings] of Object.entries(seats)) if (settings.race !== void 0) races[Number(player)] = settings.race;
+	return Object.keys(races).length ? races : void 0;
+}
+/**
+* The seats a map has room for: a seat for each of its players with a start, the creeps apart
+*
+* @beta
+*/
+var seatsOf = (map) => map.players.filter((player) => player.start && player.id !== 90).map((player) => ({
+	player: player.id,
+	name: player.name,
+	base: player.start,
+	team: player.team,
+	preset: {
+		team: String(player.team),
+		color: String(nearestColor(player.color) + 1)
+	},
+	...player.race !== void 0 && { fixed: { race: player.race } }
+}));
+/**
+* The names of the players' colours (`PLAYER_COLORS`), in their order, as a lobby shows them
+*
+* @beta
+*/
+var PLAYER_COLOR_NAMES = [
+	"Blue",
+	"Red",
+	"Teal",
+	"Purple",
+	"Yellow",
+	"Orange",
+	"Green",
+	"Pink",
+	"Grey",
+	"Light blue",
+	"Dark green",
+	"Brown",
+	"Maroon",
+	"Navy",
+	"Turquoise",
+	"Violet",
+	"Wheat",
+	"Peach",
+	"Mint",
+	"Lavender",
+	"Coal",
+	"Snow",
+	"Emerald",
+	"Peanut"
+];
+/** The colour of the players' (`PLAYER_COLORS`) nearest one, by its index */
+function nearestColor(color) {
+	let best = 0;
+	let least = Infinity;
+	PLAYER_COLORS.forEach((each, index) => {
+		const [r, g, b] = [
+			each[0] - color[0],
+			each[1] - color[1],
+			each[2] - color[2]
+		];
+		const apart = r * r + g * g + b * b;
+		if (apart < least) {
+			least = apart;
+			best = index;
+		}
+	});
+	return best;
+}
+/**
+* What a lobby offers to choose for each seat of a map's game beside the game's own: a team, of as many as there are
+* seats, and a colour of the players' (`PLAYER_COLORS`, by `PLAYER_COLOR_NAMES`), no two seats the same. Each seat has
+* the map's until chosen otherwise (`ModeSeat.preset`)
+*
+* @beta
+*/
+function seatLooksOf(seats) {
+	const teams = Math.max(seats.length, ...seats.map((seat) => seat.team ?? 0));
+	const numbers = (count) => Array.from({ length: count }, (_, i) => String(i + 1));
+	return {
+		team: {
+			label: "Team",
+			options: numbers(teams),
+			labels: Object.fromEntries(numbers(teams).map((id) => [id, `Team ${id}`])),
+			default: "1"
+		},
+		color: {
+			label: "Colour",
+			options: numbers(PLAYER_COLORS.length),
+			labels: Object.fromEntries(PLAYER_COLOR_NAMES.map((name, i) => [String(i + 1), name])),
+			default: "1",
+			unique: true
+		}
+	};
+}
+/**
+* The teams and colours chosen in the lobby (`seatLooksOf`), by player, where they are not the map's: what
+* `MapWorldOptions.teams` and `colors` take
+*
+* @beta
+*/
+function looksOfSeats(seats, modeSeats) {
+	const teams = {};
+	const colors = {};
+	for (const seat of modeSeats) {
+		const chosen = seats?.[seat.player];
+		if (!chosen) continue;
+		const team = Number(chosen.team);
+		if (chosen.team !== void 0 && chosen.team !== seat.preset?.team && Number.isInteger(team) && team > 0) teams[seat.player] = team;
+		const color = PLAYER_COLORS[Number(chosen.color) - 1];
+		if (chosen.color !== void 0 && chosen.color !== seat.preset?.color && color) colors[seat.player] = [...color];
+	}
+	return {
+		...Object.keys(teams).length && { teams },
+		...Object.keys(colors).length && { colors }
+	};
+}
+/**
+* A game on a map of it: a seat for each player the map has a start for, and a world made from the map for each game.
+* The game (`createGame`) or its module (`Rules`): a game's start (`Game.onStart`) runs where `onStart` is left out
+*
+* @public
+*/
+function mapMode(source, map, options = {}) {
+	const game = rulesOf(source);
+	const onStart = options.onStart ?? startOf(source);
+	const seats = options.seats ?? seatsOf(map);
+	return {
+		id: `map:${map.name}`,
+		name: map.name,
+		rules: game,
+		seats,
+		seatSettings: {
+			...seatSettingsOf(game, map.races),
+			...seatLooksOf(seats)
+		},
+		async makeWorld(settings, context) {
+			const made = structuredClone(map);
+			const world = await createWorldFromMap({
+				map: made,
+				rules: game,
+				seed: randomSeed(),
+				log: context?.log,
+				races: racesOfSeats(context?.seats),
+				...looksOfSeats(context?.seats, seats),
+				...context?.navigation && { navigation: { builds: context.navigation } }
+			});
+			try {
+				await onStart?.(world, {
+					map: made,
+					settings
+				});
+			} catch (error) {
+				world.dispose();
+				throw error;
+			}
+			return world;
+		},
+		...options.ai !== null && { ai: options.ai ?? againstTheRest },
+		...options.brain !== void 0 && { brain: options.brain }
+	};
+}
+/**
+* A game on a map made by a generator (`generateMap`): the map made once, with the seed given or a new one, and a
+* game of it as on any map (`mapMode`): a seat for each start, the world made from it for each game. For a room of a
+* random map (`RoomKind.room` as a function: a new map for each room made)
+*
+* @beta
+*/
+function generatedMode(source, generator, options) {
+	const game = rulesOf(source);
+	const { ai, brain, seats, ...generating } = options;
+	const onStart = options.onStart ?? startOf(source);
+	const seed = options.seed ?? 1 + Math.floor(Math.random() * 999999);
+	const { map } = generateMap(generator, {
+		...generating,
+		seed,
+		name: options.name ?? `A random map (${seed})`
+	}, createRegistry(game));
+	return {
+		...mapMode(game, map, {
+			onStart,
+			ai,
+			brain,
+			seats
+		}),
+		id: `generated:${map.generated?.seed ?? seed}`,
+		map
+	};
+}
+//#endregion
+export { PLAYER_COLOR_NAMES, againstTheRest, generatedMode, looksOfSeats, mapMode, racesOfSeats, seatLooksOf, seatsOf };
+
+//# sourceMappingURL=mode.js.map

package/dist/server/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","names":[],"sources":["../../src/server/mode.ts"],"sourcesContent":["import type { Logger } from '#engine/log'\nimport type { NavigationBuilds } from '#engine/navigation/builds'\nimport { randomSeed } from '#engine/session/seed'\nimport { type Game, rulesOf, startOf } from '#engine/createGame'\nimport type { BrainDef } from '#engine/ai/brain'\nimport type { AiOptions } from '#engine/ai/options'\nimport type { PlayerId } from '#engine/entity'\nimport { createWorldFromMap, type Rules, type ServerHooks, createRegistry } from '#engine/game'\nimport { generateMap, type GeneratorOptions, type MapGenerator } from '#engine/generate'\nimport { type GameMap, MAP_CREEPS, PLAYER_COLORS } from '#engine/map'\nimport type { Vec2 } from '#engine/math'\nimport type { World } from '#engine/world'\nimport { seatSettingsOf } from './seatSettings'\n\n/**\n * A seat a mode has: a player of the world, by default for whoever joins, or for the computer\n *\n * @beta\n */\nexport interface ModeSeat {\n\t/** The world's player this seat plays */\n\tplayer: PlayerId\n\t/** The seat's default name, shown in the lobby */\n\tname: string\n\t/** Where it starts, for a computer player to know where its opponents are */\n\tbase?: Vec2\n\t/** The team it plays for, shown in the lobby: the map's, for a mode made from a map */\n\tteam?: number\n\t/**\n\t * Settings of the seat that are not the lobby's to choose, by name (`ServerHooks.seatSettings`): the race a map gives\n\t * its player (`MapPlayer.race`)\n\t */\n\tfixed?: Record<string, string>\n\t/**\n\t * Settings of the seat chosen for it until someone chooses otherwise, by name: its team and its colour on the map\n\t * (`seatLooksOf`)\n\t */\n\tpreset?: Record<string, string>\n}\n\n/**\n * What a server runs: a game module, the seats of a game of it, and how its world is made. Each game starts from a\n * world made anew, with the lobby's settings\n *\n * @public\n */\nexport interface GameMode {\n\t/** The id of the mode, used to name the game it runs */\n\tid: string\n\t/** The mode's name as shown to players */\n\tname: string\n\t/** The game's rules each world of the mode is made with */\n\trules: Rules\n\t/** The seats of a game of this mode, in the order the lobby lists them */\n\tseats: ModeSeat[]\n\t/**\n\t * What can be chosen for each seat in the lobby, in place of what the game offers (`seatSettingsOf(game)`): the races\n\t * a map offers (`GameMap.races`)\n\t */\n\tseatSettings?: NonNullable<ServerHooks['seatSettings']>\n\t/**\n\t * Makes the world of a game. `context.log` is the server's logger, for the world's own to be made under;\n\t * `context.seats` what was chosen for each seat in the lobby, by player (`ServerHooks.seatSettings`): a race among\n\t * them, in a game with races (`seatSettingsOf`), for the world to give each player (`MapWorldOptions.races`);\n\t * `context.navigation` who builds its navigation (the server's worker thread: `GameServerOptions.navigationWorker`)\n\t */\n\tmakeWorld(\n\t\tsettings: Record<string, string>,\n\t\tcontext?: { log?: Logger; seats?: Readonly<Record<PlayerId, Readonly<Record<string, string>>>>; navigation?: NavigationBuilds }\n\t): Promise<World>\n\t/**\n\t * How a computer player in a seat plays: with what was chosen for that seat in the lobby (`settings`, from\n\t * `ServerHooks.seatSettings`: a difficulty, a race). No computer players without\n\t */\n\tai?(seat: ModeSeat, seats: readonly ModeSeat[], settings: Readonly<Record<string, string>>): AiOptions\n\t/**\n\t * Which brain plays a seat of the computer (`defineBrain`), or its id (one the game lists in `Rules.brains`, or\n\t * the engine's `core.melee`): one for every seat, or one by seat, with what was chosen for it in the lobby. The first\n\t * brain the game lists when left out\n\t */\n\tbrain?: ModeBrain\n}\n\n/**\n * Which brain plays a seat of the computer on a server (`GameMode.brain`): a brain, its id, or one chosen by seat\n *\n * @beta\n */\nexport type ModeBrain =\n\tBrainDef | string | ((seat: ModeSeat, seats: readonly ModeSeat[], settings: Readonly<Record<string, string>>) => BrainDef | string | undefined)\n\n/**\n * A computer player that goes for everyone else's base: what a seat of the computer does when the server says nothing\n * else. As hard as its seat's `difficulty` says and of the `personality` it says, where the game offers them to choose\n * (`ServerHooks.seatSettings`, `seatSettingsOf`); a name the game does not have is left to the defaults\n *\n * @beta\n */\nexport const againstTheRest = (seat: ModeSeat, seats: readonly ModeSeat[], settings: Readonly<Record<string, string>> = {}): AiOptions => ({\n\tenemyBases: seats.filter((other) => other !== seat && other.base).map((other) => other.base!),\n\t...(settings.difficulty && { difficulty: settings.difficulty }),\n\t...(settings.personality && { personality: settings.personality })\n})\n\n/**\n * The race chosen for each seat in the lobby, by player: none where nobody chose one, or the game has no races\n *\n * @beta\n */\nexport function racesOfSeats(seats: Readonly<Record<PlayerId, Readonly<Record<string, string>>>> | undefined): Record<PlayerId, string> | undefined {\n\tif (!seats) return undefined\n\tconst races: Record<PlayerId, string> = {}\n\tfor (const [player, settings] of Object.entries(seats)) if (settings.race !== undefined) races[Number(player)] = settings.race\n\treturn Object.keys(races).length ? races : undefined\n}\n\n/**\n * The seats a map has room for: a seat for each of its players with a start, the creeps apart\n *\n * @beta\n */\nexport const seatsOf = (map: GameMap): ModeSeat[] =>\n\tmap.players\n\t\t.filter((player) => player.start && player.id !== MAP_CREEPS)\n\t\t.map((player) => ({\n\t\t\tplayer: player.id,\n\t\t\tname: player.name,\n\t\t\tbase: player.start,\n\t\t\tteam: player.team,\n\t\t\t// its team and colour as the map has them, until the lobby chooses others\n\t\t\tpreset: { team: String(player.team), color: String(nearestColor(player.color) + 1) },\n\t\t\t...(player.race !== undefined && { fixed: { race: player.race } })\n\t\t}))\n\n/**\n * The names of the players' colours (`PLAYER_COLORS`), in their order, as a lobby shows them\n *\n * @beta\n */\nexport const PLAYER_COLOR_NAMES = [\n\t'Blue',\n\t'Red',\n\t'Teal',\n\t'Purple',\n\t'Yellow',\n\t'Orange',\n\t'Green',\n\t'Pink',\n\t'Grey',\n\t'Light blue',\n\t'Dark green',\n\t'Brown',\n\t'Maroon',\n\t'Navy',\n\t'Turquoise',\n\t'Violet',\n\t'Wheat',\n\t'Peach',\n\t'Mint',\n\t'Lavender',\n\t'Coal',\n\t'Snow',\n\t'Emerald',\n\t'Peanut'\n] as const\n\n/** The colour of the players' (`PLAYER_COLORS`) nearest one, by its index */\nfunction nearestColor(color: readonly [number, number, number]): number {\n\tlet best = 0\n\tlet least = Infinity\n\tPLAYER_COLORS.forEach((each, index) => {\n\t\tconst [r, g, b] = [each[0] - color[0], each[1] - color[1], each[2] - color[2]]\n\t\tconst apart = r * r + g * g + b * b\n\t\tif (apart < least) {\n\t\t\tleast = apart\n\t\t\tbest = index\n\t\t}\n\t})\n\treturn best\n}\n\n/**\n * What a lobby offers to choose for each seat of a map's game beside the game's own: a team, of as many as there are\n * seats, and a colour of the players' (`PLAYER_COLORS`, by `PLAYER_COLOR_NAMES`), no two seats the same. Each seat has\n * the map's until chosen otherwise (`ModeSeat.preset`)\n *\n * @beta\n */\nexport function seatLooksOf(seats: readonly ModeSeat[]): NonNullable<ServerHooks['seatSettings']> {\n\tconst teams = Math.max(seats.length, ...seats.map((seat) => seat.team ?? 0))\n\tconst numbers = (count: number) => Array.from({ length: count }, (_, i) => String(i + 1))\n\treturn {\n\t\tteam: {\n\t\t\tlabel: 'Team',\n\t\t\toptions: numbers(teams),\n\t\t\tlabels: Object.fromEntries(numbers(teams).map((id) => [id, `Team ${id}`])),\n\t\t\tdefault: '1'\n\t\t},\n\t\tcolor: {\n\t\t\tlabel: 'Colour',\n\t\t\toptions: numbers(PLAYER_COLORS.length),\n\t\t\tlabels: Object.fromEntries(PLAYER_COLOR_NAMES.map((name, i) => [String(i + 1), name])),\n\t\t\tdefault: '1',\n\t\t\tunique: true\n\t\t}\n\t}\n}\n\n/**\n * The teams and colours chosen in the lobby (`seatLooksOf`), by player, where they are not the map's: what\n * `MapWorldOptions.teams` and `colors` take\n *\n * @beta\n */\nexport function looksOfSeats(\n\tseats: Readonly<Record<PlayerId, Readonly<Record<string, string>>>> | undefined,\n\tmodeSeats: readonly ModeSeat[]\n): { teams?: Record<PlayerId, number>; colors?: Record<PlayerId, [number, number, number]> } {\n\tconst teams: Record<PlayerId, number> = {}\n\tconst colors: Record<PlayerId, [number, number, number]> = {}\n\tfor (const seat of modeSeats) {\n\t\tconst chosen = seats?.[seat.player]\n\t\tif (!chosen) continue\n\t\tconst team = Number(chosen.team)\n\t\tif (chosen.team !== undefined && chosen.team !== seat.preset?.team && Number.isInteger(team) && team > 0) teams[seat.player] = team\n\t\tconst color = PLAYER_COLORS[Number(chosen.color) - 1]\n\t\tif (chosen.color !== undefined && chosen.color !== seat.preset?.color && color) colors[seat.player] = [...color]\n\t}\n\treturn { ...(Object.keys(teams).length && { teams }), ...(Object.keys(colors).length && { colors }) }\n}\n\n/**\n * How a mode is made from a map (`mapMode`)\n *\n * @beta\n */\nexport interface MapModeOptions {\n\t/** The seats a player may take. One for each player of the map with a start when left out */\n\tseats?: ModeSeat[]\n\t/** How a computer player in a seat plays: against everyone else's base when left out, `null` for none */\n\tai?: GameMode['ai'] | null\n\t/** Which brain plays a seat of the computer: the first the game lists when left out */\n\tbrain?: ModeBrain\n\t/**\n\t * What the game does once a world is made from the map, before anyone plays (the game's `start`, as a page or\n\t * `startServer` runs it): the units at each start, the first wave sent. Nothing when left out\n\t */\n\tonStart?: (world: World, context: { map: GameMap; settings: Record<string, string> }) => void | Promise<void>\n}\n\n/**\n * A game on a map of it: a seat for each player the map has a start for, and a world made from the map for each game.\n * The game (`createGame`) or its module (`Rules`): a game's start (`Game.onStart`) runs where `onStart` is left out\n *\n * @public\n */\nexport function mapMode(source: Game<unknown> | Rules, map: GameMap, options: MapModeOptions = {}): GameMode {\n\tconst game = rulesOf(source)\n\tconst onStart = options.onStart ?? startOf(source)\n\tconst seats = options.seats ?? seatsOf(map)\n\treturn {\n\t\tid: `map:${map.name}`,\n\t\tname: map.name,\n\t\trules: game,\n\t\tseats,\n\t\t// the game's (a race among the map's), and a team and a colour\n\t\tseatSettings: { ...seatSettingsOf(game, map.races), ...seatLooksOf(seats) },\n\t\tasync makeWorld(settings, context) {\n\t\t\tconst made = structuredClone(map)\n\t\t\tconst world = await createWorldFromMap({\n\t\t\t\tmap: made,\n\t\t\t\trules: game,\n\t\t\t\tseed: randomSeed(),\n\t\t\t\tlog: context?.log,\n\t\t\t\traces: racesOfSeats(context?.seats),\n\t\t\t\t...looksOfSeats(context?.seats, seats),\n\t\t\t\t...(context?.navigation && { navigation: { builds: context.navigation } })\n\t\t\t})\n\t\t\ttry {\n\t\t\t\tawait onStart?.(world, { map: made, settings })\n\t\t\t} catch (error) {\n\t\t\t\tworld.dispose()\n\t\t\t\tthrow error\n\t\t\t}\n\t\t\treturn world\n\t\t},\n\t\t...(options.ai !== null && { ai: options.ai ?? againstTheRest }),\n\t\t...(options.brain !== undefined && { brain: options.brain })\n\t}\n}\n\n/**\n * How a mode on a generated map is made (`generatedMode`): the generator's options (the seed a new one each time\n * when left out), and what a mode on a map takes\n *\n * @beta\n */\nexport interface GeneratedModeOptions extends Omit<GeneratorOptions, 'seed'>, MapModeOptions {\n\t/** The generator's seed; a new one each time when left out */\n\tseed?: number\n}\n\n/**\n * A game on a map made by a generator (`generateMap`): the map made once, with the seed given or a new one, and a\n * game of it as on any map (`mapMode`): a seat for each start, the world made from it for each game. For a room of a\n * random map (`RoomKind.room` as a function: a new map for each room made)\n *\n * @beta\n */\nexport function generatedMode(\n\tsource: Game<unknown> | Rules,\n\tgenerator: MapGenerator,\n\toptions: GeneratedModeOptions\n): GameMode & { map: GameMap } {\n\tconst game = rulesOf(source)\n\tconst { ai, brain, seats, ...generating } = options\n\tconst onStart = options.onStart ?? startOf(source)\n\t// a new map each time a seed is not said: the server's own, not the simulation's\n\tconst seed = options.seed ?? 1 + Math.floor(Math.random() * 999999)\n\tconst { map } = generateMap(generator, { ...generating, seed, name: options.name ?? `A random map (${seed})` }, createRegistry(game))\n\tconst mode = mapMode(game, map, { onStart, ai, brain, seats })\n\treturn { ...mode, id: `generated:${map.generated?.seed ?? seed}`, map }\n}\n"],"mappings":"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"}

package/dist/{navigation-worker.js → server/navigation-worker.js}

@@ -1,4 +1,4 @@
-import { c as serveNavigationBuilds } from "./builds-C6LfgvEU.js";
+import { serveNavigationBuilds } from "../navigation/builds.js";
 import { parentPort } from "node:worker_threads";
 //#region src/server/navigation-worker.ts
 /**

package/dist/server/navigation-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-worker.js","names":[],"sources":["../../src/server/navigation-worker.ts"],"sourcesContent":["/**\n * A worker thread of a server's that builds navigations (S37): told what to build, it sends back what it built. Built\n * next to `server.js`, and not one of the engine's names: `nodeNavigationBuilder` starts it\n */\nimport { parentPort } from 'node:worker_threads'\nimport { serveNavigationBuilds } from '#engine/navigation/builds'\n\nif (parentPort) serveNavigationBuilds(parentPort as never)\n"],"mappings":";;;;;;;AAOA,IAAI,YAAY,sBAAsB,UAAmB"}