@nativewrappers/server 0.0.166 → 0.0.168

package/PlayerList.d.ts

@@ -0,0 +1,13 @@
+import { Player } from "./entities/Player";
+export type PlayerMap = Map<number, Player>;
+/**
+ * A static helper class that will automatically handle adding/removing players from
+ * a shared player map.
+ *
+ * This should be preferred over using constant calls to `getPlayers` since it will
+ * have marginally less overhead
+ */
+export declare class PlayerList {
+    private static playerMap;
+    static get AllPlayers(): Readonly<PlayerMap>;
+}

package/PlayerList.js

@@ -0,0 +1,27 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Player } from "./entities/Player";
+class PlayerList {
+  static {
+    __name(this, "PlayerList");
+  }
+  static playerMap = /* @__PURE__ */ new Map();
+  static {
+    for (const srcStr of getPlayers()) {
+      const src = parseInt(srcStr, 10);
+      PlayerList.playerMap.set(src, new Player(src));
+    }
+    on("playerJoining", () => {
+      PlayerList.playerMap.set(source, new Player(source));
+    });
+    on("playerDropped", () => {
+      PlayerList.playerMap.delete(source);
+    });
+  }
+  static get AllPlayers() {
+    return PlayerList.playerMap;
+  }
+}
+export {
+  PlayerList
+};

package/entities/Player.d.ts

@@ -4,10 +4,17 @@ import { Ped } from "./Ped";
 export declare class Player {
     private readonly source;
     protected type: ClassTypes;
+    protected ped: Ped | null;
     constructor(source: any);
     static fromServerId(serverId: number): Player | null;
     /**
      * Get an interable list of players currently on the server
+     *
+     * You should generally prefer to use {@see PlayerList} for this if you're
+     * frequently doing this call, since it has less overhead, as it doesn't have
+     * to iterate over the entire player list every time, and it doesn't have to
+     * create a new player object
+     *
      * @returns Iterable list of Players.
      */
     static AllPlayers(): IterableIterator<Player>;
@@ -23,7 +30,14 @@ export declare class Player {
      * Returns the player source casted as a string
      */
     get Src(): string;
-    get Ped(): Ped;
+    /**
+     * Gets the players ped, this is only ever set once, so subsequent calls will be
+     * cached
+     *
+     * Due to the fact that the ped doesn't exist at `playerJoining` this can be
+     * `null`
+     */
+    get Ped(): Ped | null;
     get Tokens(): string[];
     get Identifiers(): string[];
     get Endpoint(): string;

package/entities/Player.js

@@ -13,6 +13,7 @@ class Player {
     __name(this, "Player");
   }
   type = ClassTypes.Player;
+  ped = null;
   static fromServerId(serverId) {
     if (!DoesPlayerExist(serverId)) {
       return null;
@@ -21,6 +22,12 @@ class Player {
   }
   /**
    * Get an interable list of players currently on the server
+   *
+   * You should generally prefer to use {@see PlayerList} for this if you're
+   * frequently doing this call, since it has less overhead, as it doesn't have
+   * to iterate over the entire player list every time, and it doesn't have to
+   * create a new player object
+   *
    * @returns Iterable list of Players.
    */
   static *AllPlayers() {
@@ -51,9 +58,21 @@ class Player {
   get Src() {
     return this.source;
   }
+  /**
+   * Gets the players ped, this is only ever set once, so subsequent calls will be
+   * cached
+   *
+   * Due to the fact that the ped doesn't exist at `playerJoining` this can be
+   * `null`
+   */
   get Ped() {
-    const ped = GetPlayerPed(this.source);
-    return new Ped(ped);
+    if (!this.ped) {
+      const ped = GetPlayerPed(this.source);
+      if (ped !== 0) {
+        this.ped = new Ped(GetPlayerPed(this.source));
+      }
+    }
+    return this.ped;
   }
   get Tokens() {
     return getPlayerTokens(this.source);

package/game/generateHash.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @returns This will return an unsigned hash for the current string
+ */
+export declare function generateHash(str: string): number;

package/game/generateHash.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function generateHash(str) {
+  return GetHashKey(str) & 4294967295;
+}
+__name(generateHash, "generateHash");
+export {
+  generateHash
+};

package/index.d.ts

@@ -1,7 +1,9 @@
 export * from "./Game";
+export * from "./PlayerList";
 export * from "./utils/waitForEntityToExist";
 export * from "./type/Anticheat";
 export * from "./type/Hash";
+export * from "./game/generateHash";
 export * from "./enum/OrphanMode";
 export * from "./enum/PopulationType";
 export * from "./enum/VehicleLockStatus";

package/index.js

@@ -1,7 +1,9 @@
 export * from "./Game";
+export * from "./PlayerList";
 export * from "./utils/waitForEntityToExist";
 export * from "./type/Anticheat";
 export * from "./type/Hash";
+export * from "./game/generateHash";
 export * from "./enum/OrphanMode";
 export * from "./enum/PopulationType";
 export * from "./enum/VehicleLockStatus";

package/package.json

@@ -8,7 +8,7 @@
   ],
   "license": "MIT",
   "type": "module",
-  "version": "0.0.166",
+  "version": "0.0.168",
   "repository": {
     "type": "git",
     "url": "https://github.com/nativewrappers/nativewrappers.git"