@amxts/core 0.1.0 → 0.2.0

package/scripts/docs/as/facade.ts

@@ -102,7 +102,7 @@ export default {
 			unique within the plugin. \`fallback\` is the answer when the handler returns
 			nothing: \`0\` for most natives, \`1\` where the native expects the event handled.
 
-			Register from the \`"cfg"\` event, not at the top of the file: a console
+			Register from the \`"pluginsLoaded"\` event, not at the top of the file: a console
 			command registered that early (\`register_concmd\`, \`register_srvcmd\`) crashes
 			the server when typed.
 		`,
@@ -121,7 +121,7 @@ export default {
 			имя, уникальное в пределах плагина. \`fallback\` — ответ, если обработчик
 			ничего не вернул: \`0\` почти везде, \`1\` там, где натив ждёт обработанное событие.
 
-			Регистрируйте из события \`"cfg"\`, а не с верхнего уровня файла: консольная
+			Регистрируйте из события \`"pluginsLoaded"\`, а не с верхнего уровня файла: консольная
 			команда, зарегистрированная так рано (\`register_concmd\`, \`register_srvcmd\`),
 			роняет сервер, когда её вводят.
 		`,
@@ -375,8 +375,8 @@ export default {
 		ru: `Читает строковый аргумент, который широкий обработчик получил числом.`,
 	},
 	'cellsToString': {
-		en: `Reads the text a raw native from \`~/natives\` wrote into a cell array. \`stringToCells\` is the other way.`,
-		ru: `Читает текст, который сырой натив из \`~/natives\` записал в массив ячеек. Обратно — \`stringToCells\`.`,
+		en: `Reads the text a raw native from \`@amxts/core/natives\` wrote into a cell array. \`stringToCells\` is the other way.`,
+		ru: `Читает текст, который сырой натив из \`@amxts/core/natives\` записал в массив ячеек. Обратно — \`stringToCells\`.`,
 	},
 	'stringToCells': {
 		en: `Writes text into a cell array as a Pawn string, for a raw native.`,
@@ -384,7 +384,7 @@ export default {
 	},
 	'cells': {
 		en: `
-			Passes a string to a raw native from \`~/natives\` without declaring a
+			Passes a string to a raw native from \`@amxts/core/natives\` without declaring a
 			buffer for it:
 
 			  cfg_set_base_dir(cells("myplugin"));
@@ -393,7 +393,7 @@ export default {
 			arguments going in: a native that writes text back needs \`out()\`.
 		`,
 		ru: `
-			Передаёт строку сырому нативу из \`~/natives\` без объявления буфера под неё:
+			Передаёт строку сырому нативу из \`@amxts/core/natives\` без объявления буфера под неё:
 
 			  cfg_set_base_dir(cells("myplugin"));
 
@@ -522,6 +522,10 @@ export default {
 		en: `A Counter-Strike team, by the name the game gives it: one of \`"TERRORIST"\`, \`"CT"\`, \`"SPECTATOR"\`, \`"UNASSIGNED"\`.`,
 		ru: `Команда Counter-Strike под именем, которое даёт ей игра: одно из \`"TERRORIST"\`, \`"CT"\`, \`"SPECTATOR"\`, \`"UNASSIGNED"\`.`,
 	},
+	'AuthType': {
+		en: `The way a player's game proves who he is, as Reunion tells it, e.g. \`"steam"\` or \`"revEmu"\`; \`"unknown"\` on a server without Reunion.`,
+		ru: `Способ, которым игра игрока подтверждает, кто он, по словам Reunion, например \`"steam"\` или \`"revEmu"\`; \`"unknown"\` на сервере без Reunion.`,
+	},
 	'WeaponName': {
 		en: `A weapon a player can hold, by its class name, e.g. \`"weapon_ak47"\` or \`"weapon_knife"\`.`,
 		ru: `Оружие, которое может держать игрок, по имени класса, например \`"weapon_ak47"\` или \`"weapon_knife"\`.`,
@@ -530,36 +534,6 @@ export default {
 		en: `An item \`player.give\` hands over: a weapon, armour (\`"item_kevlar"\`, \`"item_assaultsuit"\`) or the defuse kit (\`"item_thighpack"\`).`,
 		ru: `Предмет, который выдаёт \`player.give\`: оружие, броня (\`"item_kevlar"\`, \`"item_assaultsuit"\`) или набор сапёра (\`"item_thighpack"\`).`,
 	},
-	'PlayerFilter': {
-		en: `
-			The filter of \`Player.all\`; every field is optional, e.g.
-			\`Player.all({ alive: true, team: "CT" })\`.
-		`,
-		ru: `
-			Фильтр \`Player.all\`; все поля необязательны, например
-			\`Player.all({ alive: true, team: "CT" })\`.
-		`,
-	},
-	'PlayerFilter.alive': {
-		en: `Only living players.`,
-		ru: `Только живые игроки.`,
-	},
-	'PlayerFilter.dead': {
-		en: `Only dead players.`,
-		ru: `Только мёртвые игроки.`,
-	},
-	'PlayerFilter.team': {
-		en: `Only players of this team, e.g. \`"CT"\`.`,
-		ru: `Только игроки этой команды, например \`"CT"\`.`,
-	},
-	'PlayerFilter.bots': {
-		en: `Only bots.`,
-		ru: `Только боты.`,
-	},
-	'PlayerFilter.humans': {
-		en: `Only people, no bots.`,
-		ru: `Только люди, без ботов.`,
-	},
 	'ModuleName': {
 		en: `An AMX Mod X module a plugin can check for, one of \`"reapi"\`, \`"cstrike"\`, \`"fun"\`, \`"hamsandwich"\`, \`"engine"\`, \`"fakemeta"\`.`,
 		ru: `Модуль AMX Mod X, наличие которого плагин может проверить, — одно из \`"reapi"\`, \`"cstrike"\`, \`"fun"\`, \`"hamsandwich"\`, \`"engine"\`, \`"fakemeta"\`.`,
@@ -586,25 +560,59 @@ export default {
 		en: `Keeps the player's frags: no penalty for the suicide.`,
 		ru: `Фраги игрока не меняются: штрафа за самоубийство нет.`,
 	},
+	'MoveOptions': {
+		en: `
+			One move of a bot, \`bot.move({ ... })\`: the speeds are units a second, as
+			a player's keys give them - \`250\` runs with a knife, \`-250\` backs away.
+		`,
+		ru: `
+			Один шаг бота, \`bot.move({ ... })\`: скорости — в единицах в секунду, как их
+			дают клавиши игрока: \`250\` — бег с ножом, \`-250\` — назад.
+		`,
+	},
+	'MoveOptions.forward': {
+		en: `Forward, or back when negative.`,
+		ru: `Вперёд, или назад, если число отрицательное.`,
+	},
+	'MoveOptions.side': {
+		en: `To the right, or to the left when negative.`,
+		ru: `Вправо, или влево, если число отрицательное.`,
+	},
+	'MoveOptions.up': {
+		en: `Up, or down when negative: swimming and climbing a ladder.`,
+		ru: `Вверх, или вниз, если число отрицательное: в воде и на лестнице.`,
+	},
+	'MoveOptions.buttons': {
+		en: `The buttons held during the move: \`["jump", "duck"]\`.`,
+		ru: `Кнопки, зажатые на время шага: \`["jump", "duck"]\`.`,
+	},
+	'MoveOptions.angles': {
+		en: `The direction the bot looks in, \`[pitch, yaw, roll]\` or a Vector; where it looks now when left out.`,
+		ru: `Направление взгляда бота, \`[pitch, yaw, roll]\` или Vector; если не задано — куда он смотрит сейчас.`,
+	},
+	'MoveOptions.msec': {
+		en: `The move's length in milliseconds, \`1\` to \`255\`; the server frame's time when left out.`,
+		ru: `Длительность шага в миллисекундах, от \`1\` до \`255\`; если не задано — время кадра сервера.`,
+	},
 	'Client': {
 		en: `
-			A connecting player, in \`"connect"\`, \`"authorized"\` and \`"putinserver"\`: name,
+			A connecting player, in \`"connect"\`, \`"authorized"\` and \`"putInServer"\`: name,
 			address, SteamID and team, but no health or weapons yet. Every Player is a
 			Client too.
 
 			\`\`\`ts
-			server.addEventListener("putinserver", (event) => {
+			server.addEventListener("putInServer", (event) => {
 				print(event.player, \`Welcome, \${event.player.name}!\`);
 			});
 			\`\`\`
 		`,
 		ru: `
-			Подключающийся игрок — в \`"connect"\`, \`"authorized"\` и \`"putinserver"\`: имя,
+			Подключающийся игрок — в \`"connect"\`, \`"authorized"\` и \`"putInServer"\`: имя,
 			адрес, SteamID и команда, но ещё без здоровья и оружия. Любой Player — тоже
 			Client.
 
 			\`\`\`ts
-			server.addEventListener("putinserver", (event) => {
+			server.addEventListener("putInServer", (event) => {
 				print(event.player, \`Welcome, \${event.player.name}!\`);
 			});
 			\`\`\`
@@ -622,9 +630,21 @@ export default {
 		en: `The player's IP address without the port, e.g. \`"192.168.0.10"\`.`,
 		ru: `IP-адрес игрока без порта, например \`"192.168.0.10"\`.`,
 	},
-	'Client.authid': {
-		en: `The player's SteamID, e.g. \`"STEAM_0:1:12345"\`. A bot has \`"BOT"\`, HLTV has \`"HLTV"\`; until Steam confirms the player it is \`"STEAM_ID_PENDING"\` (wait for the \`"authorized"\` event), and on a LAN server \`"STEAM_ID_LAN"\`.`,
-		ru: `SteamID игрока, например \`"STEAM_0:1:12345"\`. У бота — \`"BOT"\`, у HLTV — \`"HLTV"\`; пока Steam не подтвердил игрока — \`"STEAM_ID_PENDING"\` (дождитесь события \`"authorized"\`), на LAN-сервере — \`"STEAM_ID_LAN"\`.`,
+	'Client.steamId': {
+		en: `The player's SteamID, e.g. \`"STEAM_0:1:12345"\`. A bot has \`"BOT"\`, HLTV has \`"HLTV"\`; until Steam confirms the player it is \`"STEAM_ID_PENDING"\` (wait for the \`"authorized"\` event), and on a LAN server \`"STEAM_ID_LAN"\`. With Reunion a game without Steam gets one made from its key (\`authKey\`): \`"STEAM_..."\` or \`"VALVE_..."\`, as the server's Reunion settings say.`,
+		ru: `SteamID игрока, например \`"STEAM_0:1:12345"\`. У бота — \`"BOT"\`, у HLTV — \`"HLTV"\`; пока Steam не подтвердил игрока — \`"STEAM_ID_PENDING"\` (дождитесь события \`"authorized"\`), на LAN-сервере — \`"STEAM_ID_LAN"\`. С Reunion игра без Steam получает SteamID, сделанный из её ключа (\`authKey\`): \`"STEAM_..."\` или \`"VALVE_..."\`, как скажут настройки Reunion на сервере.`,
+	},
+	'Client.authType': {
+		en: `The way the player's game proved who he is, as Reunion tells it: one of \`"steam"\` (a Steam game), \`"steamEmu"\`, \`"revEmu"\`, \`"revEmu2013"\`, \`"oldRevEmu"\`, \`"sc2009"\`, \`"avsmp"\`, \`"sxei"\`, \`"sse3"\` (a game without Steam, by the emulator it proved itself with), \`"dproto"\`, \`"hltv"\`, or \`"unknown"\` on a server without Reunion.`,
+		ru: `Способ, которым игра игрока подтвердила, кто он, по словам Reunion: одно из \`"steam"\` (игра из Steam), \`"steamEmu"\`, \`"revEmu"\`, \`"revEmu2013"\`, \`"oldRevEmu"\`, \`"sc2009"\`, \`"avsmp"\`, \`"sxei"\`, \`"sse3"\` (игра без Steam — по эмулятору, которым она подтвердила себя), \`"dproto"\`, \`"hltv"\` или \`"unknown"\` на сервере без Reunion.`,
+	},
+	'Client.protocol': {
+		en: `The network protocol of the player's game: \`48\` for today's game, \`47\` for an old one Reunion lets in. \`0\` on a server without Reunion.`,
+		ru: `Сетевой протокол игры игрока: \`48\` у нынешней игры, \`47\` у старой, которую пускает Reunion. \`0\` на сервере без Reunion.`,
+	},
+	'Client.authKey': {
+		en: `The key the player's game proved itself with, as Reunion read it: what his SteamID is made from. \`""\` on a server without Reunion.`,
+		ru: `Ключ, которым игра игрока подтвердила себя, как его прочитал Reunion: из него сделан SteamID игрока. \`""\` на сервере без Reunion.`,
 	},
 	'Client.isBot': {
 		en: `\`true\` for a bot.`,
@@ -635,8 +655,8 @@ export default {
 		ru: `\`true\`, пока игрок на сервере.`,
 	},
 	'Client.access': {
-		en: `The player's admin rights, from the letters in \`users.ini\`: \`client.access.includes("Cvar")\`.`,
-		ru: `Права админа у игрока — по буквам из \`users.ini\`: \`client.access.includes("Cvar")\`.`,
+		en: `The player's admin rights, from the letters in \`users.ini\`: \`client.access.includes("cvar")\`.`,
+		ru: `Права админа у игрока — по буквам из \`users.ini\`: \`client.access.includes("cvar")\`.`,
 	},
 	'Client.team': {
 		en: `The player's team, one of \`"TERRORIST"\`, \`"CT"\`, \`"SPECTATOR"\` or \`"UNASSIGNED"\` (until the player joins a team). Setting it moves the player, as \`player.team\` does.`,
@@ -679,36 +699,17 @@ export default {
 			A player in the game: everything a Client has, plus health, armor, frags,
 			weapons and the screen.
 
-			An event about a player gives one as \`event.player\`; \`Player.all()\`
+			An event about a player gives one as \`event.player\`; \`server.players\`
 			lists everyone on the server.
 		`,
 		ru: `
 			Игрок в игре: всё, что есть у Client, а также здоровье, броня, фраги,
 			оружие и экран.
 
-			Событие об игроке передаёт его как \`event.player\`; \`Player.all()\`
+			Событие об игроке передаёт его как \`event.player\`; \`server.players\`
 			возвращает всех на сервере.
 		`,
 	},
-	'Player.all': {
-		en: `
-			The players on the server: \`Player.all({ alive: true })\`.
-
-			Every field narrows: \`{ bots: true }\` is bots only, \`{ humans: true }\`
-			people only. Without a filter, everyone connected, never an HLTV proxy.
-
-			Pawn: \`get_players\`
-		`,
-		ru: `
-			Игроки на сервере: \`Player.all({ alive: true })\`.
-
-			Каждое поле сужает выборку: \`{ bots: true }\` — только боты,
-			\`{ humans: true }\` — только люди. Без фильтра — все подключённые, кроме
-			HLTV-прокси.
-
-			Pawn: \`get_players\`
-		`,
-	},
 	'Player.name': {
 		en: `
 			The player's name.
@@ -796,18 +797,54 @@ export default {
 			Pawn: \`get_user_ip\`
 		`,
 	},
-	'Player.authid': {
+	'Player.steamId': {
 		en: `
-			The player's SteamID, e.g. \`"STEAM_0:1:12345"\`. A bot has \`"BOT"\`, HLTV has \`"HLTV"\`; until Steam confirms the player it is \`"STEAM_ID_PENDING"\` (wait for the \`"authorized"\` event), and on a LAN server \`"STEAM_ID_LAN"\`.
+			The player's SteamID, e.g. \`"STEAM_0:1:12345"\`. A bot has \`"BOT"\`, HLTV has \`"HLTV"\`; until Steam confirms the player it is \`"STEAM_ID_PENDING"\` (wait for the \`"authorized"\` event), and on a LAN server \`"STEAM_ID_LAN"\`. With Reunion a game without Steam gets one made from its key (\`authKey\`): \`"STEAM_..."\` or \`"VALVE_..."\`, as the server's Reunion settings say.
 
 			Pawn: \`get_user_authid\`
 		`,
 		ru: `
-			SteamID игрока, например \`"STEAM_0:1:12345"\`. У бота — \`"BOT"\`, у HLTV — \`"HLTV"\`; пока Steam не подтвердил игрока — \`"STEAM_ID_PENDING"\` (дождитесь события \`"authorized"\`), на LAN-сервере — \`"STEAM_ID_LAN"\`.
+			SteamID игрока, например \`"STEAM_0:1:12345"\`. У бота — \`"BOT"\`, у HLTV — \`"HLTV"\`; пока Steam не подтвердил игрока — \`"STEAM_ID_PENDING"\` (дождитесь события \`"authorized"\`), на LAN-сервере — \`"STEAM_ID_LAN"\`. С Reunion игра без Steam получает SteamID, сделанный из её ключа (\`authKey\`): \`"STEAM_..."\` или \`"VALVE_..."\`, как скажут настройки Reunion на сервере.
 
 			Pawn: \`get_user_authid\`
 		`,
 	},
+	'Player.authType': {
+		en: `
+			The way the player's game proved who he is, as Reunion tells it: one of \`"steam"\` (a Steam game), \`"steamEmu"\`, \`"revEmu"\`, \`"revEmu2013"\`, \`"oldRevEmu"\`, \`"sc2009"\`, \`"avsmp"\`, \`"sxei"\`, \`"sse3"\` (a game without Steam, by the emulator it proved itself with), \`"dproto"\`, \`"hltv"\`, or \`"unknown"\` on a server without Reunion.
+
+			Pawn: \`REU_GetAuthtype\`
+		`,
+		ru: `
+			Способ, которым игра игрока подтвердила, кто он, по словам Reunion: одно из \`"steam"\` (игра из Steam), \`"steamEmu"\`, \`"revEmu"\`, \`"revEmu2013"\`, \`"oldRevEmu"\`, \`"sc2009"\`, \`"avsmp"\`, \`"sxei"\`, \`"sse3"\` (игра без Steam — по эмулятору, которым она подтвердила себя), \`"dproto"\`, \`"hltv"\` или \`"unknown"\` на сервере без Reunion.
+
+			Pawn: \`REU_GetAuthtype\`
+		`,
+	},
+	'Player.protocol': {
+		en: `
+			The network protocol of the player's game: \`48\` for today's game, \`47\` for an old one Reunion lets in. \`0\` on a server without Reunion.
+
+			Pawn: \`REU_GetProtocol\`
+		`,
+		ru: `
+			Сетевой протокол игры игрока: \`48\` у нынешней игры, \`47\` у старой, которую пускает Reunion. \`0\` на сервере без Reunion.
+
+			Pawn: \`REU_GetProtocol\`
+		`,
+	},
+	'Player.authKey': {
+		en: `
+			The key the player's game proved itself with, as Reunion read it: what his SteamID is made from. \`""\` on a server without Reunion.
+
+			Pawn: \`REU_GetAuthKey\`
+		`,
+		ru: `
+			Ключ, которым игра игрока подтвердила себя, как его прочитал Reunion: из него сделан SteamID игрока. \`""\` на сервере без Reunion.
+
+			Pawn: \`REU_GetAuthKey\`
+		`,
+	},
 	'Player.isAlive': {
 		en: `
 			\`true\` while the player is alive.
@@ -888,7 +925,8 @@ export default {
 			Joins a side the way the game joins a player who picks it in the team
 			menu, appearance picked for him: \`player.joinTeam("CT")\`. A player who
 			has just arrived is in the game after it and can spawn, which
-			\`player.team = ...\` does not do for him. \`false\` if the game refused.
+			\`player.team = ...\` does not do for him. A living player sent to the
+			spectators dies quietly: no death, no frag. \`false\` if the game refused.
 
 			Pawn: \`rg_join_team\`
 		`,
@@ -896,7 +934,8 @@ export default {
 			Вводит игрока в сторону так, как игра вводит того, кто выбрал её в меню
 			команд, а внешность выбирается за него: \`player.joinTeam("CT")\`. Только
 			что пришедший игрок после этого в игре и может появиться, чего
-			\`player.team = ...\` для него не делает. \`false\`, если игра отказала.
+			\`player.team = ...\` для него не делает. Живой игрок, отправленный в
+			зрители, тихо умирает: без смерти и без фрага. \`false\`, если игра отказала.
 
 			Pawn: \`rg_join_team\`
 		`,
@@ -1086,13 +1125,13 @@ export default {
 	'Player.access': {
 		en: `
 			The player's admin rights, from the letters in \`users.ini\`:
-			\`player.access.includes("Cvar")\`.
+			\`player.access.includes("cvar")\`.
 
 			Pawn: \`get_user_flags\`
 		`,
 		ru: `
 			Права админа у игрока — по буквам из \`users.ini\`:
-			\`player.access.includes("Cvar")\`.
+			\`player.access.includes("cvar")\`.
 
 			Pawn: \`get_user_flags\`
 		`,
@@ -1160,23 +1199,19 @@ export default {
 	'playerIds': {
 		en: `
 			The ids of the players on the server, as an array. \`flags\`: \`"a"\` living,
-			\`"b"\` dead, \`"c"\` no bots, \`"h"\` no HLTV, \`"e"\` only \`team\`. \`Player.all\` does the
-			same with readable options.
+			\`"b"\` dead, \`"c"\` no bots, \`"h"\` no HLTV, \`"e"\` only \`team\`. \`server.players\` is
+			everyone, as players, to filter as an array.
 
 			Pawn: \`get_players\`
 		`,
 		ru: `
 			\`id\` игроков на сервере в виде массива. \`flags\`: \`"a"\` живые, \`"b"\` мёртвые,
-			\`"c"\` без ботов, \`"h"\` без HLTV, \`"e"\` только \`team\`. \`Player.all\` делает то
-			же с понятными полями.
+			\`"c"\` без ботов, \`"h"\` без HLTV, \`"e"\` только \`team\`. \`server.players\` — все,
+			как игроки, их фильтруют как массив.
 
 			Pawn: \`get_players\`
 		`,
 	},
-	'CommandHandler': {
-		en: `A command's handler: gets the player who typed it and the words after the command's name.`,
-		ru: `Обработчик команды: получает игрока, который её набрал, и слова после имени команды.`,
-	},
 	'CommandOptions': {
 		en: `The options of a command: who may use it and its description in a listing.`,
 		ru: `Параметры команды: кому она доступна и её описание в списке.`,
@@ -1186,27 +1221,23 @@ export default {
 		ru: `Право админа, которое нужно игроку для команды; если не указано, команда доступна всем.`,
 	},
 	'CommandOptions.description': {
-		en: `The command's description, shown by \`amx_help\` and the like.`,
-		ru: `Описание команды, которое показывают \`amx_help\` и подобные.`,
+		en: `The command's description, shown by \`amx_help\` and in \`server.commands\`.`,
+		ru: `Описание команды, которое показывают \`amx_help\` и \`server.commands\`.`,
 	},
 	'accessOf': {
 		en: `
 			Converts \`users.ini\` letters to rights: \`accessOf("abc")\` is
-			[\`"Immunity"\`, \`"Reservation"\`, \`"Kick"\`]. An unknown letter is skipped.
+			[\`"immunity"\`, \`"reservation"\`, \`"kick"\`]. An unknown letter is skipped.
 
 			Pawn: \`read_flags\`
 		`,
 		ru: `
 			Переводит буквы из \`users.ini\` в права: \`accessOf("abc")\` —
-			[\`"Immunity"\`, \`"Reservation"\`, \`"Kick"\`]. Неизвестные буквы пропускаются.
+			[\`"immunity"\`, \`"reservation"\`, \`"kick"\`]. Неизвестные буквы пропускаются.
 
 			Pawn: \`read_flags\`
 		`,
 	},
-	'ServerCommandHandler': {
-		en: `A server command's handler: gets the words after the command's name.`,
-		ru: `Обработчик серверной команды: получает слова после имени команды.`,
-	},
 	'HudOptions': {
 		en: `
 			The look of a HUD message. Every field has a default, so
@@ -1356,8 +1387,8 @@ export default {
 			or a text, as the message wrote it.
 
 			\`\`\`ts
-			server.addEventListener("message:TeamScore", (event) => {
-			  console.log(\`\${event.args.text(0)} \${event.args.number(1)}\`);
+			server.addMessageListener("botProgress", (event) => {
+			  console.log(\`\${event.args.length} \${event.args.number(0)}\`);
 			});
 			\`\`\`
 
@@ -1368,8 +1399,8 @@ export default {
 			записало сообщение.
 
 			\`\`\`ts
-			server.addEventListener("message:TeamScore", (event) => {
-			  console.log(\`\${event.args.text(0)} \${event.args.number(1)}\`);
+			server.addMessageListener("botProgress", (event) => {
+			  console.log(\`\${event.args.length} \${event.args.number(0)}\`);
 			});
 			\`\`\`
 
@@ -1406,14 +1437,15 @@ export default {
 			HUD icon - heard on its way, before it leaves:
 
 			\`\`\`ts
-			server.addEventListener("message:TextMsg", (event) => {
+			server.addMessageListener("text", (event) => {
 			  if (event.text == "#Round_Draw") event.preventDefault();
 			});
 			\`\`\`
 
-			A message the editor knows has typed fields (\`event.text\`); every one has
-			its arguments in \`event.args\`. Writing a field changes what the client
-			gets.
+			A message whose layout is known has a typed field for each argument
+			(\`event.text\`), and writing one changes what the client gets; a message
+			without a known layout is read by place, through \`event.args\`, which
+			every message has.
 
 			Pawn: \`register_message\`
 		`,
@@ -1422,21 +1454,22 @@ export default {
 			HUD, — услышанное по пути, до того как оно ушло:
 
 			\`\`\`ts
-			server.addEventListener("message:TextMsg", (event) => {
+			server.addMessageListener("text", (event) => {
 			  if (event.text == "#Round_Draw") event.preventDefault();
 			});
 			\`\`\`
 
-			У сообщения, которое знает редактор, есть типизированные поля
-			(\`event.text\`); аргументы любого — в \`event.args\`. Запись поля меняет то,
-			что получит клиент.
+			У сообщения с известной раскладкой на каждый аргумент есть типизированное
+			поле (\`event.text\`), и запись в него меняет то, что получит клиент;
+			сообщение без известной раскладки читается по месту, через \`event.args\`,
+			которые есть у любого сообщения.
 
 			Pawn: \`register_message\`
 		`,
 	},
 	'ClientMessage.name': {
-		en: `The message's name, e.g. \`"TextMsg"\`.`,
-		ru: `Имя сообщения, например \`"TextMsg"\`.`,
+		en: `The game's name of the message, e.g. \`"TextMsg"\` for \`text\`.`,
+		ru: `Имя сообщения у игры, например \`"TextMsg"\` у \`text\`.`,
 	},
 	'ClientMessage.player': {
 		en: `The player the message goes to; \`null\` for a message to everyone.`,
@@ -1542,6 +1575,14 @@ export default {
 		en: `The shake's frequency, in jolts a second; \`5\` by default.`,
 		ru: `Частота тряски — толчков в секунду; по умолчанию \`5\`.`,
 	},
+	'ProgressBarOptions': {
+		en: `The options of \`player.screen.progressBar\`.`,
+		ru: `Параметры \`player.screen.progressBar\`.`,
+	},
+	'ProgressBarOptions.startPercent': {
+		en: `The bar's fill at the start, in percent; \`0\`, empty, by default.`,
+		ru: `Заполненность полосы в начале, в процентах; по умолчанию \`0\` — пустая.`,
+	},
 	'StatusIconState': {
 		en: `A status icon's state, one of \`"hide"\`, \`"show"\` (lit) or \`"flash"\`.`,
 		ru: `Состояние иконки статуса, одно из: \`"hide"\` — убрана, \`"show"\` — горит, \`"flash"\` — мигает.`,
@@ -1557,7 +1598,8 @@ export default {
 			player.screen.statusIcon("dmg_cold", "show", [0, 160, 255]);
 			\`\`\`
 
-			Times are in seconds.
+			Times are in seconds. A message listener hears what the screen sends, as
+			it hears the game's: \`"progressBar"\` hears \`progressBar(seconds)\`.
 
 			Pawn: \`ScreenFade\`, \`ScreenShake\`, \`StatusIcon\`, ...
 		`,
@@ -1571,7 +1613,8 @@ export default {
 			player.screen.statusIcon("dmg_cold", "show", [0, 160, 255]);
 			\`\`\`
 
-			Время — в секундах.
+			Время — в секундах. Обработчик сообщений слышит то, что шлёт экран, как
+			слышит сообщения игры: \`"progressBar"\` слышит \`progressBar(seconds)\`.
 
 			Pawn: \`ScreenFade\`, \`ScreenShake\`, \`StatusIcon\`, ...
 		`,
@@ -1673,15 +1716,25 @@ export default {
 	'Screen.progressBar': {
 		en: `
 			Shows the progress bar in the middle of the player's screen, filling up
-			over \`seconds\`; \`0\` hides it.
+			over \`seconds\`; \`0\` hides it. With \`startPercent\` it starts part of the
+			way full and fills the rest of \`seconds\`:
 
-			Pawn: \`BarTime\`, \`rg_send_bartime\`
+			\`\`\`ts
+			player.screen.progressBar(4, { startPercent: 50 });   // half full, full in 2 seconds
+			\`\`\`
+
+			Pawn: \`BarTime\`, \`BarTime2\`, \`rg_send_bartime\`, \`rg_send_bartime2\`
 		`,
 		ru: `
 			Показывает полосу прогресса посреди экрана игрока, которая заполняется за
-			\`seconds\` секунд; \`0\` её убирает.
+			\`seconds\` секунд; \`0\` её убирает. С \`startPercent\` она начинается уже
+			частично заполненной и заполняет остаток \`seconds\`:
+
+			\`\`\`ts
+			player.screen.progressBar(4, { startPercent: 50 });   // наполовину полна, заполнится за 2 секунды
+			\`\`\`
 
-			Pawn: \`BarTime\`, \`rg_send_bartime\`
+			Pawn: \`BarTime\`, \`BarTime2\`, \`rg_send_bartime\`, \`rg_send_bartime2\`
 		`,
 	},
 	'PlayerChangeEvent': {
@@ -1690,7 +1743,7 @@ export default {
 			plugin, TypeScript or Pawn:
 
 			\`\`\`ts
-			server.addEventListener("playerchange", (event) => {
+			server.addEventListener("playerChange", (event) => {
 			  print(event.player, event.value ? "You are protected" : "Your spawn protection is over");
 			}, { field: "spawnProtected" });
 			\`\`\`
@@ -1704,7 +1757,7 @@ export default {
 			записал любой плагин, на TypeScript или Pawn:
 
 			\`\`\`ts
-			server.addEventListener("playerchange", (event) => {
+			server.addEventListener("playerChange", (event) => {
 			  print(event.player, event.value ? "You are protected" : "Your spawn protection is over");
 			}, { field: "spawnProtected" });
 			\`\`\`
@@ -1728,12 +1781,12 @@ export default {
 	},
 	'ServerListenerOptions.field': {
 		en: `
-			For \`"playerchange"\`: the field listened for, e.g. \`"spawnProtected"\`, or
+			For \`"playerChange"\`: the field listened for, e.g. \`"spawnProtected"\`, or
 			an object field's member, \`"glow.enabled"\`; an object field's name
 			hears each of its members. Left out, every field.
 		`,
 		ru: `
-			Для \`"playerchange"\`: поле, которое слушают, например \`"spawnProtected"\`,
+			Для \`"playerChange"\`: поле, которое слушают, например \`"spawnProtected"\`,
 			или член поля-объекта, \`"glow.enabled"\`; имя поля-объекта слышит
 			каждый его член. Без него — любое поле.
 		`,
@@ -1852,7 +1905,7 @@ export default {
 			the folders AMX Mod X keeps. Used through \`server\`:
 
 			\`\`\`ts
-			server.addEventListener("putinserver", (event) => {
+			server.addEventListener("putInServer", (event) => {
 			  print(event.player, "Welcome!");      // event is a PutinserverEvent
 			});
 			server.map;                             // "de_dust2"
@@ -1869,7 +1922,7 @@ export default {
 			AMX Mod X. Используется через \`server\`:
 
 			\`\`\`ts
-			server.addEventListener("putinserver", (event) => {
+			server.addEventListener("putInServer", (event) => {
 			  print(event.player, "Welcome!");      // event — это PutinserverEvent
 			});
 			server.map;                             // "de_dust2"
@@ -1884,20 +1937,60 @@ export default {
 	},
 	'Server.addEventListener': {
 		en: `
-			Calls \`listener\` every time the server raises the event \`type\` - or,
-			for \`"message:<Name>"\`, every time it sends that message to a client.
-			\`"playerchange"\` takes the field it is for: \`{ field: "spawnProtected" }\`.
+			Calls \`listener\` every time the server raises the event \`type\`.
+			\`"playerChange"\` takes the field it is for: \`{ field: "spawnProtected" }\`.
 		`,
 		ru: `
-			Вызывает \`listener\` каждый раз, когда сервер поднимает событие \`type\`, —
-			или, для \`"message:<Name>"\`, каждый раз, когда он шлёт это сообщение клиенту.
-			\`"playerchange"\` принимает поле, для которого он: \`{ field: "spawnProtected" }\`.
+			Вызывает \`listener\` каждый раз, когда сервер поднимает событие \`type\`.
+			\`"playerChange"\` принимает поле, для которого он: \`{ field: "spawnProtected" }\`.
 		`,
 	},
 	'Server.removeEventListener': {
 		en: `Stops calling a listener added with \`addEventListener\` - the same function and the same options.`,
 		ru: `Перестаёт вызывать обработчик, добавленный через \`addEventListener\`, — ту же функцию с теми же настройками.`,
 	},
+	'Server.addMessageListener': {
+		en: `
+			Calls \`listener\` every time the server sends the message \`name\` to a
+			client, before it leaves: the listener reads its fields, changes them, or
+			stops it with \`preventDefault()\`.
+
+			\`\`\`ts
+			server.addMessageListener("death", (event) => {
+			  if (event.headshot) console.log(\`\${event.killer?.name} - headshot - \${event.victim?.name}\`);
+			});
+			\`\`\`
+
+			The editor lists the names, each with the game's own one in its words:
+			\`death\` is the game's \`DeathMsg\`. A name may hear a few of the game's
+			messages that are one thing: \`progressBar\` is \`BarTime\` and
+			\`BarTime2\`, and \`event.name\` says which one came.
+
+			Pawn: \`register_message\`
+		`,
+		ru: `
+			Вызывает \`listener\` каждый раз, когда сервер шлёт клиенту сообщение
+			\`name\`, до того как оно ушло: обработчик читает его поля, меняет их или
+			останавливает его через \`preventDefault()\`.
+
+			\`\`\`ts
+			server.addMessageListener("death", (event) => {
+			  if (event.headshot) console.log(\`\${event.killer?.name} - headshot - \${event.victim?.name}\`);
+			});
+			\`\`\`
+
+			Редактор подсказывает имена, и в описании каждого — собственное имя у игры:
+			\`death\` — это \`DeathMsg\` игры. Одно имя может слышать несколько
+			сообщений игры, которые означают одно и то же: \`progressBar\` — это
+			\`BarTime\` и \`BarTime2\`, а \`event.name\` говорит, какое из них пришло.
+
+			Pawn: \`register_message\`
+		`,
+	},
+	'Server.removeMessageListener': {
+		en: `Stops calling a listener added with \`addMessageListener\` - the same name and the same function.`,
+		ru: `Перестаёт вызывать обработчик, добавленный через \`addMessageListener\`, — то же имя и ту же функцию.`,
+	},
 	'Server.map': {
 		en: `
 			The current map's name, e.g. \`"de_dust2"\`.
@@ -1922,6 +2015,60 @@ export default {
 			Pawn: \`get_maxplayers\`
 		`,
 	},
+	'Server.players': {
+		en: `
+			The players on the server, every one connected - never an HLTV proxy -
+			read anew each time. Narrow them with the array's \`filter\`:
+
+			\`\`\`ts
+			const alive = server.players.filter(player => player.isAlive);
+			const cts = server.players.filter(player => player.team === "CT" && !player.isBot);
+			\`\`\`
+
+			Pawn: \`get_players\`
+		`,
+		ru: `
+			Игроки на сервере, все подключённые, кроме HLTV-прокси; читается заново
+			при каждом обращении. Выборку сужает \`filter\` массива:
+
+			\`\`\`ts
+			const alive = server.players.filter(player => player.isAlive);
+			const cts = server.players.filter(player => player.team === "CT" && !player.isBot);
+			\`\`\`
+
+			Pawn: \`get_players\`
+		`,
+	},
+	'Server.addBot': {
+		en: `
+			Adds a bot under \`name\`: a player the server runs, with no game behind
+			it and no mind of its own - it stands where it spawns until a plugin
+			moves it with \`bot.move()\`. \`null\` when no slot is free. \`"putInServer"\`
+			fires for it as for anyone, \`bot.isBot\` is \`true\` and \`bot.kick()\`
+			removes it.
+
+			\`\`\`ts
+			const bot = server.addBot("Dummy");
+			bot?.joinTeam("CT");
+			\`\`\`
+
+			Pawn: \`engfunc(EngFunc_CreateFakeClient)\`, \`dllfunc(DLLFunc_ClientConnect)\`, \`dllfunc(DLLFunc_ClientPutInServer)\`
+		`,
+		ru: `
+			Добавляет бота с именем \`name\`: игрока, которого ведёт сервер, — без игры за
+			ним и без своего разума: он стоит, где появился, пока плагин не двинет его
+			через \`bot.move()\`. \`null\`, если свободного слота нет. \`"putInServer"\`
+			срабатывает для него, как для любого, \`bot.isBot\` равно \`true\`, а
+			\`bot.kick()\` убирает его.
+
+			\`\`\`ts
+			const bot = server.addBot("Dummy");
+			bot?.joinTeam("CT");
+			\`\`\`
+
+			Pawn: \`engfunc(EngFunc_CreateFakeClient)\`, \`dllfunc(DLLFunc_ClientConnect)\`, \`dllfunc(DLLFunc_ClientPutInServer)\`
+		`,
+	},
 	'Server.configsDir': {
 		en: `
 			The AMX Mod X configs folder, relative to the game folder, as \`fs\` takes it:
@@ -1970,65 +2117,6 @@ export default {
 			Pawn: \`server_cmd\`
 		`,
 	},
-	'Server.addCommand': {
-		en: `
-			Adds a command players type, e.g. \`"/hp"\` in chat, or a name without the slash
-			in the console.
-
-			\`\`\`ts
-			server.addCommand("/hp", (player) => print(player, \`\${player.health} HP\`));
-			server.addCommand("/kick", kick, { access: "Kick", description: "Kick a player" });
-			\`\`\`
-
-			\`args\` are the words after the command. A chat command is not repeated in
-			chat, and it does not run for a player without the \`access\` right.
-			\`"say time"\` runs when a player writes exactly \`"time"\` in chat.
-
-			Pawn: \`register_clcmd\`
-		`,
-		ru: `
-			Добавляет команду, которую набирают игроки, например \`"/hp"\` в чате или имя без
-			слеша — в консоли.
-
-			\`\`\`ts
-			server.addCommand("/hp", (player) => print(player, \`\${player.health} HP\`));
-			server.addCommand("/kick", kick, { access: "Kick", description: "Kick a player" });
-			\`\`\`
-
-			\`args\` — слова после команды. Чат-команда не повторяется в чате и не
-			срабатывает у игрока без права \`access\`. \`"say time"\` срабатывает, когда
-			игрок пишет в чат ровно \`"time"\`.
-
-			Pawn: \`register_clcmd\`
-		`,
-	},
-	'Server.addServerCommand': {
-		en: `
-			Adds a command of the server console - typed there, sent over rcon or run by
-			another plugin. Players cannot use it.
-
-			\`\`\`ts
-			server.addServerCommand("myplugin_reset", (args) => reset(args.length > 0 ? args[0] : "all"));
-			\`\`\`
-
-			\`args\` are the words after the command. It may be added at the top level of
-			the file.
-
-			Pawn: \`register_srvcmd\`
-		`,
-		ru: `
-			Добавляет команду консоли сервера — набранную там, пришедшую по rcon или
-			вызванную другим плагином. Игроки её не набирают.
-
-			\`\`\`ts
-			server.addServerCommand("myplugin_reset", (args) => reset(args.length > 0 ? args[0] : "all"));
-			\`\`\`
-
-			\`args\` — слова после команды. Её можно добавлять на верхнем уровне файла.
-
-			Pawn: \`register_srvcmd\`
-		`,
-	},
 	'Server.showHud': {
 		en: `Shows a HUD message to every player, with the same options as \`player.showHud\`.`,
 		ru: `Показывает HUD-сообщение всем игрокам, с теми же настройками, что у \`player.showHud\`.`,
@@ -2069,7 +2157,7 @@ export default {
 			  if (event.player.isBot) event.preventDefault();
 			});
 			game.addEventListener("canPlayerHearPlayer", (event) => event.listener.team == event.sender.team);
-			game.addEventListener("flPlayerFallDamage", (event) => event.result / 2, true);
+			game.addEventListener("fallDamage", (event) => event.result / 2, true);
 			\`\`\`
 
 			The event's type follows from its name. What a listener returns is the
@@ -2078,7 +2166,7 @@ export default {
 			nothing leaves it to the game; \`event.preventDefault()\` blocks without an
 			answer. A value of the wrong type is an error in the editor and in the build.
 
-			The game rules are its fields: \`game.freezePeriod\`, \`game.numCtWins\`,
+			The game rules are its fields: \`game.isFreezeTime\`, \`game.ctWins\`,
 			\`game.roundWinner\`.
 
 			Pawn: \`RegisterHookChain\`, \`RegisterHam\`, \`get_member_game\`
@@ -2092,7 +2180,7 @@ export default {
 			  if (event.player.isBot) event.preventDefault();
 			});
 			game.addEventListener("canPlayerHearPlayer", (event) => event.listener.team == event.sender.team);
-			game.addEventListener("flPlayerFallDamage", (event) => event.result / 2, true);
+			game.addEventListener("fallDamage", (event) => event.result / 2, true);
 			\`\`\`
 
 			Тип события следует из его имени. То, что возвращает обработчик, — ответ
@@ -2101,7 +2189,7 @@ export default {
 			игре; \`event.preventDefault()\` блокирует без ответа. Значение не того типа —
 			ошибка и в редакторе, и при сборке.
 
-			Правила игры — её поля: \`game.freezePeriod\`, \`game.numCtWins\`,
+			Правила игры — её поля: \`game.isFreezeTime\`, \`game.ctWins\`,
 			\`game.roundWinner\`.
 
 			Pawn: \`RegisterHookChain\`, \`RegisterHam\`, \`get_member_game\`
@@ -2216,8 +2304,8 @@ export default {
 		`,
 	},
 	'ActionOptions': {
-		en: `The options of an entity's action such as \`weapon.deploy()\` or \`entity.takeHealth(...)\`.`,
-		ru: `Настройки действия сущности, такого как \`weapon.deploy()\` или \`entity.takeHealth(...)\`.`,
+		en: `The options of an entity's action such as \`weapon.deploy()\` or \`entity.heal(...)\`.`,
+		ru: `Настройки действия сущности, такого как \`weapon.deploy()\` или \`entity.heal(...)\`.`,
 	},
 	'ActionOptions.hooks': {
 		en: `
@@ -2704,7 +2792,7 @@ export default {
 	'Call': {
 		en: `
 			A call of a Pawn native with a \`...\` tail, built one argument at a time -
-			the low-level way. A native from \`~/natives\` is an ordinary function and
+			the low-level way. A native from \`@amxts/core/natives\` is an ordinary function and
 			needs none of this.
 
 			  new Call(NATIVE_server_print).str("%s").str(text).run();
@@ -2722,7 +2810,7 @@ export default {
 		`,
 		ru: `
 			Вызов Pawn-натива с хвостом \`...\`, собираемый по одному аргументу, —
-			низкоуровневый способ. Натив из \`~/natives\` — обычная функция, и ему это
+			низкоуровневый способ. Натив из \`@amxts/core/natives\` — обычная функция, и ему это
 			не нужно.
 
 			  new Call(NATIVE_server_print).str("%s").str(text).run();
@@ -2792,6 +2880,54 @@ export default {
 		en: `The value the native left in the \`ref\` argument at this position, after \`run\`.`,
 		ru: `Значение, которое натив оставил в аргументе \`ref\` на этой позиции, после \`run\`.`,
 	},
+	'Call.count': {
+		en: `The number of arguments added so far: the position the next one takes.`,
+		ru: `Число уже добавленных аргументов: позиция, которую займёт следующий.`,
+	},
+	'Call.textInto': {
+		en: `
+			Adds room for text the native writes, in a \`...\` tail, holding \`text\` to
+			begin with; its length follows by address, as \`ret[], len\` wants it.
+			After \`run\` the text is in \`cellsAt\` of this position.
+		`,
+		ru: `
+			Добавляет в хвост \`...\` место для текста, который пишет натив, с \`text\`
+			в начале; его длина идёт следом по адресу, как того ждёт \`ret[], len\`.
+			После \`run\` текст — в \`cellsAt\` этой позиции.
+		`,
+	},
+	'Call.cellsAt': {
+		en: `The cells at the address of the argument at this position, after \`run\`: a vector or text the native wrote.`,
+		ru: `Ячейки по адресу аргумента на этой позиции, после \`run\`: вектор или текст, который записал натив.`,
+	},
+	'Ref': {
+		en: `
+			A value a native writes back through its argument, where Pawn passes a
+			variable for the native to fill: text into \`ret[], len\`, a number into
+			\`&value\`. Give it where the native takes one; after the call, \`value\` is
+			what the native wrote.
+
+			\`\`\`ts
+			const reason = new Ref("");
+			if (!dllfunc(DLLFunc_ClientConnect, id, "Bot", "127.0.0.1", reason)) console.log(reason.value);
+			\`\`\`
+		`,
+		ru: `
+			Значение, которое натив возвращает через свой аргумент там, где Pawn
+			передаёт переменную, чтобы натив её заполнил: текст в \`ret[], len\`, число
+			в \`&value\`. Передайте его туда, где натив его ждёт; после вызова \`value\` —
+			то, что записал натив.
+
+			\`\`\`ts
+			const reason = new Ref("");
+			if (!dllfunc(DLLFunc_ClientConnect, id, "Bot", "127.0.0.1", reason)) console.log(reason.value);
+			\`\`\`
+		`,
+	},
+	'Ref.value': {
+		en: `The value the native wrote; before the call, the one it starts with.`,
+		ru: `Значение, которое записал натив; до вызова — то, с которого он начинает.`,
+	},
 	'Call.run': {
 		en: `Calls the native with the arguments added so far and returns its result.`,
 		ru: `Вызывает натив с добавленными аргументами и возвращает его результат.`,
@@ -2907,6 +3043,62 @@ export default {
 			задаёт \`amxts.config.ts\`. Глобальная; \`import { defineModule } from "@amxts/core"\` тоже работает.
 		`,
 	},
+	'callingPlugin': {
+		en: `
+			The plugin whose call the module runs now, as a number: what the module
+			keeps for that plugin - a menu it made, a function it gave - is marked with
+			it, and dropped when \`onPluginStop()\` gives the same number. \`0\` when no
+			other plugin's call runs: the module's own plugin, its natives for Pawn
+			plugins, its events and timers.
+
+			\`\`\`ts
+			export function addRule(test: Rule) {
+				rules.push({ test, from: callingPlugin() });
+			}
+			\`\`\`
+		`,
+		ru: `
+			Плагин, чей вызов модуль выполняет сейчас, — числом: то, что модуль хранит
+			для этого плагина, — созданное им меню, переданную им функцию, — помечается
+			этим числом и убирается, когда \`onPluginStop()\` даёт то же число. \`0\`, когда
+			вызова другого плагина нет: собственный плагин модуля, его нативы для
+			Pawn-плагинов, его события и таймеры.
+
+			\`\`\`ts
+			export function addRule(test: Rule) {
+				rules.push({ test, from: callingPlugin() });
+			}
+			\`\`\`
+		`,
+	},
+	'onPluginStop': {
+		en: `
+			Calls \`listener\` when a plugin that called the module stops - unloaded,
+			reloaded, or its load failed - with the number \`callingPlugin()\` gave
+			during its calls. The module drops what that plugin gave it: a reloaded
+			plugin is a new one, which gives everything again, and a function of the
+			one that stopped answers nothing.
+
+			\`\`\`ts
+			onPluginStop((plugin) => {
+				rules = rules.filter(rule => rule.from != plugin);
+			});
+			\`\`\`
+		`,
+		ru: `
+			Вызывает \`listener\`, когда останавливается плагин, вызывавший модуль, —
+			выгружен, перезагружен или не загрузился, — с числом, которое давал
+			\`callingPlugin()\` во время его вызовов. Модуль убирает то, что этот плагин
+			ему дал: перезагруженный плагин — новый, он даёт всё заново, а функция
+			остановленного ничего не отвечает.
+
+			\`\`\`ts
+			onPluginStop((plugin) => {
+				rules = rules.filter(rule => rule.from != plugin);
+			});
+			\`\`\`
+		`,
+	},
 	'ForwardStop': {
 		en: `
 			The forward's stopping rule, one of: \`"never"\` - every plugin hears it, whatever it
@@ -3299,4 +3491,312 @@ export default {
 			Pawn: \`show_menu\`, \`register_menucmd\`
 		`,
 	},
+	'MenuColor': {
+		en: `A colour of a menu's item numbers: a menu's colour tag, \`"!y"\`, \`"!r"\`, \`"!d"\` or \`"!w"\`.`,
+		ru: `Цвет номеров пунктов меню: цветовой тег меню, \`"!y"\`, \`"!r"\`, \`"!d"\` или \`"!w"\`.`,
+	},
+	'MenuOptions': {
+		en: `The options of a \`Menu\`: its pages and the texts of its own items.`,
+		ru: `Настройки \`Menu\`: его страницы и тексты его собственных пунктов.`,
+	},
+	'MenuOptions.perPage': {
+		en: `
+			Items on a page, \`7\` at most: Back, More and Exit go below them. \`0\`
+			puts every item on one page, without Back and More - \`10\` at most.
+
+			Pawn: \`MPROP_PERPAGE\`
+		`,
+		ru: `
+			Пунктов на странице, не больше \`7\`: под ними идут «Назад», «Дальше» и «Выход».
+			\`0\` ставит все пункты на одну страницу, без «Назад» и «Дальше», — не больше \`10\`.
+
+			Pawn: \`MPROP_PERPAGE\`
+		`,
+	},
+	'MenuOptions.exit': {
+		en: `
+			Whether the menu has an Exit item; \`true\` by default.
+
+			Pawn: \`MPROP_EXIT\`
+		`,
+		ru: `
+			Есть ли у меню пункт «Выход»; по умолчанию \`true\`.
+
+			Pawn: \`MPROP_EXIT\`
+		`,
+	},
+	'MenuOptions.backText': {
+		en: `
+			The Back item's text; AMX Mod X's \`"Back"\`, in the player's language, by default.
+
+			Pawn: \`MPROP_BACKNAME\`
+		`,
+		ru: `
+			Текст пункта «Назад»; по умолчанию \`"Back"\` AMX Mod X на языке игрока.
+
+			Pawn: \`MPROP_BACKNAME\`
+		`,
+	},
+	'MenuOptions.nextText': {
+		en: `
+			The More item's text; AMX Mod X's \`"More"\` by default.
+
+			Pawn: \`MPROP_NEXTNAME\`
+		`,
+		ru: `
+			Текст пункта «Дальше»; по умолчанию \`"More"\` AMX Mod X.
+
+			Pawn: \`MPROP_NEXTNAME\`
+		`,
+	},
+	'MenuOptions.exitText': {
+		en: `
+			The Exit item's text; AMX Mod X's \`"Exit"\` by default.
+
+			Pawn: \`MPROP_EXITNAME\`
+		`,
+		ru: `
+			Текст пункта «Выход»; по умолчанию \`"Exit"\` AMX Mod X.
+
+			Pawn: \`MPROP_EXITNAME\`
+		`,
+	},
+	'MenuOptions.numberColor': {
+		en: `
+			The colour of the item numbers; \`"!r"\`, red, by default.
+
+			Pawn: \`MPROP_NUMBER_COLOR\`
+		`,
+		ru: `
+			Цвет номеров пунктов; по умолчанию \`"!r"\`, красный.
+
+			Pawn: \`MPROP_NUMBER_COLOR\`
+		`,
+	},
+	'MenuContext': {
+		en: `The context a menu's functions get: the player it is shown to, the menu and the data it was shown with.`,
+		ru: `Контекст, который получают функции меню: игрок, которому оно показано, само меню и данные, с которыми его показали.`,
+	},
+	'MenuContext.player': {
+		en: `The player the menu is shown to.`,
+		ru: `Игрок, которому показано меню.`,
+	},
+	'MenuContext.menu': {
+		en: `The menu itself: \`menu.show(player, data)\` keeps it open after a choice.`,
+		ru: `Само меню: \`menu.show(player, data)\` оставляет его открытым после выбора.`,
+	},
+	'MenuContext.data': {
+		en: `The data \`show\` was given.`,
+		ru: `Данные, которые получил \`show\`.`,
+	},
+	'MenuItemOptions': {
+		en: `An item of a \`Menu\`: its title, when it is shown and can be chosen, and what choosing it does.`,
+		ru: `Пункт \`Menu\`: его заголовок, когда он показан и доступен и что делает его выбор.`,
+	},
+	'MenuItemOptions.title': {
+		en: `The item's text - or a function that gives it for the player it is shown to.`,
+		ru: `Текст пункта — или функция, которая даёт его для игрока, которому он показан.`,
+	},
+	'MenuItemOptions.enabled': {
+		en: `Whether the player can choose it; one he cannot is drawn grey and does nothing. \`true\` by default.`,
+		ru: `Может ли игрок его выбрать; недоступный рисуется серым и ничего не делает. По умолчанию \`true\`.`,
+	},
+	'MenuItemOptions.visible': {
+		en: `Whether it is shown at all; a hidden item takes no place. \`true\` by default.`,
+		ru: `Показан ли он вообще; скрытый пункт не занимает места. По умолчанию \`true\`.`,
+	},
+	'MenuItemOptions.onSelect': {
+		en: `The item's action, run when the player chooses it. The menu closes, unless this shows it again.`,
+		ru: `Действие пункта, которое выполняется, когда игрок его выбирает. Меню закрывается, если эта функция не покажет его снова.`,
+	},
+	'Menu': {
+		en: `
+			A menu of AMX Mod X's own: items a player picks with the number keys, on
+			pages with Back and More, and Exit. \`Data\` is what it is shown with, which
+			its functions get beside the player.
+
+			\`\`\`ts
+			interface ShopData {
+			  category: string;
+			}
+
+			const shop = new Menu<ShopData>("!yShop");
+			shop.addItem({
+			  title: "Armor - $1000",
+			  enabled: ({ player }) => player.armor < 100,
+			  onSelect: ({ player }) => {
+			    player.armor = 100;
+			  },
+			});
+			shop.show(player, { category: "armor" });
+			\`\`\`
+
+			The title and each item's title, \`visible\` and \`enabled\` are asked at
+			every \`show\`, for that player. Colour tags as in \`showMenu\`: \`!y\` yellow,
+			\`!r\` red, \`!d\` grey, \`!w\` white, \`!R\` to the right edge.
+
+			Pawn: \`menu_create\`, \`menu_setprop\`
+		`,
+		ru: `
+			Меню самого AMX Mod X: пункты, которые игрок выбирает цифровыми клавишами,
+			на страницах с «Назад» и «Дальше», и «Выход». \`Data\` — то, с чем его
+			показывают; это получают его функции рядом с игроком.
+
+			\`\`\`ts
+			interface ShopData {
+			  category: string;
+			}
+
+			const shop = new Menu<ShopData>("!yShop");
+			shop.addItem({
+			  title: "Armor - $1000",
+			  enabled: ({ player }) => player.armor < 100,
+			  onSelect: ({ player }) => {
+			    player.armor = 100;
+			  },
+			});
+			shop.show(player, { category: "armor" });
+			\`\`\`
+
+			Заголовок и у каждого пункта заголовок, \`visible\` и \`enabled\` вычисляются
+			при каждом \`show\`, для этого игрока. Цветовые теги — как в \`showMenu\`: \`!y\`
+			жёлтый, \`!r\` красный, \`!d\` серый, \`!w\` белый, \`!R\` — к правому краю.
+
+			Pawn: \`menu_create\`, \`menu_setprop\`
+		`,
+	},
+	'Menu.addItem': {
+		en: `
+			Adds an item: its title, when it is shown and can be chosen, and what
+			choosing it does.
+
+			\`\`\`ts
+			shop.addItem({
+			  title: ({ player }) => \`Heal (\${player.health} HP)\`,
+			  visible: ({ player }) => player.isAlive,
+			  enabled: ({ player }) => player.health < 100,
+			  onSelect: ({ player }) => {
+			    player.health = 100;
+			  },
+			});
+			\`\`\`
+
+			Pawn: \`menu_additem\`
+		`,
+		ru: `
+			Добавляет пункт: его заголовок, когда он показан и доступен и что делает
+			его выбор.
+
+			\`\`\`ts
+			shop.addItem({
+			  title: ({ player }) => \`Heal (\${player.health} HP)\`,
+			  visible: ({ player }) => player.isAlive,
+			  enabled: ({ player }) => player.health < 100,
+			  onSelect: ({ player }) => {
+			    player.health = 100;
+			  },
+			});
+			\`\`\`
+
+			Pawn: \`menu_additem\`
+		`,
+	},
+	'Menu.show': {
+		en: `
+			Shows the menu to a player, with the data its functions get; it closes
+			when he chooses an item or leaves it.
+
+			Pawn: \`menu_display\`
+		`,
+		ru: `
+			Показывает меню игроку, с данными, которые получают его функции; оно
+			закрывается, когда он выбирает пункт или выходит из меню.
+
+			Pawn: \`menu_display\`
+		`,
+	},
+	'Client.kick': {
+		en: `Kicks the player off the server, with the reason he is shown: \`client.kick("Spam")\`.`,
+		ru: `Кикает игрока с сервера с причиной, которую он видит: \`client.kick("Спам")\`.`,
+	},
+	'Player.kick': {
+		en: `
+			Kicks the player off the server, with the reason he is shown:
+			\`player.kick("Spam")\`; without one, the game's own.
+
+			Pawn: \`server_cmd("kick #%d")\`
+		`,
+		ru: `
+			Кикает игрока с сервера с причиной, которую он видит:
+			\`player.kick("Спам")\`; без неё — собственной причиной игры.
+
+			Pawn: \`server_cmd("kick #%d")\`
+		`,
+	},
+	'Player.move': {
+		en: `
+			Moves a bot \`server.addBot\` made, as a player's keys and mouse would for
+			one frame: \`bot.move({ forward: 250, buttons: ["jump"] })\`. A bot does
+			nothing by itself, so it is moved every frame - in the \`"frame"\` event -
+			or it stands still. A player who is not a bot is refused with an error.
+
+			Pawn: \`engfunc(EngFunc_RunPlayerMove, ...)\`
+		`,
+		ru: `
+			Двигает бота, созданного \`server.addBot\`, как клавиши и мышь игрока за один
+			кадр: \`bot.move({ forward: 250, buttons: ["jump"] })\`. Сам бот ничего не
+			делает, поэтому его двигают каждый кадр — в событии \`"frame"\`, — иначе он
+			стоит на месте. Игрока, который не бот, метод отклоняет с ошибкой.
+
+			Pawn: \`engfunc(EngFunc_RunPlayerMove, ...)\`
+		`,
+	},
+	'CommandInfo': {
+		en: `A command the plugin added, as \`server.commands\` lists it: what a \`/help\` shows.`,
+		ru: `Команда, которую добавил плагин, как её перечисляет \`server.commands\`: то, что показывает \`/help\`.`,
+	},
+	'CommandInfo.usage': {
+		en: `The command's usage, as it is typed, e.g. \`"/kick <target> [reason]"\`.`,
+		ru: `Использование команды, как её набирают, например \`"/kick <target> [reason]"\`.`,
+	},
+	'CommandInfo.description': {
+		en: `The command's description, as its \`description\` option gave it; \`""\` without one.`,
+		ru: `Описание команды, как его дала настройка \`description\`; \`""\`, если описания нет.`,
+	},
+	'CommandInfo.access': {
+		en: `The admin right the command needs; \`null\` when everyone may use it.`,
+		ru: `Право админа, которое нужно команде; \`null\`, если пользоваться ей может каждый.`,
+	},
+	'CommandInfo.server': {
+		en: `Whether it is a command of the server console rather than a player's.`,
+		ru: `Команда ли это консоли сервера, а не игрока.`,
+	},
+	'Server.commands': {
+		en: `
+			The commands this plugin added, players' and the server's, in the order
+			they were added: each one's \`usage\`, \`description\` and \`access\` - what a
+			\`/help\` prints.
+
+			\`\`\`ts
+			server.addCommand("/help", ({ player }) => {
+			  for (const command of server.commands) {
+			    if (command.access == null || player.access.includes(command.access)) print(player, command.usage);
+			  }
+			});
+			\`\`\`
+		`,
+		ru: `
+			Команды, которые добавил этот плагин, игроков и сервера, в порядке
+			добавления: у каждой \`usage\`, \`description\` и \`access\` — то, что
+			печатает \`/help\`.
+
+			\`\`\`ts
+			server.addCommand("/help", ({ player }) => {
+			  for (const command of server.commands) {
+			    if (command.access == null || player.access.includes(command.access)) print(player, command.usage);
+			  }
+			});
+			\`\`\`
+		`,
+	},
 };