@cybermp-community/server-types 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cybermp-community/server-types",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "TypeScript type definitions for the CyberMP server-side environment.",
   "license": "MIT",
   "author": {

package/src/hashes.d.ts

@@ -1,7 +1,27 @@
 import type { CName, ResRef, TweakDBID } from './shared';
 
+/**
+ * Interface providing utility methods to hash object paths into internal types.
+ */
 export interface MpHashes {
+  /**
+   * Converts a string path into a TweakDBID hash.
+   * @param path - The string path of entry.
+   * @returns The corresponding TweakDBID.
+   */
   tweakdbid(path: string): TweakDBID;
+
+  /**
+   * Converts a string path into a CName hash.
+   * @param path - The string path of entry.
+   * @returns The corresponding CName.
+   */
   cname(path: string): CName;
+
+  /**
+   * Converts a string path into a ResRef hash.
+   * @param path - The string path of entry.
+   * @returns The corresponding ResRef.
+   */
   resref(path: string): ResRef;
 }

package/src/mp/multiplayer.d.ts

@@ -32,7 +32,7 @@ export interface MpServer {
    */
   isServer(): boolean;
 
-  config: MpServ.ServerConfig;
+  config: MpServ.ServerConfig & Record<string, string>;
 }
 
 export const mp: MpServer;

package/src/resources.d.ts

@@ -18,6 +18,10 @@ export interface MpResources {
    */
   stop(resourceName: string): void;
 
+  /**
+ * Restarts a specific resource by name.
+ * @param resourceName Name of the resource to restart.
+ */
   restart(resourceName: string): void;
 
   /**

package/src/voice-chat.d.ts

@@ -1,9 +1,26 @@
 import type { MpPlayer } from './entities';
 
+/**
+ * Interface representing the voice chat management system on the server.
+ */
 export interface MpVoiceChat {
-  mutePlayer(player: MpPlayer | number): void;
+  /**
+   * Mutes or unmutes a specific player.
+   * @param player - The player instance or their unique ID.
+   * @param state - Set to `true` to mute, `false` to unmute.
+   */
+  mutePlayer(player: MpPlayer | number, state: boolean): void;
 
+  /**
+   * Creates a new voice chat channel.
+   * @param voiceId - The unique identifier for the voice channel.
+   */
   createChannel(voiceId: number): void;
 
+  /**
+   * Checks whether a specific player is currently muted in the voice chat.
+   * @param player - The player instance or their unique ID.
+   * @returns `true` if the player is muted, `false` otherwise.
+   */
   isPlayerMuted(player: MpPlayer | number): boolean;
 }