@evitcastudio/kit 2.1.2 → 2.3.0

package/lib/bundle/cli/kit-game-templates/single/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    // Enable latest features
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "baseUrl": "./",
+    "moduleDetection": "force",
+    "allowJs": true,
+    "resolveJsonModule": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/lib/cli/init.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Options for the init command.
+ */
+export interface InitOptions {
+    projectName?: string;
+    single?: boolean;
+    multi?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Process the initialization of a new project.
+ * @param pOptions - Options for initialization.
+ */
+export declare function processInit(pOptions: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/lib/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAgED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoItE"}

package/lib/cli/init.js

@@ -0,0 +1,190 @@
+import { intro, outro, text, select, confirm, spinner, note, isCancel, cancel } from '@clack/prompts';
+import chalk from 'chalk';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import packageJSON from '../../package.json';
+/**
+ * Gets the git user name and email from the local system.
+ * @returns The formatted author string.
+ */
+function getGitUser() {
+    try {
+        const name = spawnSync('git', ['config', '--get', 'user.name'], { encoding: 'utf8' }).stdout.trim();
+        const email = spawnSync('git', ['config', '--get', 'user.email'], { encoding: 'utf8' }).stdout.trim();
+        if (name && email) {
+            return `${name} <${email}>`;
+        }
+        return name || 'Author';
+    }
+    catch {
+        return 'Author';
+    }
+}
+/**
+ * Recursively copy template files and replace placeholders.
+ * @param pSrc - Source template directory.
+ * @param pDest - Destination project directory.
+ * @param pProjectName - Project name for placeholder replacement.
+ * @param pVersion - Version number for placeholder replacement.
+ * @param pAuthor - Author for placeholder replacement.
+ */
+function copyTemplate(pSrc, pDest, pProjectName, pVersion, pAuthor) {
+    if (!fs.existsSync(pDest)) {
+        fs.mkdirSync(pDest, { recursive: true });
+    }
+    const files = fs.readdirSync(pSrc);
+    for (const file of files) {
+        const srcPath = path.join(pSrc, file);
+        const destPath = path.join(pDest, file);
+        const stats = fs.statSync(srcPath);
+        if (stats.isDirectory()) {
+            if (file === '.git')
+                continue; // Do not copy .git directories
+            copyTemplate(srcPath, destPath, pProjectName, pVersion, pAuthor);
+        }
+        else {
+            const ext = path.extname(file).toLowerCase();
+            const textExtensions = ['.ts', '.js', '.json', '.html', '.css', '.md', '.txt'];
+            if (textExtensions.includes(ext) || file === '.gitignore' || file.startsWith('.')) {
+                let content = fs.readFileSync(srcPath, 'utf8');
+                // Replace placeholders
+                content = content.replace(/{{PROJECT_NAME}}/g, pProjectName);
+                content = content.replace(/{{VERSION}}/g, pVersion);
+                content = content.replace(/{{PROJECT_AUTHOR}}/g, pAuthor);
+                fs.writeFileSync(destPath, content);
+            }
+            else {
+                // Binary-safe copy for other files (like .vyi, images, etc.)
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+}
+/**
+ * Process the initialization of a new project.
+ * @param pOptions - Options for initialization.
+ */
+export async function processInit(pOptions) {
+    intro(chalk.cyan(`Kit CLI v${packageJSON.version}`));
+    let projectName = pOptions.projectName;
+    let gameType = 'single';
+    // Interactive Walkthrough
+    if (!pOptions.single && !pOptions.multi && !projectName) {
+        const name = await text({
+            message: 'What is the name of your project?',
+            placeholder: 'my-amazing-project',
+            validate(pValue) {
+                if (!pValue || pValue.length === 0)
+                    return 'Project name is required';
+                if (!/^[a-z0-9-_]+$/i.test(pValue))
+                    return 'Project name must be alphanumeric with dashes or underscores';
+            },
+        });
+        if (isCancel(name)) {
+            cancel('Operation cancelled.');
+            process.exit(0);
+        }
+        projectName = name;
+        const type = await select({
+            message: 'What type of game are you building?',
+            options: [
+                { value: 'single', label: 'Single Player', hint: 'Legacy of Goku, Chrono Trigger, Final Fantasy, etc.' },
+                { value: 'multi', label: 'Multiplayer', hint: 'APEX Legends, DBZ Squadra, Valorant, etc.' },
+                { value: 'both', label: 'Single & Multiplayer', hint: 'Minecraft, Terraria, etc.' },
+            ],
+        });
+        if (isCancel(type)) {
+            cancel('Operation cancelled.');
+            process.exit(0);
+        }
+        gameType = type;
+    }
+    else {
+        // Handle flags
+        if (pOptions.single)
+            gameType = 'single';
+        if (pOptions.multi)
+            gameType = 'multi';
+        if (pOptions.single && pOptions.multi)
+            gameType = 'both';
+        if (!projectName)
+            projectName = 'kit-project';
+    }
+    const projectDir = path.join(process.cwd(), projectName);
+    if (fs.existsSync(projectDir)) {
+        const overwrite = await confirm({
+            message: `Directory ${chalk.cyan(projectName)} already exists. Overwrite?`,
+            initialValue: false,
+        });
+        if (isCancel(overwrite) || !overwrite) {
+            cancel('Installation aborted.');
+            process.exit(0);
+        }
+    }
+    const s = spinner();
+    s.start(`Scaffolding ${chalk.cyan(projectName)}...`);
+    try {
+        const projectPath = path.join(process.cwd(), projectName);
+        if (fs.existsSync(projectPath)) {
+            // This case should ideally be handled by the confirm prompt above,
+            // but good to have a fallback for non-interactive mode or race conditions.
+            fs.rmSync(projectPath, { recursive: true, force: true });
+        }
+        fs.mkdirSync(projectPath, { recursive: true });
+        // Determine the template type based on gameType
+        let templateType = gameType;
+        if (gameType === 'both')
+            templateType = 'multi'; // Use multi for both for now
+        // Resolve template path
+        // When running from lib/bundle/cli/cli.js, templates are in ./kit-game-templates/
+        const templatesDir = path.join(path.dirname(fileURLToPath(import.meta.url)), 'kit-game-templates', templateType);
+        const author = getGitUser();
+        if (!fs.existsSync(templatesDir)) {
+            // Fallback for local development (src/cli/init.ts)
+            // Go up to root then templates/pType
+            const localTemplatesDir = path.join(process.cwd(), 'kit-game-templates', templateType);
+            if (!fs.existsSync(localTemplatesDir)) {
+                console.error(chalk.red(`Error: Templates not found at ${templatesDir} or ${localTemplatesDir}`));
+                process.exit(1);
+            }
+            copyTemplate(localTemplatesDir, projectPath, projectName, packageJSON.version, author);
+        }
+        else {
+            copyTemplate(templatesDir, projectPath, projectName, packageJSON.version, author);
+        }
+        // Initialize git and create initial commit
+        try {
+            spawnSync('git', ['init'], { cwd: projectPath });
+            spawnSync('git', ['add', '.'], { cwd: projectPath });
+            spawnSync('git', ['commit', '-m', 'Initial commit from Kit CLI'], {
+                cwd: projectPath,
+                env: { ...process.env, GIT_AUTHOR_NAME: author.split(' <')[0], GIT_AUTHOR_EMAIL: author.split('<')[1]?.slice(0, -1) || '' }
+            });
+        }
+        catch {
+            // Silently fail if git is not installed or config is missing 
+        }
+        s.stop(`Project ${chalk.green(projectName)} created!`);
+        console.log(`${chalk.cyan('│')}`);
+        console.log(`${chalk.cyan('│')}  ${chalk.white.bold('Next steps:')}`);
+        console.log(`${chalk.cyan('│')}  ${chalk.dim('1.')} cd ${chalk.cyan(projectName)}`);
+        console.log(`${chalk.cyan('│')}  ${chalk.dim('2.')} bun install`);
+        console.log(`${chalk.cyan('│')}  ${chalk.dim('3.')} bun run build`);
+        console.log(`${chalk.cyan('│')}`);
+        outro(chalk.green.bold('Happy coding!'));
+    }
+    catch (pError) {
+        s.stop(chalk.red('Scaffolding failed.'));
+        // Cleanup partially created directory
+        if (projectName) {
+            const projectPath = path.join(process.cwd(), projectName);
+            if (fs.existsSync(projectPath)) {
+                fs.rmSync(projectPath, { recursive: true, force: true });
+            }
+        }
+        console.error(pError);
+        process.exit(1);
+    }
+}

package/lib/cli/main.d.ts

@@ -0,0 +1,13 @@
+import type { ProcessOptions } from './types';
+import { type InitOptions } from './init';
+export declare class KitCLI {
+    /**
+     * Start resource builder.
+     */
+    static processResources(pProcessOptions: ProcessOptions): Promise<void>;
+    /**
+     * Start project initialization.
+     */
+    static init(pInitOptions: InitOptions): Promise<void>;
+}
+//# sourceMappingURL=main.d.ts.map

package/lib/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEvD,qBAAa,MAAM;IACf;;OAEG;WACU,gBAAgB,CAAC,eAAe,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E;;OAEG;WACU,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/lib/cli/main.js

@@ -0,0 +1,16 @@
+import { processResources } from './resource-builder';
+import { processInit } from './init';
+export class KitCLI {
+    /**
+     * Start resource builder.
+     */
+    static async processResources(pProcessOptions) {
+        await processResources(pProcessOptions);
+    }
+    /**
+     * Start project initialization.
+     */
+    static async init(pInitOptions) {
+        await processInit(pInitOptions);
+    }
+}

package/lib/cli/resource-builder.d.ts

@@ -0,0 +1,6 @@
+import type { ProcessOptions } from './types';
+/**
+ * Main entry point for building resources.
+ */
+export declare function processResources({ inDirectory, outDirectory, verbose, ignoreSound }: ProcessOptions): Promise<void>;
+//# sourceMappingURL=resource-builder.d.ts.map

package/lib/cli/resource-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-builder.d.ts","sourceRoot":"","sources":["../../src/cli/resource-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA+K9C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBzH"}

package/lib/cli/resource-builder.js

@@ -0,0 +1,191 @@
+import { promises as fs } from 'fs';
+import { join, extname, basename } from 'path';
+import chalk from 'chalk';
+import { v4 as uuidv4 } from 'uuid';
+// Logging helpers
+const log = console.log;
+const info = chalk.hex('#ffa552');
+const error = chalk.hex('#c42847');
+const alert = chalk.hex('#EFF2C0');
+// Resource types and valid file extensions
+const RESOURCE_TYPES = ['interface', 'icon', 'map', 'sound', 'macros'];
+const VALID_EXTENSIONS = ['vyint', 'vyi', 'vym', 'vymac', 'mp3', 'aac', 'wav', 'm4a', 'ogg', 'flac'];
+// State variables
+let resourceJSON = initializeResourceJSON();
+let isVerbose = false;
+let ignoringSound = false;
+let resourceInDirectory = '';
+let resourceOutDirectory = '';
+const resourcesToProcess = [];
+/**
+ * Initializes the resource JSON structure.
+ */
+function initializeResourceJSON() {
+    return RESOURCE_TYPES.reduce((acc, type) => {
+        acc[type] = [];
+        return acc;
+    }, {});
+}
+/**
+ * Processes a single file and updates the resource JSON.
+ */
+function prepareFileForProcessing(pFilePath) {
+    const extension = extname(pFilePath).slice(1);
+    const fileName = basename(pFilePath);
+    const resourceIdentifier = `${uuidv4()}.vyr`;
+    const type = getResourceType(extension);
+    if (!type)
+        return;
+    if (type === 'sound' && ignoringSound) {
+        logVerbose(`[Ignored File] ${pFilePath} (ignoreSound flag enabled)`);
+        return;
+    }
+    resourcesToProcess.push({ filePath: pFilePath, type });
+    resourceJSON[type].push({ resourceIdentifier, fileName });
+}
+/**
+ * Determines the resource type based on the file extension.
+ */
+function getResourceType(pExtension) {
+    switch (pExtension) {
+        case 'vyint': return 'interface';
+        case 'vyi': return 'icon';
+        case 'vym': return 'map';
+        case 'vymac': return 'macros';
+        case 'mp3':
+        case 'aac':
+        case 'wav':
+        case 'm4a':
+        case 'ogg':
+        case 'flac': return 'sound';
+        default: return null;
+    }
+}
+/**
+ * Processes a directory and its contents recursively.
+ */
+async function processDirectory(pDirectoryPath) {
+    try {
+        const contents = await fs.readdir(pDirectoryPath);
+        for (const item of contents) {
+            const itemPath = join(pDirectoryPath, item);
+            const stats = await fs.stat(itemPath);
+            if (stats.isDirectory()) {
+                await processDirectory(itemPath);
+            }
+            else if (isValidExtension(extname(itemPath).slice(1))) {
+                prepareFileForProcessing(itemPath);
+            }
+        }
+    }
+    catch (pError) {
+        logError(`[Error] Processing directory: ${pError}`);
+    }
+}
+/**
+ * Checks if a file extension is valid.
+ */
+function isValidExtension(pExtension) {
+    return VALID_EXTENSIONS.includes(pExtension);
+}
+/**
+ * Executes all file copy operations in parallel after preparation.
+ */
+async function processAllFiles() {
+    try {
+        await clearResourceTypeDirectories(`${resourceOutDirectory}/resources`);
+        // Create copy operations for all files
+        const copyOperations = resourcesToProcess.map(({ filePath, type }) => {
+            const fileName = basename(filePath);
+            const resource = resourceJSON[type].find(res => res.fileName === fileName);
+            if (!resource) {
+                throw new Error(`Resource not found for file: ${fileName}`);
+            }
+            const destination = join(resourceOutDirectory, 'resources');
+            const resourceName = resource.resourceIdentifier;
+            return copyFile(filePath, destination, resourceName);
+        });
+        // Execute all copy operations concurrently
+        await Promise.all(copyOperations);
+        logVerbose(`[Kit CLI] All resources have been processed.`);
+        await saveResourceJSON();
+    }
+    catch (pError) {
+        const errorMessage = pError instanceof Error ? pError.message : String(pError);
+        logError(`[Error] Processing files in batch: ${errorMessage}`);
+    }
+}
+/**
+ * Clears specified directories within a base directory.
+ * @param pBaseDirectory - The path to the base directory.
+ */
+async function clearResourceTypeDirectories(pBaseDirectory) {
+    try {
+        const directoryExists = await fs.stat(pBaseDirectory).then(stat => stat.isDirectory()).catch(() => false);
+        if (directoryExists) {
+            await fs.rm(pBaseDirectory, { recursive: true });
+        }
+    }
+    catch (pError) {
+        log(`${error(`[Error]`)} clearing resource directory: ${pError}`);
+    }
+}
+/**
+ * Copies a file to the specified directory.
+ */
+async function copyFile(pSource, pDestinationDir, pNewName) {
+    try {
+        await fs.mkdir(pDestinationDir, { recursive: true });
+        await fs.copyFile(pSource, join(pDestinationDir, pNewName));
+    }
+    catch (pError) {
+        logError(`[Error] Copying file ${pSource}: ${pError}`);
+    }
+}
+/**
+ * Saves the resource JSON to a file.
+ */
+async function saveResourceJSON() {
+    const filePath = 'resource.json';
+    try {
+        await fs.writeFile(filePath, JSON.stringify(resourceJSON, null, 4));
+    }
+    catch (pError) {
+        logError(`[Error] Saving resource JSON: ${pError}`);
+    }
+}
+/**
+ * Main entry point for building resources.
+ */
+export async function processResources({ inDirectory, outDirectory, verbose, ignoreSound }) {
+    // Initialize state
+    resourceInDirectory = inDirectory;
+    resourceOutDirectory = outDirectory;
+    isVerbose = verbose;
+    ignoringSound = ignoreSound;
+    resourceJSON = initializeResourceJSON();
+    // Validate inputs
+    if (!resourceInDirectory || !resourceOutDirectory) {
+        logError('[Error] Input and output directories must be specified');
+        return;
+    }
+    // Process resources
+    await processDirectory(resourceInDirectory);
+    if (resourcesToProcess.length > 0) {
+        await processAllFiles();
+    }
+    else {
+        logAlert('No resources found!');
+        await saveResourceJSON();
+    }
+}
+function logVerbose(pMessage) {
+    if (isVerbose)
+        log(info(pMessage));
+}
+function logError(pMessage) {
+    log(error(pMessage));
+}
+function logAlert(pMessage) {
+    log(alert(pMessage));
+}

package/lib/cli/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ProcessOptions for resource builder.
+ */
+type ProcessOptions = {
+    inDirectory: string;
+    outDirectory: string;
+    verbose?: boolean;
+    ignoreSound?: boolean;
+};
+export type { ProcessOptions };
+//# sourceMappingURL=types.d.ts.map

package/lib/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,cAAc,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/lib/cli/types.js

@@ -0,0 +1 @@
+export {};

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export { Kit } from './kit';
 export { EventEmitter } from './events/event-system';
-export type { EmitterEvent, ResourceData, Listener } from './types/shared-types';
+export type { EmitterEvent, ResourceData, Listener, KitPluginConstructor } from './types/shared-types';
+export type { Client, Diob } from './types/vylo';
 export { KitPlugin } from './plugins/kit-plugin';
 export { Network } from './plugins/network';
 export type { NetworkListener } from './plugins/network';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACvG,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/plugins/network/index.d.ts

@@ -25,6 +25,13 @@ export declare class Network extends KitPlugin {
      * @param pPacketName - The name of the packet that will be listened to.
      * @param pListener - The listener that will be called when the packet is received.
      */
+    onPacket<T extends unknown[]>(pPacketName: string, pListener: NetworkListener<T>): void;
+    /**
+     * Register a listener for a packet.
+     * @deprecated Use `onPacket` instead.
+     * @param pPacketName - The name of the packet that will be listened to.
+     * @param pListener - The listener that will be called when the packet is received.
+     */
     on<T extends unknown[]>(pPacketName: string, pListener: NetworkListener<T>): void;
     /**
      * API for receiving data from the server.

package/lib/plugins/network/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/network/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtG,qBAAa,OAAQ,SAAQ,SAAS;IAClC,IAAI,SAAa;IACjB;;OAEG;IACH,OAAO,CAAC,SAAS,CAAkB;IACnC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAkC;IACjD;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,YAAY,IAAI,IAAI;IAGpB;;OAEG;IACH,OAAO,CAAC,SAAS,CAAiD;IAClE;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAMjF;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,GAAE,OAAO,EAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IA4BzG;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IASlD;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/network/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtG,qBAAa,OAAQ,SAAQ,SAAS;IAClC,IAAI,SAAa;IACjB;;OAEG;IACH,OAAO,CAAC,SAAS,CAAkB;IACnC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAkC;IACjD;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,YAAY,IAAI,IAAI;IAGpB;;OAEG;IACH,OAAO,CAAC,SAAS,CAAiD;IAClE;;;;OAIG;IACH,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAOvF;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAGjF;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,GAAE,OAAO,EAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IA+BzG;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IASlD;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOrD"}

package/lib/plugins/network/index.js

@@ -25,12 +25,21 @@ export class Network extends KitPlugin {
      * @param pPacketName - The name of the packet that will be listened to.
      * @param pListener - The listener that will be called when the packet is received.
      */
-    on(pPacketName, pListener) {
+    onPacket(pPacketName, pListener) {
         if (!this.packets.has(pPacketName)) {
             throw new Error(`Packet name '${pPacketName}' is not registered.`);
         }
         this.listeners.set(pPacketName, pListener);
     }
+    /**
+     * Register a listener for a packet.
+     * @deprecated Use `onPacket` instead.
+     * @param pPacketName - The name of the packet that will be listened to.
+     * @param pListener - The listener that will be called when the packet is received.
+     */
+    on(pPacketName, pListener) {
+        this.onPacket(pPacketName, pListener);
+    }
     /**
      * API for receiving data from the server.
      * @param pClient - The client involved with this packet.
@@ -44,19 +53,23 @@ export class Network extends KitPlugin {
         if (typeof pPacketName === 'number') {
             const packetName = this.reversedPacketMap.get(pPacketName);
             if (!packetName) {
-                console.warn(`Unknown packet index: ${pPacketName}`);
+                if (pVerbose) {
+                    console.group(`Kit.${this.name}Plugin.onNetwork`);
+                    console.warn(`Unknown packet index: ${pPacketName}`);
+                    console.groupEnd();
+                }
                 return;
             }
             const listener = this.listeners.get(packetName);
             if (pVerbose) {
                 console.group(`Kit.${this.name}Plugin.onNetwork`);
+                if (!listener) {
+                    console.warn(`No listener was registered for this packet: ${packetName}`);
+                }
                 console.log(`Packet name: ${pPacketName}`);
                 console.log(`Resolved packet name: ${packetName}`);
                 console.log(`Data:`, pData);
                 console.groupEnd();
-                if (!listener) {
-                    console.warn(`No listener registered for packet: ${packetName}`);
-                }
             }
             listener?.(pClient, ...pData);
         }