v8scli 0.4.0 → 0.4.1

package/README.md

@@ -10,7 +10,7 @@ one (the scaffolded project has it as a devDependency).
 npx v8scli init my_mod     # scaffold a new mod in ./my_mod
 cd my_mod && npm install
 
-npx v8scli build           # bundle + dist/my_mod.vjs_c для теста на своём сервере
+npx v8scli build           # bundle + dist/my_mod.vjs_c for testing on your own server
 npx v8scli login           # portal url + api token (dpt_...)
 npx v8scli upload          # pack sources, create a version on the portal
 npx v8scli status          # versions + review status

package/bin/v8s.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// v8scli — CLI разработчика модов. Команды: init, build, login, upload, status, deps.
+// v8scli — the mod developer CLI. Commands: see `usage` below.
 import { init } from '../src/commands/init.js';
 import { build } from '../src/commands/build.js';
 import { login } from '../src/commands/login.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "v8scli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "CLI for building and publishing V8 point_script mods (companion of v8_scripting)",
   "license": "MIT",
   "type": "module",

package/src/commands/add.js

@@ -5,10 +5,10 @@ import { api, readConfig, readManifest } from '../common.js';
 import { deps } from './deps.js';
 
 /**
- * v8scli add <slug>[@version] — подключить библиотеку точным пином релиза.
- * Без версии берётся последний published; typings скачиваются сразу.
+ * v8scli add <slug>[@version] — adds a library pinned to an exact release.
+ * Without a version, the latest published release is used; typings are downloaded right away.
  *
- * v8scli update [slug] — поднять пин(ы) до последнего published-релиза.
+ * v8scli update [slug] — bumps the pin(s) to the latest published release.
  */
 
 async function resolveLibrary(config, slug) {
@@ -75,7 +75,7 @@ export async function remove(args) {
   raw.dependencies = dependencies;
   await writeFile('mod.json', `${JSON.stringify(raw, null, 2)}\n`);
 
-  // тайпинги больше не нужны
+  // the typings are no longer needed
   await rm(join('.v8s_types', `${slug}.d.ts`), { force: true });
 
   console.log(`removed: ${removed}`);

package/src/commands/build.js

@@ -3,14 +3,14 @@ import { join } from 'node:path';
 import { readManifest } from '../common.js';
 import { ensureGenerated, typecheck } from '../typegen.js';
 
-// Локальная самопроверка: тот же контракт, что на портале —
-// только файлы мода + SDK, cs_script/point_script остаётся external.
+// Local self-check with the same contract as on the portal:
+// only mod files + the SDK; cs_script/point_script stays external.
 export async function build() {
   const esbuild = await import('esbuild');
   const manifest = await readManifest();
   const disallowed = new Set();
 
-  // apiVersion 2: ключи мода — типами из mod.json, и сборка без проверки типов не идёт
+  // apiVersion 2: mod keys are typed from mod.json, and there is no build without a typecheck
   if (await ensureGenerated(manifest))
     typecheck();
 
@@ -28,7 +28,7 @@ export async function build() {
         build.onResolve({ filter: /.*/ }, (args) => {
           if (args.path === 'cs_script/point_script') return { path: args.path, external: true };
           if (args.path.startsWith('.') || args.path.startsWith('/')) return null;
-          if (args.path === 'v8_scripting' || args.path.startsWith('v8_scripting/')) return null; // SDK из node_modules
+          if (args.path === 'v8_scripting' || args.path.startsWith('v8_scripting/')) return null; // SDK from node_modules
           disallowed.add(args.path);
           return { path: args.path, external: true };
         });
@@ -45,14 +45,14 @@ export async function build() {
   const jsOut = join('dist', `${manifest.slug}.js`);
   await writeFile(jsOut, bundle);
 
-  // .vjs_c рядом с бандлом: его можно сразу положить на свой сервер в
-  // addons/scripts_dev и проверить мод, не дожидаясь сборки на портале
+  // .vjs_c next to the bundle: it can go straight into addons/scripts_dev on your
+  // own server to test the mod without waiting for the portal build
   const { buildVjsC } = await import('../vjs.js');
   const resource = buildVjsC(bundle);
   const resourceOut = join('dist', `${manifest.slug}.vjs_c`);
   await writeFile(resourceOut, resource);
 
   console.log(`ok: ${jsOut} (${bundle.length} bytes)`);
-  console.log(`ok: ${resourceOut} (${resource.length} bytes) — для локального теста: положить в game/csgo/addons/scripts_dev/`);
-  console.log('релизный артефакт портал собирает сам из исходников');
+  console.log(`ok: ${resourceOut} (${resource.length} bytes) — for local testing, put it in game/csgo/addons/scripts_dev/`);
+  console.log('the release artifact is built by the portal from the sources');
 }

package/src/commands/deps.js

@@ -2,9 +2,9 @@ import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { api, readConfig, readManifest } from '../common.js';
 
-// Скачивает typings модов-библиотек из dependencies в ./.v8s_types/<slug>.d.ts.
-// Рантайм-объект библиотеки берётся через Instance.GetInterface("<slug>") —
-// typings дают только типы для import type.
+// Downloads the typings of library mods from dependencies into ./.v8s_types/<slug>.d.ts.
+// The library's runtime object is obtained via Instance.GetInterface("<slug>") —
+// typings only provide types for import type.
 export async function deps() {
   const config = await readConfig();
   const manifest = await readManifest();

package/src/commands/init.js

@@ -7,8 +7,8 @@ const CLI_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
 const TEMPLATES = join(CLI_ROOT, 'templates');
 
 /**
- * Пути до локальных чекаутов SDK и CLI для режима --local (пакеты ещё не в npm).
- * SDK ищем в V8S_LOCAL_SDK, иначе рядом с CLI (dev_portal/sdk).
+ * Paths to local SDK and CLI checkouts for --local mode (changes not yet published to npm).
+ * The SDK is taken from V8S_LOCAL_SDK, otherwise from next to the CLI (dev_portal/sdk).
  */
 async function resolveLocalPackages() {
   const sdk = process.env.V8S_LOCAL_SDK ?? join(CLI_ROOT, '..', 'sdk');
@@ -33,13 +33,13 @@ export async function init(args) {
   await mkdir(dir, { recursive: true });
   await cp(TEMPLATES, dir, { recursive: true });
 
-  // подстановка slug в шаблоны
+  // substitute the slug into the templates
   for (const file of ['mod.json', 'package.json']) {
     const path = join(dir, file);
     await writeFile(path, (await readFile(path, 'utf-8')).replaceAll('__SLUG__', slug));
   }
 
-  // локальный режим: SDK и CLI ставятся из чекаутов (file:), реестр не нужен
+  // local mode: the SDK and CLI are installed from checkouts (file:), no registry needed
   if (local) {
     const path = join(dir, 'package.json');
     const manifest = JSON.parse(await readFile(path, 'utf-8'));

package/src/commands/login.js

@@ -1,7 +1,7 @@
 import { createInterface } from 'node:readline/promises';
 import { api, readConfig, writeConfig, CONFIG_PATH } from '../common.js';
 
-// v8scli login [portalUrl] [token] — с аргументами работает без интерактива (CI-friendly).
+// v8scli login [portalUrl] [token] — with arguments it runs non-interactively (CI-friendly).
 export async function login(args = []) {
   const config = await readConfig();
   let [portalUrl, token] = args;
@@ -22,7 +22,7 @@ export async function login(args = []) {
   if (!token?.startsWith('dpt_')) throw new Error('token must start with dpt_');
 
   const next = { portalUrl, token };
-  await api(next, '/api/registry/health'); // живость портала (и basic auth из url)
+  await api(next, '/api/registry/health'); // checks that the portal is reachable (and basic auth from the url)
   await writeConfig(next);
   console.log(`saved to ${CONFIG_PATH}`);
 }

package/src/commands/mod.js

@@ -3,14 +3,14 @@ import { basename, extname } from 'node:path';
 import { api, readConfig, readManifest } from '../common.js';
 
 /**
- * Жизненный цикл мода из CLI: создать, описать, дать картинки, отправить.
+ * Mod lifecycle from the CLI: create, describe, add images, submit.
  *
- * До этого создание и оформление жили только в веб-панели, и написать мод
- * целиком из редактора было нельзя — приходилось прерываться на браузер.
- * Все команды работают по API-токену.
+ * Previously, creating a mod and filling in its page was only possible in the web panel, so a mod
+ * could not be made entirely from the editor — you had to switch to the browser.
+ * All commands work with an API token.
  */
 
-/** modId по slug из mod.json; вызывающему нужен и сам манифест */
+/** modId by the slug from mod.json; the caller needs the manifest itself as well */
 async function resolveMod(config, manifest) {
   const { mods } = await api(config, '/api/mods/my');
   const mod = mods.find((m) => m.slug === manifest.slug);
@@ -18,7 +18,7 @@ async function resolveMod(config, manifest) {
   return mod;
 }
 
-/** Последняя версия мода — с ней работают submit и release */
+/** The mod's latest version — the one submit and release work with */
 async function latestVersion(config, modId) {
   const { versions } = await api(config, `/api/mods/${modId}`);
   if (!versions?.length) throw new Error('no versions uploaded yet — run `v8scli upload` first');
@@ -39,7 +39,7 @@ async function uploadImage(config, modId, path, kind) {
   console.log(`${kind}: ${kind === 'icon' ? mod.iconUrl : mod.coverUrl}`);
 }
 
-/** v8scli create — заводит мод на портале по mod.json текущей папки */
+/** v8scli create — registers the mod on the portal from mod.json in the current folder */
 export async function create(args) {
   const config = await readConfig();
   const manifest = await readManifest();
@@ -105,14 +105,14 @@ export async function cover(args) {
   await uploadImage(config, mod.id, args[0], 'cover');
 }
 
-/** v8scli submit — последнюю загруженную версию на дев-проверку */
+/** v8scli submit — sends the latest uploaded version to dev review */
 export async function submit() {
   const config = await readConfig();
   const mod = await resolveMod(config, await readManifest());
   const version = await latestVersion(config, mod.id);
 
-  // У разработчиков команды загрузка сразу даёт dev_ready — отправлять нечего,
-  // и это нормальный исход, а не ошибка: сценарий «залил и тестирую» не ломается
+  // For team developers, an upload goes straight to dev_ready — there is nothing to submit,
+  // and that is a normal outcome, not an error: the "upload and test" flow keeps working
   if (version.status === 'dev_ready') {
     console.log(`${version.version}: already dev_ready — ready to test in your lobby`);
     return;
@@ -127,14 +127,14 @@ export async function submit() {
     body: JSON.stringify({ action: 'submit_dev' }),
   });
 
-  // У разработчиков команды дев-ревью пропускается, и версия сразу dev_ready
+  // For team developers, dev review is skipped and the version goes straight to dev_ready
   console.log(`${moved.version}: ${moved.status}`);
   console.log(moved.status === 'dev_ready'
     ? 'ready to test in your lobby'
     : 'sent to review');
 }
 
-/** v8scli release "заметки к релизу" — публикация версии в прод */
+/** v8scli release "release notes" — publishes the version to prod */
 export async function release(args) {
   const config = await readConfig();
   const mod = await resolveMod(config, await readManifest());
@@ -156,7 +156,7 @@ export async function release(args) {
   console.log(`${moved.version}: ${moved.status} — waiting for an admin to publish it`);
 }
 
-/** v8scli whoami — чей это токен и можно ли им работать */
+/** v8scli whoami — whose token this is and whether it can be used */
 export async function whoami() {
   const config = await readConfig();
   const { developer } = await api(config, '/api/developers/me');

package/src/commands/pull.js

@@ -8,11 +8,11 @@ import { api, apiBinary, readConfig } from '../common.js';
 const TEMPLATES = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'templates');
 
 /**
- * v8scli pull <slug> — скачивает исходники последней версии мода с портала.
+ * v8scli pull <slug> — downloads the sources of the mod's latest version from the portal.
  *
- * В папке существующего мода (mod.json с тем же slug) обновляет исходники
- * на месте; иначе создаёт ./<slug> с полной обвязкой проекта (package.json,
- * tsconfig из шаблона) — «git clone» для мода одной командой.
+ * In the folder of an existing mod (mod.json with the same slug), it updates the sources
+ * in place; otherwise it creates ./<slug> with the full project setup (package.json,
+ * tsconfig from the template) — a one-command "git clone" for a mod.
  */
 export async function pull(args) {
   const slug = args[0];
@@ -32,7 +32,7 @@ export async function pull(args) {
   const archive = await apiBinary(
     config, `/api/mods/${mod.id}/versions/${latest.id}/sources`);
 
-  // куда разворачивать: текущая папка, если это уже этот мод, иначе ./<slug>
+  // where to extract: the current folder if it already is this mod, otherwise ./<slug>
   let target = process.cwd();
   let created = false;
 

package/src/commands/search.js

@@ -1,6 +1,6 @@
 import { api, readConfig } from '../common.js';
 
-/** v8scli search [query] — публичный каталог библиотек портала */
+/** v8scli search [query] — the portal's public library catalog */
 export async function search(args) {
   const config = await readConfig();
   const query = encodeURIComponent(args.join(' ').trim());

package/src/commands/upload.js

@@ -2,8 +2,8 @@ import { readFile, writeFile } from 'node:fs/promises';
 import { api, readConfig, readManifest } from '../common.js';
 import { ensureGenerated, typecheck } from '../typegen.js';
 
-// Пакует исходники (mod.json + src/ + typings) и создаёт версию на портале.
-// Финальный артефакт собирает сам портал — загружаются только исходники.
+// Packs the sources (mod.json + src/ + typings) and creates a version on the portal.
+// The portal builds the final artifact itself — only the sources are uploaded.
 async function packSources(manifest) {
   const tar = await import('tar');
 
@@ -24,8 +24,8 @@ async function packSources(manifest) {
   return archive;
 }
 
-// Портал требует версию строго выше последней загруженной. Если локальная не выше
-// (забыли поднять после прошлой загрузки) — поднимаем patch сами и пишем в mod.json.
+// The portal requires a version strictly higher than the last uploaded one. If the local one is not higher
+// (not bumped after the previous upload), bump the patch here and write it to mod.json.
 async function bumpVersion(manifest, lastVersion) {
   const [major, minor, patch] = lastVersion.split('.').map((part) => parseInt(part, 10));
   const next = `${major}.${minor}.${patch + 1}`;
@@ -42,11 +42,11 @@ export async function upload() {
   const config = await readConfig();
   const manifest = await readManifest();
 
-  // Сгенерированные типы — часть исходников: портал собирает мод с тем же модулем, что и build
+  // The generated types are part of the sources: the portal builds the mod with the same module as build
   if (await ensureGenerated(manifest))
     typecheck();
 
-  // modId по slug
+  // modId by slug
   const { mods } = await api(config, '/api/mods/my');
   const mod = mods.find((m) => m.slug === manifest.slug);
   if (!mod)

package/src/common.js

@@ -31,11 +31,11 @@ export async function readManifest(dir = process.cwd()) {
 }
 
 /**
- * Авторизованный запрос к порталу.
- * API-токен уходит в X-Api-Token: заголовок Authorization может быть занят
- * basic auth стенда (дев за traefik) — его CLI берёт из user:pass в portalUrl.
+ * Authenticated request to the portal.
+ * The API token goes in X-Api-Token: the Authorization header may already be taken by
+ * the environment's basic auth (dev behind traefik) — the CLI takes it from user:pass in portalUrl.
  */
-/** Как api(), но возвращает Buffer — для скачивания архивов исходников */
+/** Like api(), but returns a Buffer — for downloading source archives */
 export async function apiBinary(config, path) {
   if (!config.portalUrl) throw new Error('not logged in — run `v8scli login` first');
   const url = new URL(config.portalUrl);

package/src/typegen.js

@@ -3,16 +3,16 @@ import { readFile, writeFile } from 'node:fs/promises';
 import { spawnSync } from 'node:child_process';
 import { dirname, join } from 'node:path';
 
-// Типы ключей мода из mod.json — API apiVersion 2 (v8_scripting/access).
+// Mod key types from mod.json — the apiVersion 2 API (v8_scripting/access).
 //
-// Мод спрашивает у платформы разрешения, персональные значения и настройки сервера по ключам из
-// манифеста. Чтобы опечатка в ключе или чтение player-ключа как настройки сервера ловились при сборке,
-// а не в игре, CLI пишет рядом с entry модуль с типами и готовыми access / commands. Файл —
-// часть исходников: его пакует upload, и портал собирает мод с ним же.
+// A mod asks the platform for permissions, per-player values and server settings by keys from the
+// manifest. So that a typo in a key, or reading a player key as a server setting, fails the build
+// rather than the game, the CLI writes a module with the types and ready-made access / commands next
+// to the entry. The file is part of the sources: upload packs it, and the portal builds the mod with it.
 
 export const GENERATED_FILE = 'xplay.generated.ts';
 
-const header = `// Сгенерировано v8scli из mod.json — не править руками: build и upload перепишут.
+const header = `// Generated by v8scli from mod.json — do not edit by hand: build and upload overwrite it.
 `;
 
 function literal(value) {
@@ -24,7 +24,7 @@ function union(values, fallback) {
   return items.length ? items.map(literal).join(' | ') : fallback;
 }
 
-/** Тип значения настройки манифеста в TypeScript */
+/** TypeScript type of a manifest setting's value */
 function valueType(setting) {
   switch (setting.type) {
     case 'bool':
@@ -49,7 +49,7 @@ function valueType(setting) {
   }
 }
 
-/** Все настройки, включая зависимые (dependents), в порядке манифеста */
+/** All settings, including dependents, in manifest order */
 function flattenSettings(settings, out = []) {
   for (const setting of settings ?? []) {
     if (!setting || typeof setting.key !== 'string')
@@ -91,23 +91,23 @@ export function generateAccessModule(manifest) {
   return `${header}import { createAccess, createCommands } from 'v8_scripting/access';
 import type { AudienceValue, CommandContext, CommandResult } from 'v8_scripting/access';
 
-/** Разрешения мода (permissions[]) */
+/** Mod permissions (permissions[]) */
 export type PermissionKey = ${union(permissions.map((item) => item.key), 'never')};
 
-/** Персональные настройки (scope: "player"): у групп и игроков могут быть свои значения */
+/** Per-player settings (scope: "player"): groups and players can have their own values */
 export interface PlayerValues {
 ${fields(playerSettings)}
 }
 
-/** Настройки мода на сервер (scope: "session") — одно значение на всех */
+/** Per-server mod settings (scope: "session") — one value for everyone */
 export interface SessionSettings {
 ${fields(sessionSettings)}
 }
 
-/** Команды мода (commands[]) */
+/** Mod commands (commands[]) */
 export type CommandKey = ${union(commands.map((item) => item.key), 'never')};
 
-/** Аргументы команд — уже разобранные платформой: player — AccountID, duration — секунды */
+/** Command arguments, already parsed by the platform: player — AccountID, duration — seconds */
 export interface CommandArgs {
 ${commandArgs}
 }
@@ -120,7 +120,7 @@ ${permissionDefaults}
 
 const commandsRaw = createCommands<CommandKey>();
 
-/** Обработчик команды с типизированными аргументами */
+/** Command handler with typed arguments */
 export const commands = {
   on<K extends CommandKey>(key: K, handler: (context: CommandContext, args: CommandArgs[K]) => CommandResult): () => void {
     return commandsRaw.on(key, handler as (context: CommandContext, args: Record<string, string | number>) => CommandResult);
@@ -129,14 +129,14 @@ export const commands = {
 `;
 }
 
-/** Путь сгенерированного модуля — рядом с entry */
+/** Path of the generated module — next to the entry */
 export function generatedPath(manifest, dir = process.cwd()) {
   return join(dir, dirname(manifest.entry), GENERATED_FILE);
 }
 
 /**
- * Написать модуль типов для мода apiVersion 2. Переписывает только при изменении — иначе
- * вотчеры сборки крутились бы по кругу. false — мод apiVersion 1, типов нет
+ * Writes the types module for an apiVersion 2 mod. Rewrites it only when the content changes — otherwise
+ * build watchers would loop forever. false — an apiVersion 1 mod, no types
  */
 export async function ensureGenerated(manifest, dir = process.cwd()) {
   if (!(Number(manifest.apiVersion) >= 2))
@@ -147,14 +147,14 @@ export async function ensureGenerated(manifest, dir = process.cwd()) {
   const current = existsSync(path) ? await readFile(path, 'utf-8') : '';
   if (current !== source) {
     await writeFile(path, source);
-    console.log(`ok: ${path} — типы ключей из mod.json`);
+    console.log(`ok: ${path} — key types from mod.json`);
   }
   return true;
 }
 
 /**
- * Проверка типов проекта. Для модов apiVersion 2 обязательна: ради неё и генерируются ключи.
- * Нужен typescript в проекте (он есть в шаблоне init)
+ * Typechecks the project. Mandatory for apiVersion 2 mods: the keys are generated for exactly this.
+ * Requires typescript in the project (the init template includes it)
  */
 export function typecheck(dir = process.cwd()) {
   const tsc = join(dir, 'node_modules', '.bin', process.platform === 'win32' ? 'tsc.cmd' : 'tsc');

package/src/vjs.js

@@ -1,6 +1,6 @@
-// Упаковка JS в ресурс .vjs_c — копия портального src/versions/vjs.ts (единственное
-// место знания о формате). Нужна для локальных тестов на своём сервере: релизный
-// артефакт всё равно собирает портал из исходников.
+// Packs JS into a .vjs_c resource — a copy of the portal's src/versions/vjs.ts (the only
+// place that knows the format). Needed for local tests on your own server: the release
+// artifact is built by the portal from the sources anyway.
 const RED2_HEX ='0533564b7c161274e9069846aff2e63eb59037e7010000000000004071020000' +
   '010000000000000027000000070007008f0300008e0200000000000000000000' +
   '000000000000000078020000cd01000017010000c10000000300000000000000' +
@@ -42,7 +42,7 @@ export function buildVjsC(jsBuffer) {
   const totalHeaderSize = headerSize + blockMetaSize;
 
   const header = Buffer.alloc(totalHeaderSize);
-  header.writeUInt32LE(0, 0); // fileSize, патчится в конце
+  header.writeUInt32LE(0, 0); // fileSize, patched at the end
   header.writeUInt16LE(HEADER_VERSION, 4);
   header.writeUInt16LE(RESOURCE_VERSION, 6);
   header.writeUInt32LE(8, 8);
@@ -61,7 +61,7 @@ export function buildVjsC(jsBuffer) {
 
   for (let i = 0; i < blocks.length; i++) {
     const blockData = blocks[i].data;
-    const pad = (16 - (currentPos % 16)) % 16; // выравнивание как в Resource.Serialize
+    const pad = (16 - (currentPos % 16)) % 16; // alignment as in Resource.Serialize
     if (pad > 0) {
       chunks.push(Buffer.alloc(pad, 0));
       currentPos += pad;

package/templates/package.json

@@ -7,7 +7,7 @@
     "upload": "v8scli upload"
   },
   "devDependencies": {
-    "v8_scripting": "^0.27.0",
+    "v8_scripting": "^0.28.0",
     "v8scli": "^0.4.0",
     "typescript": "^5.9.2"
   }

package/templates/src/index.ts

@@ -1,18 +1,18 @@
 import { Instance } from "cs_script/point_script";
 import { runScheduler, setInterval } from "v8_scripting/scheduler";
 
-// Конфиг мода: настройки из лобби (ключи из mod.json settings[]).
-// До запуска через платформу GetModConfig может отсутствовать — работаем на дефолтах.
+// Mod config: settings from the lobby (keys from mod.json settings[]).
+// Until the mod runs through the platform, GetModConfig may be missing — fall back to defaults.
 const config = Instance.GetModConfig?.();
 Instance.Msg(`mod started, environment: ${config?.environment ?? "dev"}`);
 
-// В рантайме нет своего цикла событий: таймеры и отложенные вызовы двигаются
-// отсюда. Без этой строки setInterval/setTimeout/nextFrame молча не сработают.
+// The runtime has no event loop of its own: timers and deferred calls are driven
+// from here. Without this line, setInterval/setTimeout/nextFrame silently never fire.
 Instance.OnGameFrame(() => runScheduler());
 
-// У ботов (и в момент подключения до создания контроллера) player приходит
-// undefined, хотя движковые типы обещают его всегда — проверяйте перед доступом,
-// иначе колбэк упадёт на каждом заходе бота.
+// For bots (and while connecting, before the controller exists), player is
+// undefined, even though the engine typings promise it is always set — check it before use,
+// otherwise the callback crashes every time a bot joins.
 Instance.OnPlayerConnect(({ player }) => {
   if (!player) {
     return;