@v12-engine/engine 0.1.0 → 0.4.0

package/dist/server.js

@@ -1,2861 +1,15 @@
-import { An as logLine, En as Logger, Fu as pauseAsked, Gc as engineMessage, Mn as rootLogger, Ti as RANDOM_RACE, Xt as PLAYER_COLORS, eu as commandRejected, kn as errorFields } from "./debugCommands-CzjrSm66.js";
-import { I as composeGame, a as createWorldFromMap, r as createRegistry } from "./game-DiJEN-Ks.js";
-import { s as navigationWorker } from "./builds-C6LfgvEU.js";
-import { C as randomSeed, D as SessionHost, I as readPlayerMessage, c as generateMap, i as packFromJson, r as checkPackSchema, t as PackError, w as delayed } from "./packs-g5thvmGn.js";
-import { _ as readMessage, h as isFiniteNumber } from "./local-Dkovq42k.js";
-import { i as difficultiesOf, o as personalitiesOf } from "./profiles-B3NS9jwk.js";
-import { existsSync, readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { createHash, timingSafeEqual } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { createServer } from "node:http";
-import { constants, createDeflateRaw, inflateRawSync } from "node:zlib";
-//#region src/server/navigation.ts
-/**
-* A builder of navigations in a worker thread of this process (S37): what a server builds with, so that the world of
-* one game being made does not hold up the ticks of the others (two seconds for a map of 512 cells a side). One
-* thread, made the first time and kept, which keeps the process alive only while it builds. Nothing where the
-* worker's file is not there: in this repository, which runs the engine as it is written, it builds on the thread
-* that asks
-*
-* @beta
-*/
-function nodeNavigationBuilder() {
-	const script = new URL("navigation-worker.js", import.meta.url);
-	if (script.protocol !== "file:" || !existsSync(fileURLToPath(script))) return void 0;
-	let made;
-	let pending = 0;
-	return async (build) => {
-		made ??= import("node:worker_threads").then(({ Worker }) => {
-			const worker = new Worker(script);
-			return {
-				worker,
-				builder: navigationWorker(worker)
-			};
-		});
-		const { worker, builder } = await made;
-		if (pending++ === 0) worker.ref();
-		try {
-			return await builder(build);
-		} finally {
-			if (--pending === 0) worker.unref();
-		}
-	};
-}
-//#endregion
-//#region src/server/log.ts
-/**
-* The logger of a server, from what it was started with. A logger: one under it. A function of lines: a logger of its
-* own that gives it the server's own entries as their words, and everything else (a game's, a warning) as a whole
-* line. Nothing: one under the root, which says warnings and errors only, as a server said nothing else before
-*/
-function serverLogger(given) {
-	if (given instanceof Logger) return given.child();
-	if (!given) return rootLogger.child({ level: "warn" });
-	const logger = new Logger();
-	logger.to((entry) => given(entry.category === "server" && entry.level === "info" ? entry.message : logLine(entry)));
-	return logger;
-}
-//#endregion
-//#region src/server/ratings.ts
-/**
-* The id a player is rated by: a hash of their key or login id, safe to show and keep. The same key, the same id
-*
-* @beta
-*/
-var ratedId = (key) => createHash("sha256").update(key).digest("hex").slice(0, 16);
-/**
-* Ratings kept in a file (`file`, JSON, read once and written after every game) or in memory: Elo, each side's
-* players against the average of the other's, `k` 32, starting at 1500. The computer counts as `start`, and is not
-* rated; a game with no winner, or with players of one side only, changes nothing
-*
-* @beta
-*/
-function createRatings(options = {}) {
-	const k = options.k ?? 32;
-	const start = options.start ?? 1500;
-	let byMode = {};
-	const ready = (async () => {
-		if (!options.file) return;
-		let text;
-		try {
-			text = await readFile(options.file, "utf8");
-		} catch (error) {
-			if (error.code === "ENOENT") return;
-			throw error;
-		}
-		byMode = JSON.parse(text);
-	})();
-	ready.catch(() => void 0);
-	let writing = Promise.resolve();
-	const keep = () => {
-		if (!options.file) return writing;
-		const file = options.file;
-		writing = writing.then(async () => {
-			await mkdir(dirname(file), { recursive: true });
-			await writeFile(file, JSON.stringify(byMode, null, 1));
-		});
-		return writing;
-	};
-	/** A mode's players, best first: by rating, then by more games, then by id, so the order is always the same */
-	const ranked = (mode) => Object.entries(byMode[mode] ?? {}).sort(([a, x], [b, y]) => y.rating - x.rating || y.games - x.games || (a < b ? -1 : 1)).map(([id, rating], index) => ({
-		id,
-		place: index + 1,
-		...rating
-	}));
-	return {
-		ready,
-		get: (mode, player) => byMode[mode]?.[player],
-		top: (mode, count) => ranked(mode).slice(0, Math.max(0, count)),
-		placeOf: (mode, player) => ranked(mode).find((each) => each.id === player),
-		async record(result) {
-			await ready;
-			if (result.winner === null || result.failed) return;
-			const seats = result.seats.filter((seat) => seat.outcome !== "none");
-			const rated = seats.filter((seat) => !seat.ai && seat.rated);
-			if (!rated.length) return;
-			const table = byMode[result.mode] ??= {};
-			const ratingOf = (seat) => !seat.ai && seat.rated ? table[seat.rated]?.rating ?? start : start;
-			const sides = /* @__PURE__ */ new Map();
-			for (const seat of seats) {
-				const side = seat.outcome;
-				sides.set(side, [...sides.get(side) ?? [], seat]);
-			}
-			const winners = sides.get("victory") ?? [];
-			const losers = sides.get("defeat") ?? [];
-			if (!winners.length || !losers.length) return;
-			const average = (list) => list.reduce((sum, seat) => sum + ratingOf(seat), 0) / list.length;
-			const changes = rated.map((seat) => {
-				const won = seat.outcome === "victory";
-				const theirs = average(won ? losers : winners);
-				const mine = ratingOf(seat);
-				const expected = 1 / (1 + 10 ** ((theirs - mine) / 400));
-				return {
-					seat,
-					won,
-					next: mine + k * ((won ? 1 : 0) - expected)
-				};
-			});
-			for (const { seat, won, next } of changes) {
-				const before = table[seat.rated] ?? {
-					rating: start,
-					games: 0,
-					wins: 0,
-					name: seat.name
-				};
-				table[seat.rated] = {
-					rating: Math.round(next),
-					games: before.games + 1,
-					wins: before.wins + (won ? 1 : 0),
-					name: seat.name
-				};
-			}
-			await keep();
-		}
-	};
-}
-//#endregion
-//#region src/server/secret.ts
-/** A secret as bytes of one length, whatever its own: what is compared takes as long whatever it is */
-var digest = (text) => createHash("sha256").update(text).digest();
-/**
-* Whether what was brought is the secret (an admin's key, a key to watch, to the numbers), compared in a time that
-* says nothing of how much of it is right (RV37)
-*/
-var sameSecret = (brought, secret) => timingSafeEqual(digest(brought), digest(secret));
-//#endregion
-//#region src/server/doorman.ts
-/**
-* Where one who joins a server's game goes (`Doorman`): their seat again, a free seat, a seat the game decides
-* (`GameServerOptions.seat`), watching, or away with why (design review E12). It decides and says so; the server seats,
-* tells and closes
-*/
-/**
-* Decides where each who joins a server goes
-*
-* @internal
-*/
-var Doorman = class {
-	server;
-	constructor(server) {
-		this.server = server;
-	}
-	/** Why one who joins speaks another version of the wire, or nothing: told before any seat is taken or welcome sent that it would misread */
-	wrongWire(join) {
-		if (join.protocol === void 0 || join.protocol === 13) return void 0;
-		return `this server runs another version of the engine (protocol 13, yours is ${join.protocol}): update the game`;
-	}
-	/**
-	* Where one who joins from `address` goes: decided now, or once the game said (`GameServerOptions.seat`), a promise
-	* then. Their wire is the server's (`wrongWire`)
-	*/
-	place(join, address) {
-		const { server } = this;
-		const theirs = join.token ? server.seats.find((each) => each.token === join.token) : void 0;
-		if (theirs) return {
-			to: "seat",
-			seat: theirs,
-			name: join.name
-		};
-		if (server.draining) return {
-			to: "refuse",
-			reason: "the server is stopping"
-		};
-		if (join.back) return {
-			to: "refuse",
-			reason: "the game you were in is over"
-		};
-		if (server.options.seat && !join.watch) return this.asked(join, address);
-		const free = !join.watch && server.phase === "lobby" ? server.seats.find((each) => !each.ai && !each.connected) : void 0;
-		if (!free) return this.noSeat(join, address);
-		return {
-			to: "seat",
-			seat: free,
-			name: join.name,
-			rated: join.who ? ratedId(join.who) : void 0
-		};
-	}
-	/** Where the game says one who joins sits (`seat`), checked as it answered: a seat may have been taken meanwhile */
-	async asked(join, address) {
-		const { server } = this;
-		let answer;
-		try {
-			answer = await server.options.seat({
-				address,
-				name: join.name,
-				ticket: join.ticket,
-				free: server.seats.filter((seat) => seat.isFree).map((seat) => server.publicSeat(seat)),
-				phase: server.phase
-			});
-		} catch (error) {
-			server.logger.error("server", "deciding a seat threw: they are refused", {
-				error: errorFields(error),
-				name: join.name
-			});
-			return {
-				to: "refuse",
-				reason: "the server could not seat you"
-			};
-		}
-		if (!answer || typeof answer !== "object") return {
-			to: "refuse",
-			reason: "the server could not seat you"
-		};
-		if ("refuse" in answer) return {
-			to: "refuse",
-			reason: String(answer.refuse)
-		};
-		return this.answered(join, answer, address);
-	}
-	/** The game's answer, checked against the seats as they are now */
-	answered(join, answer, address) {
-		const { server } = this;
-		const { player, id } = answer;
-		let seat;
-		if (player === void 0) seat = server.phase === "lobby" ? server.seats.find((each) => each.isFree) : void 0;
-		else {
-			seat = server.seats.find((each) => each.player === player);
-			if (!seat) return {
-				to: "refuse",
-				reason: `there is no seat ${player}`
-			};
-			if (seat.ai) return {
-				to: "refuse",
-				reason: "that seat is the computer's"
-			};
-			if (!seat.isFree && (id === void 0 || seat.id !== id)) return {
-				to: "refuse",
-				reason: "that seat is taken"
-			};
-			if (seat.isFree && server.phase !== "lobby") return {
-				to: "refuse",
-				reason: "the game has started"
-			};
-		}
-		if (!seat) return this.noSeat(join, address);
-		const rate = answer.rate || join.who || id;
-		return {
-			to: "seat",
-			seat,
-			name: answer.name ?? join.name,
-			named: answer.name !== void 0,
-			id,
-			rated: rate !== void 0 ? ratedId(rate) : void 0
-		};
-	}
-	/** No seat for who joined: they watch, if they may, or are told so */
-	noSeat(join, address) {
-		const { phase } = this.server;
-		if (phase === "lobby" && !join.watch) return { to: "full" };
-		if (this.mayWatch(join, address)) return { to: "watch" };
-		if (phase === "lobby") return { to: "full" };
-		return {
-			to: "refuse",
-			reason: "watching is not open"
-		};
-	}
-	/** Whether who asks may watch, as the server was told (`watch`) */
-	mayWatch(join, address) {
-		const { watch } = this.server.options;
-		if (!watch) return false;
-		if (watch === true) return true;
-		if (typeof watch === "object") return join.key !== void 0 && sameSecret(join.key, watch.key);
-		const seated = this.server.seats.some((seat) => seat.connected && seat.connection?.address === address);
-		return watch({
-			address,
-			name: join.name,
-			key: join.key,
-			seated,
-			phase: this.server.phase
-		});
-	}
-};
-//#endregion
-//#region src/server/seat.ts
-/** A token to come back to a seat with: what only who has it knows */
-function randomToken() {
-	const bytes = /* @__PURE__ */ new Uint8Array(16);
-	crypto.getRandomValues(bytes);
-	return [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join("");
-}
-/**
-* A seat of a server's game and who holds it
-*
-* @internal
-*/
-var Seat = class {
-	mode;
-	computer;
-	player;
-	name;
-	/** A computer plays it */
-	ai;
-	/** Someone is in it now */
-	connected = false;
-	ready = false;
-	settings;
-	/** Who it is rated as (`ratedId`), where the server rates */
-	rated;
-	rating;
-	/** What lets who held it back in: theirs while they hold it, in the lobby and in the game */
-	token;
-	/** Who holds it, as the `seat` hook said (`SeatAnswer.id`) */
-	id;
-	/** When what an honest client never sends came from it, in this game: the last `cheating.seconds`' worth, and how many in all */
-	cheats = {
-		at: [],
-		total: 0
-	};
-	/** The connection of who is in it */
-	connection;
-	constructor(mode, computer, settings) {
-		this.mode = mode;
-		this.computer = computer;
-		this.player = mode.player;
-		this.name = mode.name;
-		this.ai = computer;
-		this.settings = settings;
-	}
-	/** Nobody in it, nor holding it in a game to come back to, nor a computer */
-	get isFree() {
-		return !this.ai && !this.connected && this.token === void 0;
-	}
-	/**
-	* Taken by a connection: whoever was in it before is closed out (a player back from another page), and its token is
-	* kept, or made. A name it is given is taken. Gives the token
-	*/
-	take(connection, name) {
-		if (this.connection && this.connection !== connection) this.connection.close();
-		this.connected = true;
-		this.connection = connection;
-		this.token ??= randomToken();
-		if (name) this.name = name.slice(0, 24);
-		return this.token;
-	}
-	/** Whoever holds another seat moves here, in the lobby: their connection, token, who they are and their name; not ready */
-	takeFrom(other) {
-		this.connected = true;
-		this.connection = other.connection;
-		this.token = other.token;
-		this.id = other.id;
-		this.rated = other.rated;
-		this.name = other.name;
-		this.ready = false;
-		other.free();
-	}
-	/** Its connection gone, held for who had it to come back to (a game on): their token, who they are and their name stay */
-	drop() {
-		this.connected = false;
-		this.connection = void 0;
-	}
-	/** Given up: free for anyone, with the mode's name, nobody's token, not ready */
-	free() {
-		this.drop();
-		this.token = void 0;
-		this.id = void 0;
-		this.rated = void 0;
-		this.ready = false;
-		this.name = this.mode.name;
-	}
-	/** Held no more by who it was: their token and who they are no good (a kick). Their connection is closed by the caller */
-	revoke() {
-		this.token = void 0;
-		this.id = void 0;
-		this.rated = void 0;
-	}
-	/** What a new game starts it with: nobody's cheats, not ready, the computer's where the server says */
-	newGame() {
-		this.cheats = {
-			at: [],
-			total: 0
-		};
-		this.ready = false;
-		this.ai = this.computer;
-	}
-	/** New, for a new game with nobody: free, and as a new game starts it */
-	reset() {
-		this.free();
-		this.newGame();
-	}
-};
-//#endregion
-//#region src/server/seatSettings.ts
-/** A name as a lobby shows it: `insane` as `Insane` */
-var titled = (id) => id.charAt(0).toUpperCase() + id.slice(1);
-/**
-* What a lobby offers a computer's seat of a game that says how its computers play (`GameModule.ai`, AI plan D1): a
-* difficulty and a personality, the engine's and the game's own. Nothing for a game that says nothing, or `lobby: false`
-*/
-function computerSettingsOf(game) {
-	if (!game.ai || game.ai.lobby === false) return {};
-	const registry = { module: game };
-	const difficulties = Object.keys(difficultiesOf(registry));
-	const personalities = Object.keys(personalitiesOf(registry));
-	return {
-		difficulty: {
-			label: "Difficulty",
-			options: difficulties,
-			labels: Object.fromEntries(difficulties.map((id) => [id, titled(id)])),
-			default: game.ai.defaults?.difficulty ?? "normal"
-		},
-		personality: {
-			label: "Personality",
-			options: personalities,
-			labels: Object.fromEntries(personalities.map((id) => [id, titled(id)])),
-			default: game.ai.defaults?.personality ?? "balanced"
-		}
-	};
-}
-/**
-* What a game offers to choose for each seat in a lobby (`ServerHooks.seatSettings`), with a race among them where the
-* game has races and does not offer its own choice of one: each race, by its name, and `random` where there are two
-* or more; only those of
-* `races` where given (the races a map offers, `GameMap.races`). The first is chosen until someone does
-*
-* @beta
-*/
-function seatSettingsOf(game, races) {
-	const own = {
-		...computerSettingsOf(game),
-		...game.server?.seatSettings
-	};
-	const all = game.races ?? [];
-	if (!all.length || own.race) return own;
-	const offered = races?.length ? all.filter((race) => races.includes(race.id)) : all;
-	const options = [...offered.map((race) => race.id), ...offered.length > 1 ? [RANDOM_RACE] : []];
-	return {
-		race: {
-			label: "Race",
-			options: options.length ? options : [all[0].id],
-			labels: {
-				...Object.fromEntries(all.map((race) => [race.id, race.name])),
-				[RANDOM_RACE]: "Random"
-			},
-			default: options[0] ?? all[0].id
-		},
-		...own
-	};
-}
-//#endregion
-//#region src/server/lobby.ts
-/**
-* A server's seats and settings, and when its game starts
-*
-* @internal
-*/
-var Lobby = class {
-	server;
-	/** Its seats, in the mode's order */
-	seats;
-	/** The game's settings (`ServerHooks.settings`), as chosen */
-	settings = {};
-	/** What each seat can have chosen for it: the game's (`ServerHooks.seatSettings`), and a race where it has races (`seatSettingsOf`) */
-	seatOffered;
-	/** Back in the lobby after a game, with its players: it starts once they are ready, not as the seats fill */
-	again = false;
-	/** The votes to let a seated player go (`voteKick`), by who it is about: who voted */
-	kickVotes = /* @__PURE__ */ new Map();
-	hooks;
-	constructor(server) {
-		this.server = server;
-		const { mode, ai, settings } = server.options;
-		this.hooks = mode.game.server ?? {};
-		this.seatOffered = mode.seatSettings ?? seatSettingsOf(mode.game);
-		for (const [name, setting] of Object.entries(this.hooks.settings ?? {})) {
-			const wanted = settings?.[name];
-			this.settings[name] = wanted !== void 0 && setting.options.includes(wanted) ? wanted : setting.default;
-		}
-		this.seats = mode.seats.map((seat) => new Seat(seat, !!ai?.includes(seat.player), {
-			...Object.fromEntries(Object.entries(this.seatOffered).map(([name, setting]) => [name, setting.default])),
-			...Object.fromEntries(Object.entries(seat.preset ?? {}).filter(([name]) => Object.hasOwn(this.seatOffered, name))),
-			...seat.fixed
-		}));
-	}
-	/** A seat by its player */
-	seat(player) {
-		return this.seats.find((each) => each.player === player);
-	}
-	/** A seat as everyone is told it (the lobby, the hooks) */
-	publicSeat(seat) {
-		const { ratings, mode } = this.server.options;
-		const team = seat.settings?.team !== void 0 ? Number(seat.settings.team) : seat.mode.team;
-		return {
-			player: seat.player,
-			name: seat.name,
-			ai: seat.ai,
-			connected: seat.connected,
-			...team !== void 0 && { team },
-			...this.server.phase === "lobby" && !seat.ai && { ready: !!seat.ready },
-			...seat.settings && Object.keys(seat.settings).length > 0 && { settings: { ...seat.settings } },
-			...seat.mode.fixed && Object.keys(seat.mode.fixed).length > 0 && { fixed: Object.keys(seat.mode.fixed) },
-			...seat.rated && { rated: seat.rated },
-			...seat.rated && ratings && { rating: ratings.get(mode.id, seat.rated)?.rating ?? void 0 },
-			...this.kickVotes.get(seat.player)?.size && { kick: {
-				votes: this.kickVotes.get(seat.player).size,
-				needed: this.kickNeeded(seat)
-			} }
-		};
-	}
-	/** The players who may vote to let one go: the others seated and there */
-	voters(about) {
-		return this.seats.filter((seat) => seat !== about && seat.connected && !seat.ai);
-	}
-	/** How many votes let a seated player go: most of the others seated and there */
-	kickNeeded(about) {
-		return Math.floor(this.voters(about).length / 2) + 1;
-	}
-	/**
-	* A seated player votes to let another go, in the lobby: once most of the others seated and there have, the seat
-	* voted on is given back (its player is the server's to let go, `GameServer.kick`). Nothing for a seat nobody is in,
-	* a computer's, or one's own
-	*/
-	voteKick(by, player) {
-		const about = this.seat(player);
-		if (this.server.phase !== "lobby" || !about || about === by || !about.connected || about.ai || !by.connected) return void 0;
-		const votes = this.kickVotes.get(player) ?? /* @__PURE__ */ new Set();
-		votes.add(by.player);
-		this.kickVotes.set(player, votes);
-		if (this.voters(about).filter((seat) => votes.has(seat.player)).length >= this.kickNeeded(about)) {
-			this.kickVotes.delete(player);
-			return about;
-		}
-		this.broadcast();
-	}
-	/** A player left their seat, or moved: the votes about them and theirs go */
-	forgetVotes(player) {
-		this.kickVotes.delete(player);
-		for (const votes of this.kickVotes.values()) votes.delete(player);
-	}
-	/** The rating of the players in its seats, on average: none where nobody rated sits or there are no ratings */
-	rating() {
-		const { ratings, mode } = this.server.options;
-		if (!ratings) return void 0;
-		const rated = this.seats.filter((seat) => seat.connected && seat.rated).map((seat) => ratings.get(mode.id, seat.rated)?.rating ?? void 0).filter((rating) => rating !== void 0);
-		return rated.length ? Math.round(rated.reduce((sum, rating) => sum + rating, 0) / rated.length) : void 0;
-	}
-	/** Tells everyone the lobby as it is now */
-	broadcast() {
-		const { mode } = this.server.options;
-		this.server.tellAll({
-			type: "lobby",
-			mode: mode.id,
-			game: mode.game.id,
-			phase: this.server.phase,
-			seats: this.seats.map((seat) => this.publicSeat(seat)),
-			settings: { ...this.settings },
-			offered: this.hooks.settings ?? {},
-			seatOffered: this.seatOffered
-		});
-	}
-	/** A player took a seat in the lobby: the game starts once every seat is filled, unless they are back from one ("Again") */
-	seated() {
-		this.broadcast();
-		if ((this.server.options.autoStart ?? true) && !this.again && this.seats.every((each) => each.ai || each.connected)) this.server.startGame();
-	}
-	/** A player left the lobby: their seat is free for anyone */
-	left(seat) {
-		this.forgetVotes(seat.player);
-		seat.free();
-		this.broadcast();
-	}
-	/** A seated player moves to another seat, free, in the lobby: their own is free for anyone then. The seat moved to, or none */
-	move(from, player) {
-		const to = this.seat(player);
-		if (!to || to === from || this.server.phase !== "lobby" || !to.isFree) return void 0;
-		this.forgetVotes(from.player);
-		to.takeFrom(from);
-		this.server.logger.info("server", `${to.name} moved from seat ${from.player} to ${to.player}`, {
-			name: to.name,
-			from: from.player,
-			player: to.player
-		});
-		this.broadcast();
-		return to;
-	}
-	/** A seated player says they are ready, or not: once every player seated is, the game starts */
-	ready(seat, ready) {
-		if (this.server.phase !== "lobby" || seat.ready === ready) return;
-		seat.ready = ready;
-		this.broadcast();
-		if (this.seats.every((each) => !each.connected || each.ready)) this.server.startGame();
-	}
-	/** A seated player's new name */
-	rename(seat, name) {
-		if (this.server.phase !== "lobby") return;
-		const trimmed = name.trim().slice(0, 24);
-		if (!trimmed || trimmed === seat.name) return;
-		seat.name = trimmed;
-		this.broadcast();
-	}
-	/** A setting of the game a seated player chose: one it offers, with a value it offers */
-	set(name, value) {
-		if (this.server.phase !== "lobby" || !Object.hasOwn(this.hooks.settings ?? {}, name)) return;
-		if (!this.hooks.settings[name].options.includes(value)) return;
-		this.settings[name] = value;
-		this.broadcast();
-	}
-	/**
-	* A setting of a seat chosen by a seated player (`by`): their own seat, or one no other player holds (a computer's,
-	* or one nobody took yet). Not what the mode fixes
-	*/
-	setSeat(by, player, name, value) {
-		if (this.server.phase !== "lobby" || !Object.hasOwn(this.seatOffered, name)) return;
-		if (!this.seatOffered[name].options.includes(value)) return;
-		const seat = this.seat(player);
-		if (!seat || seat !== by && seat.connected && !seat.ai) return;
-		if (seat.mode.fixed && Object.hasOwn(seat.mode.fixed, name)) return;
-		if (this.seatOffered[name].unique && this.seats.some((other) => other !== seat && other.settings?.[name] === value)) return;
-		seat.settings = {
-			...seat.settings,
-			[name]: value
-		};
-		this.broadcast();
-	}
-	/** A game starts: what nobody joined is the computer's */
-	fill() {
-		this.kickVotes.clear();
-		for (const seat of this.seats) if (!seat.connected) seat.ai = true;
-	}
-	/** Back after a game, with who is still there in their seats (and who comes again with `keepToken`): the seats of those gone are free */
-	backFromGame(keepToken) {
-		this.again = true;
-		for (const seat of this.seats) {
-			seat.newGame();
-			if (!seat.connected && seat.token !== keepToken) seat.free();
-		}
-	}
-	/** New, for a new game with nobody: every seat free */
-	reset() {
-		this.again = false;
-		for (const seat of this.seats) seat.reset();
-	}
-};
-//#endregion
-//#region src/server/ops.ts
-/** The numbers of a process: its memory */
-var memory = () => {
-	const { rss, heapUsed } = process.memoryUsage();
-	return {
-		rss,
-		heapUsed
-	};
-};
-/**
-* The numbers of the rooms of a process, in Prometheus's text: each by its room, where there is more than one
-*
-* @internal
-*/
-function metricsText(rooms) {
-	const lines = [];
-	const each = (name, help, type, value) => {
-		lines.push(`# HELP vg_${name} ${help}`, `# TYPE vg_${name} ${type}`);
-		for (const [room, metrics] of rooms) lines.push(`vg_${name}${room ? `{room=${JSON.stringify(room)}}` : ""} ${value(metrics)}`);
-	};
-	each("up", "Whether it takes new games: 0 once it is stopping", "gauge", (m) => m.draining ? 0 : 1);
-	each("games_running", "Games running now", "gauge", (m) => m.games.running);
-	each("games_played_total", "Games played to their end", "counter", (m) => m.games.played);
-	each("players", "Seats held by someone connected", "gauge", (m) => m.players);
-	each("watching", "Connections watching a game", "gauge", (m) => m.watching);
-	each("connections", "Connections open", "gauge", (m) => m.connections);
-	each("ticks_total", "Ticks of the simulation stepped", "counter", (m) => m.ticks);
-	each("tick_seconds_total", "Seconds the ticks took", "counter", (m) => round(m.tickSeconds));
-	each("last_tick_seconds", "How long the last tick took", "gauge", (m) => round(m.lastTickSeconds));
-	each("sends_total", "Rounds of sending what changed", "counter", (m) => m.sends);
-	each("send_seconds_total", "Seconds the sending took", "counter", (m) => round(m.sendSeconds));
-	each("bytes_sent", "Bytes sent to those connected now", "gauge", (m) => m.bytesSent);
-	each("uptime_seconds", "Seconds since it started", "gauge", (m) => round(m.uptime));
-	const { rss, heapUsed } = memory();
-	lines.push("# HELP vg_protocol_version The version of the wire its players have to speak", "# TYPE vg_protocol_version gauge", `vg_protocol_version 13`, "# HELP vg_memory_bytes Memory of the process", "# TYPE vg_memory_bytes gauge", `vg_memory_bytes{kind="rss"} ${rss}`, `vg_memory_bytes{kind="heap"} ${heapUsed}`);
-	return `${lines.join("\n")}\n`;
-}
-var round = (value) => Math.round(value * 1e6) / 1e6;
-/**
-* Answers the health and numbers addresses for the rooms of a process; false for any other request, which goes to
-* what answered it before. `draining` is whether the process takes no new games
-*/
-function answerOps(request, response, options, state, games, ratings) {
-	const { pathname, searchParams } = new URL(request.url ?? "/", "http://server");
-	const best = options?.ratings ?? "/ratings";
-	if (best && ratings?.ratings && pathname === best && (request.method === "GET" || request.method === "HEAD")) {
-		const mode = searchParams.get("mode") ?? ratings.modes[0] ?? "";
-		const count = Math.min(Math.max(Number(searchParams.get("n")) || 10, 1), 100);
-		const player = searchParams.get("player");
-		const top = ratings.ratings.top?.(mode, count) ?? [];
-		const own = player ? ratings.ratings.placeOf?.(mode, player) : void 0;
-		response.writeHead(200, {
-			"content-type": "application/json",
-			"cache-control": "no-store",
-			"access-control-allow-origin": "*"
-		});
-		response.end(JSON.stringify({
-			mode,
-			modes: ratings.modes,
-			top,
-			...own && { player: own }
-		}));
-		return true;
-	}
-	const health = options?.health ?? "/health";
-	const metrics = options?.metrics ?? "/metrics";
-	const list = options?.games ?? "/games";
-	if (request.method !== "GET" && request.method !== "HEAD") return false;
-	if (list && games && pathname === list) {
-		response.writeHead(200, {
-			"content-type": "application/json",
-			"cache-control": "no-store",
-			"access-control-allow-origin": "*"
-		});
-		response.end(JSON.stringify({
-			draining: state().draining,
-			...games()
-		}));
-		return true;
-	}
-	if (health && pathname === health) {
-		const { draining } = state();
-		response.writeHead(draining ? 503 : 200, {
-			"content-type": "application/json",
-			"cache-control": "no-store"
-		});
-		response.end(JSON.stringify({
-			ok: !draining,
-			draining
-		}));
-		return true;
-	}
-	if (metrics && pathname === metrics) {
-		if (options?.metricsKey && !sameSecret(request.headers.authorization ?? "", `Bearer ${options.metricsKey}`)) {
-			response.writeHead(401, {
-				"content-type": "text/plain",
-				"www-authenticate": "Bearer"
-			});
-			response.end("The numbers take a key\n");
-			return true;
-		}
-		const { rooms, draining } = state();
-		if (searchParams.has("json")) {
-			response.writeHead(200, {
-				"content-type": "application/json",
-				"cache-control": "no-store"
-			});
-			response.end(JSON.stringify({
-				draining,
-				protocol: 13,
-				memory: memory(),
-				rooms: Object.fromEntries(rooms)
-			}));
-		} else {
-			response.writeHead(200, {
-				"content-type": "text/plain; version=0.0.4",
-				"cache-control": "no-store"
-			});
-			response.end(metricsText(rooms));
-		}
-		return true;
-	}
-	return false;
-}
-/** A game's result as a file of its own in `dir` (`GameServerOptions.resultsDir`): by when it ended and its mode */
-async function writeResult(dir, result) {
-	await mkdir(dir, { recursive: true });
-	await writeFile(join(dir, `${Date.now()}-${result.mode.replace(/[^\w-]/g, "_")}.json`), JSON.stringify(result, null, 2));
-}
-//#endregion
-//#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.game.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.game.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.game.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
-//#region src/server/websocket.ts
-var GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
-var TEXT = 1;
-var CONTINUATION = 0;
-var CLOSE = 8;
-var PING = 9;
-var PONG = 10;
-/**
-* Starts a WebSocket server, and resolves once it listens
-*
-* @beta
-*/
-function startSocketServer(options) {
-	const maxMessage = options.maxMessage ?? 65536;
-	const maxConnections = options.maxConnections ?? 1024;
-	const limits = {
-		idle: (options.idleTimeout ?? 60) * 1e3,
-		buffered: options.maxBuffered ?? 16777216
-	};
-	let handler = () => {};
-	const open = /* @__PURE__ */ new Set();
-	/** Each connection's own check: pinged when quiet, closed when silent too long */
-	const sweeps = /* @__PURE__ */ new Set();
-	const sweeper = setInterval(() => {
-		for (const sweep of sweeps) sweep();
-	}, Math.max(Math.min(limits.idle / 3, 2e4), 50));
-	sweeper.unref?.();
-	const server = createServer(options.onRequest ?? ((_request, response) => {
-		response.writeHead(426, { "content-type": "text/plain" });
-		response.end("A game server: connect with a WebSocket\n");
-	}));
-	server.on("upgrade", (request, socket) => {
-		const key = request.headers["sec-websocket-key"];
-		if (request.headers.upgrade?.toLowerCase() !== "websocket" || typeof key !== "string") {
-			socket.end("HTTP/1.1 400 Bad Request\r\n\r\n");
-			return;
-		}
-		if (open.size >= maxConnections) {
-			socket.end("HTTP/1.1 503 Service Unavailable\r\nContent-Length: 0\r\n\r\n");
-			return;
-		}
-		const accept = createHash("sha1").update(key + GUID).digest("base64");
-		const offered = String(request.headers["sec-websocket-extensions"] ?? "");
-		const compressed = (options.compress ?? true) && /(^|,)\s*permessage-deflate\b/.test(offered);
-		const extension = compressed ? "Sec-WebSocket-Extensions: permessage-deflate; client_no_context_takeover\r\n" : "";
-		socket.write(`HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\nSec-WebSocket-Accept: ${accept}\r\n${extension}\r\n`);
-		open.add(socket);
-		const { connection, sweep } = connectionOf(socket, request, maxMessage, compressed, limits, options.log ?? rootLogger);
-		sweeps.add(sweep);
-		socket.on("close", () => {
-			open.delete(socket);
-			sweeps.delete(sweep);
-		});
-		handler(connection);
-	});
-	return new Promise((resolve) => server.listen(options.port, () => {
-		const address = server.address();
-		resolve({
-			server,
-			port: typeof address === "object" && address ? address.port : options.port,
-			onConnection: (next) => handler = next,
-			close: () => new Promise((done) => {
-				clearInterval(sweeper);
-				for (const socket of open) socket.destroy();
-				server.close(() => done());
-			})
-		});
-	}));
-}
-/** The end every compressed message has, which the wire leaves off (RFC 7692): an empty block of a sync flush */
-var SYNC_TAIL = Buffer.from([
-	0,
-	0,
-	255,
-	255
-]);
-/** Messages shorter than this go as they are: compressing them would save next to nothing */
-var COMPRESS_FROM = 64;
-/** Milliseconds a connection closed from here stays open for the other end's own close, which says it has read everything */
-var CLOSE_WAIT = 1e3;
-/** A frame to send: a server's are never masked. `deflated` marks a compressed message (RSV1) */
-function frame(opcode, payload, deflated = false) {
-	const length = payload.length;
-	const head = length < 126 ? Buffer.alloc(2) : length < 65536 ? Buffer.alloc(4) : Buffer.alloc(10);
-	head[0] = 128 | (deflated ? 64 : 0) | opcode;
-	if (length < 126) head[1] = length;
-	else if (length < 65536) {
-		head[1] = 126;
-		head.writeUInt16BE(length, 2);
-	} else {
-		head[1] = 127;
-		head.writeBigUInt64BE(BigInt(length), 2);
-	}
-	return Buffer.concat([head, payload]);
-}
-/**
-* Compresses messages one after another against all the ones before (`permessage-deflate` with context): a delta
-* says much of what the one before it said, which the compressor remembers. In order, as zlib works in the background
-*/
-var Compressor = class {
-	deflate = createDeflateRaw({
-		windowBits: 15,
-		memLevel: 8
-	});
-	chunks = [];
-	/** The last message being compressed: the next waits for it, so that they go out in order */
-	queue = Promise.resolve();
-	/** Closed: what is still queued is let go, not written into a stream that is gone */
-	closed = false;
-	constructor() {
-		this.deflate.on("data", (chunk) => this.chunks.push(chunk));
-	}
-	/** Compresses a message, and hands it on when done: in the order they were given */
-	compress(message, done) {
-		this.queue = this.queue.then(() => new Promise((resolve) => {
-			if (this.closed) return resolve();
-			this.deflate.write(message);
-			this.deflate.flush(constants.Z_SYNC_FLUSH, () => {
-				const all = Buffer.concat(this.chunks.splice(0));
-				done(all.subarray(0, all.length - SYNC_TAIL.length));
-				resolve();
-			});
-		}));
-	}
-	/** Runs once what is being compressed has gone: for what goes as it is, in its turn */
-	after(run) {
-		this.queue = this.queue.then(run);
-	}
-	close() {
-		if (this.closed) return;
-		this.closed = true;
-		this.deflate.close();
-	}
-};
-function connectionOf(socket, request, maxMessage, compressed, limits, log) {
-	let onMessage = () => {};
-	let onClose = () => {};
-	let closed = false;
-	let buffer = Buffer.alloc(0);
-	/** The parts of a text message sent in several frames, until its last, and whether it came compressed */
-	let parts = [];
-	let deflated = false;
-	let bytesSent = 0;
-	const compressor = compressed ? new Compressor() : void 0;
-	/** Whether the close frame has gone: nothing more is written after it */
-	let ended = false;
-	/** When something last came in */
-	let heardAt = Date.now();
-	const write = (data) => {
-		if (ended || socket.destroyed) return;
-		bytesSent += data.length;
-		socket.write(data);
-		if (socket.writableLength > limits.buffered) {
-			log.warn("server", "a connection took in too slowly, it is closed", {
-				waiting: socket.writableLength,
-				address: request.socket.remoteAddress
-			});
-			ended = true;
-			socket.destroy();
-		}
-	};
-	const shut = () => {
-		if (closed) return;
-		closed = true;
-		onClose();
-	};
-	/** Our close has gone, and the other end's is waited for, a moment: what comes in is read for that alone */
-	let lingering;
-	const end = () => {
-		clearTimeout(lingering);
-		lingering = void 0;
-		socket.end();
-	};
-	/** `answering`: the other end closed first, and has nothing more to say or to read */
-	const close = (code = 1e3, answering = false) => {
-		if (closed) return;
-		const payload = Buffer.alloc(2);
-		payload.writeUInt16BE(code, 0);
-		const finish = () => {
-			write(frame(CLOSE, payload));
-			ended = true;
-			compressor?.close();
-			if (answering || socket.destroyed) return end();
-			lingering = setTimeout(end, CLOSE_WAIT);
-			lingering.unref?.();
-		};
-		if (compressor) compressor.after(finish);
-		else finish();
-		shut();
-	};
-	socket.on("data", (data) => {
-		if (closed && !lingering) return;
-		heardAt = Date.now();
-		buffer = Buffer.concat([buffer, data]);
-		for (;;) {
-			if (closed && !lingering || buffer.length < 2) return;
-			const fin = (buffer[0] & 128) !== 0;
-			const rsv1 = (buffer[0] & 64) !== 0;
-			const opcode = buffer[0] & 15;
-			const masked = (buffer[1] & 128) !== 0;
-			let length = buffer[1] & 127;
-			let at = 2;
-			if (length === 126) {
-				if (buffer.length < 4) return;
-				length = buffer.readUInt16BE(2);
-				at = 4;
-			} else if (length === 127) {
-				if (buffer.length < 10) return;
-				const long = buffer.readBigUInt64BE(2);
-				if (long > BigInt(maxMessage)) return closed ? end() : close(1009);
-				length = Number(long);
-				at = 10;
-			}
-			if (!masked) return closed ? end() : close(1002);
-			if (length > maxMessage) return closed ? end() : close(1009);
-			if (buffer.length < at + 4 + length) return;
-			const mask = buffer.subarray(at, at + 4);
-			const payload = Buffer.from(buffer.subarray(at + 4, at + 4 + length));
-			for (let i = 0; i < payload.length; i++) payload[i] ^= mask[i & 3];
-			buffer = buffer.subarray(at + 4 + length);
-			if (closed) {
-				if (opcode === CLOSE) return end();
-				continue;
-			}
-			if (opcode === TEXT || opcode === CONTINUATION) {
-				if (opcode === TEXT) deflated = rsv1 && compressed;
-				parts.push(payload);
-				if (parts.reduce((sum, part) => sum + part.length, 0) > maxMessage) return close(1009);
-				if (!fin) continue;
-				let data = Buffer.concat(parts);
-				parts = [];
-				if (deflated) try {
-					data = inflateRawSync(Buffer.concat([data, SYNC_TAIL]), {
-						maxOutputLength: maxMessage,
-						finishFlush: constants.Z_SYNC_FLUSH
-					});
-				} catch {
-					return close(1009);
-				}
-				try {
-					onMessage(data.toString("utf8"));
-				} catch (error) {
-					log.error("server", "a message could not be handled, the connection is closed", {
-						error: errorFields(error),
-						address: request.socket.remoteAddress
-					});
-					return close(1011);
-				}
-			} else if (opcode === PING) write(frame(PONG, payload));
-			else if (opcode === CLOSE) return close(1e3, true);
-		}
-	});
-	const gone = () => {
-		clearTimeout(lingering);
-		lingering = void 0;
-		ended = true;
-		compressor?.close();
-		shut();
-	};
-	socket.on("close", gone);
-	socket.on("error", gone);
-	const connection = {
-		url: request.url ?? "/",
-		address: request.socket.remoteAddress ?? "",
-		compressed,
-		get bytesSent() {
-			return bytesSent;
-		},
-		send(message) {
-			if (closed) return;
-			const data = Buffer.from(message, "utf8");
-			if (!compressor || data.length < COMPRESS_FROM) {
-				if (compressor) compressor.after(() => write(frame(TEXT, data)));
-				else write(frame(TEXT, data));
-				return;
-			}
-			compressor.compress(data, (deflatedData) => write(frame(TEXT, deflatedData, true)));
-		},
-		onMessage(next) {
-			onMessage = next;
-		},
-		onClose(next) {
-			onClose = next;
-		},
-		close: () => close()
-	};
-	/** Pings a connection that has been quiet, and closes one that has said nothing for longer than it may */
-	const sweep = () => {
-		if (closed) return;
-		const quiet = Date.now() - heardAt;
-		if (quiet > limits.idle) return close(1001);
-		if (quiet > limits.idle / 3) write(frame(PING, Buffer.alloc(0)));
-	};
-	return {
-		connection,
-		sweep
-	};
-}
-//#endregion
-//#region src/server/gameServer.ts
-/** The messages of the lobby: each told to everyone, or a key tried (`lobbyRate`) */
-var LOBBY_MESSAGES = /* @__PURE__ */ new Set([
-	"join",
-	"sit",
-	"ready",
-	"resume",
-	"name",
-	"start",
-	"setting",
-	"seatSetting",
-	"admin",
-	"lobbyChat",
-	"kick"
-]);
-/** How long a line said in the lobby may be */
-var LOBBY_LINE = 200;
-/** A token bucket: so many at once, filled again at so many a second */
-var Bucket = class {
-	rate;
-	tokens;
-	toppedUp = performance.now();
-	constructor(rate) {
-		this.rate = rate;
-		this.tokens = rate.burst;
-	}
-	/** Whether one more goes now: taken from the bucket, when it does */
-	take() {
-		const now = performance.now();
-		this.tokens = Math.min(this.rate.burst, this.tokens + (now - this.toppedUp) / 1e3 * this.rate.perSecond);
-		this.toppedUp = now;
-		if (this.tokens < 1) return false;
-		this.tokens--;
-		return true;
-	}
-};
-/**
-* A server of a game: its connections, who joins and where they go (`Doorman`), its lobby (`Lobby`: the seats, the
-* settings, when a game starts) and its game while one is on (`Match`)
-*
-* @beta
-*/
-var GameServer = class GameServer {
-	source;
-	options;
-	navigation;
-	phase = "lobby";
-	clients = /* @__PURE__ */ new Set();
-	/** The keys of those the lobby voted out (`kick`): kept out until the server starts afresh (`reset`) */
-	kickedOut = /* @__PURE__ */ new Set();
-	/** Where each who joins goes */
-	doorman = new Doorman(this);
-	/** The seats, the settings, and when a game starts */
-	lobby;
-	/** The game on, or the one that ended while its players are still on its screen */
-	match;
-	constructor(source, options, logger, navigation) {
-		this.source = source;
-		this.options = options;
-		this.navigation = navigation;
-		const server = this;
-		this.logger = logger;
-		this.lobby = new Lobby({
-			options,
-			logger,
-			get phase() {
-				return server.phase;
-			},
-			tellAll: (message) => this.tellAll(message),
-			startGame: () => void this.startGame()
-		});
-		source.onConnection((connection) => this.accept(connection));
-	}
-	/** Starts a server, and resolves once it listens */
-	static async start(options) {
-		const logger = serverLogger(options.log);
-		const builder = options.navigationWorker !== false ? nodeNavigationBuilder() : void 0;
-		let server;
-		const socket = await startSocketServer({
-			port: options.port,
-			compress: options.compress,
-			idleTimeout: options.idleTimeout,
-			maxBuffered: options.maxBuffered,
-			maxConnections: options.maxConnections,
-			log: logger,
-			onRequest: (request, response) => {
-				if (server && answerOps(request, response, options.http, () => ({
-					draining: server.draining,
-					rooms: /* @__PURE__ */ new Map([["", server.metrics()]])
-				}), () => ({ games: [server.listing("")] }), {
-					ratings: options.ratings,
-					modes: [options.mode.id]
-				})) return;
-				response.writeHead(426, { "content-type": "text/plain" });
-				response.end("A game server: connect with a WebSocket\n");
-			}
-		});
-		server = new GameServer(socket, options, logger, builder && { builder });
-		return server.begin();
-	}
-	/**
-	* A server whose connections come from elsewhere (`ConnectionSource`): a room of `GameRooms`, those a port it shares
-	* hands it. Closing it closes those, and leaves where they come from to whoever owns it
-	*/
-	static async attach(source, options) {
-		return new GameServer(source, {
-			...options,
-			port: source.port
-		}, serverLogger(options.log)).begin();
-	}
-	/** Says it is there, and starts a game at once where the computer has every seat */
-	async begin() {
-		const { options, source } = this;
-		this.log(`${options.mode.name} (${options.mode.game.id}) on port ${source.port}, ${this.seats.length} seats`);
-		if ((options.autoStart ?? true) && this.seats.every((seat) => seat.ai)) await this.startGame();
-		return this;
-	}
-	/**
-	* Its seats, in the mode's order: the server's own (its doorman's), a seat of a player is `publicSeat`'s
-	*
-	* @internal
-	*/
-	get seats() {
-		return this.lobby.seats;
-	}
-	/** The game's settings (`ServerHooks.settings`), as chosen in the lobby */
-	get settings() {
-		return this.lobby.settings;
-	}
-	/** The world of the game on, or of the one that ended while its players are still on its screen */
-	get world() {
-		return this.match?.world;
-	}
-	/** What sends the game to its players, while there is one */
-	get host() {
-		return this.match?.host;
-	}
-	/** Who paused the game: an admin, or a player (with a pause of theirs, for so long at most). Nobody while it runs */
-	get pausedBy() {
-		return this.match?.pausedBy;
-	}
-	/** When it started, for its uptime */
-	startedAt = performance.now();
-	/** Games played to their end */
-	played = 0;
-	/** What the hosts of the games before this one counted: the numbers go on from there */
-	past = {
-		ticks: 0,
-		tickTime: 0,
-		sends: 0,
-		sendTime: 0
-	};
-	/** It takes no new games: it is stopping once the running one is over (`close({ drain })`) */
-	draining = false;
-	/** Tells a stop that waits that the running game is over */
-	drained;
-	/** What a list of games says of it (`GET /games`, `GameListing`), as the room it is reached at */
-	listing(room) {
-		const { mode } = this.options;
-		const rating = this.lobby.rating();
-		return {
-			room,
-			game: mode.game.id,
-			mode: mode.name,
-			phase: this.phase,
-			players: this.seats.filter((seat) => !seat.ai && seat.connected).length,
-			free: this.seats.filter((seat) => !seat.ai && seat.isFree).length,
-			computer: this.seats.filter((seat) => seat.ai).length,
-			watchers: this.watching,
-			settings: { ...this.settings },
-			draining: this.draining,
-			...rating !== void 0 && { rating }
-		};
-	}
-	/** How many are connected to it, playing or watching: none, for a room that may be closed */
-	get connections() {
-		return this.clients.size;
-	}
-	/** How many watch */
-	get watching() {
-		return [...this.clients].filter((client) => client.watching).length;
-	}
-	/** Its numbers now: what `/metrics` says (see `ServerMetrics`) */
-	metrics() {
-		const totals = this.host?.totals;
-		return {
-			phase: this.phase,
-			draining: this.draining,
-			uptime: (performance.now() - this.startedAt) / 1e3,
-			games: {
-				running: this.phase === "game" ? 1 : 0,
-				played: this.played
-			},
-			players: this.seats.filter((seat) => seat.connected).length,
-			watching: this.watching,
-			connections: this.clients.size,
-			ticks: this.past.ticks + (totals?.ticks ?? 0),
-			tickSeconds: (this.past.tickTime + (totals?.tickTime ?? 0)) / 1e3,
-			lastTickSeconds: (totals?.lastTick ?? 0) / 1e3,
-			sends: this.past.sends + (totals?.sends ?? 0),
-			sendSeconds: (this.past.sendTime + (totals?.sendTime ?? 0)) / 1e3,
-			bytesSent: this.bytesSent
-		};
-	}
-	/** The game let go of, what its host counted kept for the numbers */
-	dropMatch(options) {
-		const { match } = this;
-		if (!match) return;
-		const { host } = match;
-		match.stop();
-		this.past.ticks += host.totals.ticks;
-		this.past.tickTime += host.totals.tickTime;
-		this.past.sends += host.totals.sends;
-		this.past.sendTime += host.totals.sendTime;
-		host.dispose(options);
-		this.match = void 0;
-	}
-	get port() {
-		return this.source.port;
-	}
-	/** Bytes sent to those connected now, as they went over the wire: compressed, where they are */
-	get bytesSent() {
-		let total = 0;
-		for (const client of this.clients) total += client.connection.bytesSent;
-		return total;
-	}
-	/** What the server and its games say: see `GameServerOptions.log` */
-	logger;
-	log(line, fields) {
-		this.logger.info("server", line, fields);
-	}
-	accept(connection) {
-		const { options } = this;
-		const client = {
-			connection,
-			watching: false,
-			commands: new Bucket(options.rate ?? {
-				perSecond: 30,
-				burst: 60
-			}),
-			messages: new Bucket(options.messageRate ?? {
-				perSecond: 100,
-				burst: 200
-			}),
-			lobby: new Bucket(options.lobbyRate ?? {
-				perSecond: 4,
-				burst: 20
-			}),
-			toGame: () => {},
-			fromGameClosed: () => {},
-			relay: void 0
-		};
-		client.relay = {
-			send: (message) => connection.send(message),
-			onMessage: (handler) => client.toGame = handler,
-			onClose: (handler) => client.fromGameClosed = handler,
-			close: () => connection.close()
-		};
-		this.clients.add(client);
-		connection.onMessage((text) => this.receive(client, text));
-		connection.onClose(() => this.leave(client));
-		const within = options.joinWithin ?? 10;
-		if (Number.isFinite(within)) {
-			client.deadline = setTimeout(() => {
-				if (client.joined || client.joining || !this.clients.has(client)) return;
-				this.log("a connection that did not join in time was closed", { address: connection.address });
-				connection.close();
-			}, Math.max(0, within) * 1e3);
-			client.deadline.unref?.();
-		}
-	}
-	tell(client, message) {
-		client.connection.send(JSON.stringify(message));
-	}
-	/** Tells everyone who joined: never a connection that has not (RV38) */
-	tellAll(message) {
-		for (const client of this.clients) if (client.joined) this.tell(client, message);
-	}
-	receive(client, text) {
-		if (!this.clients.has(client)) return;
-		const message = readPlayerMessage(text);
-		const { seat } = client;
-		if (!(message?.type === "command" && seat && this.phase === "game") && !client.messages.take()) return;
-		if (!message) return;
-		if (LOBBY_MESSAGES.has(message.type) && !client.lobby.take()) return;
-		switch (message.type) {
-			case "join": return this.join(client, {
-				type: "join",
-				name: typeof message.name === "string" ? message.name : void 0,
-				token: typeof message.token === "string" ? message.token : void 0,
-				ticket: typeof message.ticket === "string" ? message.ticket : void 0,
-				watch: message.watch === true,
-				key: typeof message.key === "string" ? message.key : void 0,
-				who: typeof message.who === "string" && message.who.length <= 128 ? message.who : void 0,
-				back: message.back === true,
-				protocol: isFiniteNumber(message.protocol) ? message.protocol : void 0
-			});
-			case "sit":
-				if (typeof message.player === "number") this.move(client, message.player);
-				return;
-			case "ready":
-				if (seat && typeof message.ready === "boolean") this.lobby.ready(seat, message.ready);
-				return;
-			case "resume":
-				if (seat && this.phase === "game" && this.pausedBy !== void 0 && this.pausedBy !== "admin") this.pause(false);
-				return;
-			case "name":
-				if (seat && typeof message.name === "string") this.lobby.rename(seat, message.name);
-				return;
-			case "start":
-				if (seat && this.phase === "lobby") this.startGame();
-				return;
-			case "setting": {
-				const { name, value } = message;
-				if (seat && typeof name === "string" && typeof value === "string") this.lobby.set(name, value);
-				return;
-			}
-			case "seatSetting": {
-				const { player, name, value } = message;
-				if (seat && typeof name === "string" && typeof value === "string" && typeof player === "number") this.lobby.setSeat(seat, player, name, value);
-				return;
-			}
-			case "lobbyChat": {
-				const text = typeof message.text === "string" ? message.text.trim().slice(0, LOBBY_LINE) : "";
-				if (!client.joined || this.phase !== "lobby" || !text) return;
-				return this.tellAll({
-					type: "lobbyChat",
-					...seat && { player: seat.player },
-					name: seat?.name ?? "A watcher",
-					text
-				});
-			}
-			case "kick": {
-				if (!seat || typeof message.player !== "number") return;
-				const out = this.lobby.voteKick(seat, message.player);
-				if (!out) return;
-				const theirs = [...this.clients].find((each) => each.seat === out);
-				if (theirs?.who) this.kickedOut.add(theirs.who);
-				return this.kick(out.player, "let go by a vote of the lobby");
-			}
-			case "admin": {
-				const { key, action } = message;
-				if (typeof key !== "string" || action !== "pause" && action !== "resume" && action !== "stop") return;
-				return this.admin(client, {
-					type: "admin",
-					key,
-					action
-				});
-			}
-			default: client.toGame(text);
-		}
-	}
-	/** Whether a command of this client's goes in: a bucket that fills at the rate allowed. Why not, when it does not */
-	allow(client) {
-		return client.commands.take() || engineMessage("tooManyCommands");
-	}
-	join(client, message) {
-		if (client.seat || client.watching || client.joining) return;
-		client.who = message.who;
-		client.name = message.name?.trim().slice(0, 24) || void 0;
-		if (message.who && this.kickedOut.has(message.who)) return this.enter(client, message, {
-			to: "refuse",
-			reason: "let go by a vote of the lobby"
-		});
-		const wrong = this.doorman.wrongWire(message);
-		if (wrong) {
-			this.log(`${message.name ?? "someone"} was refused: protocol ${message.protocol}, this server's is 13`, {
-				name: message.name,
-				protocol: message.protocol
-			});
-			return this.enter(client, message, {
-				to: "refuse",
-				reason: wrong
-			});
-		}
-		if (this.phase === "ended" && !message.back && message.token && this.seats.some((each) => each.token === message.token)) this.backToLobby(message.token);
-		const door = this.doorman.place(message, client.connection.address);
-		if (!(door instanceof Promise)) return this.enter(client, message, door);
-		client.joining = true;
-		door.then((placed) => {
-			client.joining = false;
-			if (this.clients.has(client) && !client.seat && !client.watching) this.enter(client, message, placed);
-		});
-	}
-	/** Takes who joined where the doorman said: a seat, watching, told every seat is taken, or away with why */
-	enter(client, message, door) {
-		if (door.to !== "refuse") {
-			client.joined = true;
-			clearTimeout(client.deadline);
-		}
-		switch (door.to) {
-			case "seat":
-				if ("id" in door) door.seat.id = door.id;
-				if ("rated" in door) door.seat.rated = door.rated;
-				return this.sit(client, door.seat, door.name, door.named);
-			case "watch": return this.watch(client);
-			case "full": return this.tell(client, { type: "full" });
-			case "refuse":
-				this.log(`${message.name ?? "someone"} was refused: ${door.reason}`, {
-					name: message.name,
-					reason: door.reason
-				});
-				this.tell(client, {
-					type: "refused",
-					reason: door.reason
-				});
-				return client.connection.close();
-		}
-	}
-	/** A seated player moves to another seat, free, in the lobby */
-	move(client, player) {
-		if (!client.seat) return;
-		const to = this.lobby.move(client.seat, player);
-		if (!to) return;
-		client.seat = to;
-		this.tell(client, {
-			type: "seated",
-			player: to.player,
-			token: to.token
-		});
-	}
-	/** Seats a client, and lets go whoever had the seat before: a player back from another page. A name the game gave goes in any phase */
-	sit(client, seat, name, named = false) {
-		const token = seat.take(client.connection, this.phase === "lobby" || named ? name : void 0);
-		client.seat = seat;
-		this.tell(client, {
-			type: "seated",
-			player: seat.player,
-			token
-		});
-		this.log(`${seat.name} took seat ${seat.player}`, {
-			name: seat.name,
-			player: seat.player
-		});
-		this.hooks.onPlayerJoin?.(this.publicSeat(seat), this.world);
-		if (this.phase === "lobby") return this.lobby.seated();
-		this.match?.keep();
-		this.seatInGame(client, seat);
-	}
-	/** The game's hooks */
-	get hooks() {
-		return this.options.mode.game.server ?? {};
-	}
-	/**
-	* Who comes once the seats are taken watches, when the server lets them (`watch`): everything, the whole map without fog, every player's resources. From
-	* the side of the world's neutral player, so that nobody's units are theirs; from the first seat's, in a world without one
-	*/
-	watch(client) {
-		client.watching = true;
-		const { world, host } = this;
-		if (this.phase === "lobby" || !host || !world) {
-			this.tell(client, {
-				type: "watching",
-				player: this.seats[0].player
-			});
-			return this.lobby.broadcast();
-		}
-		const side = [...world.players.values()].find((player) => player.neutral)?.id ?? this.seats[0].player;
-		this.tell(client, {
-			type: "watching",
-			player: side
-		});
-		const delay = this.options.watchDelay ?? 0;
-		host.connect(side, delay > 0 ? delayed(client.relay, delay) : client.relay, {
-			readOnly: true,
-			observer: true,
-			name: client.name
-		});
-		if (!host.running && this.phase === "game") host.start();
-	}
-	seatInGame(client, seat) {
-		const { host } = this;
-		if (!host) return;
-		if (this.options.debug) this.world?.debugPlayers.add(seat.player);
-		host.connect(seat.player, client.relay, { allow: () => this.allow(client) });
-		if (!host.running && this.phase === "game") host.start();
-	}
-	leave(client) {
-		if (!this.clients.delete(client)) return;
-		clearTimeout(client.deadline);
-		client.fromGameClosed();
-		const { seat } = client;
-		if (!seat || seat.connection !== client.connection) return;
-		seat.drop();
-		this.log(`${seat.name} left seat ${seat.player}`, {
-			name: seat.name,
-			player: seat.player
-		});
-		this.hooks.onPlayerLeave?.(this.publicSeat(seat), this.world);
-		const anyone = this.seats.some((each) => each.connected);
-		if (this.phase === "lobby") this.lobby.left(seat);
-		else if (this.phase === "ended" && !anyone) this.reset();
-		else if (this.phase === "game" && !anyone) this.match?.abandon();
-	}
-	/**
-	* A seat as everyone is told it (the lobby, the hooks)
-	*
-	* @internal
-	*/
-	publicSeat(seat) {
-		return this.lobby.publicSeat(seat);
-	}
-	/** Makes the world, seats everyone at it, and runs it */
-	async startGame() {
-		if (this.phase !== "lobby" || this.draining) return;
-		this.phase = "game";
-		this.lobby.again = false;
-		const server = this;
-		const match = await Match.make({
-			options: this.options,
-			logger: this.logger,
-			seats: this.seats,
-			navigation: this.navigation,
-			fill: () => this.lobby.fill(),
-			get watching() {
-				return server.watching;
-			},
-			publicSeat: (seat) => this.publicSeat(seat),
-			tellAll: (message) => this.tellAll(message),
-			kick: (player, reason) => this.kick(player, reason),
-			end: () => void this.endGame()
-		}, this.settings);
-		this.match = match;
-		this.lobby.broadcast();
-		for (const client of this.clients) if (client.seat) this.seatInGame(client, client.seat);
-		else if (client.watching) this.watch(client);
-		match.run();
-	}
-	/** Lets a player go for good: told why, their connection closed, and their token and id no good any more */
-	kick(player, reason) {
-		const held = this.lobby.seat(player);
-		if (!held) return;
-		const client = [...this.clients].find((each) => each.seat === held);
-		held.revoke();
-		this.log(`${held.name} was let go from seat ${held.player}: ${reason}`, {
-			name: held.name,
-			player: held.player,
-			reason
-		});
-		if (!client) return;
-		this.tell(client, {
-			type: "refused",
-			reason
-		});
-		client.connection.close();
-	}
-	/** The game is over: the result told to everyone and kept. The game goes on being shown until everyone has left */
-	async endGame() {
-		const { match } = this;
-		if (!match || this.phase !== "game") return void 0;
-		this.phase = "ended";
-		this.played++;
-		const result = await match.end();
-		if (!this.seats.some((seat) => seat.connected)) this.reset();
-		this.drained?.();
-		return result;
-	}
-	/**
-	* Back to the lobby after a game, with who is still there in their seats: a player of it who joins again ("Again",
-	* with their seat's token) takes theirs, the seats of those gone are free
-	*/
-	backToLobby(keepToken) {
-		this.dropMatch({ closeTransports: false });
-		for (const client of this.clients) {
-			client.toGame = () => {};
-			client.fromGameClosed = () => {};
-		}
-		this.phase = "lobby";
-		this.lobby.backFromGame(keepToken);
-		this.log("back to the lobby, for another game");
-		this.lobby.broadcast();
-	}
-	/** Back to the lobby, for a new game: the old one gone, every seat free */
-	reset() {
-		this.dropMatch();
-		this.phase = "lobby";
-		this.lobby.reset();
-		this.kickedOut.clear();
-		this.log("back to the lobby");
-	}
-	admin(client, message) {
-		if (!this.options.adminKey || !sameSecret(message.key, this.options.adminKey)) return this.tell(client, {
-			type: "refused",
-			reason: "not an admin"
-		});
-		if (message.action === "stop") {
-			this.endGame();
-			return;
-		}
-		this.pause(message.action === "pause");
-	}
-	/**
-	* 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
-	*/
-	pause(paused, by) {
-		this.match?.pause(paused, by);
-	}
-	/**
-	* Stops the server: every connection closed. With `drain`, it first takes no new games (its health says so, for a
-	* load balancer to send nobody new) and waits for the running one to end, up to so many seconds: then it is ended
-	* (no winner, the players told the server stopped) and the server closes
-	*/
-	async close(options = {}) {
-		if (options.drain && !this.draining) {
-			this.draining = true;
-			this.log(`stopping: no new games, ${this.phase === "game" ? `the running one has ${options.drain} s to end` : "none running"}`);
-			if (this.phase === "game") {
-				let limit;
-				const over = await new Promise((resolve) => {
-					this.drained = () => resolve(true);
-					limit = setTimeout(() => resolve(false), options.drain * 1e3);
-				});
-				clearTimeout(limit);
-				this.drained = void 0;
-				if (!over) {
-					if (this.match) this.match.failed = "The server stopped";
-					await this.endGame();
-				}
-			}
-		}
-		this.dropMatch();
-		await this.source.close();
-	}
-};
-//#endregion
-//#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
-*
-* @beta
-*/
-function mapMode(game, map, options = {}) {
-	const { start } = options;
-	const seats = options.seats ?? seatsOf(map);
-	return {
-		id: `map:${map.name}`,
-		name: map.name,
-		game,
-		seats,
-		seatSettings: {
-			...seatSettingsOf(game, map.races),
-			...seatLooksOf(seats)
-		},
-		async makeWorld(settings, context) {
-			const made = structuredClone(map);
-			const world = await createWorldFromMap({
-				map: made,
-				game,
-				seed: randomSeed(),
-				log: context?.log,
-				races: racesOfSeats(context?.seats),
-				...looksOfSeats(context?.seats, seats),
-				...context?.navigation && { navigation: { builds: context.navigation } }
-			});
-			try {
-				await start?.(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(game, generator, options) {
-	const { start, ai, brain, seats, ...generating } = options;
-	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, {
-			start,
-			ai,
-			brain,
-			seats
-		}),
-		id: `generated:${map.generated?.seed ?? seed}`,
-		map
-	};
-}
-//#endregion
-//#region src/server/start.ts
-/**
-* Starts a server of a game, and resolves once it listens: a lobby that seats who joins, then games of it, one after
-* the other, each on a world made anew.
-*
-*     const server = await startServer({ game: rules, map, start: (world) => startMission(world) })
-*     // server.port, server.close()
-*
-* The parts are there on their own: `GameServer.start` with a `GameMode`, `mapMode`, `SessionHost`
-*
-* @beta
-*/
-async function startServer(options) {
-	const { game, port = 8787, map, makeWorld, seats, start, computer, mode: givenMode, name, ...server } = options;
-	return GameServer.start({
-		...server,
-		port,
-		mode: givenMode ?? modeOf(game, {
-			map,
-			makeWorld,
-			seats,
-			start,
-			computer,
-			name
-		})
-	});
-}
-/** The mode a server runs, from what it was started with */
-function modeOf(game, options) {
-	const { map, makeWorld, start } = options;
-	if (!map && !makeWorld) throw new Error("startServer: a server needs a map of the game, or a makeWorld, to make the world of each game from");
-	const seats = options.seats ?? (map ? seatsOf(map) : void 0);
-	if (!seats?.length) throw new Error(map ? `startServer: the map "${map.name}" has no player with a start. Give its players starts, or say the seats` : "startServer: say the seats players may take (seats), with a world made in code");
-	const { computer } = options;
-	const brain = computer && typeof computer === "object" ? computer : void 0;
-	const ai = brain ? againstTheRest : computer;
-	const base = map && !makeWorld ? mapMode(game, map, {
-		seats,
-		ai,
-		brain
-	}) : void 0;
-	return {
-		id: base?.id ?? game.id,
-		name: options.name ?? base?.name ?? game.name,
-		game,
-		seats,
-		async makeWorld(settings, context) {
-			const world = base ? await base.makeWorld(settings, context) : await makeWorld(settings, context);
-			try {
-				await start?.(world, {
-					map,
-					settings
-				});
-			} catch (error) {
-				world.dispose();
-				throw error;
-			}
-			return world;
-		},
-		...ai !== null && { ai: ai ?? againstTheRest },
-		...brain && { brain }
-	};
-}
-//#endregion
-//#region src/server/rooms.ts
-/** What a room is reached at: the first part of the address a connection asked for */
-var roomOf = (url) => new URL(url, "ws://server").pathname.split("/")[1] ?? "";
-/** A name for a room: letters, digits, `-` and `_` */
-var isRoomName = (name) => /^[\w-]+$/.test(name);
-/** What an address that asked for games too often is told */
-var TOO_OFTEN = "too many games asked for: wait a minute";
-/** The most a body of a request to make a room may be: a kind and a few settings */
-var MAX_BODY = 4096;
-/**
-* Where a room's game server gets its connections (`ConnectionSource`): those the shared port hands it for the room's
-* name. Its server is told of a connection closing after the room has let go of it, and its `close` closes those in
-* the room, never the port
-*/
-var RoomConnections = class {
-	port;
-	handler = () => {};
-	open = /* @__PURE__ */ new Set();
-	constructor(port) {
-		this.port = port;
-	}
-	onConnection(handler) {
-		this.handler = handler;
-	}
-	/** A connection to the room, handed to its server */
-	hand(connection) {
-		let closed = () => {};
-		const theirs = {
-			get url() {
-				return connection.url;
-			},
-			get address() {
-				return connection.address;
-			},
-			get bytesSent() {
-				return connection.bytesSent;
-			},
-			get compressed() {
-				return connection.compressed;
-			},
-			send: (message) => connection.send(message),
-			onMessage: (next) => connection.onMessage(next),
-			onClose: (next) => void (closed = next),
-			close: () => connection.close()
-		};
-		this.open.add(theirs);
-		connection.onClose(() => {
-			this.open.delete(theirs);
-			closed();
-		});
-		this.handler(theirs);
-	}
-	async close() {
-		for (const connection of [...this.open]) connection.close();
-	}
-};
-/**
-* Many games in a process (S58): game servers that share a port, each a room reached at its name, as a server of its
-* own would be at its port. One process, one thread: each room's games step in turn, so the rooms of a process are as
-* many as its ticks have time for (`/metrics` says how long they take). A connection to a room there is not is told so
-* and closed. Rooms are added in code (`add`), or made by players of the kinds it offers (`kinds`, `POST /games`) and
-* closed once empty
-*
-* @beta
-*/
-var GameRooms = class GameRooms {
-	socket;
-	options;
-	logger;
-	servers = /* @__PURE__ */ new Map();
-	/** Where each room's connections come from, by its name */
-	doors = /* @__PURE__ */ new Map();
-	/** The rooms players made, and since when each has been empty (nobody connected): what closes them */
-	made = /* @__PURE__ */ new Map();
-	/** When each address last asked for rooms (`POST /games`): a few a minute each */
-	askedBy = /* @__PURE__ */ new Map();
-	sweeper;
-	nextMade = 1;
-	/** Who waits to be matched, by kind, in the order they came */
-	queues = /* @__PURE__ */ new Map();
-	constructor(socket, options, logger) {
-		this.socket = socket;
-		this.options = options;
-		this.logger = logger;
-	}
-	/** The rooms there are now, by name */
-	get rooms() {
-		return this.servers;
-	}
-	/** Starts the rooms, and resolves once they listen */
-	static async start(options) {
-		for (const name of Object.keys(options.rooms)) if (!isRoomName(name)) throw new Error(`GameRooms: "${name}" is no name for a room: letters, digits, - and _`);
-		const logger = serverLogger(options.log);
-		let rooms;
-		const socket = await startSocketServer({
-			port: options.port ?? 8787,
-			compress: options.compress,
-			idleTimeout: options.idleTimeout,
-			maxBuffered: options.maxBuffered,
-			maxConnections: options.maxConnections,
-			log: logger,
-			onRequest: (request, response) => {
-				if (!rooms) return;
-				if (rooms.answerMake(request, response)) return;
-				if (answerOps(request, response, options.http, () => ({
-					draining: rooms.draining,
-					rooms: rooms.metrics()
-				}), () => ({
-					games: rooms.listing(),
-					kinds: rooms.kinds()
-				}), {
-					ratings: options.ratings,
-					modes: rooms.modes()
-				})) return;
-				response.writeHead(426, { "content-type": "text/plain" });
-				response.end(`Game rooms: connect with a WebSocket to one of ${[...rooms.servers.keys()].join(", ")}\n`);
-			}
-		});
-		rooms = new GameRooms(socket, options, logger);
-		socket.onConnection((connection) => rooms.connect(connection));
-		try {
-			for (const [name, room] of Object.entries(options.rooms)) await rooms.add(name, room);
-		} catch (error) {
-			await rooms.close();
-			throw error;
-		}
-		if (options.kinds && Object.keys(options.kinds).length) rooms.sweeper = setInterval(() => void rooms.sweep(), 1e3);
-		return rooms;
-	}
-	/** A kind it offers, by id: its own, never what every object has (`constructor`), whatever a page sends */
-	kind(id) {
-		const { kinds } = this.options;
-		return kinds && Object.hasOwn(kinds, id) ? kinds[id] : void 0;
-	}
-	/** The address of the queue, or none where there is no matchmaking */
-	get queuePath() {
-		const { matchmaking, kinds } = this.options;
-		if (matchmaking === false || !kinds || !Object.keys(kinds).length) return void 0;
-		return typeof matchmaking === "object" && matchmaking.path || "queue";
-	}
-	/** A connection to a room: handed to its game server, or told there is no such room. The queue's, to the queue */
-	connect(connection) {
-		const name = roomOf(connection.url);
-		if (name === this.queuePath) return this.waitInQueue(connection);
-		const door = this.doors.get(name);
-		if (!door) {
-			connection.send(JSON.stringify({
-				type: "refused",
-				reason: `there is no room "${name}"`
-			}));
-			return connection.close();
-		}
-		door.hand(connection);
-	}
-	/** Opens a room at a name, as `rooms` does: in code, while the rooms run */
-	async add(name, room) {
-		if (!isRoomName(name)) throw new Error(`GameRooms: "${name}" is no name for a room: letters, digits, - and _`);
-		if (this.servers.has(name)) throw new Error(`GameRooms: there is a room "${name}" already`);
-		const door = new RoomConnections(this.socket.port);
-		this.doors.set(name, door);
-		const server = await GameServer.attach(door, {
-			...room,
-			ratings: room.ratings ?? this.options.ratings,
-			log: this.logger.child({ context: () => ({ fields: { room: name } }) })
-		});
-		this.servers.set(name, server);
-		return server;
-	}
-	/** Closes a room and lets go of its name: those in it are let go */
-	async remove(name) {
-		const server = this.servers.get(name);
-		if (!server) return;
-		this.servers.delete(name);
-		this.made.delete(name);
-		await server.close();
-		this.doors.delete(name);
-	}
-	/**
-	* Makes a room of a kind it offers (`kinds`), with the settings asked for: what `POST /games` does. Its name is the
-	* kind's and a number. Refused (with why) for a kind it does not offer, too many made, or while it stops
-	*/
-	async make(kind, settings = {}, seat) {
-		const offered = this.kind(kind);
-		if (!offered) return { refused: `there is no kind of game "${kind}"` };
-		if (this.draining) return { refused: "the server is stopping: it takes no new games" };
-		if (this.made.size >= (this.options.maxMade ?? 16)) return { refused: "there are as many games as there may be: join one" };
-		let name = `${kind}-${this.nextMade++}`;
-		while (this.servers.has(name)) name = `${kind}-${this.nextMade++}`;
-		this.made.set(name, {
-			kind,
-			emptySince: Date.now(),
-			joined: false,
-			matched: !!seat
-		});
-		try {
-			const room = typeof offered.room === "function" ? offered.room(settings) : offered.room;
-			await this.add(name, {
-				...room,
-				settings: {
-					...room.settings,
-					...settings
-				},
-				...seat && { seat }
-			});
-		} catch (error) {
-			this.made.delete(name);
-			throw error;
-		}
-		this.logger.info("server", `made the room ${name} (${offered.name})`);
-		return { room: name };
-	}
-	/** A room a kind makes, as its listing and matchmaking read it: the one it makes, or one it made once (a kind of a function) */
-	samples = /* @__PURE__ */ new Map();
-	sampleOf(kind) {
-		const { room } = this.kind(kind);
-		if (typeof room !== "function") return room;
-		let sample = this.samples.get(kind);
-		if (!sample) this.samples.set(kind, sample = room({}));
-		return sample;
-	}
-	/** How many of a kind's seats are for players: those the computer does not play */
-	seatsFor(kind) {
-		const room = this.sampleOf(kind);
-		return room.mode.seats.filter((seat) => !room.ai?.includes(seat.player)).length;
-	}
-	/** A connection to the queue: it says the kind it waits for, is told how many wait, and its ticket once matched */
-	waitInQueue(connection) {
-		let waitingFor;
-		const leave = () => {
-			if (!waitingFor) return;
-			const queue = this.queues.get(waitingFor) ?? [];
-			const at = queue.findIndex((each) => each.connection === connection);
-			if (at >= 0) queue.splice(at, 1);
-			this.tellQueue(waitingFor);
-			waitingFor = void 0;
-		};
-		const within = this.options.joinWithin ?? 10;
-		const deadline = Number.isFinite(within) ? setTimeout(() => !waitingFor && connection.close(), Math.max(0, within) * 1e3) : void 0;
-		deadline?.unref?.();
-		connection.onClose(() => {
-			clearTimeout(deadline);
-			leave();
-		});
-		connection.onMessage((text) => {
-			let message;
-			try {
-				message = JSON.parse(text);
-			} catch {
-				return;
-			}
-			if (message.type === "leave") return leave();
-			if (message.type !== "queue") return;
-			const kind = String(message.kind ?? "");
-			if (!this.kind(kind)) return connection.send(JSON.stringify({
-				type: "refused",
-				reason: `there is no kind of game "${kind}"`
-			}));
-			if (this.askedTooOften(connection.address)) return connection.send(JSON.stringify({
-				type: "refused",
-				reason: TOO_OFTEN
-			}));
-			clearTimeout(deadline);
-			leave();
-			waitingFor = kind;
-			const queue = this.queues.get(kind) ?? [];
-			this.queues.set(kind, queue);
-			queue.push({
-				connection,
-				...typeof message.name === "string" && { name: message.name.slice(0, 24) }
-			});
-			this.match(kind).catch((error) => this.logger.error("server", "matchmaking failed", { error: String(error) }));
-		});
-	}
-	/**
-	* Whether an address has asked for games too often to ask again now: a few a minute each, made (`POST /games`) or
-	* waited for in the queue, so that nobody fills every place there is by asking over and over. Counted when it has not
-	*/
-	askedTooOften(address) {
-		const now = Date.now();
-		const recent = (this.askedBy.get(address) ?? []).filter((at) => now - at < 6e4);
-		if (recent.length >= 3) return true;
-		recent.push(now);
-		this.askedBy.set(address, recent);
-		if (this.askedBy.size > 1024) {
-			for (const [each, times] of this.askedBy) if (times.every((at) => now - at >= 6e4)) this.askedBy.delete(each);
-		}
-		return false;
-	}
-	/** Tells everyone waiting for a kind how many wait, of how many it takes */
-	tellQueue(kind) {
-		const queue = this.queues.get(kind) ?? [];
-		const needed = this.seatsFor(kind);
-		for (const each of queue) each.connection.send(JSON.stringify({
-			type: "queued",
-			kind,
-			waiting: queue.length,
-			needed
-		}));
-	}
-	/** As many wait for a kind as its seats: a room of it for them, which lets in only them, and a ticket each */
-	async match(kind) {
-		const queue = this.queues.get(kind);
-		const needed = this.seatsFor(kind);
-		if (queue.length < needed) return this.tellQueue(kind);
-		const players = queue.splice(0, needed);
-		const room = this.sampleOf(kind);
-		const seats = room.mode.seats.filter((seat) => !room.ai?.includes(seat.player));
-		const tickets = new Map(players.map((player, i) => [crypto.randomUUID(), {
-			player: seats[i].player,
-			name: player.name
-		}]));
-		const made = await this.make(kind, {}, (request) => {
-			const ticket = request.ticket ? tickets.get(request.ticket) : void 0;
-			return ticket ? {
-				player: ticket.player,
-				name: ticket.name,
-				id: request.ticket
-			} : { refuse: "this game is for the players matched to it" };
-		}).catch((error) => ({ refused: error instanceof Error ? error.message : String(error) }));
-		const given = [...tickets.keys()];
-		players.forEach(({ connection }, i) => connection.send(JSON.stringify("room" in made ? {
-			type: "matched",
-			kind,
-			room: made.room,
-			ticket: given[i]
-		} : {
-			type: "refused",
-			reason: made.refused
-		})));
-		this.tellQueue(kind);
-	}
-	/** Closes the rooms players made that have been empty long enough */
-	async sweep() {
-		const now = Date.now();
-		const emptyFor = (this.options.emptyFor ?? 60) * 1e3;
-		for (const [name, made] of [...this.made]) {
-			const server = this.servers.get(name);
-			if (!server) continue;
-			if (server.connections > 0) {
-				made.emptySince = now;
-				made.joined = true;
-				continue;
-			}
-			const wait = !made.joined ? Math.min(emptyFor, 2e4) : server.phase === "game" ? Math.max(emptyFor, (server.options.abandonAfter ?? 60) * 1e3) : emptyFor;
-			if (now - made.emptySince >= wait) await this.remove(name);
-		}
-	}
-	/** `POST /games`: a room made of a kind it offers, `{ kind, settings }`, answered with its name. And what a page asks first */
-	answerMake(request, response) {
-		const list = this.options.http?.games ?? "/games";
-		const { pathname } = new URL(request.url ?? "/", "http://server");
-		if (!list || pathname !== list || request.method !== "POST" && request.method !== "OPTIONS") return false;
-		const cors = {
-			"access-control-allow-origin": "*",
-			"access-control-allow-methods": "GET, POST",
-			"access-control-allow-headers": "content-type"
-		};
-		if (request.method === "OPTIONS") {
-			response.writeHead(204, cors);
-			response.end();
-			return true;
-		}
-		const answer = (status, body) => {
-			response.writeHead(status, {
-				"content-type": "application/json",
-				"cache-control": "no-store",
-				...cors
-			});
-			response.end(JSON.stringify(body));
-		};
-		if (this.askedTooOften(request.socket.remoteAddress ?? "")) {
-			answer(429, { refused: TOO_OFTEN });
-			return true;
-		}
-		let body = "";
-		request.on("data", (chunk) => {
-			body += chunk.toString();
-			if (body.length > MAX_BODY) request.destroy();
-		});
-		request.on("end", () => {
-			let asked;
-			try {
-				asked = JSON.parse(body || "{}");
-			} catch {
-				return answer(400, { refused: "what was asked is not JSON" });
-			}
-			const settings = asked.settings && typeof asked.settings === "object" ? Object.fromEntries(Object.entries(asked.settings).filter(([, value]) => typeof value === "string")) : {};
-			this.make(String(asked.kind ?? ""), settings).then((made) => answer("room" in made ? 201 : 409, made), (error) => answer(500, { refused: error instanceof Error ? error.message : String(error) }));
-		});
-		return true;
-	}
-	/** The port they share */
-	get port() {
-		return this.socket.port;
-	}
-	/** Whether they take no new games: stopping */
-	get draining() {
-		return [...this.servers.values()].some((room) => room.draining);
-	}
-	/** The modes the rooms play, each once, in their order: what the ratings are kept by (`/ratings`) */
-	modes() {
-		return [...new Set([...this.servers.values()].map((room) => room.options.mode.id))];
-	}
-	/** Every room's game, as a list of games says it (`GET /games`) */
-	listing() {
-		return [...this.servers].map(([name, room]) => room.listing(name));
-	}
-	/** The kinds of game players may make a room of (`kinds`), by id, with their names and the settings they offer */
-	kinds() {
-		const queue = this.queuePath;
-		return Object.entries(this.options.kinds ?? {}).map(([id, kind]) => ({
-			id,
-			name: kind.name,
-			settings: { ...this.sampleOf(id).mode.game.server?.settings },
-			...queue && {
-				queue,
-				waiting: this.queues.get(id)?.length ?? 0,
-				needed: this.seatsFor(id)
-			}
-		}));
-	}
-	/** The numbers of each room, by its name */
-	metrics() {
-		return new Map([...this.servers].map(([name, room]) => [name, room.metrics()]));
-	}
-	/** Stops every room (see `GameServer.close`: with `drain`, each waits for its game, all at once), then the port */
-	async close(options = {}) {
-		if (this.sweeper) clearInterval(this.sweeper);
-		for (const queue of this.queues.values()) for (const { connection } of queue) connection.close();
-		this.queues.clear();
-		await Promise.all([...this.servers.values()].map((room) => room.close(options)));
-		await this.socket.close();
-	}
-};
-//#endregion
-//#region src/server/relay.ts
-/** @beta */
-var WatchRelay = class WatchRelay {
-	socket;
-	shares = /* @__PURE__ */ new Map();
-	watchers = /* @__PURE__ */ new Map();
-	next = 1;
-	/** What the relay says: see `RelayOptions.log` */
-	logger;
-	constructor(socket, options) {
-		this.socket = socket;
-		this.logger = serverLogger(options.log);
-		socket.onConnection((connection) => this.accept(connection));
-	}
-	/** Starts a relay, and resolves once it listens */
-	static async start(options) {
-		const socket = await startSocketServer({
-			port: options.port,
-			compress: options.compress,
-			maxMessage: 16777216
-		});
-		const relay = new WatchRelay(socket, options);
-		relay.logger.info("server", `a relay for games watched, on port ${socket.port}`, { port: socket.port });
-		return relay;
-	}
-	get port() {
-		return this.socket.port;
-	}
-	/** How many watch what is shared under a key */
-	watching(key) {
-		return [...this.watchers.values()].filter((watcher) => watcher.key === key).length;
-	}
-	accept(connection) {
-		let role;
-		connection.onMessage((text) => {
-			if (role && "watcher" in role) return this.fromWatcher(role.watcher, text);
-			const message = readMessage(text);
-			if (!message) return;
-			if (!role && message.type === "share") {
-				if (typeof message.key === "string" && typeof message.name === "string") role = this.share(connection, {
-					type: "share",
-					key: message.key,
-					name: message.name
-				});
-			} else if (!role && message.type === "watch") {
-				if (typeof message.key === "string") role = { watcher: this.watch(connection, message.key) };
-			} else if (role && "share" in role && message.type === "send" && typeof message.to === "number" && typeof message.text === "string") {
-				const watcher = this.watchers.get(message.to);
-				if (watcher?.key === role.share.key) watcher.connection.send(message.text);
-			}
-		});
-		connection.onClose(() => {
-			if (role && "share" in role) this.unshare(role.share);
-			else if (role && "watcher" in role) this.leave(role.watcher);
-		});
-	}
-	tell(connection, notice) {
-		connection.send(JSON.stringify(notice));
-	}
-	share(host, message) {
-		if (this.shares.has(message.key)) {
-			this.tell(host, {
-				type: "taken",
-				key: message.key
-			});
-			return;
-		}
-		const share = {
-			key: message.key,
-			name: message.name.slice(0, 80),
-			host
-		};
-		this.shares.set(share.key, share);
-		this.tell(host, {
-			type: "shared",
-			key: share.key
-		});
-		this.logger.info("server", `${share.name} is shared under ${share.key}`, { name: share.name });
-		for (const watcher of this.watchers.values()) if (watcher.key === share.key) this.tell(host, {
-			type: "watcher",
-			id: watcher.id
-		});
-		return { share };
-	}
-	unshare(share) {
-		if (this.shares.get(share.key) !== share) return;
-		this.shares.delete(share.key);
-		this.logger.info("server", `${share.name} is no longer shared`, { name: share.name });
-		for (const watcher of this.watchers.values()) if (watcher.key === share.key) this.tell(watcher.connection, {
-			type: "ended",
-			key: share.key
-		});
-	}
-	watch(connection, key) {
-		const watcher = {
-			id: this.next++,
-			connection,
-			key
-		};
-		this.watchers.set(watcher.id, watcher);
-		const share = this.shares.get(key);
-		if (share) this.tell(share.host, {
-			type: "watcher",
-			id: watcher.id
-		});
-		else this.tell(connection, {
-			type: "waiting",
-			key
-		});
-		return watcher;
-	}
-	fromWatcher(watcher, text) {
-		const share = this.shares.get(watcher.key);
-		if (share) this.tell(share.host, {
-			type: "from",
-			watcher: watcher.id,
-			text
-		});
-	}
-	leave(watcher) {
-		if (!this.watchers.delete(watcher.id)) return;
-		const share = this.shares.get(watcher.key);
-		if (share) this.tell(share.host, {
-			type: "gone",
-			watcher: watcher.id
-		});
-	}
-	/** Stops the relay: every connection closed */
-	async close() {
-		await this.socket.close();
-	}
-};
-var pack_schema_default = {
-	$schema: "http://json-schema.org/draft-07/schema#",
-	$ref: "#/definitions/PackFile",
-	definitions: /* @__PURE__ */ JSON.parse("{\"PackFile\":{\"type\":\"object\",\"properties\":{\"$schema\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"Letters, digits, dots and dashes: what the game composed of it is called by (`melee+<id>`)\"},\"version\":{\"type\":\"string\",\"description\":\"`major.minor.patch`\"},\"name\":{\"type\":\"string\"},\"requires\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The game and the packs or mods it is made for, as a mod's (`ModDef.requires`)\"},\"units\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/UnitTypeDef\"}},\"abilities\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AbilityDef\"}},\"buffs\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/BuffDef\"}},\"items\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ItemDef\"}},\"upgrades\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/UpgradeDef\"}},\"races\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/RaceDef\"}},\"rules\":{\"$ref\":\"#/definitions/RulesInit\",\"description\":\"The rules it changes, as data (`GameBuilder.rules`)\"},\"data\":{\"$ref\":\"#/definitions/GameData\",\"description\":\"Values over the definitions, as a `data.json` has them (`GameData`): the editor's Data panel writes here for a pack\"},\"looks\":{\"type\":\"object\",\"additionalProperties\":{},\"description\":\"What its units look like, as a `looks.json` has them: the client's to lay over the game's view\"}},\"required\":[\"id\",\"version\"],\"additionalProperties\":false,\"description\":\"A pack of content as its file has it (`packs/<id>/pack.json`): plain data, checked against the pack's schema (`@v12-engine/engine/schemas/pack.schema.json`) as it is read. Its definitions are added to the game's, or put in the place of those of the same id; then its `data` is laid over the whole as a `data.json` is (`withData`), and its `rules` over the game's\"},\"UnitTypeDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"kind\":{\"$ref\":\"#/definitions/EntityKind\"},\"radius\":{\"type\":\"number\",\"description\":\"Collision radius\"},\"footprint\":{\"type\":\"object\",\"properties\":{\"w\":{\"type\":\"number\"},\"d\":{\"type\":\"number\"}},\"required\":[\"w\",\"d\"],\"additionalProperties\":false,\"description\":\"Size in grid cells. Required for buildings and resources\"},\"stats\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"health\":{\"type\":\"number\"},\"attackDamage\":{\"type\":\"number\",\"description\":\"What a basic attack deals, before the armor of the target\"},\"attackSpeed\":{\"type\":\"number\",\"description\":\"Attacks per second\"},\"attackRange\":{\"type\":\"number\",\"description\":\"Measured between the edges of attacker and target\"},\"armor\":{\"type\":\"number\",\"description\":\"Against physical damage: 100 of it halve what arrives\"},\"magicResist\":{\"type\":\"number\",\"description\":\"The same against magic damage\"},\"healthRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"mana\":{\"type\":\"number\"},\"manaRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"moveSpeed\":{\"type\":\"number\",\"description\":\"Units per second. Who has none cannot move\"},\"sight\":{\"type\":\"number\",\"description\":\"How far it sees. At night the unit type says how far that is\"}},\"required\":[\"health\"],\"description\":\"What it starts with. What is left out is 0, a critical strike is worth 175%\"},\"initialMana\":{\"type\":\"number\",\"description\":\"Mana it comes into the world with. All of it when left out\"},\"sight\":{\"type\":\"number\",\"description\":\"Vision radius by day\"},\"sightNight\":{\"type\":\"number\",\"description\":\"Vision radius at night. A part of the one by day when left out\"},\"flying\":{\"type\":\"boolean\",\"description\":\"Flies: over cliffs, trees and buildings, out of reach of whatever cannot hit the air\"},\"naval\":{\"type\":\"boolean\",\"description\":\"Goes on deep water and nowhere else: a boat. Sent onto land, it goes to the water nearest where it was sent. On the ground, as far as what can hit it goes\"},\"waygate\":{\"type\":\"boolean\",\"description\":\"A waygate, in a game with the portals pack (`withPortals`): a unit told to it walks in and is at once where it leads (its `waygate` field, a point of the map; `setWaygate` in code)\"},\"destructible\":{\"type\":\"boolean\",\"description\":\"Rocks, a barricade, a gate to break down, in a game with the destructibles pack (`withDestructibles`): it stands in the way as any building does until it is brought down, and any unit whose attack reaches it attacks it when told to, never of its own accord\"},\"transport\":{\"type\":\"object\",\"properties\":{\"capacity\":{\"type\":\"number\"},\"armed\":{\"type\":\"number\",\"description\":\"Attack damage each one inside adds; or in code, all of what they add, by who is inside (none for nobody)\"}},\"required\":[\"capacity\"],\"additionalProperties\":false,\"description\":\"Carries others: a boat, or a building they go into (a garrison). `takes` says who may get in; `armed`, for a building with an attack, is the attack damage each one inside adds, and it attacks only while someone is inside, as an orc burrow does. What a building holds comes out when it falls; what a boat holds goes down with it\"},\"turnRate\":{\"type\":\"number\",\"description\":\"Radians per second\"},\"attacks\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AttackDef\"},\"description\":\"How it attacks, as the classic RTS two weapons: against each target the first that reaches it (its `targets`), or the one the game picks (`GameRules.combat.pickAttack`). It swings one at a time: a hit's cooldown is that attack's, whichever swings next. None for what does not attack\"},\"hero\":{\"$ref\":\"#/definitions/HeroDef\"},\"level\":{\"type\":\"number\",\"description\":\"How dangerous it is, for creeps. Shown to the player, and added up per camp\"},\"bounty\":{\"type\":\"array\",\"minItems\":2,\"items\":[{\"type\":\"number\",\"title\":\"min\"},{\"type\":\"number\",\"title\":\"max\"}],\"maxItems\":2,\"description\":\"Gold for whoever kills it, rolled between the two\"},\"corpse\":{\"type\":\"boolean\",\"description\":\"Whether it leaves a corpse when it dies, for spells to use (see `raiseDead`). Units do, unless this says no: machines, spirits. Decided for each death in code: false for none, true or seconds for one (how long it lies)\"},\"spellImmune\":{\"type\":\"boolean\",\"description\":\"Immune to spells: abilities do not touch it, of friends or enemies, unless they say they get through (`piercesImmunity`). Decided in code whenever it is asked: while it stands on holy ground. The player's screen only knows the plain `true` of it, to grey out a target; the simulation goes by the code\"},\"xp\":{\"type\":\"number\",\"description\":\"Experience heroes get for killing it. Follows from its cost when left out\"},\"requires\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Building types the player has to have before this can be built or trained\"},\"race\":{\"type\":\"string\",\"description\":\"The race it is of (`GameModule.races`): only its players may build or train it. Everyone's when left out: creeps, what is shared. What a player may have is the game's to change (the `available` hook)\"},\"provides\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Building types this one counts as, for requirements. A keep is a town hall too\"},\"upgradesTo\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"array\",\"items\":{\"type\":\"string\"}}],\"description\":\"Type this building can be upgraded into, where it stands; or the types, for one that may become one of several (a keep that turns into a castle or a citadel, `upgradesOf`). The first is what an upgrade is into where none is named\"},\"inventory\":{\"type\":\"number\",\"description\":\"Slots for items. Heroes have six\"},\"sells\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Items this building sells\"},\"hires\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Units it hires out to whoever has one of theirs there, by type: a tavern's heroes, a dock's boats. Their cost, and a hero only once (see `hire`). Neutral, it hires to everyone\"},\"drops\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"item\":{\"type\":\"string\"},\"chance\":{\"type\":\"number\"}},\"required\":[\"item\",\"chance\"],\"additionalProperties\":false},\"description\":\"What it may leave behind when it dies, each with its chance from 0 to 1. Or code: the items it leaves, decided as it dies (one random level-3 item; more for a stronger killer)\"},\"revives\":{\"type\":\"boolean\",\"description\":\"Brings fallen heroes back\"},\"abilities\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Ids of the abilities the unit has\"},\"cost\":{\"$ref\":\"#/definitions/Cost\"},\"supply\":{\"type\":\"number\",\"description\":\"Supply (food) it takes up for as long as it lives, and while it is being trained\"},\"supplies\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"What it takes of the game's other pools of supply, by name (`GameRules.supply.pools`): `{ command: 1 }`\"},\"buildTime\":{\"type\":\"number\",\"description\":\"Seconds to build or train\"},\"supplyProvided\":{\"type\":\"number\"},\"suppliesProvided\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"What it provides of the game's other pools of supply, by name (`GameRules.supply.pools`), once it stands finished\"},\"harvester\":{\"type\":\"object\",\"properties\":{\"capacity\":{\"type\":\"number\"},\"gatherTime\":{\"type\":\"number\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ResourceKind\"},\"description\":\"The kinds of resource it gathers: all of them when left out. The undead's acolytes gold and nothing else, ghouls lumber. The `canHarvest` hook has the last word (`canHarvest`)\"}},\"required\":[\"capacity\",\"gatherTime\"],\"additionalProperties\":false},\"builds\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Building types this unit can construct\"},\"trains\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Unit types this building can train\"},\"researches\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Upgrades that can be researched here\"},\"dropOff\":{\"anyOf\":[{\"type\":\"boolean\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ResourceKind\"}}],\"description\":\"Accepts harvested resources: all of them, or only the ones listed\"},\"builtOn\":{\"$ref\":\"#/definitions/ResourceKind\",\"description\":\"Goes up on a resource of this kind, over it, of the same footprint: the undead's cursed gold mine. The resource is its owner's alone from then on (`canHarvest`); one that takes what is gathered there (`dropOff`) has its owner's workers gather at it from around it, handing in where they stand, as many at once as `gatherers` says. It goes down with the resource, which stands again where it is destroyed\"},\"gatherers\":{\"type\":\"number\",\"description\":\"Workers that gather at once at it, when it stands on a resource (`builtOn`): 5 when left out\"},\"buildsItself\":{\"type\":\"boolean\",\"description\":\"Goes up on its own once it is put down, as the undead summon theirs: the builder is free at once, and nobody helps (`GameRules.production.buildRate` of one builder, all the way). The same as `construction: 'self'`\"},\"construction\":{\"type\":\"string\",\"enum\":[\"builder\",\"self\",\"instant\"],\"description\":\"How it goes up once it is put down: with builders at it (`builder`, the more the faster, as `buildRate` says), on its own with the builder free at once (`self`, the undead's), or whole at once (`instant`: a wall piece, a ward). `builder` when left out (`self` with `buildsItself`)\"},\"resource\":{\"type\":\"object\",\"properties\":{\"kind\":{\"$ref\":\"#/definitions/ResourceKind\"},\"amount\":{\"type\":\"number\"},\"slots\":{\"type\":\"number\",\"description\":\"Workers that fit inside at once, for resources that are entered\"},\"entered\":{\"type\":\"boolean\",\"description\":\"Workers go inside to gather, like into a gold mine, instead of working on it from next to it\"},\"gatherTime\":{\"type\":\"number\",\"description\":\"Seconds a load takes, when that is not what the worker usually needs\"}},\"required\":[\"kind\",\"amount\",\"slots\"],\"additionalProperties\":false},\"hotkey\":{\"type\":\"string\",\"description\":\"Key used in the command card when building or training this type\"},\"threat\":{\"type\":\"number\",\"description\":\"Higher values are picked first when acquiring targets\"},\"invulnerable\":{\"type\":\"boolean\"},\"undying\":{\"type\":\"boolean\",\"description\":\"Takes damage like anything else but never dies of it: it is left with a little health, like something to practise on\"},\"recovers\":{\"type\":\"number\",\"description\":\"Seconds after it was last hurt that it is whole again, all at once\"},\"ignored\":{\"type\":\"boolean\",\"description\":\"Nobody picks a fight with it on their own: it is only attacked when someone is told to\"},\"fellable\":{\"type\":\"boolean\",\"description\":\"Destroyed by attacks that fell, like a tree by a catapult, whatever else it withstands\"},\"wall\":{\"type\":\"object\",\"properties\":{\"family\":{\"type\":\"string\"},\"gate\":{\"type\":\"boolean\"}},\"required\":[\"family\"],\"additionalProperties\":false,\"description\":\"A piece of wall (`withWalls`): it joins with the pieces of its family beside it, and its shape (`single`, `end`, `straight`, `corner`, `tee`, `cross`) is its look. A gate (`gate`) joins as a piece does, turned along its line, and its owner opens and shuts it for everyone (`wallGateCommand`): its look `open` or `shut`. Pieces join by their footprints, so a gate wider than a cell sits in a line of pieces of one: one of a cell lets nobody through, the ground about a wall being kept off by the radius of what walks (a gatehouse of 3 by 3 lets through what is 1 wide)\"},\"lifetime\":{\"type\":\"number\",\"description\":\"Seconds it lasts before it is gone by itself, like a ward\"},\"invisible\":{\"type\":\"object\",\"properties\":{\"after\":{\"type\":\"number\"}},\"additionalProperties\":false,\"description\":\"Enemies cannot see it, `after` seconds after it came into the world, unless something reveals it to them\"},\"hits\":{\"type\":\"number\",\"description\":\"Goes down after this many attacks and spells, whatever they deal: its health counts hits\"},\"ai\":{\"$ref\":\"#/definitions/AiHints\",\"description\":\"What the computer player takes it for (`AiHints`): its roles (`worker`, `hall`, `soldier`...), the game's words about it, what it answers. Declared where what the kit infers from the rest of the definition is wrong or cannot be known; inferred otherwise (`inferRoles` in `@v12-engine/engine/ai`)\"},\"armourType\":{\"type\":\"string\",\"description\":\"Its armour type, the column of the game's damage table (`GameRules.combat.damageTable`): `light`, `heavy`, `fortified`…\"}},\"required\":[\"id\",\"name\",\"kind\",\"radius\",\"stats\",\"sight\"],\"additionalProperties\":false},\"EntityKind\":{\"type\":\"string\",\"enum\":[\"unit\",\"building\",\"resource\"]},\"AttackDef\":{\"type\":\"object\",\"properties\":{\"stats\":{\"$ref\":\"#/definitions/AttackStats\",\"description\":\"The stats its numbers are, by id: a stat of the game's (`GameModule.stats`) for a weapon whose damage, speed or range is not the unit's first's. What changes those stats (research, items, buffs) changes this attack alone\"},\"damageType\":{\"$ref\":\"#/definitions/DamageType\",\"description\":\"Physical when left out\"},\"damagePoint\":{\"type\":\"number\",\"description\":\"Seconds from the start of the swing until damage lands (or the projectile leaves), at the attack speed the unit starts with\"},\"acquisitionRange\":{\"type\":\"number\",\"description\":\"Enemies closer than this are attacked automatically\"},\"minRange\":{\"type\":\"number\",\"description\":\"How near is too near, edge to edge: what is closer than this the attack does not hit (a siege weapon's dead zone). Another of the unit's attacks takes over there where one reaches (`GameRules.combat.pickAttack`); with none, a unit told to attack steps back out of it first, and one left to itself does not pick what is that near. None when left out\"},\"onTheMove\":{\"type\":\"boolean\",\"description\":\"Fires as the unit walks (a horse archer, a tank's turret): told to move, it hits what it passes within the attack's range without stopping or turning to it, at the attack's speed. Every other order fights as any attack does (it stops to). Not when left out\"},\"projectileSpeed\":{\"type\":\"number\",\"description\":\"Set for ranged attacks\"},\"targets\":{\"type\":\"array\",\"items\":{\"anyOf\":[{\"$ref\":\"#/definitions/EntityKind\"},{\"$ref\":\"#/definitions/Layer\"}]},\"description\":\"What this attack can hit: kinds of things, and where they are. Everything on the ground when left out. What flies is only hit by attacks that name `air`, and an attack that names `air` alone does not hit the ground\"},\"splash\":{\"type\":\"number\",\"description\":\"Radius around the point of impact in which everyone is hit, friends too: in full in the inner half, by half further out. Shots of such an attack land where they were aimed, they do not follow their target\"},\"ground\":{\"type\":\"boolean\",\"description\":\"Can be told to attack a spot on the ground\"},\"fells\":{\"type\":\"boolean\",\"description\":\"Brings down what is `fellable` in the area it hits\"},\"how\":{\"type\":\"string\",\"description\":\"How what this attack kills dies, for the screen (`'shot'`, `'crushed'`, `'burnt'`): the death's `how`, which the view shows its way (`UnitLook.death`). A word, or one decided for each blow. The `death` hook has the last say\"},\"attackType\":{\"type\":\"string\",\"description\":\"The attack's type against the target's armour type, by the game's damage table (`GameRules.combat.damageTable`): `pierce`, `siege`… Left out, the attack is multiplied by nothing\"}},\"required\":[\"damagePoint\",\"acquisitionRange\"],\"additionalProperties\":false,\"description\":\"One of the ways a unit attacks (`UnitTypeDef.attacks`): what it hits, how its blow lands. How hard, how fast and how far are stats: the unit's `attackDamage`, `attackSpeed` and `attackRange`, or stats of the game's own that the attack names (`stats`: a second weapon's)\"},\"AttackStats\":{\"type\":\"object\",\"properties\":{\"damage\":{\"$ref\":\"#/definitions/StatKey\",\"description\":\"What a hit deals, before the armour of the target. `attackDamage` when left out\"},\"speed\":{\"$ref\":\"#/definitions/StatKey\",\"description\":\"Hits a second. `attackSpeed` when left out\"},\"range\":{\"$ref\":\"#/definitions/StatKey\",\"description\":\"How far it reaches, between the edges. `attackRange` when left out\"}},\"additionalProperties\":false,\"description\":\"The stats an attack reads how hard, how fast and how far it hits from (`AttackDef.stats`): the unit's `attackDamage`, `attackSpeed` and `attackRange` for what is left out\"},\"StatKey\":{\"type\":\"string\",\"description\":\"A stat: one of the engine's (`CoreStatKey`), or one a game defined. Checked when the game is built\"},\"DamageType\":{\"type\":\"string\",\"enum\":[\"physical\",\"magic\",\"true\"],\"description\":\"Physical damage is held off by armor, magic damage by magic resist, true damage by nothing\"},\"Layer\":{\"type\":\"string\",\"enum\":[\"ground\",\"air\"],\"description\":\"Where something is: on the ground, or above it\"},\"HeroDef\":{\"type\":\"object\",\"properties\":{\"growth\":{\"$ref\":\"#/definitions/StatChange\",\"description\":\"What every level after the first adds\"},\"learns\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Abilities the hero can put points into\"},\"spells\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Abilities it has from the start and does not learn: the two spells every hero brings along. No mana, and nothing shortens their cooldown\"},\"maxLevel\":{\"type\":\"number\",\"description\":\"The level it stops at. 10 when left out\"},\"meter\":{\"type\":\"string\",\"description\":\"A buff whose stacks are shown next to its health and mana, as so many points out of as many as it can have\"},\"primary\":{\"type\":\"string\",\"enum\":[\"strength\",\"agility\",\"intelligence\"],\"description\":\"Its primary attribute, in a game with the attributes pack (`withAttributes`): each point of it adds to its attack as well. `AttributesOptions.primaryOf` says it in code\"}},\"required\":[\"growth\",\"learns\"],\"additionalProperties\":false,\"description\":\"What makes a unit a hero: it gains levels, grows with them and learns abilities\"},\"StatChange\":{\"type\":\"object\",\"properties\":{\"stats\":{\"type\":\"object\",\"properties\":{\"attackDamage\":{\"type\":\"number\",\"description\":\"What a basic attack deals, before the armor of the target\"},\"attackSpeed\":{\"type\":\"number\",\"description\":\"Attacks per second\"},\"attackRange\":{\"type\":\"number\",\"description\":\"Measured between the edges of attacker and target\"},\"health\":{\"type\":\"number\"},\"armor\":{\"type\":\"number\",\"description\":\"Against physical damage: 100 of it halve what arrives\"},\"magicResist\":{\"type\":\"number\",\"description\":\"The same against magic damage\"},\"healthRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"mana\":{\"type\":\"number\"},\"manaRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"moveSpeed\":{\"type\":\"number\",\"description\":\"Units per second. Who has none cannot move\"},\"sight\":{\"type\":\"number\",\"description\":\"How far it sees. At night the unit type says how far that is\"}},\"additionalProperties\":false},\"percent\":{\"type\":\"object\",\"properties\":{\"attackDamage\":{\"type\":\"number\",\"description\":\"What a basic attack deals, before the armor of the target\"},\"attackSpeed\":{\"type\":\"number\",\"description\":\"Attacks per second\"},\"attackRange\":{\"type\":\"number\",\"description\":\"Measured between the edges of attacker and target\"},\"health\":{\"type\":\"number\"},\"armor\":{\"type\":\"number\",\"description\":\"Against physical damage: 100 of it halve what arrives\"},\"magicResist\":{\"type\":\"number\",\"description\":\"The same against magic damage\"},\"healthRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"mana\":{\"type\":\"number\"},\"manaRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"moveSpeed\":{\"type\":\"number\",\"description\":\"Units per second. Who has none cannot move\"},\"sight\":{\"type\":\"number\",\"description\":\"How far it sees. At night the unit type says how far that is\"}},\"additionalProperties\":false}},\"additionalProperties\":false,\"description\":\"Something that changes stats: `stats` is added, `percent` makes them bigger or smaller by a part of what they are with everything added. Parts from different places add up: two times +10% are +20%.\"},\"Cost\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"propertyNames\":{\"description\":\"The id of a resource, as its game module defines it (`ResourceDef`)\"},\"description\":\"What something costs: an amount of each resource it takes, by resource id. What is left out costs nothing\"},\"ResourceKind\":{\"type\":\"string\",\"description\":\"The id of a resource, as its game module defines it (`ResourceDef`)\"},\"AiHints\":{\"type\":\"object\",\"properties\":{\"role\":{\"anyOf\":[{\"$ref\":\"#/definitions/AiRole\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AiRole\"}}],\"description\":\"What it is for (`AiRole`), one or several: in place of what the kit would infer\"},\"tags\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Words of the game's own about it (`'ranged'`, `'cavalry'`), for a brain's queries (`UnitSet.withTag`). Beside the inferred ones\"},\"counters\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/CounterHint\"},\"description\":\"What it is good against: tags, roles or type ids (`['air', 'siege']`), each with a weight where a word is not enough (`{ target: 'air', weight: 1 }`). Read by the matchups (`Strength.matchup`, `odds`, `counterFor`)\"},\"strength\":{\"type\":\"number\",\"description\":\"How strong it is at full health, in place of the kit's formula (`defaultStrength`) and of any formula the brain was given: for a type whose numbers mislead (a unit that is all spells). Scaled by the health a unit has left\"},\"priority\":{\"type\":\"number\",\"description\":\"How much it is worth hitting first, in a fight: 1 when left out. Read by the micro of C2\"},\"placement\":{\"$ref\":\"#/definitions/PlacementName\",\"description\":\"Where the build plan puts it (`PlacementName`): `atEdge` for a tower, `behind` for supply, `cluster` beside its own kind. Over the brain's table; the role's default when left out\"}},\"additionalProperties\":false,\"description\":\"What a game declares of a unit type for the computer player (`UnitTypeDef.ai`), where what the kit infers from the definition is wrong or cannot be known: its roles, words of the game's own about it, what it answers, how much it is worth hitting. A declared role is in place of the inferred ones, not beside them\"},\"AiRole\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"string\",\"enum\":[\"worker\",\"gatherer\",\"topper\",\"hall\",\"supply\",\"barracks\",\"altar\",\"workshop\",\"tower\",\"shop\",\"soldier\",\"hero\",\"caster\",\"healer\",\"siege\",\"air\",\"scout\",\"detector\"]}],\"description\":\"What a unit type is for, to a computer player: the engine's roles, or a word of the game's own. A type can have several (a ghoul is a `gatherer` and a `soldier`)\\n\\n- `worker`: gathers and builds; `gatherer`: gathers (a worker is one too); `topper`: what is put up on a deposit of   the money to gather it there (`builtOn`)\\n- `hall`: takes deposits and trains workers; `supply`: provides supply and trains nothing; `barracks`: trains   soldiers; `altar`: trains or revives heroes; `workshop`: researches; `tower`: a building that attacks; `shop`:   sells or hires\\n- `soldier`: a unit that fights and is no hero; `hero`; `caster`: fights with mana; `healer`: has an ability that   heals; `siege`: attacks that splash, fell or are aimed at the ground; `air`: flies; `scout`: the fastest of the   soldiers; `detector`: finds the invisible\"},\"CounterHint\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"object\",\"properties\":{\"target\":{\"type\":\"string\"},\"weight\":{\"type\":\"number\"}},\"required\":[\"target\"],\"additionalProperties\":false}],\"description\":\"What a game declares a type good against (`UnitTypeDef.ai.counters`): a tag (`'air'`), a role (`'siege'`) or a type id, as a word, or with how much it counts (`weight`, 0.5 when left out: a unit whose whole opponent it counters is worth half again)\"},\"PlacementName\":{\"type\":\"string\",\"description\":\"The kit's placement strategies, by name: `nearHome` (rings around the place, keeping the way to the mine clear), `byResource` (on the nearest deposit it is built on: a mine), `atEdge` (at the edge of the base towards the enemy, for a tower), `behind` (away from the enemy, for supply), `cluster` (beside another of its type, barracks by barracks; `cluster:<type>` beside another type), `onLayer:<layer>` (where the whole footprint is on a layer of cells the game paints: `onLayer:blight` for a race that builds on blight)\"},\"AbilityDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"how\":{\"type\":\"string\",\"description\":\"How what its damage kills dies, for the screen (`'burnt'`, `'frozen'`, `'blasted'`): the death's `how`, which the view shows its way. A word, or one decided for each blow: by its level, its caster, what it hit. An effect's own (`EffectDef.how`) goes over it; the `death` hook has the last say\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"description\":{\"type\":\"string\",\"description\":\"What it does, in words: a template with values in braces, worked out for the caster as it is now (\\\"Deals {damage} magic damage\\\" shows \\\"Deals 80 (50 + 60% ability power) magic damage\\\"). The values are its own (`values`), or found in its effects: `damage`, `heal`, `shield`, `amount`, `duration`, `radius`, `range`, `cooldown`, `charges`, `refill`, `mana`, `count`, `distance` (see `abilityValues`)\"},\"values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/AbilityValueDef\"},\"description\":\"Values of its own to put in its description, by name: an amount and what of the caster scales it, or worked out in code\"},\"hotkey\":{\"type\":\"string\"},\"target\":{\"$ref\":\"#/definitions/AbilityTarget\",\"description\":\"none: happens at once. unit, point: needs a target, and the caster walks into range of it. direction: goes off from where the caster stands, towards where it was aimed. passive: always on, cannot be cast\"},\"targets\":{\"type\":\"object\",\"properties\":{\"allies\":{\"type\":\"boolean\"},\"enemies\":{\"type\":\"boolean\"},\"self\":{\"type\":\"boolean\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"}},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"}},\"heroes\":{\"type\":\"boolean\"}},\"additionalProperties\":false,\"description\":\"What may be targeted, for abilities cast on a unit\"},\"manaCost\":{\"$ref\":\"#/definitions/Scaled\"},\"healthCost\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Health it costs, as a part of all the caster can have. It cannot be cast with less than that left\"},\"cooldown\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds before it can be used again\"},\"charges\":{\"type\":\"object\",\"properties\":{\"count\":{\"$ref\":\"#/definitions/Scaled\"},\"refill\":{\"$ref\":\"#/definitions/Scaled\"}},\"required\":[\"count\",\"refill\"],\"additionalProperties\":false,\"description\":\"Uses it holds, for one used so many times before it waits: `count` of them at the most, one more back every `refill` seconds while it holds fewer (shortened as the cooldown is). Each use spends one; with none left it is not ready. Its `cooldown`, where it has one, is then the time between two uses. Full when it is learned\"},\"range\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"How far away the target may be\"},\"attackRange\":{\"type\":\"boolean\",\"description\":\"The target may be as far away as the caster's attacks reach, and `range` farther\"},\"tags\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"What kind of thing it is, for those who can keep out of its way: a buff that `avoids` one of these lets nothing of the ability happen to who carries it. `ground` is for what comes out of the ground or along it\"},\"maxLevel\":{\"type\":\"number\",\"description\":\"Levels a hero can put into it. 3 when left out\"},\"requiresLevel\":{\"type\":\"number\",\"description\":\"Hero level needed for the first level of the ability. Ultimates ask for 6\"},\"levelStep\":{\"type\":\"number\",\"description\":\"Hero levels between two levels of the ability. 2 when left out\"},\"castTime\":{\"type\":\"number\",\"description\":\"Seconds between starting to cast and the effect. The caster stands still for as long and cannot be called away: what it is told to do in the meantime, it does right after. None when left out\"},\"piercesImmunity\":{\"type\":\"boolean\",\"description\":\"Gets through a unit's immunity to spells (see `UnitTypeDef.spellImmune`), as an ultimate may. Or for the targets its function says\"},\"aim\":{\"anyOf\":[{\"type\":\"object\",\"properties\":{\"shape\":{\"type\":\"string\",\"const\":\"circle\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\"}},\"required\":[\"shape\",\"radius\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"shape\":{\"type\":\"string\",\"const\":\"line\"},\"length\":{\"$ref\":\"#/definitions/Scaled\"},\"width\":{\"$ref\":\"#/definitions/Scaled\"}},\"required\":[\"shape\",\"length\",\"width\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"shape\":{\"type\":\"string\",\"const\":\"cone\"},\"length\":{\"$ref\":\"#/definitions/Scaled\"},\"angle\":{\"type\":\"number\"}},\"required\":[\"shape\",\"length\",\"angle\"],\"additionalProperties\":false}],\"description\":\"The ground it covers, when that is not what its effects say: see `aimOf`\"},\"autocast\":{\"type\":\"boolean\",\"description\":\"Units use it on their own when they have nothing else to do. The player can switch this off\"},\"charge\":{\"type\":\"string\",\"description\":\"A buff of the caster that charges the ability when it has as many stacks as it can: the ability shows it, its `charged` effects do their other thing, and casting it takes the buff away\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"}},\"passive\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What an ability that is cast does all the time besides, once it is learned: buffs, auras, `onHit`\"},\"channel\":{\"type\":\"object\",\"properties\":{\"duration\":{\"type\":\"number\"},\"every\":{\"type\":\"number\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"}},\"finished\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What it does once kept up to the end, and only then: a recall's teleport home\"},\"breaksOnDamage\":{\"type\":\"boolean\",\"description\":\"Broken off when the caster is hurt, as a recall is: any damage, from anyone\"}},\"required\":[\"duration\"],\"additionalProperties\":false,\"description\":\"Kept up once it went off: the caster stands, for `duration` seconds, doing it every `every` seconds (effects, or code), until it is done or interrupted (another order, a stun), when `interrupted` runs. An ice storm\"}},\"required\":[\"id\",\"name\",\"target\",\"effects\"],\"additionalProperties\":false},\"AbilityValueDef\":{\"type\":\"object\",\"properties\":{\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"scaling\":{\"$ref\":\"#/definitions/Scaling\"},\"unit\":{\"type\":\"string\"},\"percent\":{\"type\":\"boolean\"}},\"additionalProperties\":false,\"description\":\"How a game gives a value of an ability: an amount and what scales it, or worked out in code\"},\"Scaled\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"array\",\"items\":{\"type\":\"number\"}}],\"description\":\"A value that can grow with the level of an ability: one number, or one per level\"},\"Scaling\":{\"type\":\"object\",\"properties\":{\"level\":{\"$ref\":\"#/definitions/Scaled\"},\"bonusAttackDamage\":{\"$ref\":\"#/definitions/Scaled\"}},\"additionalProperties\":{\"$ref\":\"#/definitions/Scaled\"},\"description\":\"What the stats of the caster add to an amount. `level` is for every level of a hero past the first, `bonusAttackDamage` for the attack damage it has on top of what its type and its levels give it\"},\"AbilityTarget\":{\"type\":\"string\",\"enum\":[\"none\",\"unit\",\"point\",\"direction\",\"passive\"],\"description\":\"How an ability is aimed\"},\"EffectDef\":{\"anyOf\":[{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"scaling\":{\"$ref\":\"#/definitions/Scaling\",\"description\":\"What the stats of the caster add to the amount: `{ abilityPower: 0.6 }` adds 60% of its ability power. `level` is for every level of the hero past the first\"},\"damageType\":{\"$ref\":\"#/definitions/DamageType\",\"description\":\"For damage. Magic when left out\"},\"how\":{\"type\":\"string\",\"description\":\"For damage: how what it kills dies, for the screen, over the ability's own `how`\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"damage\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"scaling\":{\"$ref\":\"#/definitions/Scaling\",\"description\":\"What the stats of the caster add to the amount: `{ abilityPower: 0.6 }` adds 60% of its ability power. `level` is for every level of the hero past the first\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"heal\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"scaling\":{\"$ref\":\"#/definitions/Scaling\",\"description\":\"What the stats of the caster add to the amount: `{ abilityPower: 0.6 }` adds 60% of its ability power. `level` is for every level of the hero past the first\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"mana\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"stack\":{\"type\":\"boolean\",\"description\":\"For `buff`: adds one to how many of it the target carries instead of renewing it, up to what the buff allows\"},\"buff\":{\"type\":\"string\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"buff\"}},\"required\":[\"buff\",\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"speed\":{\"type\":\"number\",\"description\":\"For missiles: how fast they travel, in units per second, and how far\"},\"distance\":{\"$ref\":\"#/definitions/Scaled\"},\"count\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: how many are sent, spread over an angle in radians. What one of them hit the others pass by\"},\"spread\":{\"type\":\"number\"},\"homing\":{\"type\":\"boolean\",\"description\":\"For missiles: flies after the unit the ability was cast on, and only hits that one\"},\"toPoint\":{\"type\":\"boolean\",\"description\":\"For missiles: flies to the spot the ability was aimed at and stops there, `distance` away at the most\"},\"delay\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: seconds they take shape where they were cast before they set off. The caster is free to go\"},\"sight\":{\"type\":\"number\",\"description\":\"For missiles: how far the team of the caster sees around it\"},\"blocked\":{\"type\":\"boolean\",\"description\":\"For missiles: buildings and trees in its way stop it, without anything happening to them\"},\"pierce\":{\"type\":\"boolean\",\"description\":\"For missiles: goes on after it hit something. False for the ones that are used up by the first thing in their way\"},\"arc\":{\"type\":\"object\",\"properties\":{\"height\":{\"type\":\"number\"},\"time\":{\"type\":\"number\"}},\"required\":[\"height\"],\"additionalProperties\":false,\"description\":\"For missiles: thrown, not shot. It goes `height` up in the middle of its way and comes down at its end, `time` seconds after it set off however far that is (`speed` otherwise). It flies over everything, and what is within its `radius` where it comes down is what it hits\"},\"bounce\":{\"type\":\"object\",\"properties\":{\"count\":{\"$ref\":\"#/definitions/Scaled\"},\"range\":{\"type\":\"number\"},\"falloff\":{\"type\":\"number\"}},\"required\":[\"count\",\"range\"],\"additionalProperties\":false,\"description\":\"For missiles: where it would be done (it reached its target, was used up by what it hit, came down, or came to the end of its way) it springs on to the nearest thing it may hit within `range` that it has not hit yet, and flies after that one, `count` times. Every spring takes `falloff` of the amounts off what it does (0.25: a quarter less each time). Its `onEnd` is where it is done for good\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"onEnd\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"For missiles that were not stopped, and for zones: what happens where and when they end\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"missile\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"buff\":{\"type\":\"string\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"aura\"}},\"required\":[\"buff\",\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"unit\":{\"type\":\"string\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"spawn\"}},\"required\":[\"type\",\"unit\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"buff\":{\"type\":\"string\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"toggle\"}},\"required\":[\"buff\",\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"reveal\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"whileBuff\":{\"type\":\"string\",\"description\":\"For `onHit`: only while the attacker carries this buff\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"onHit\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"properties\":{\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"resetAttack\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"distance\":{\"$ref\":\"#/definitions/Scaled\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"blink\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"to\":{\"type\":\"string\",\"enum\":[\"home\",\"point\",\"target\"],\"description\":\"For `teleport`: where to, however far: the caster's side's home (`homeOf`), where it was aimed, or by its target\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"teleport\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"distance\":{\"$ref\":\"#/definitions/Scaled\"},\"leap\":{\"type\":\"number\",\"description\":\"For `dash`: how high the caster rises on the way, which makes it a leap. For whoever draws it\"},\"climb\":{\"type\":\"number\",\"description\":\"For a leap: how much higher than where it takes off the ground on its way may stand. What stands higher is a wall to it: it comes down in front of it. Over anything when left out\"},\"speed\":{\"type\":\"number\",\"description\":\"For missiles: how fast they travel, in units per second, and how far\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"buff\":{\"type\":\"string\",\"description\":\"Id of the buff to put on the targets\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"dash\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"distance\":{\"$ref\":\"#/definitions/Scaled\"},\"speed\":{\"type\":\"number\",\"description\":\"For missiles: how fast they travel, in units per second, and how far\"},\"leap\":{\"type\":\"number\",\"description\":\"For `dash`: how high the caster rises on the way, which makes it a leap. For whoever draws it\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"knockback\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"ability\":{\"type\":\"string\",\"description\":\"For `refresh`: the ability that is ready again, when it is not the one the effect belongs to\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"refresh\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"attack\":{\"type\":\"boolean\",\"description\":\"For `onKill`: only when it was an attack of the carrier that killed\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"onKill\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"onCast\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"otherwise\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"For `charged`: what happens when the ability is not charged\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"charged\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"delay\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: seconds they take shape where they were cast before they set off. The caster is free to go\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"impact\":{\"type\":\"string\",\"description\":\"For `after`: the name its arrival goes by for whoever draws it and plays its sound, where one ability sets off several that do not look alike: the last of a barrage. The ability's own when left out\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"after\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens to what is hit. For missiles: everything they pass through. For `onHit`: the target of an attack. For `dash`: what is around where it ends. For `after`: what is there when the time is up. For `zone`: what is inside, over and over\"},\"onEnd\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"For missiles that were not stopped, and for zones: what happens where and when they end\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"zone\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"detect\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"count\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: how many are sent, spread over an angle in radians. What one of them hit the others pass by\"},\"unit\":{\"type\":\"string\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"raiseDead\"}},\"required\":[\"type\",\"unit\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"dealt\":{\"type\":\"number\"},\"taken\":{\"type\":\"number\"},\"count\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: how many are sent, spread over an angle in radians. What one of them hit the others pass by\"},\"duration\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Seconds the buff lasts, when that is different from its usual duration\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"illusion\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"dispel\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"sell\":{\"type\":\"string\"},\"buy\":{\"type\":\"string\"},\"rate\":{\"type\":\"number\"},\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"exchange\"}},\"required\":[\"amount\",\"buy\",\"rate\",\"sell\",\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"gain\":{\"$ref\":\"#/definitions/StatChange\"},\"xp\":{\"type\":\"number\"},\"levels\":{\"type\":\"number\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"tome\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"ratio\":{\"type\":\"number\"},\"amount\":{\"$ref\":\"#/definitions/Scaled\"},\"scaling\":{\"$ref\":\"#/definitions/Scaling\",\"description\":\"What the stats of the caster add to the amount: `{ abilityPower: 0.6 }` adds 60% of its ability power. `level` is for every level of the hero past the first\"},\"damageType\":{\"$ref\":\"#/definitions/DamageType\",\"description\":\"For damage. Magic when left out\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"manaBurn\"}},\"required\":[\"type\"]},{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"count\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"For missiles: how many are sent, spread over an angle in radians. What one of them hit the others pass by\"},\"ifBuff\":{\"type\":\"string\",\"description\":\"Only hits what carries this buff\"},\"only\":{\"type\":\"string\",\"const\":\"heroes\",\"description\":\"Only hits heroes\"},\"kinds\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EntityKind\"},\"description\":\"Only hits these kinds of things. Everything but resources when left out\"},\"layers\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Layer\"},\"description\":\"Where what it hits has to be: on the ground, in the air. Both when left out\"},\"radius\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Makes the effect hit everything around the point of impact. Required for auras, and the size of a missile\"},\"affects\":{\"type\":\"string\",\"enum\":[\"enemies\",\"allies\",\"all\"],\"description\":\"Who an effect with a radius applies to. Follows from the kind of effect when left out\"},\"on\":{\"type\":\"string\",\"const\":\"caster\",\"description\":\"Applies to the caster, wherever the ability was aimed\"},\"type\":{\"type\":\"string\",\"const\":\"townPortal\"}},\"required\":[\"type\"]}],\"description\":\"One thing an ability does: its `type`, which picks the handler and says which fields it has (`EffectTypes`)\"},\"BuffDef\":{\"type\":\"object\",\"properties\":{\"stats\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/Scaled\"}},\"percent\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/Scaled\"}},\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"description\":{\"type\":\"string\"},\"duration\":{\"type\":\"number\",\"description\":\"Seconds. Lasts until removed when left out\"},\"harmful\":{\"type\":\"boolean\",\"description\":\"A debuff: by default it goes on enemies\"},\"stun\":{\"type\":\"boolean\",\"description\":\"The unit cannot do anything. A function says so for one carrier, one moment\"},\"airborne\":{\"type\":\"boolean\",\"description\":\"Thrown into the air for as long as it lasts. Comes with a stun, the rest is for the eye\"},\"down\":{\"type\":\"boolean\",\"description\":\"Knocked down: it lies on the ground for as long as it lasts, and gets up at the end. For the eye, like `airborne`\"},\"grounds\":{\"type\":\"boolean\",\"description\":\"Brings what flies down: it counts as being on the ground, for whatever is aimed at it\"},\"invisible\":{\"type\":\"boolean\",\"description\":\"Its carrier is invisible to enemies for as long as it lasts, unless they find it (`detect`): a Wind Walk. A function says so for one carrier, one moment\"},\"root\":{\"type\":\"boolean\",\"description\":\"The unit cannot move from the spot. It can still fight and cast. A function says so for one carrier, one moment\"},\"silence\":{\"type\":\"boolean\",\"description\":\"The unit cannot use its abilities. What it carries and the spells every hero has still work. A function says which abilities it keeps it from (`(ability) => ability.tags?.includes('fire')`): the screen asks it too\"},\"shield\":{\"$ref\":\"#/definitions/Scaled\",\"description\":\"Damage it takes in place of the unit, for as long as the buff lasts and there is something left of it\"},\"shieldScaling\":{\"$ref\":\"#/definitions/Scaling\",\"description\":\"What the stats of whoever gave the shield add to it\"},\"recharge\":{\"type\":\"number\",\"description\":\"The shield is as good as new once the unit has not been hurt for this many seconds\"},\"avoids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Tags of abilities that do nothing to who carries it, for as long as it does: `ground` for someone up in the air\"},\"disarm\":{\"type\":\"boolean\",\"description\":\"Who carries it does not attack while it lasts: burrowed, or disarmed. Or while its function says\"},\"spellImmune\":{\"type\":\"boolean\",\"description\":\"Who carries it is immune to spells while it lasts, as an avatar is (see `UnitTypeDef.spellImmune`). Or while its function says\"},\"dispellable\":{\"type\":\"boolean\",\"description\":\"Whether a dispel takes it off (see the effect `dispel`). Yes when left out: no for what nothing should end early. Decided in code for each dispel: by who dispels it (`by`), its level\"},\"maxStacks\":{\"type\":\"number\",\"description\":\"How many of it one unit can carry at most. What puts it on says whether it adds one (`stack`)\"},\"onEnd\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens around who carried it when its time is up, in the name of who put it there. Not when it is taken off\"},\"perStack\":{\"type\":\"boolean\",\"description\":\"Its stats count once for every stack it has (`stacks`), rather than once: \\\"each stack, -5% move speed\\\"\"},\"stacking\":{\"type\":\"string\",\"enum\":[\"strongest\",\"refresh\",\"perSource\",\"independent\"],\"description\":\"What happens when it is put on a unit that has it already. `strongest` (the default): the higher level wins, the longer among equals. `refresh`: the time starts over, the level the new one's. `perSource`: one of it for every unit that puts it on, each of its own (two poisons from two casters). `independent`: a new one every time. A function decides from the one there and the one coming: `replace` it, `renew` its time, `add` another, or `keep`\"},\"onApply\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"},\"description\":\"What happens as it is put on: effects in the name of who put it there (while they live), or code\"},\"onTick\":{\"type\":\"object\",\"properties\":{\"every\":{\"type\":\"number\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/EffectDef\"}}},\"required\":[\"every\"],\"additionalProperties\":false,\"description\":\"What happens every `every` seconds while it lasts: effects in the name of who put it there (while they live), or code, which runs whoever is left\"}},\"required\":[\"id\",\"name\"],\"additionalProperties\":false,\"description\":\"Something lasting on a unit that changes what it can do\"},\"ItemDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"level\":{\"type\":\"number\",\"description\":\"How good it is, 1 and up (campaign plan GP3): what an item table draws by (`{ level: 3 }`)\"},\"class\":{\"type\":\"string\",\"description\":\"Its kind of item, a word of the game's (`permanent`, `charged`, `powerup`): what an item table draws by too\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"description\":{\"type\":\"string\"},\"cost\":{\"$ref\":\"#/definitions/Cost\"},\"charges\":{\"type\":\"number\",\"description\":\"Uses before it is gone. Items without charges stay\"},\"ability\":{\"type\":\"string\",\"description\":\"Id of the ability the item gives: using the item casts it, without mana\"},\"passive\":{\"type\":\"string\",\"description\":\"Id of an ability whose passive part works for whoever carries the item\"},\"from\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Items it is made of. Those the buyer carries are used up and taken off the price, which is for all of it\"},\"tier\":{\"$ref\":\"#/definitions/ItemTier\",\"description\":\"Where it goes in a shop: consumable, starter, basic, epic, legendary\"},\"bonus\":{\"$ref\":\"#/definitions/StatChange\",\"description\":\"Applies for as long as the item is carried\"},\"stock\":{\"type\":\"object\",\"properties\":{\"max\":{\"type\":\"number\"},\"restock\":{\"type\":\"number\"}},\"required\":[\"max\",\"restock\"],\"additionalProperties\":false,\"description\":\"How many a shop has at most, and the seconds it takes to get one back. As many as anyone wants when left out\"},\"hotkey\":{\"type\":\"string\"},\"powerUp\":{\"type\":\"boolean\",\"description\":\"Used as it is picked up, by walking over it or by the order, and never carried: a rune, a tome. Its ability is cast by whoever picked it. In a game with the runes pack (`withRunes`, whose `powerUp` says it in code)\"}},\"required\":[\"id\",\"name\",\"cost\"],\"additionalProperties\":false},\"ItemTier\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"string\",\"enum\":[\"consumable\",\"starter\",\"basic\",\"epic\",\"legendary\"]}],\"description\":\"Where an item is in a shop. The client's tiers, or a game's own (`GameView.shopTiers`)\"},\"UpgradeDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"description\":{\"type\":\"string\"},\"cost\":{\"$ref\":\"#/definitions/Cost\",\"description\":\"Paid for every level\"},\"researchTime\":{\"type\":\"number\",\"description\":\"Seconds per level\"},\"maxLevel\":{\"type\":\"number\"},\"requires\":{\"type\":\"array\",\"items\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"description\":\"Building types needed, one list per level. Levels past the end of the list need nothing\"},\"race\":{\"type\":\"string\",\"description\":\"The race it is of (`GameModule.races`): only its players may research it. Everyone's when left out\"},\"hotkey\":{\"type\":\"string\"},\"effects\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/UpgradeEffect\"}}},\"required\":[\"id\",\"name\",\"cost\",\"researchTime\",\"effects\"],\"additionalProperties\":false,\"description\":\"Research that improves a player's units for the rest of the game\"},\"UpgradeEffect\":{\"type\":\"object\",\"properties\":{\"stats\":{\"type\":\"object\",\"properties\":{\"attackDamage\":{\"type\":\"number\",\"description\":\"What a basic attack deals, before the armor of the target\"},\"attackSpeed\":{\"type\":\"number\",\"description\":\"Attacks per second\"},\"attackRange\":{\"type\":\"number\",\"description\":\"Measured between the edges of attacker and target\"},\"health\":{\"type\":\"number\"},\"armor\":{\"type\":\"number\",\"description\":\"Against physical damage: 100 of it halve what arrives\"},\"magicResist\":{\"type\":\"number\",\"description\":\"The same against magic damage\"},\"healthRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"mana\":{\"type\":\"number\"},\"manaRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"moveSpeed\":{\"type\":\"number\",\"description\":\"Units per second. Who has none cannot move\"},\"sight\":{\"type\":\"number\",\"description\":\"How far it sees. At night the unit type says how far that is\"}},\"additionalProperties\":false},\"percent\":{\"type\":\"object\",\"properties\":{\"attackDamage\":{\"type\":\"number\",\"description\":\"What a basic attack deals, before the armor of the target\"},\"attackSpeed\":{\"type\":\"number\",\"description\":\"Attacks per second\"},\"attackRange\":{\"type\":\"number\",\"description\":\"Measured between the edges of attacker and target\"},\"health\":{\"type\":\"number\"},\"armor\":{\"type\":\"number\",\"description\":\"Against physical damage: 100 of it halve what arrives\"},\"magicResist\":{\"type\":\"number\",\"description\":\"The same against magic damage\"},\"healthRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"mana\":{\"type\":\"number\"},\"manaRegen\":{\"type\":\"number\",\"description\":\"Per second\"},\"moveSpeed\":{\"type\":\"number\",\"description\":\"Units per second. Who has none cannot move\"},\"sight\":{\"type\":\"number\",\"description\":\"How far it sees. At night the unit type says how far that is\"}},\"additionalProperties\":false},\"units\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Unit types that benefit, or a function of the type. Everything the player owns when left out\"}},\"additionalProperties\":false,\"description\":\"What a level of research changes\"},\"RaceDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\",\"description\":\"What players are shown: in the lobby, on the scores\"},\"basedOn\":{\"type\":\"string\",\"description\":\"The definition this one is a copy of, made from the data (`copyOf` in a `data.json`, the editor's Copy as new): what it is drawn, heard and pictured as where the game gives it no look of its own\"},\"description\":{\"type\":\"string\",\"description\":\"What it is like, for a tooltip\"},\"icon\":{\"type\":\"string\",\"description\":\"Its picture, by the id the game's view knows icons by\"},\"resources\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"What its players start with of each resource, by resource id, over what the game starts everyone with (`ResourceDef.start`). Not for a player given resources of their own (`PlayerInit.resources`, a map's)\"},\"start\":{\"$ref\":\"#/definitions/StartDef\",\"description\":\"What its players get at the start of a game on a map, in place of the game's (`GameModule.start`): its own hall and workers, as data (`StartData`: what a race made in the Data panel has, `start.hall` and the rest editable there) or as code (`StartCode`)\"},\"hooks\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/RaceHookDef\"},\"description\":\"Hook handlers of its own, run only for what is of its players (`RaceHookDef`): how it gathers, where it may build. With these a race plays differently with no test of the race in the game's code\"},\"inherits\":{\"type\":\"object\",\"properties\":{\"hooks\":{\"type\":\"boolean\"},\"onStart\":{\"type\":\"boolean\"}},\"additionalProperties\":false,\"description\":\"What a race made as a copy of another (`basedOn`: `copyOf` in a `data.json`, the editor's Copy as new) keeps of the original's code: its `hooks` and its `onStart`, each kept unless said `false` here. A copy keeps both when this is left out, so a race copied from the undead gathers at a cursed mine and builds on blight as they do; one that says `hooks: false` plays by the game's rules alone. Its `start` is data, the copy's own to change; a `start` in code is kept whole. Two toggles in the Data panel, on a copy\"}},\"required\":[\"id\",\"name\"],\"additionalProperties\":false,\"description\":\"A side a player can play, with a roster of its own: melee's humans and undead. Optional: a game that lists none (`GameModule.races`) has no race anywhere, no choice of one in the lobby and nothing kept from anyone. A unit type or an upgrade of a race (`UnitTypeDef.race`, `UpgradeDef.race`) is only its players' to make; one of none, everyone's. Each player has one (`raceOf`): chosen in the lobby (a seat setting the server offers by itself, `seatSettingsOf`), given to the world as it is made (`PlayerInit.race`, `MapWorldOptions.races`), or changed by the rules (`setRace`)\"},\"StartDef\":{\"anyOf\":[{\"$ref\":\"#/definitions/StartCode\"},{\"$ref\":\"#/definitions/StartData\"}],\"description\":\"What each player gets at the beginning of a game on a map, for players the map places nothing for: as data (`StartData`: a hall, workers and what else by unit type, editable in the Data panel) or as code (`StartCode`). What they start with of each resource is in its `ResourceDef`\"},\"StartCode\":{\"type\":\"object\",\"additionalProperties\":false,\"description\":\"A start in code: puts down a base at the start location, whatever it likes\"},\"StartData\":{\"type\":\"object\",\"properties\":{\"hall\":{\"type\":\"string\",\"description\":\"The unit type put down at the start location: a town hall\"},\"workers\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"count\":{\"type\":\"number\"}},\"required\":[\"type\",\"count\"],\"additionalProperties\":false,\"description\":\"The workers put down beside it, facing the closest gold mine\"},\"units\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"count\":{\"type\":\"number\"}},\"required\":[\"type\",\"count\"],\"additionalProperties\":false},\"description\":\"What else is put down with the workers, in the same row after them: a race's first fighter\"},\"onMine\":{\"type\":\"string\",\"description\":\"What the race builds on the closest gold mine to gather it, put down there already standing (the undead's cursed mine). With it, the closest mine is found at any distance; without, the workers face a mine within 20 cells\"},\"distance\":{\"type\":\"number\",\"description\":\"How far from the hall the workers stand: 5 cells when left out\"},\"spread\":{\"type\":\"number\",\"description\":\"The angle between two workers in the row, in radians: 0.35 when left out\"}},\"required\":[\"hall\",\"workers\"],\"additionalProperties\":false,\"description\":\"A start as data: a hall at the start location and workers on the side of the closest gold mine, as in a classic melee game (`startingBase` puts it down). Every id is a unit type of the game's (`checkRaces` says where one is not)\"},\"RaceHookDef\":{\"type\":\"object\",\"properties\":{},\"description\":\"A hook handler of a race (`RaceDef.hooks`): run only where the event is of one of the race's players. Whose an event is, is `of(event)` where it is given, or else its `player`, or else the owner of the first there is of its `entity`, `caster`, `attacker`, `worker`, `buyer`, `hero`, `producer`, `source`, `target`: the one doing it before the one it is done to (a damage is its source's)\"},\"RulesInit\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"score\":{\"$ref\":\"#/definitions/ScoreRules\"},\"hud\":{\"$ref\":\"#/definitions/HudSharing\"},\"supply\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-6406-7192-src_rules.ts-0-2567620292202711967698989%3E\"},\"production\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-7192-7817-src_rules.ts-0-256769690053192058131377%3E\"},\"economy\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-7817-8384-src_rules.ts-0-25676871182655808602831%3E\"},\"combat\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-8384-12915-src_rules.ts-0-2567620803371672015716859%3E\"},\"movement\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-12915-15119-src_rules.ts-0-2567619627991872051239824%3E\"},\"fog\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-2336-3434-src_rules.ts-0-256761516734472119914999%3E\"},\"talk\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-15119-16441-src_rules.ts-0-256767575302061161883220%3E\"},\"camps\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_rules.ts-22230-22604-src_rules.ts-0-25676594161992489921438%3E\"},\"heroes\":{\"$ref\":\"#/definitions/RulesPart%3Cdef-interface-src_hero.ts-953-2062-src_hero.ts-0-1454210919897661340881447%3E\"}},\"description\":\"What a game says of its rules (`GameModule.rules`), or a pack (`GamePack.rules`): any of them, a group in part (`{ supply: { max: 200 } }`), the engine's for the rest. The damage table, the score and the HUD's sharing are given whole\"},\"ScoreRules\":{\"type\":\"object\",\"properties\":{\"stats\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ScoreStatDef\"},\"description\":\"The stats, or what makes them of the game (the engine's set makes one of each resource)\"},\"every\":{\"type\":\"number\",\"description\":\"Seconds between two points of the timeline: 10 when left out, 0 for no timeline\"},\"maxPoints\":{\"type\":\"number\",\"description\":\"Points the timeline keeps at most: past it, every other point goes and they are twice as far apart, so a long game keeps its whole story in as much room. 360 when left out\"},\"live\":{\"$ref\":\"#/definitions/ScoreAudience\",\"description\":\"Who is told a player's numbers while the game goes on: their side (`allies`) when left out. An observer is told everyone's\"},\"end\":{\"$ref\":\"#/definitions/ScoreAudience\",\"description\":\"Who is told them once the game is decided: `everyone` when left out\"},\"refresh\":{\"type\":\"number\",\"description\":\"Seconds between two tellings of the numbers to the screens while the game goes on: 1 when left out\"},\"categories\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"label\":{\"type\":\"string\"}},\"required\":[\"id\",\"label\"],\"additionalProperties\":false},\"description\":\"The tabs of the score screen, in order, with their names: those of the stats, in the order met, when left out\"}},\"required\":[\"stats\"],\"additionalProperties\":false,\"description\":\"What a game counts of its players (`GameRules.score`): the stats, how often the timeline is sampled, and who is told what while the game goes on and after it ended. `presetScore()` makes one of the engine's stats\"},\"ScoreStatDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Its own, among the game's stats: `world.score.add(player, id, …)` names it\"},\"label\":{\"type\":\"string\",\"description\":\"What it is called on a screen: its id when left out\"},\"description\":{\"type\":\"string\",\"description\":\"What the screen says it is, in a tip\"},\"category\":{\"type\":\"string\",\"description\":\"The tab of the score screen it is in: `units`, `heroes`, `resources`, `combat`, or the game's own. `other` when left out\"},\"kind\":{\"$ref\":\"#/definitions/ScoreKind\",\"description\":\"How it adds up: `sum` when left out, `last` for one that only samples\"},\"from\":{\"anyOf\":[{\"$ref\":\"#/definitions/ScoreSource\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ScoreSource\"}}],\"description\":\"The events it is counted from\"},\"byType\":{\"type\":\"boolean\",\"description\":\"Kept by what it was counted of too (`ScoreCount.type`): units killed by unit type, abilities cast by ability\"},\"timeline\":{\"type\":\"boolean\",\"description\":\"On the timeline: sampled every `ScoreRules.every` seconds, for a screen's graph\"},\"format\":{\"$ref\":\"#/definitions/ScoreFormat\",\"description\":\"How its number is written: `number` (when left out), `decimal`, `percent` (0 to 1), `time` (seconds)\"},\"hidden\":{\"type\":\"boolean\",\"description\":\"Counted, and not on the score screen: for the game's own use (an achievement, a mission's goal)\"}},\"required\":[\"id\"],\"additionalProperties\":false,\"description\":\"A number the score keeps for each player (`GameRules.score`, `defineStat`): what it is called, how it adds up, where it comes from, and how it is shown. One with no source is counted by the game's code alone (`world.score.add`)\"},\"ScoreKind\":{\"type\":\"string\",\"enum\":[\"sum\",\"count\",\"max\",\"min\",\"last\"],\"description\":\"How a stat takes what it is told: `sum` adds it up (the default), `count` adds one each time whatever the amount, `max` keeps the most it was told, `min` the least, `last` what it was told last (a gauge: the army now)\"},\"ScoreSource\":{\"type\":\"object\",\"properties\":{\"event\":{\"$ref\":\"#/definitions/EventKey%3Cany%3E\",\"description\":\"The event: one of the engine's (`entityDied`) or of the game's own (`defineEvent`)\"}},\"required\":[\"event\"],\"additionalProperties\":false,\"description\":\"Where a stat's numbers come from: an event of the world's (`'entityDied'`) or of the game's own (`defineEvent`), and what it counts of each (`scoreOn`)\"},\"EventKey<any>\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"replicate\":{\"$ref\":\"#/definitions/EventAudience%3Cany%3E\",\"description\":\"Sent to the screens of these players, in their snapshots. Only to whoever listens in the world when left out\"},\"payload\":{\"description\":\"Only there for the type of the payload\"}},\"required\":[\"id\"],\"additionalProperties\":false,\"description\":\"A typed key for an event of a game's own, made with `defineEvent`\"},\"EventAudience<any>\":{\"type\":\"string\",\"const\":\"everyone\",\"description\":\"Who of the players gets an event of a game's own on their screen (see `defineEvent`): everyone, or those a function picks, from what the event says and what the seat may know (`SessionView`: its player, `knows`, `sees`)\"},\"ScoreFormat\":{\"type\":\"string\",\"enum\":[\"number\",\"decimal\",\"percent\",\"time\"],\"description\":\"How a stat's number reads on a screen: a whole `number` (the default), a `decimal` one, a `percent` (0..1), or `time` (seconds, as 3:05). A screen's own (`GameView.hud.score.format`) goes over it\"},\"ScoreAudience\":{\"type\":\"string\",\"enum\":[\"own\",\"allies\",\"everyone\",\"none\"],\"description\":\"Who of the players is told a player's numbers: that player alone (`own`), their side (`allies`), `everyone`, or `none`; or a function of the world, who is told (`undefined` for an observer) and whose numbers they are\"},\"HudSharing\":{\"type\":\"object\",\"properties\":{\"shareBuffTimes\":{\"$ref\":\"#/definitions/HudShareRule%3C(boolean%7C%22allies%22)%3E\",\"description\":\"The seconds left of its buffs (`EntityState.buffTimes`): to everyone who sees it (`true`), to its owner and their allies (`'allies'`), or to no one (`false`, when left out)\"},\"shareAbilities\":{\"$ref\":\"#/definitions/HudShareRule%3C(%22none%22%7C%22icons%22%7C%22cooldowns%22)%3E\",\"description\":\"Its abilities (`EntityState.abilities`) to everyone who sees it, its side's or not: those it has learned and their levels (`'icons'`), with how much of their cooldowns is left too (`'cooldowns'`), or none (`'none'`, when left out: its side has them in `own` all the same)\"},\"shareXp\":{\"$ref\":\"#/definitions/HudShareRule%3Cboolean%3E\",\"description\":\"A hero's experience (`HeroSent.xp`) to everyone who sees it. Its side's alone when left out\"}},\"additionalProperties\":false,\"description\":\"What of a unit the players who see it are told beyond what they always are (`GameRules.hud`), each for the plates over it to show. What is not shared never reaches a player, so no screen can show it. A game's own data goes in a component with `replicate` (the client's `hudData` reads it)\"},\"HudShareRule<(boolean|\\\"allies\\\")>\":{\"anyOf\":[{\"type\":\"boolean\"},{\"type\":\"string\",\"const\":\"allies\"}],\"description\":\"A rule of `HudSharing`: one value for every unit, or a function deciding it for each (only heroes', only a boss's)\"},\"HudShareRule<(\\\"none\\\"|\\\"icons\\\"|\\\"cooldowns\\\")>\":{\"type\":\"string\",\"enum\":[\"none\",\"icons\",\"cooldowns\"],\"description\":\"A rule of `HudSharing`: one value for every unit, or a function deciding it for each (only heroes', only a boss's)\"},\"HudShareRule<boolean>\":{\"type\":\"boolean\",\"description\":\"A rule of `HudSharing`: one value for every unit, or a function deciding it for each (only heroes', only a boss's)\"},\"RulesPart<def-interface-src_rules.ts-6406-7192-src_rules.ts-0-2567620292202711967698989>\":{\"type\":\"object\",\"properties\":{\"max\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1860156146%3E\"},\"pools\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/RulesPart%3Cstructure-src_rules.ts-6876-6906-src_rules.ts-6861-6907-src_rules.ts-6578-6907-src_rules.ts-6406-7192-src_rules.ts-0-25676%3E\"}}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1860156146>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<structure-src_rules.ts-6876-6906-src_rules.ts-6861-6907-src_rules.ts-6578-6907-src_rules.ts-6406-7192-src_rules.ts-0-25676>\":{\"type\":\"object\",\"properties\":{\"name\":{\"$ref\":\"#/definitions/RulesPart%3Cstring%3E\"},\"max\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<string>\":{\"type\":\"string\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-7192-7817-src_rules.ts-0-256769690053192058131377>\":{\"type\":\"object\",\"properties\":{\"queue\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber2067800667%3E\"},\"cancelRefund\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1635358800%3E\"},\"constructionHealth\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1408574317%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number2067800667>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1635358800>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1408574317>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-7817-8384-src_rules.ts-0-25676871182655808602831>\":{\"type\":\"object\",\"properties\":{\"sellPrice\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber236571108%3E\"},\"repairCost\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber385641258%3E\"},\"tradeTax\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber500452615%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number236571108>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number385641258>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number500452615>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-8384-12915-src_rules.ts-0-2567620803371672015716859>\":{\"type\":\"object\",\"properties\":{\"attackSpeedLimits\":{\"$ref\":\"#/definitions/RulesPart%3C%5Bnumber%2Cnumber%5D131060964%3E\"},\"corpseTime\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber202117478%3E\"},\"damageTable\":{\"type\":\"object\",\"properties\":{\"attacks\":{\"$ref\":\"#/definitions/RulesPart%3Cstring%5B%5D%3E\"},\"armours\":{\"$ref\":\"#/definitions/RulesPart%3Cstring%5B%5D%3E\"},\"table\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%5B%5D%5B%5D%3E\"}},\"additionalProperties\":false}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<[number,number]131060964>\":{\"type\":\"array\",\"items\":{\"type\":\"number\"},\"minItems\":2,\"maxItems\":2,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number202117478>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<string[]>\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number[][]>\":{\"type\":\"array\",\"items\":{\"type\":\"array\",\"items\":{\"type\":\"number\"}},\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-12915-15119-src_rules.ts-0-2567619627991872051239824>\":{\"type\":\"object\",\"properties\":{\"together\":{\"type\":\"boolean\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-2336-3434-src_rules.ts-0-256761516734472119914999>\":{\"type\":\"object\",\"properties\":{\"nightSight\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1727028879%3E\"},\"explored\":{\"type\":\"string\",\"enum\":[\"remembered\",\"nothing\"]},\"startExplored\":{\"type\":\"boolean\"},\"mask\":{\"type\":\"string\",\"enum\":[\"black\",\"dim\"]}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1727028879>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-15119-16441-src_rules.ts-0-256767575302061161883220>\":{\"type\":\"object\",\"properties\":{\"pings\":{\"$ref\":\"#/definitions/RulesPart%3Cstructure-src_rules.ts-15901-16099-src_rules.ts-15214-16099-src_rules.ts-15119-16441-src_rules.ts-0-25676624849888%3E\"},\"lines\":{\"$ref\":\"#/definitions/RulesPart%3Cstructure-src_rules.ts-16207-16256-src_rules.ts-16099-16256-src_rules.ts-15119-16441-src_rules.ts-0-25676381541611%3E\"},\"pauses\":{\"$ref\":\"#/definitions/RulesPart%3Cstructure-src_rules.ts-16405-16439-src_rules.ts-16256-16439-src_rules.ts-15119-16441-src_rules.ts-0-256761718446262%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<structure-src_rules.ts-15901-16099-src_rules.ts-15214-16099-src_rules.ts-15119-16441-src_rules.ts-0-25676624849888>\":{\"type\":\"object\",\"properties\":{\"most\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"},\"within\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"},\"kinds\":{\"$ref\":\"#/definitions/RulesPart%3Cstring%5B%5D%3E\"},\"meanings\":{\"$ref\":\"#/definitions/RulesPart%3Cindexed-type-140537781-73964-74003-140537781-73899-74004-140537781-0-218439%3Calias-140537781-74138-74264-140537781-0-218439%3Cstring%2C(%22help%22%7C%22attack%22%7C%22defend%22%7C%22rally%22%7C%22ignore%22)%3E%3E%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<indexed-type-140537781-73964-74003-140537781-73899-74004-140537781-0-218439<alias-140537781-74138-74264-140537781-0-218439<string,(\\\"help\\\"|\\\"attack\\\"|\\\"defend\\\"|\\\"rally\\\"|\\\"ignore\\\")>>>\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/RulesPart%3C(%22help%22%7C%22attack%22%7C%22defend%22%7C%22rally%22%7C%22ignore%22)%3E\"},\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<(\\\"help\\\"|\\\"attack\\\"|\\\"defend\\\"|\\\"rally\\\"|\\\"ignore\\\")>\":{\"type\":\"string\",\"enum\":[\"help\",\"attack\",\"defend\",\"rally\",\"ignore\"],\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<structure-src_rules.ts-16207-16256-src_rules.ts-16099-16256-src_rules.ts-15119-16441-src_rules.ts-0-25676381541611>\":{\"type\":\"object\",\"properties\":{\"most\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"},\"within\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"},\"length\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<structure-src_rules.ts-16405-16439-src_rules.ts-16256-16439-src_rules.ts-15119-16441-src_rules.ts-0-256761718446262>\":{\"type\":\"object\",\"properties\":{\"each\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"},\"seconds\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_rules.ts-22230-22604-src_rules.ts-0-25676594161992489921438>\":{\"type\":\"object\",\"properties\":{\"leash\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1257883159%3E\"},\"sleep\":{\"$ref\":\"#/definitions/RulesPart%3Cboolean1244251315%3E\"},\"respawn\":{\"type\":\"number\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1257883159>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<boolean1244251315>\":{\"type\":\"boolean\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<def-interface-src_hero.ts-953-2062-src_hero.ts-0-1454210919897661340881447>\":{\"type\":\"object\",\"properties\":{\"maxHeroes\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1867899884%3E\"},\"maxHeroLevel\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1322296163%3E\"},\"xpRange\":{\"$ref\":\"#/definitions/RulesPart%3Cnumber1756145837%3E\"}},\"additionalProperties\":false,\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1867899884>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1322296163>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"RulesPart<number1756145837>\":{\"type\":\"number\",\"description\":\"What is said of a group of the rules: any of it, a group in it in part as well. A function, a list and a table whole\"},\"GameData\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"removed\":{\"type\":\"object\",\"properties\":{\"units\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"abilities\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"buffs\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"items\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"upgrades\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"races\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},\"additionalProperties\":false},\"ai\":{\"type\":\"object\",\"properties\":{\"races\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/AiProfile\"}}},\"additionalProperties\":false,\"description\":\"How the game's computers play each race (campaign plan AR4), by race id: each a whole profile, in the place of the code's (`GameModule.ai.races`). What the editor's Data panel writes of a race's AI\"},\"rules\":{\"$ref\":\"#/definitions/DataRules\",\"description\":\"The rules as data (campaign plan RC7), laid over the game's (`DataRules`): what the Data panel's Rules writes\"},\"units\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}},\"abilities\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}},\"buffs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}},\"items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}},\"upgrades\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}},\"races\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/DataValues\"}}},\"description\":\"The values of a game's definitions, by kind and id: what its `data.json` holds. `removed` takes definitions of the game's out, by kind (the Data panel's Delete): what still names one is the rules' check's to say (`checkRules`)\"},\"AiProfile\":{\"type\":\"object\",\"properties\":{\"economy\":{\"$ref\":\"#/definitions/EconomyOptions\",\"description\":\"The workers and the bases (`Economy`)\"},\"defence\":{\"$ref\":\"#/definitions/DefenceOptions\",\"description\":\"What it defends and how (`Defence`)\"},\"scouting\":{\"$ref\":\"#/definitions/ScoutingOptions\",\"description\":\"How often it looks and with whom (`Scouting`)\"},\"micro\":{\"$ref\":\"#/definitions/MicroOptions\",\"description\":\"How its units fight (`Micro`)\"},\"squads\":{\"$ref\":\"#/definitions/SquadsOptions\",\"description\":\"How its squads go, and the tasks they may be given (`Squads`)\"},\"team\":{\"$ref\":\"#/definitions/TeamOptions\",\"description\":\"How it plays with its team (`Team`)\"},\"waves\":{\"$ref\":\"#/definitions/WavesOptions\",\"description\":\"The waves it was given (`Waves`)\"},\"plans\":{\"$ref\":\"#/definitions/PlansOptions\",\"description\":\"What it builds, trains and researches, and in what order (`Plans`)\"},\"army\":{\"$ref\":\"#/definitions/MeleeArmyOptions\",\"description\":\"The melee army: when it attacks, how many go, how a wave goes (`melee.army`)\"},\"heroes\":{\"$ref\":\"#/definitions/MeleeHeroesOptions\",\"description\":\"The melee player's heroes: how many, and from when (`melee.heroes`)\"},\"lanes\":{\"$ref\":\"#/definitions/LanesPlayOptions\",\"description\":\"A lanes brain's play (`lanes`)\"},\"weights\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"How much each goal weighs, by its id (1 when left out): the picker's (`Goals`)\"},\"flags\":{\"$ref\":\"#/definitions/AiFlags\",\"description\":\"The classic flags (see the file's comment)\"},\"brain\":{\"type\":\"string\",\"description\":\"The brain it plays with, by id (one the game lists in `GameModule.brains`): what a race's profile says (`GameAi.races`, campaign plan AR3), for a seat that names none and a map that says none. The game's first brain where nothing says\"},\"difficulty\":{\"type\":\"string\",\"description\":\"The difficulty by name: `easy`, `normal`, `hard`, `insane`, or a game's own (`GameModule.ai.difficulties`). `normal` when left out\"},\"personality\":{\"type\":\"string\",\"description\":\"The personality by name: `balanced`, `rusher`, `turtle`, `expander`, `harasser`, or a game's own. `balanced` when left out\"},\"every\":{\"type\":\"number\",\"description\":\"Seconds between thinks: its reactions\"},\"commandsPerThink\":{\"type\":\"number\",\"description\":\"Commands a think may send at the most, like a person's hands: no limit when left out\"},\"mistakes\":{\"type\":\"number\",\"description\":\"How often it slips, 0 to 1: a think's fights left alone, a wave sent early. Drawn with the brain's own numbers\"},\"vision\":{\"type\":\"string\",\"enum\":[\"fair\",\"all\"],\"description\":\"`fair`: it sees what its seat does. `all`: it sees through the fog (an observer's session), for insane only\"},\"budget\":{\"$ref\":\"#/definitions/ThinkBudgetOptions\",\"description\":\"How much of a think one tick may do (`ThinkBudgetOptions`): modules a tick, units looked at a tick, the milliseconds a module is warned over (4). Nothing sliced when left out: a game sets it where its numbers ask, at many computers\"},\"handicap\":{\"$ref\":\"#/definitions/AiHandicap\",\"description\":\"What it is given beyond the rules, each a factor (1 is none), through the game's hooks while it is seated: `income`, what its workers bring in (1.5: half again; `beforeDeposit`); `health`, the most health of everything it has (`stats`); `damage`, the damage it deals (`beforeDamage`, before armour); `buildTime`, how long what it trains, builds and researches takes (0.8: a fifth sooner; `beforeProduce`). The classic handicap is `health`\"}},\"additionalProperties\":false,\"description\":\"How a computer player plays, as plain data: the settings of its areas (`AiSettings`) and how well it plays, every field optional, layered (see the file's comment). What a difficulty, a personality and a game's defaults give\"},\"EconomyOptions\":{\"type\":\"object\",\"properties\":{\"workers\":{\"type\":\"number\",\"description\":\"Workers on the game's money at each base, where `workersPer` says nothing of it: 8 when left out\"},\"lumberjacks\":{\"type\":\"number\",\"description\":\"Workers on the other resource, at home only, where `workersPer` says nothing of it: 3 when left out\"},\"workersPer\":{\"$ref\":\"#/definitions/WorkersPer\",\"description\":\"Workers on each resource at each base (`WorkersPer`): `{ gold: 5, lumber: 3 }` at every base, or a function of the base for one that differs (home, an expansion). What it leaves out is `workers` and `lumberjacks`\"},\"saturate\":{\"type\":\"boolean\",\"description\":\"Whether a base wants no more workers on a deposit than it serves (see the file's comment): yes when left out\"},\"trainWorkers\":{\"type\":\"boolean\",\"description\":\"Whether its halls train workers up to what the bases want: yes when left out\"},\"builders\":{\"type\":\"number\",\"description\":\"Workers trained past what the bases want, to build with: a worker sent to build is off the mine meanwhile, and a mine with only as many as it serves would gather less. 1 when left out\"},\"expansions\":{\"type\":\"number\",\"description\":\"Halls to have past the first, each by a mine nobody has a hall at: the seat's `expansions`, else none\"},\"expandWhen\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"When it may expand: a condition (`AiCondition`, as data or a function). Four minutes in and with a building that trains soldiers, when left out\"},\"workersFlee\":{\"type\":\"boolean\",\"description\":\"Whether workers a raid is on walk to a base no enemy is at, and back once theirs is clear: yes when left out\"}},\"additionalProperties\":false,\"description\":\"How a brain runs its economy (`BrainDef.economy`, the seat's `AiOptions.economy` over it, the `economy()` module's own under both). Every field has a data form a save keeps; the function forms are the brain's to give again\"},\"WorkersPer\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"How many workers a base wants on each resource (`EconomyOptions.workersPer`): as numbers by resource id, or a function of the base (`index` 0 is home)\"},\"AiCondition\":{\"$ref\":\"#/definitions/AiConditionData\",\"description\":\"A condition: a question with a yes or no, as a function of the brain, or as plain data (`AiConditionData`)\"},\"AiConditionData\":{\"anyOf\":[{\"type\":\"object\",\"properties\":{\"all\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AiCondition\"}}},\"required\":[\"all\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"any\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AiCondition\"}}},\"required\":[\"any\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"not\":{\"$ref\":\"#/definitions/AiCondition\"}},\"required\":[\"not\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"resource\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"},\"id\":{\"type\":\"string\"}},\"required\":[\"id\"]}},\"required\":[\"resource\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"units\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"},\"type\":{\"type\":\"string\"},\"role\":{\"$ref\":\"#/definitions/AiRole\"},\"tag\":{\"type\":\"string\"},\"of\":{\"$ref\":\"#/definitions/AiWhose\"},\"near\":{\"anyOf\":[{\"type\":\"string\"},{\"$ref\":\"#/definitions/Vec2\"}]},\"within\":{\"type\":\"number\"},\"finished\":{\"type\":\"boolean\"},\"known\":{\"type\":\"boolean\"}}}},\"required\":[\"units\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"supply\":{\"type\":\"object\",\"properties\":{\"free\":{\"$ref\":\"#/definitions/AiRange\"},\"used\":{\"$ref\":\"#/definitions/AiRange\"},\"cap\":{\"$ref\":\"#/definitions/AiRange\"}},\"additionalProperties\":false}},\"required\":[\"supply\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"time\":{\"type\":\"object\",\"properties\":{\"after\":{\"type\":\"number\"},\"before\":{\"type\":\"number\"}},\"additionalProperties\":false}},\"required\":[\"time\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"underAttack\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":true},{\"type\":\"object\",\"properties\":{\"seconds\":{\"type\":\"number\"},\"near\":{\"anyOf\":[{\"type\":\"string\"},{\"$ref\":\"#/definitions/Vec2\"}]},\"reach\":{\"type\":\"number\"}},\"additionalProperties\":false}]}},\"required\":[\"underAttack\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"seen\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"role\":{\"$ref\":\"#/definitions/AiRole\"},\"within\":{\"type\":\"number\"}},\"additionalProperties\":false}},\"required\":[\"seen\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"difficulty\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"array\",\"items\":{\"type\":\"string\"}}]}},\"required\":[\"difficulty\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"told\":{\"type\":\"string\"}},\"required\":[\"told\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"chance\":{\"type\":\"number\"}},\"required\":[\"chance\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"hero\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"alive\":{\"type\":\"boolean\"},\"level\":{\"$ref\":\"#/definitions/AiRange\"}},\"additionalProperties\":false}},\"required\":[\"hero\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"wave\":{\"$ref\":\"#/definitions/AiRange\"}},\"required\":[\"wave\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"objective\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"status\":{\"anyOf\":[{\"$ref\":\"#/definitions/ObjectiveStatus\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ObjectiveStatus\"}}]}},\"required\":[\"id\",\"status\"],\"additionalProperties\":false}},\"required\":[\"objective\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"report\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"},\"path\":{\"type\":\"string\"},\"equals\":{}},\"required\":[\"path\"]}},\"required\":[\"report\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"component\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"},\"id\":{\"type\":\"string\"},\"entity\":{\"type\":\"string\"},\"type\":{\"type\":\"string\"},\"path\":{\"type\":\"string\"},\"equals\":{}},\"required\":[\"id\"]}},\"required\":[\"component\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"region\":{\"type\":\"object\",\"additionalProperties\":false,\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"},\"name\":{\"type\":\"string\"},\"of\":{\"$ref\":\"#/definitions/AiWhose\"},\"type\":{\"type\":\"string\"},\"role\":{\"$ref\":\"#/definitions/AiRole\"}},\"required\":[\"name\"]}},\"required\":[\"region\"],\"additionalProperties\":false},{\"type\":\"object\",\"properties\":{\"is\":{\"type\":\"string\"},\"args\":{\"type\":\"object\",\"additionalProperties\":{}}},\"required\":[\"is\"],\"additionalProperties\":false}],\"description\":\"A condition as plain data: what a map's file, a mission's JSON or the editor holds. Each form is one question; the table in `docs/ai.md` says what each asks\"},\"AiWhose\":{\"type\":\"string\",\"enum\":[\"mine\",\"enemy\",\"ally\"],\"description\":\"Whose units a condition counts: the player’s own (the default), its rivals’ in sight, its allies’\"},\"Vec2\":{\"type\":\"object\",\"properties\":{\"x\":{\"type\":\"number\"},\"z\":{\"type\":\"number\"}},\"required\":[\"x\",\"z\"],\"additionalProperties\":false,\"description\":\"A point on the ground plane. The simulation is 2D; height always comes from the terrain.\"},\"AiRange\":{\"type\":\"object\",\"properties\":{\"min\":{\"type\":\"number\"},\"max\":{\"type\":\"number\"}},\"additionalProperties\":false,\"description\":\"At least `min` and at most `max`, each left out for no bound: a count, an amount, a level\"},\"ObjectiveStatus\":{\"type\":\"string\",\"enum\":[\"open\",\"done\",\"failed\"]},\"DefenceOptions\":{\"type\":\"object\",\"properties\":{\"radius\":{\"type\":\"number\",\"description\":\"How near one of its buildings a rival's unit is an intruder: the seat's `defendRadius`, else 16\"},\"odds\":{\"type\":\"number\",\"description\":\"The odds of the fight (`Strength.odds`) the defenders sent against a raid are to have: two in three when left out (about four tenths stronger than the raid)\"},\"recall\":{\"type\":\"boolean\",\"description\":\"Whether a raid more than what is at home can meet brings the army home (the goal is urgent: it takes squads out, whole, once it scores past what they are on): yes when left out\"},\"towers\":{\"type\":\"number\",\"description\":\"Towers a base wants once raided `towerAfter` times: 1 when left out. 0 for none\"},\"towerAfter\":{\"type\":\"number\",\"description\":\"Raids at one base before it wants towers: 2 when left out\"},\"tower\":{\"type\":\"string\",\"description\":\"The tower to build, by type id: the cheapest of the `tower` role its workers build when left out\"},\"quiet\":{\"type\":\"number\",\"description\":\"Seconds a base stands clear before a raid on it is over: 15 when left out\"}},\"additionalProperties\":false,\"description\":\"How a brain defends its bases (`BrainDef.defence`, the seat's `AiOptions.defence` over it, the `defence()` module's own under both). Data, kept in a save\"},\"ScoutingOptions\":{\"type\":\"object\",\"properties\":{\"lookEvery\":{\"type\":\"number\",\"description\":\"Seconds a place stays out of sight before it is worth a look again: 90 when left out\"},\"scout\":{\"type\":\"boolean\",\"const\":false,\"description\":\"Where to look: `false` nowhere (the goal is left out), a function for places of the game's own each think (in place of the kit's plan). The kit's plan when left out\"},\"expansions\":{\"type\":\"boolean\",\"description\":\"Whether the mines they would expand to are looked at: yes when left out\"},\"army\":{\"type\":\"boolean\",\"description\":\"Whether where their army was last seen is looked at again: yes when left out\"},\"flyers\":{\"type\":\"boolean\",\"description\":\"Whether a flying unit with nothing to do goes before the fastest on foot: yes when left out\"},\"from\":{\"type\":\"number\",\"description\":\"Seconds into the game before the first look: 15 when left out\"}},\"additionalProperties\":false,\"description\":\"How a brain scouts (`BrainDef.scouting`, the seat's `AiOptions.scouting` over it, the `scouting()` module's own under both). Data, but for the function form of `scout`\"},\"MicroOptions\":{\"type\":\"object\",\"properties\":{\"targets\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/TargetRule\"},\"description\":\"Who is worth hitting first, as ranked rules (`TargetRule`), or a function that picks (`TargetPicker`). The kit's when left out: casters 2, heroes 1.5 (with `targetHeroes`), siege 1, healers 2, over the type's declared `UnitTypeDef.ai.priority`; among those alike, the weakest, the nearest\"},\"targetHeroes\":{\"type\":\"boolean\",\"description\":\"Whether heroes are worth hitting first (the classic Target Heroes): yes when left out\"},\"focusEvery\":{\"type\":\"number\",\"description\":\"Seconds a squad keeps hitting the rival it was told to before another is chosen: 4\"},\"kite\":{\"anyOf\":[{\"type\":\"boolean\"},{\"type\":\"string\",\"const\":\"ranged\"}],\"description\":\"Whether ranged units step back from the melee closing on them, when they are the faster: `'ranged'` (or `true`) when left out, `false` never\"},\"unitsFlee\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"The share of its health under which a unit leaves the fight for safety (the classic Units Flee): 0.25. `false` never\"},\"heroesFlee\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"The same for heroes (Heroes Flee): 0.35. `false` never\"},\"returnAt\":{\"type\":\"number\",\"description\":\"The share of its health at which a unit that fled is back: 0.8\"},\"removeInjuries\":{\"type\":\"boolean\",\"description\":\"Whether the hurt go home to heal between fights, not only out of one (Remove Injuries): no when left out\"},\"ignoreInjured\":{\"type\":\"boolean\",\"description\":\"Whether a unit that fled stays out until healed, however long (Ignore Injured): no when left out, so one nothing heals (or that heals too slowly to wait a minute for) comes back once safe\"},\"spells\":{\"anyOf\":[{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/SpellAim\"}},{\"type\":\"boolean\",\"const\":false}],\"description\":\"Where to use abilities, by ability id (`SpellAim`): before the ability's own `ai`, and before what the kit works out from its effects. `false` casts nothing: what is on autocast looks after itself\"},\"potions\":{\"type\":\"boolean\",\"description\":\"Whether a potion is drunk when it is needed: yes when left out\"},\"takeItems\":{\"type\":\"boolean\",\"description\":\"Whether what lies about is picked up (Take Items): yes when left out\"},\"buyItems\":{\"type\":\"boolean\",\"description\":\"Whether heroes buy from a shop in reach (Buy Items): yes when left out, where there is a shop and a list\"},\"shopping\":{\"anyOf\":[{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ShoppingItem\"}},{\"type\":\"boolean\",\"const\":false}],\"description\":\"What a hero shops for, in order (`ShoppingItem`), or a function that names the item a hero should buy next (none for nothing). The cheapest item whose ability heals, one of it, when left out; `false` nothing\"},\"hireUnits\":{\"type\":\"boolean\",\"description\":\"Whether it hires units at a place that hires in reach (a tavern, a mercenary camp: `UnitTypeDef.hires`): yes when left out, where there is one\"},\"hiring\":{\"anyOf\":[{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/HiringItem\"}},{\"type\":\"boolean\",\"const\":false}],\"description\":\"What it hires, in order (`HiringItem`), or a function that names the unit to hire next of those a place offers (none for nothing). When left out: no hero, the strongest soldier for its price, with money to spare (150 past it) and supply free, four at the most. `false` nothing\"},\"smartArtillery\":{\"type\":\"boolean\",\"description\":\"Whether siege units shoot buildings when they may and stay behind the squad (Smart Artillery): yes when left out\"},\"heroes\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/HeroPlan\"},\"description\":\"The heroes to make, in order (`HeroPlan`: which, its skills, its items, a chance), or a function that picks the next of those that could be made. The first that can be made, and the ultimate first, when left out\"}},\"additionalProperties\":false,\"description\":\"How a brain fights (`BrainDef.micro`, the seat's `AiOptions.micro` over it, the `micro()` module's own under both): whom it hits first, whether its ranged units kite, when its units flee, how it casts, what it buys, how its siege is used, which heroes it makes. Every field has a data form a save keeps; the function forms are the brain's to give again\"},\"TargetRule\":{\"type\":\"object\",\"properties\":{\"match\":{\"type\":\"string\",\"description\":\"What it picks out: a role (`caster`, `hero`, `siege`, `worker`, `healer`), `building`, a tag (`ranged`, the game's own), or a unit type by id\"},\"weight\":{\"type\":\"number\",\"description\":\"What it adds to the worth of what it picks out: 1 when left out. Rules add up; a foe no rule names is worth 1\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"When it counts: a condition (`AiCondition`, as data or a function). Always when left out\"}},\"required\":[\"match\"],\"additionalProperties\":false,\"description\":\"One rule of who is worth hitting first (`MicroOptions.targets`): what it picks out, how much it adds, when it counts. Plain data\"},\"SpellAim\":{\"not\":{},\"description\":\"Where to use an ability, in code (`MicroOptions.spells`, by ability id): where (`point`) and on whom (`target`), `null` for not now, `undefined` to leave it to what the kit works out from the effects. `foes` are the enemies within the ability's reach of the caster, `friends` its own and its allies' fighters near it\"},\"ShoppingItem\":{\"type\":\"object\",\"properties\":{\"item\":{\"type\":\"string\",\"description\":\"The item, by id\"},\"count\":{\"type\":\"number\",\"description\":\"How many of it to carry: 1 when left out\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"When it is wanted: a condition. Always when left out\"}},\"required\":[\"item\"],\"additionalProperties\":false,\"description\":\"A line of a hero's shopping list (`MicroOptions.shopping`, `HeroPlan.items`): an item to carry, how many, when\"},\"HiringItem\":{\"type\":\"object\",\"properties\":{\"unit\":{\"type\":\"string\",\"description\":\"The unit type, by id: one a place that hires lists (`UnitTypeDef.hires`)\"},\"count\":{\"type\":\"number\",\"description\":\"How many of it to have: 1 when left out\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"When it is wanted: a condition. Always when left out\"}},\"required\":[\"unit\"],\"additionalProperties\":false,\"description\":\"A line of what a brain hires (`MicroOptions.hiring`): a unit a place hires out, how many of it to have, when\"},\"HeroPlan\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\",\"description\":\"The hero's unit type\"},\"skills\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The order its skills are learned in, each level a line (`['stomp', 'holyLight', 'stomp', …]`); past the end, or left out, the ultimate as soon as it can be had and then whatever is furthest behind. Or a function: the skill to learn next of those it may, by id\"},\"items\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ShoppingItem\"},\"description\":\"What it shops for, in place of the brain's `shopping`\"},\"chance\":{\"type\":\"number\",\"description\":\"The chance it is made at all, 0 to 1 (1 when left out): rolled once, with the brain's numbers, and remembered\"}},\"required\":[\"type\"],\"additionalProperties\":false,\"description\":\"A hero the brain means to have (`MicroOptions.heroes`): which, what it learns in what order, what it buys\"},\"SquadsOptions\":{\"type\":\"object\",\"properties\":{\"spread\":{\"type\":\"number\",\"description\":\"How far from its middle a unit may be before it counts as strayed: what a regroup brings in. Grows with the squad when left out (8, and three times the square root of its size above that: 12 for sixteen units)\"},\"regroupWhen\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"The share of its units strayed (`spread`) at which it stops to regroup, on its way and out of a fight: 0.4. `false` never\"},\"reinforce\":{\"type\":\"boolean\",\"description\":\"Whether it makes up what it lost since its task began from the pool (the idle fighters nothing holds): no when left out\"},\"retreatAt\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"Its odds in a fight (`Strength.odds`) under which it falls back home, away from home: 0.3. `false` fights on to the last (a mission's guards)\"},\"home\":{\"type\":\"number\",\"description\":\"How near home it fights on whatever the odds: there is nowhere to fall back to. 20 when left out\"},\"micro\":{\"type\":\"boolean\",\"description\":\"Whether the micro module (`micro()`, C2) fights for it once it is in a fight: focus fire, kiting, fleeing, siege. Yes when left out; `false` for a squad left to its units (a scout, a mission's guards on an order of the game's)\"},\"tasks\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/TaskDef\"},\"description\":\"Tasks of the game's own: registered with the brain, so that a squad on one is carried on after a load\"}},\"additionalProperties\":false,\"description\":\"How a brain's squads behave, where a squad says nothing for itself (`BrainDef.squads`, the seat's `AiOptions.squads` over it); and the tasks of the game's own (`defineTask`) a save of the brain may name\"},\"TaskDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Unique among the brain's tasks: what a save names it by. The kit's are words (`attack`); a game's prefixed (`ctf.capture`)\"},\"handles\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"retreat\",\"regroup\",\"reinforce\"]},\"description\":\"What the squads module leaves to it: a task that regroups in its own way, or retreats never\"},\"standing\":{\"type\":\"boolean\",\"description\":\"Whether it is a standing duty, going on as long as its squad has it (a hero walking a lane with its waves): never stuck, whatever its phase, for the `ends` invariant (`checkBrain`). No when left out\"},\"fighting\":{\"type\":\"boolean\",\"description\":\"Whether a squad on it is in a fight it means to win, which the micro fights for (`ai.area(Micro)`): yes when left out. No for a task that goes somewhere, looks, stands, gathers or falls back (the kit's `move`, `scout`, `hold`, `gather`, `retreat`, and the micro's own `flee`)\"}},\"required\":[\"id\"],\"additionalProperties\":false,\"description\":\"A kind of task (`defineTask`): what it sends as it begins (`start`), what it looks at each think (`think`), and the place it is about (`where`, for the squads module's regroup and reinforcements and for the report). The squads module runs it with its own regroup, reinforce and retreat around it, but for what it `handles` itself\"},\"TeamOptions\":{\"type\":\"object\",\"properties\":{\"defendUsers\":{\"type\":\"boolean\",\"description\":\"Whether it helps its allies, people and computers, where asked (the classic Defend Users): yes when left out\"},\"answerPings\":{\"type\":\"boolean\",\"description\":\"Whether it does what an ally's ping asks besides help (`GameRules.talk.pings.meanings`): a squad sent to fight at an `attack` (a push), one to hold a place at a `defend` (a hold), its squads out brought home at a `rally` (a retreat). Yes when left out\"},\"helpOdds\":{\"type\":\"number\",\"description\":\"The odds of the fight (`Strength.odds`) what it sends to help is to have: one in two when left out\"},\"askForHelp\":{\"type\":\"boolean\",\"description\":\"Whether it asks its team for help with a raid more than it can meet: yes when left out\"},\"together\":{\"type\":\"boolean\",\"description\":\"Whether its waves wait for the team's plan and go together: no when left out\"},\"gatherFor\":{\"type\":\"number\",\"description\":\"Seconds ahead of the proposal the waves of a plan go: 20 when left out\"},\"requestFor\":{\"type\":\"number\",\"description\":\"Seconds a request stands: 30 when left out\"},\"say\":{\"type\":\"boolean\",\"description\":\"Whether it says a line to its side as it sends a wave, comes to help, falls back: no when left out\"},\"lines\":{\"type\":\"object\",\"properties\":{\"attacking\":{\"type\":\"string\"},\"helping\":{\"type\":\"string\"},\"retreating\":{\"type\":\"string\"}},\"additionalProperties\":false,\"description\":\"Its lines, the game's words: `{ attacking, helping, retreating }`. Nothing is said for a line not given\"}},\"additionalProperties\":false,\"description\":\"How a brain plays with its team (`BrainDef.team`, the seat's `AiOptions.team` over it, the `team()` module's own under both). Data\"},\"WavesOptions\":{\"type\":\"object\",\"properties\":{\"groups\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AttackGroup\"},\"description\":\"The groups waves are made of, by name\"},\"waves\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/AttackWave\"},\"description\":\"The waves, in order, or a function giving the wave whose turn it is (by its index), none for no more\"},\"train\":{\"type\":\"boolean\",\"description\":\"Whether a wave's group is trained (wants of the production plan): yes when left out. No for units that are given (a lanes game)\"},\"priority\":{\"type\":\"number\",\"description\":\"How important a wave's units are to the purse, as wants: 30 when left out (under a hall, a barracks, a hero)\"}},\"additionalProperties\":false,\"description\":\"How a brain sends its waves (`BrainDef.waves`; the seat's `AiOptions.waves` and `groups`, the data of it, go over)\"},\"AttackGroup\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Its name: what a wave names it by\"},\"units\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"So many of each unit type or role: `{ footman: 4, rifleman: 2 }`\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"Only while this holds: a wave of a group whose condition fails is skipped as its own would be\"}},\"required\":[\"id\",\"units\"],\"additionalProperties\":false,\"description\":\"What a wave is made of: so many of each unit type (by id) or role (`caster`, a game's own), by name, under a condition\"},\"AttackWave\":{\"type\":\"object\",\"properties\":{\"group\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"}}],\"description\":\"Its group: a group's name (`WavesOptions.groups`), or the units in place (`{ footman: 4 }`)\"},\"after\":{\"type\":\"number\",\"description\":\"Seconds after the wave before it (after the start, for the first) before it may go: 0 when left out\"},\"minForces\":{\"type\":\"number\",\"description\":\"The share of its group that is enough to go with, 0 to 1: all of it when left out\"},\"gatherFor\":{\"type\":\"number\",\"description\":\"Seconds it gathers at the rally before it goes, whoever is late: 15 when left out\"},\"repeat\":{\"type\":[\"boolean\",\"number\"],\"description\":\"Whether it goes again once sent: `true` for ever, a number for so many times in all. Once when left out\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"Only when this holds as its turn comes: a wave whose condition fails is skipped\"},\"together\":{\"type\":\"boolean\",\"description\":\"Whether it waits for its team's attack together (`TeamOptions.together`, C5)\"},\"target\":{\"$ref\":\"#/definitions/WaveTarget\",\"description\":\"Where it goes: their base nearest home when left out\"},\"rally\":{\"anyOf\":[{\"$ref\":\"#/definitions/Vec2\"},{\"type\":\"string\"}],\"description\":\"Where it gathers: a place, or a name the map or the rules gave. A little out of home towards the target when left out\"}},\"required\":[\"group\"],\"additionalProperties\":false,\"description\":\"One wave (the classic attack wave): its group, when it goes, how much of it is enough, how long it gathers, whether it goes again, together or not, and where to\"},\"WaveTarget\":{\"anyOf\":[{\"type\":\"string\",\"const\":\"nearestBase\"},{\"type\":\"string\",\"const\":\"weakestBase\"},{\"type\":\"string\",\"const\":\"expansion\"},{\"type\":\"string\",\"const\":\"army\"},{\"$ref\":\"#/definitions/Vec2\"}],\"description\":\"Where a wave goes: their base nearest home, their weakest (the fewest towers and army seen there), an expansion of theirs, their army as last seen, a place, or a function of the brain\"},\"PlansOptions\":{\"type\":\"object\",\"properties\":{\"build\":{\"$ref\":\"#/definitions/BuildPlanOptions\"},\"production\":{\"$ref\":\"#/definitions/ProductionPlanOptions\"},\"order\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/BuildOrderItem\"},\"description\":\"What to have first, in order (`BuildOrderItem`): each item waits for the one before, and nothing else the computer would make of itself is made meanwhile (`following`); what it works out for itself once done. The seat's `AiOptions.buildOrder`\"}},\"additionalProperties\":false,\"description\":\"How a brain plans (`BrainDef.plans`): the build plan's options, the production plan's, the build order\"},\"BuildPlanOptions\":{\"type\":\"object\",\"properties\":{\"wants\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/Want\"},\"description\":\"Standing wants: what the brain always has, built anew when lost\"},\"placement\":{\"$ref\":\"#/definitions/PlacementTable\",\"description\":\"How each type's spot is chosen, by type id or by role: a name or a function. What a type declares (`UnitTypeDef.ai.placement`) goes over it\"},\"rebuild\":{\"type\":\"boolean\",\"description\":\"Whether a building lost is built again, for standing wants that do not say: yes when left out\"},\"repair\":{\"type\":\"boolean\",\"description\":\"Whether a worker is sent to mend a damaged building when no enemy reaches it: yes when left out\"},\"siteTimeout\":{\"type\":\"number\",\"description\":\"Seconds without a spot before a want that does not stand is given up: 60 when left out\"},\"within\":{\"type\":\"number\",\"description\":\"How far from home a building goes at the most, where a want does not say: 22 when left out\"}},\"additionalProperties\":false,\"description\":\"How the build plan goes about it (`BrainDef.plans.build`, the `build()` module; the data of it in `AiOptions`)\"},\"Want\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Its name: what the memory, the report and `drop` know it by. Made up when left out\"},\"type\":{\"type\":\"string\",\"description\":\"The unit type wanted: a building, or a unit (whose buildings the plan puts up; the production plan trains it)\"},\"within\":{\"type\":\"number\",\"description\":\"How far from there at the most: 22 when left out\"},\"priority\":{\"type\":\"number\",\"description\":\"Wants are taken most important first, and the most important one that cannot be paid for saves up: 0 when left out\"},\"spare\":{\"type\":\"number\",\"description\":\"Money to have left over after paying for it: a luxury that waits for gold to spare. 0 when left out\"},\"keep\":{\"type\":\"boolean\",\"description\":\"Whether the want stands: kept once met, and short again when what it made is lost, so that it is built anew. Wants of a brain's or a seat's options stand; one added as the game goes is dropped once met, unless it says so\"},\"rebuild\":{\"type\":\"boolean\",\"description\":\"For a standing want: whether a building lost is built again (the plan's `rebuild` when left out)\"},\"siteTimeout\":{\"type\":\"number\",\"description\":\"Seconds without a spot for it before a want that does not stand is given up: the plan's `siteTimeout` when left out\"},\"by\":{\"type\":\"string\",\"description\":\"Who wants it, for the report: `order`, `production`, `economy`, a goal's or a rule's id\"},\"count\":{\"type\":\"number\"},\"when\":{\"$ref\":\"#/definitions/AiCondition\"},\"near\":{\"anyOf\":[{\"$ref\":\"#/definitions/Vec2\"},{\"type\":\"string\"}]},\"placement\":{\"$ref\":\"#/definitions/PlacementName\"}},\"additionalProperties\":false,\"required\":[\"type\"],\"description\":\"A want with the function forms: how many as a function of the brain, a condition as code, a place found each think, a placement strategy of the game's own (`ai.plans.want`, `BuildPlanOptions.wants`)\"},\"PlacementTable\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/definitions/PlacementName\"},\"description\":\"Which strategy a type goes by (`AiOptions.placement`, `BuildPlanOptions.placement`): by type id or by role, a name or a function\"},\"ProductionPlanOptions\":{\"type\":\"object\",\"properties\":{\"composition\":{\"$ref\":\"#/definitions/Composition\",\"description\":\"The army it wants (`Composition`), or a function of the brain giving it. Even shares of every soldier type it can train when left out\"},\"counters\":{\"type\":\"number\",\"description\":\"How much what answers the enemy's army seen pulls the shares about: 0 not at all, 1 (left out) as much as a share; a type that cannot hit what they field is not trained while they field it\"},\"train\":{\"type\":\"boolean\",\"description\":\"Whether it trains soldiers at all: yes when left out. Workers and heroes are the economy's and the hero module's\"},\"queue\":{\"type\":\"number\",\"description\":\"How many may queue at one building: 2 when left out\"},\"supplyAhead\":{\"type\":\"boolean\",\"description\":\"Whether to want one more of what provides supply when what it would train next does not fit: yes when left out\"},\"supplyMargin\":{\"type\":\"number\",\"description\":\"Supply to keep free beyond the next unit's, so that the farm is up before it is needed: 4 when left out\"},\"research\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Upgrades to research, in order, by id (the first it can is next), or a function of the brain giving the next; what the army it has uses most when left out\"},\"researchSpare\":{\"type\":\"number\",\"description\":\"Money to have left over before researching: 200 when left out (research is a luxury)\"},\"priority\":{\"type\":\"number\",\"description\":\"How important training and research are to the purse (`Purse`): 0 when left out, under every want that saves\"},\"upkeepTier\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"The tier of the game's upkeep (`GameModule.upkeep`: 0 none, 1 the first) the composition trains no further into: a soldier that would take the supply used past it waits, and no supply is wanted past it, unless the money would lie idle (`upkeepSpare`). What is wanted outright (a wave's, a build order's) is trained all the same. `UPKEEP_TIER` (1) when left out; `false` reads no upkeep\"},\"upkeepSpare\":{\"type\":\"number\",\"description\":\"Money free past which upkeep is not read (it would lie idle else): `UPKEEP_SPARE` (600) when left out\"}},\"additionalProperties\":false,\"description\":\"How the production plan goes about it (`BrainDef.plans.production`, the `production()` module; the data of it in `AiOptions.composition` and `research`)\"},\"Composition\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"number\"},\"description\":\"The army a computer player wants, as shares by unit type id or tag (the kit's `ranged`, `melee`, `hitsAir`, a game's own): `{ footman: 2, rifleman: 1 }` is two footmen to a rifleman. A tag's share is split among the types that have it; a type named gets its own beside. Types it cannot train yet are left out until it can\"},\"BuildOrderItem\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"count\":{\"type\":\"number\"}},\"required\":[\"type\"],\"additionalProperties\":false}],\"description\":\"One item of a build order: a type to have (one of it), or a type and how many. Counts of a type add up along the order\"},\"MeleeArmyOptions\":{\"type\":\"object\",\"properties\":{\"firstAttack\":{\"type\":\"number\",\"description\":\"Seconds before its first wave: 150 when left out\"},\"attackEvery\":{\"type\":\"number\",\"description\":\"Seconds between two waves: 45 when left out\"},\"waveSize\":{\"type\":\"number\",\"description\":\"Units in its first wave, each after bringing two more: 6 when left out\"},\"goOdds\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"The odds (`Strength.odds`) of what it has ready against their army as last seen (the last minute) under which a wave whose time has come waits and trains on rather than go: 0.4 when left out; `false` never waits\"},\"waitAtMost\":{\"type\":\"number\",\"description\":\"Seconds a wave waits past its time at the most, outmatched or short of its size: then it goes with what it has, half the wave at the least, where that would hold against what is remembered to reach the target. Twice `attackEvery` when left out. A wave that could never reach its size (the supply capped) still comes\"},\"pressOn\":{\"type\":\"boolean\",\"description\":\"Whether a wave that razed what it went for goes on to the next of their buildings it knows, while it is strong enough: yes when left out\"},\"target\":{\"type\":\"string\",\"enum\":[\"nearest\",\"weakest\"],\"description\":\"Where a wave of its own goes among their buildings it knows of: the `nearest`, or the `weakest` (the one the least of their strength is remembered to reach: an expansion before a main with towers; the nearest among those alike). `weakest` when left out\"},\"counter\":{\"type\":\"boolean\",\"description\":\"Whether a wave of theirs that died at its gate is answered at once with what is ready (half a wave at the least), their base being empty of it: yes when left out. `counterAfter` is how many of their fighters must have fallen near its bases in the last twenty seconds (3 when left out)\"},\"counterAfter\":{\"type\":\"number\"},\"pressOdds\":{\"type\":\"number\",\"description\":\"The odds against their army as last seen a wave needs to go on: 0.5 when left out\"},\"reinforce\":{\"type\":\"boolean\",\"description\":\"Whether idle fighters at home join a wave that is out, making up what it lost: yes when left out\"},\"strike\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"awayFor\":{\"type\":\"number\"},\"odds\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"A strike while their army is away (FJ1): every sighting of their army within `awayFor` seconds (60) stands far from what a wave would go for (their base, out raiding or creeping or at a base of mine), and what is ready (half a wave at the least) would hold against what is remembered to reach it at these odds (`odds`, 0.6): the wave goes before its time. `false` for none\"},\"waveGrowth\":{\"type\":\"number\",\"description\":\"Units more in each wave than the one before: 2 when left out\"},\"waveMax\":{\"type\":\"number\",\"description\":\"The most units a wave of its own asks for: 24 when left out\"},\"raid\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"size\":{\"type\":\"number\"},\"odds\":{\"type\":\"number\"},\"every\":{\"type\":\"number\"},\"armyAwayFor\":{\"type\":\"number\"},\"workersSeenFor\":{\"type\":\"number\"},\"retreatAt\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"Raids on their workers where their army is not (the `raid` goal): how many go (`size`, 3, the fastest), the odds against what is remembered at the base they need (`odds`, 0.6), seconds between raids (`every`, 60), seconds their army must not have been seen near the base (`armyAwayFor`, 45), how long ago their workers were seen at the most (`workersSeenFor`, 120), the odds the raiders fall back at (`retreatAt`, 0.5). `false` for no raids\"},\"harass\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"size\":{\"type\":\"number\"},\"odds\":{\"type\":\"number\"},\"every\":{\"type\":\"number\"},\"retreatAt\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"Harassing their main before the first wave (the `harass` goal): the party (`size`, 3: the hero and the fastest), the odds it needs at their base (`odds`, 0.6), seconds between (`every`, 90), the odds it falls back at (`retreatAt`, 0.5). `false` for none\"},\"expand\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"guards\":{\"type\":\"number\"},\"spare\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"Guards at a base past home that has no tower yet (the `expand` goal): how many (`guards`, 2), and how many fighters past a wave must stand idle for any to go (`spare`, 0). `false` for none\"},\"creep\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"every\":{\"type\":\"number\"},\"from\":{\"type\":\"number\"},\"reach\":{\"type\":\"number\"},\"party\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"Creeping (the `creep` goal): seconds between camps (`every`, 40), seconds into the game before the first (`from`, 30), how far from home a camp may be (`reach`, 70), the fewest in a party (`party`, 3). `false` for none\"},\"surrender\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"$ref\":\"#/definitions/MeleeSurrenderOptions\"}],\"description\":\"When it gives up (the `melee.surrender` module, `MeleeSurrenderOptions`): once it has no hall, no worker and no army that could win the game back, for half a minute, when left out; a condition of the game's own (`when`), and how long it holds first (`after`). `false` plays to the last\"}},\"additionalProperties\":false,\"description\":\"How the melee player's army goes about its own waves and the goals beside them (`AiSettings.army` over the melee brain's `army(options)`). Data: a save keeps the seat's\"},\"MeleeSurrenderOptions\":{\"type\":\"object\",\"properties\":{\"when\":{\"$ref\":\"#/definitions/AiCondition\",\"description\":\"When it cannot come back, as a condition (data or a function of the brain). By default: no hall and no worker of its own, and its fighters (none at all, or) outmatched by their army as last seen in the last two minutes, odds under 0.2\"},\"after\":{\"type\":\"number\",\"description\":\"Seconds the condition holds on end before it gives up: 30 when left out\"}},\"additionalProperties\":false,\"description\":\"When the melee player gives up (`MeleeArmyOptions.surrender`): the condition, and how long it holds first\"},\"MeleeHeroesOptions\":{\"type\":\"object\",\"properties\":{\"most\":{\"type\":\"number\",\"description\":\"Heroes it has once the game is under way (`secondFrom`): one before. 2 when left out\"},\"secondFrom\":{\"type\":\"number\",\"description\":\"Seconds into the game from which it wants every hero it may have: one before. 240 when left out\"},\"priority\":{\"type\":\"number\",\"description\":\"How important a hero's price is to the purse while it is short (`Purse.reserve`): the hall, supply, the barracks, the altar, the answer to their army and another hall go before it (their wants are more important); a workshop, the next tier, a second barracks and the soldiers wait for it. 35 when left out\"}},\"additionalProperties\":false,\"description\":\"How the melee brain makes its heroes (`heroes()` of the melee brain): how many once the game is under way (the profile's `heroes`), from when, and how important their price is to the purse\"},\"LanesPlayOptions\":{\"type\":\"object\",\"properties\":{\"home\":{\"$ref\":\"#/definitions/Vec2\",\"description\":\"Where its heroes go to rest: a point, or a function. Its side's building by its side's ends of the lanes when left out (a core)\"},\"lanes\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Only these lanes, by their path's name: every lane of the map when left out\"},\"backAt\":{\"type\":\"number\",\"description\":\"The share of its health under which a hero goes home to rest: 0.35\"},\"returnAt\":{\"type\":\"number\",\"description\":\"The share at which a resting hero goes back out: 0.85\"},\"restFor\":{\"type\":\"number\",\"description\":\"Seconds a hero rests at home at most, healed or not: 40\"},\"recall\":{\"type\":\"boolean\",\"description\":\"Whether a hero going home uses an ability that takes it there (a recall), where nothing hostile is near: yes when left out\"},\"backOdds\":{\"type\":\"number\",\"description\":\"The odds where a hero stands on its lane under which it falls back along it: 0.3\"},\"behind\":{\"type\":\"number\",\"description\":\"How many cells behind its side's wave a hero walks: 3\"},\"help\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"reach\":{\"type\":\"number\"},\"odds\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"An ally's hero in a fight it goes to: within `reach` cells of it (30), where the odds with it are at least `odds` (0.4). `false` never\"},\"camps\":{\"anyOf\":[{\"type\":\"boolean\",\"const\":false},{\"type\":\"object\",\"properties\":{\"reach\":{\"type\":\"number\"},\"odds\":{\"type\":\"number\"}},\"additionalProperties\":false}],\"description\":\"A camp it takes with no wave to walk with: within `reach` cells (50), where the odds against it are at least `odds` (0.6). `false` never\"},\"lastHits\":{\"type\":\"boolean\",\"description\":\"Whether a hero hits the minion its next hit kills before anything else (a last hit): yes when left out\"}},\"additionalProperties\":false,\"description\":\"How a lanes brain plays (`lanesPlay(options)`, the seat's `AiOptions.lanes` over it): its heroes' rest, how far it goes for an ally or a camp, how near its wave it walks. Data, but for `units` and `home` as functions\"},\"AiFlags\":{\"type\":\"object\",\"properties\":{\"defendUsers\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Helps its allies, people and computers, where asked (the team's `help` goal)\"},\"targetHeroes\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Hits heroes first among those alike (the micro's targets)\"},\"repairStructures\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Mends damaged buildings when no enemy reaches them (the build plan's `repair`)\"},\"heroesFlee\":{\"$ref\":\"#/definitions/AiFlag%3C(boolean%7Cnumber)%3E\",\"description\":\"A hero leaves a fight under this share of its health: `true` at the share under it, `false` never (`micro.heroesFlee`)\"},\"unitsFlee\":{\"$ref\":\"#/definitions/AiFlag%3C(boolean%7Cnumber)%3E\",\"description\":\"A unit leaves a fight under this share of its health: `true` at the share under it, `false` never (`micro.unitsFlee`)\"},\"groupsFlee\":{\"$ref\":\"#/definitions/AiFlag%3C(boolean%7Cnumber)%3E\",\"description\":\"A squad falls back from a fight away from home under these odds: `true` at the odds under it, `false` never (`squads.retreatAt`)\"},\"noMercy\":{\"$ref\":\"#/definitions/AiFlag%3C(boolean%7Cnumber)%3E\",\"description\":\"Attacks before its time when the enemy's army as last seen is weak against its own: at these odds (`true`: 0.75)\"},\"ignoreInjured\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"A unit that fled stays out until healed\"},\"removeInjuries\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"The hurt go home to heal between fights\"},\"takeItems\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Picks up what lies about\"},\"buyItems\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Its heroes buy from shops in reach\"},\"allowHomeChanges\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Builds its hall again where it can, once its home falls, rather than where it first stood: yes when left out\"},\"smartArtillery\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Siege units shoot buildings and stay behind their squad\"},\"randomPaths\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Each wave takes a way of its own to the target, by the brain's numbers: straight, or round one side or the other\"},\"rebuild\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Builds again what it lost\"},\"kite\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Ranged units step back from melee they outrun\"},\"workersFlee\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Workers a raid is on walk to a safe base\"},\"say\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Says its lines to its side (the team's `say`)\"},\"scout\":{\"$ref\":\"#/definitions/AiFlag%3Cboolean%3E\",\"description\":\"Sends a unit to look at the enemy (the scouting's goal)\"}},\"additionalProperties\":false,\"description\":\"The classic RTS behaviour flags, where the meaning holds, and the kit's own beside them: each a yes or no, a number where one says how much, or a function of the brain\"},\"AiFlag<boolean>\":{\"type\":\"boolean\",\"description\":\"A flag's value: as data, or worked out by the brain as it is asked (code, not kept in a save)\"},\"AiFlag<(boolean|number)>\":{\"type\":[\"boolean\",\"number\"],\"description\":\"A flag's value: as data, or worked out by the brain as it is asked (code, not kept in a save)\"},\"ThinkBudgetOptions\":{\"type\":\"object\",\"properties\":{\"modulesPerTick\":{\"type\":\"number\",\"description\":\"Modules of a brain a think may run in one tick: a think with more goes on at the next tick, over the same picture of the game. All of them in one tick when left out\"},\"unitsPerTick\":{\"type\":\"number\",\"description\":\"Units a tick's modules may look at, as the modules say (`ai.budget.spent(n)`): a module that walks the squads or the bases stops once the tick has looked at this many, and goes on at the next tick from where it was (`later`). No limit when left out. A module that says nothing of what it looks at is never stopped by it\"},\"warnAfterMs\":{\"anyOf\":[{\"type\":\"number\"},{\"type\":\"boolean\",\"const\":false}],\"description\":\"Milliseconds a module may take before the log says so (once a module, a warning): what to measure first. A module is never cut short for it. 4 when left out; `false` for never\"}},\"additionalProperties\":false,\"description\":\"How much of a think one tick may do (`AiOptions.budget`, `AiProfile.budget`, `ComputerSeatOptions.budget`), counted in work and never in milliseconds: the same on every machine, so that a game with a sliced think is the same game everywhere. Nothing is limited where a field is left out\"},\"AiHandicap\":{\"type\":\"object\",\"properties\":{\"income\":{\"type\":\"number\",\"description\":\"What its workers bring in, through the game's `beforeDeposit` hook\"},\"health\":{\"type\":\"number\",\"description\":\"The most health of everything it has, through a `stats` hook: the classic handicap\"},\"damage\":{\"type\":\"number\",\"description\":\"The damage it deals, before armour, through a `beforeDamage` hook\"},\"buildTime\":{\"type\":\"number\",\"description\":\"How long what it trains, builds and researches takes, through a `beforeProduce` hook: under 1 is sooner\"}},\"additionalProperties\":false,\"description\":\"What a computer is given beyond the rules (`AiProfile.handicap`): each a factor, 1 (or left out) for none\"},\"DataRules\":{\"type\":\"object\",\"properties\":{\"combat\":{\"type\":\"object\",\"properties\":{\"damageTable\":{\"$ref\":\"#/definitions/DamageTable\"}},\"additionalProperties\":false},\"supply\":{\"type\":\"object\",\"properties\":{\"max\":{\"type\":\"number\"},\"pools\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"max\":{\"type\":\"number\"}},\"required\":[\"name\",\"max\"],\"additionalProperties\":false}}},\"additionalProperties\":false},\"heroes\":{\"type\":\"object\",\"properties\":{\"maxHeroes\":{\"type\":\"number\"},\"maxHeroLevel\":{\"type\":\"number\"},\"xpRange\":{\"type\":\"number\"}},\"additionalProperties\":false},\"resources\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/ResourceDef\"}},\"upkeep\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/UpkeepTier\"}}},\"additionalProperties\":false,\"description\":\"The rules a `data.json` may say (campaign plan RC7), each over the game's: the damage table whole, the supply's and the heroes' numbers, the resources and the upkeep's tiers whole (in place of `GameModule.resources`, `upkeep`)\"},\"DamageTable\":{\"type\":\"object\",\"properties\":{\"attacks\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"armours\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"table\":{\"type\":\"array\",\"items\":{\"type\":\"array\",\"items\":{\"type\":\"number\"}}}},\"required\":[\"attacks\",\"armours\",\"table\"],\"additionalProperties\":false,\"description\":\"A damage table: what a hit of each attack type is multiplied by against each armour type (`GameRules.combat.damageTable`). `table[attack][armour]`, the rows the attacks in their order, the columns the armours in theirs\"},\"ResourceDef\":{\"type\":\"object\",\"properties\":{\"id\":{\"$ref\":\"#/definitions/ResourceKind\"},\"name\":{\"type\":\"string\"},\"start\":{\"type\":\"number\",\"description\":\"What every player starts a game with. Nothing when left out\"},\"upkeep\":{\"type\":\"boolean\",\"description\":\"What workers gather of it is cut by the upkeep of the army, see `UpkeepTier`\"}},\"required\":[\"id\",\"name\"],\"additionalProperties\":false,\"description\":\"Something players have amounts of and pay with, like gold, lumber or crystals. A game module lists its own\"},\"UpkeepTier\":{\"type\":\"object\",\"properties\":{\"above\":{\"type\":\"number\",\"description\":\"Applies when the player uses more supply than this\"},\"name\":{\"type\":\"string\"},\"income\":{\"type\":\"number\",\"description\":\"Part of what is gathered that still arrives, 0..1\"}},\"required\":[\"above\",\"name\",\"income\"],\"additionalProperties\":false,\"description\":\"A big army is paid for with income: past a certain supply, less arrives of what workers gather of the resources with `upkeep`\"},\"DataValues\":{\"type\":\"object\",\"additionalProperties\":{\"anyOf\":[{\"$ref\":\"#/definitions/DataValue\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/DataValue\"}},{\"$ref\":\"#/definitions/DataValues\"},{\"type\":\"array\",\"items\":{\"$ref\":\"#/definitions/DataValues\"}}]},\"description\":\"Values of a definition, as its own fields nest them: `{ stats: { health: 420 }, cost: { gold: 135 } }`. What a `data.json` keeps of each definition, and what `world.redefine` is given. A list of things by place (a unit's attacks) is written as a list or as its places (`{ attacks: { 0: { damagePoint: 0.5 } } }`), each over the thing there. A list of things changed whole (an ability's effects, the units a race's start adds: a `rows` field) written as places goes over the things there, and written as a list is the list: those things, in that order, each in full\"},\"DataValue\":{\"type\":[\"number\",\"string\",\"boolean\"],\"description\":\"What a field of the data can hold: a number, words, yes or no\"}}")
-};
-//#endregion
-//#region src/server/packs.ts
-/**
-* The packs of content of a server, read from their files (`packs/<id>/pack.json`) in the order named: that order is
-* the game's, as a page's `defineGame({ packs })` is
-*
-* @beta
-*/
-function readPacks(files) {
-	return files.map((file) => {
-		const text = readFileSync(file, "utf8");
-		const pack = packFromJson(text, file);
-		const wrong = checkPackSchema(JSON.parse(text), pack_schema_default);
-		if (wrong) throw new PackError(`${file}: ${wrong}`);
-		return pack;
-	});
-}
-/**
-* A server's game with its packs of content composed in (`readPacks`, `composeGame`): the game as is with none
-*
-* @beta
-*/
-function withPackFiles(game, files) {
-	return files.length ? composeGame(game, readPacks(files)) : game;
-}
-//#endregion
-export { Doorman, GameRooms, GameServer, Lobby, PLAYER_COLOR_NAMES, Seat, WatchRelay, againstTheRest, createRatings, generatedMode, looksOfSeats, mapMode, metricsText, nodeNavigationBuilder, racesOfSeats, ratedId, readPacks, seatLooksOf, seatSettingsOf, seatsOf, startServer, startSocketServer, withPackFiles };
-
-//# sourceMappingURL=server.js.map
+import { nodeNavigationBuilder } from "./server/navigation.js";
+import { createRatings, ratedId } from "./server/ratings.js";
+import { Doorman } from "./server/doorman.js";
+import { Seat } from "./server/seat.js";
+import { seatSettingsOf } from "./server/seatSettings.js";
+import { Lobby } from "./server/lobby.js";
+import { metricsText } from "./server/ops.js";
+import { startSocketServer } from "./server/websocket.js";
+import { GameServer } from "./server/gameServer.js";
+import { PLAYER_COLOR_NAMES, againstTheRest, generatedMode, looksOfSeats, mapMode, racesOfSeats, seatLooksOf, seatsOf } from "./server/mode.js";
+import { startServer } from "./server/start.js";
+import { GameRooms } from "./server/rooms.js";
+import { WatchRelay } from "./server/relay.js";
+import { mergePackFiles, readPacks } from "./server/packs.js";
+export { Doorman, GameRooms, GameServer, Lobby, PLAYER_COLOR_NAMES, Seat, WatchRelay, againstTheRest, createRatings, generatedMode, looksOfSeats, mapMode, mergePackFiles, metricsText, nodeNavigationBuilder, racesOfSeats, ratedId, readPacks, seatLooksOf, seatSettingsOf, seatsOf, startServer, startSocketServer };