@nativewrappers/fivem 0.0.65 → 0.0.73

package/utils/Quaternion.js

@@ -1,27 +0,0 @@
-import { Vector3 } from ".";
-export class Quaternion {
-    x;
-    y;
-    z;
-    w;
-    constructor(valueXOrVector, yOrW, z, w) {
-        if (valueXOrVector instanceof Vector3) {
-            this.x = valueXOrVector.x;
-            this.y = valueXOrVector.y;
-            this.z = valueXOrVector.z;
-            this.w = yOrW ?? 0;
-        }
-        else if (yOrW === undefined) {
-            this.x = valueXOrVector;
-            this.y = valueXOrVector;
-            this.z = valueXOrVector;
-            this.w = valueXOrVector;
-        }
-        else {
-            this.x = valueXOrVector;
-            this.y = yOrW;
-            this.z = z ?? 0;
-            this.w = w ?? 0;
-        }
-    }
-}

package/utils/Size.js

@@ -1,8 +0,0 @@
-export class Size {
-    width;
-    height;
-    constructor(w = 0, h = 0) {
-        this.width = w;
-        this.height = h;
-    }
-}

package/utils/String.js

@@ -1,25 +0,0 @@
-import { Font, Screen, Text } from "..";
-import { Maths } from "./Maths";
-export class String {
-    static stringToArray(input) {
-        let stringsNeeded = 1;
-        if (input.length > 99) {
-            stringsNeeded = Math.ceil(input.length / 99);
-        }
-        const outputString = new Array(stringsNeeded);
-        for (let i = 0; i < stringsNeeded; i++) {
-            outputString[i] = input.substring(i * 99, i * 99 + Maths.clamp(input.substring(i * 99).length, 0, 99));
-        }
-        return outputString;
-    }
-    static measureStringWidthNoConvert(input, font = Font.ChaletLondon, scale = 0) {
-        SetTextEntryForWidth("STRING");
-        Text.addLongString(input);
-        SetTextFont(font);
-        SetTextScale(1, scale);
-        return GetTextScreenWidth(false);
-    }
-    static measureString(str, font, scale, screenWidth = Screen.ScaledWidth) {
-        return this.measureStringWidthNoConvert(str, font, scale) * screenWidth;
-    }
-}

package/utils/enumValues.js

@@ -1,14 +0,0 @@
-export function* enumValues(enumObj) {
-    let isStringEnum = true;
-    for (const property in enumObj) {
-        if (typeof enumObj[property] === "number") {
-            isStringEnum = false;
-            break;
-        }
-    }
-    for (const property in enumObj) {
-        if (isStringEnum || typeof enumObj[property] === "number") {
-            yield enumObj[property];
-        }
-    }
-}

package/utils/index.js

@@ -1,9 +0,0 @@
-export { String } from "./String";
-export { LiteEvent } from "./LiteEvent";
-export { PointF } from "./PointF";
-export { Crypto } from "./Crypto";
-export { Point } from "./Point";
-export { Size } from "./Size";
-export { Vector2, Vector3, Vector4, Maths, Color, Quaternion, Delay, enumValues, getStringFromUInt8Array, getUInt32FromUint8Array, } from "../../common/utils/index";
-export const Wait = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
-export * from "./Animations";

package/weapon/DlcWeaponData.js

@@ -1,44 +0,0 @@
-import { getUInt32FromUint8Array } from "../utils";
-import { getStringFromUInt8Array } from "../utils";
-/**
- * DlcWeaponData - Mapping of WeaponHash -> DlcWeaponData
- */
-export const DlcWeaponData = new Map();
-/**
- * Initialize DlcWeaponData, avoid calling expansive native repeatedly
- *
- */
-function initializeOnce() {
-    let isInitialized = false;
-    return function () {
-        if (isInitialized || IsDuplicityVersion()) {
-            return;
-        }
-        // magic number based on struct DlcWeaponData
-        const intLength = 4;
-        const strLength = 64;
-        const weaponCount = GetNumDlcWeapons();
-        for (let i = 0; i < weaponCount; i++) {
-            const buffer = new Uint8Array(14 * intLength + 4 * strLength);
-            // https://docs.fivem.net/natives/?_0x79923CD21BECE14E
-            Citizen.invokeNative("0x79923CD21BECE14E", i, buffer, Citizen.returnResultAnyway());
-            // noinspection PointlessArithmeticExpressionJS
-            const dlcWeaponData = {
-                validCheck: getUInt32FromUint8Array(buffer, 0 * intLength, 1 * intLength),
-                weaponHash: getUInt32FromUint8Array(buffer, 2 * intLength, 3 * intLength),
-                unk: getUInt32FromUint8Array(buffer, 4 * intLength, 5 * intLength),
-                weaponCost: getUInt32FromUint8Array(buffer, 6 * intLength, 7 * intLength),
-                ammoCost: getUInt32FromUint8Array(buffer, 8 * intLength, 9 * intLength),
-                ammoType: getUInt32FromUint8Array(buffer, 10 * intLength, 11 * intLength),
-                defaultClipSize: getUInt32FromUint8Array(buffer, 12 * intLength, 13 * intLength),
-                name: getStringFromUInt8Array(buffer, 14 * intLength, 14 * intLength + strLength),
-                desc: getStringFromUInt8Array(buffer, 14 * intLength + strLength, 14 * intLength + 2 * strLength),
-                simpleDesc: getStringFromUInt8Array(buffer, 14 * intLength + 2 * strLength, 14 * intLength + 3 * strLength),
-                upperCaseName: getStringFromUInt8Array(buffer, 14 * intLength + 3 * strLength, 14 * intLength + 4 * strLength),
-            };
-            DlcWeaponData.set(dlcWeaponData.weaponHash, dlcWeaponData);
-        }
-        isInitialized = true;
-    };
-}
-initializeOnce()();

package/weapon/Mk2WeaponHash.js

@@ -1,25 +0,0 @@
-/**
- * Mk2 weapon hash
- *
- */
-export var Mk2WeaponHash;
-(function (Mk2WeaponHash) {
-    // handguns
-    Mk2WeaponHash[Mk2WeaponHash["PistolMk2"] = 3219281620] = "PistolMk2";
-    Mk2WeaponHash[Mk2WeaponHash["SNSPistolMk2"] = 2285322324] = "SNSPistolMk2";
-    Mk2WeaponHash[Mk2WeaponHash["RevolverMk2"] = 3415619887] = "RevolverMk2";
-    // smg
-    Mk2WeaponHash[Mk2WeaponHash["SMGMk2"] = 2024373456] = "SMGMk2";
-    // shotgun
-    Mk2WeaponHash[Mk2WeaponHash["PumpShotgunMk2"] = 1432025498] = "PumpShotgunMk2";
-    // assault_rifles
-    Mk2WeaponHash[Mk2WeaponHash["AssaultRifleMk2"] = 961495388] = "AssaultRifleMk2";
-    Mk2WeaponHash[Mk2WeaponHash["CarbineRifleMk2"] = 4208062921] = "CarbineRifleMk2";
-    Mk2WeaponHash[Mk2WeaponHash["SpecialCarbineMk2"] = 2526821735] = "SpecialCarbineMk2";
-    Mk2WeaponHash[Mk2WeaponHash["BullpupRifleMk2"] = 2228681469] = "BullpupRifleMk2";
-    // machine_guns
-    Mk2WeaponHash[Mk2WeaponHash["CombatMGMk2"] = 3686625920] = "CombatMGMk2";
-    // sniper_rifles
-    Mk2WeaponHash[Mk2WeaponHash["HeavySniperMk2"] = 177293209] = "HeavySniperMk2";
-    Mk2WeaponHash[Mk2WeaponHash["MarksmanRifleMk2"] = 1785463520] = "MarksmanRifleMk2";
-})(Mk2WeaponHash || (Mk2WeaponHash = {}));

package/weapon/Weapon.js

@@ -1,270 +0,0 @@
-import { WeaponComponentCollection } from "../weaponComponent/WeaponComponentCollection";
-import { WeaponHash } from "../hashes";
-import { WeaponDisplayNameByHash } from "./WeaponDisplayNameByHash";
-import { Game } from "../Game";
-import { Model } from "../Model";
-import { WeaponHudStats } from "./WeaponHudStats";
-import { enumValues } from "../utils";
-import { Mk2WeaponHash } from "./Mk2WeaponHash";
-import { WeaponComponentHashesByWeaponHash } from "../weaponComponent/WeaponComponentHashesByWeaponHash";
-/**
- * ped weapon
- *
- */
-export class Weapon {
-    owner;
-    components;
-    hash;
-    constructor(owner, hash) {
-        this.owner = owner;
-        this.hash = hash;
-        this.components = new WeaponComponentCollection(this.owner, this);
-    }
-    /**
-     * weapon components
-     *
-     * @constructor
-     */
-    get Components() {
-        return this.components;
-    }
-    /**
-     * weapon hash
-     *
-     * @constructor
-     */
-    get Hash() {
-        return this.hash;
-    }
-    /**
-     * check ped is unarmed or not
-     *
-     * @constructor
-     */
-    get IsUnarmed() {
-        return this.hash === WeaponHash.Unarmed;
-    }
-    /**
-     * Check if the ped has the current weapon.
-     *
-     * @constructor
-     */
-    get IsPresent() {
-        if (this.IsUnarmed) {
-            return true;
-        }
-        return HasPedGotWeapon(this.owner.Handle, this.hash, false);
-    }
-    /**
-     * get weapon display name / label
-     *
-     * @constructor
-     */
-    get DisplayName() {
-        return Weapon.getDisplayNameFromHash(this.hash) ?? "WCT_INVALID";
-    }
-    /**
-     * get weapon localized name
-     *
-     * @constructor
-     */
-    get LocalizedName() {
-        return Game.getGXTEntry(this.DisplayName);
-    }
-    /**
-     * get weapon model
-     *
-     * @constructor
-     */
-    get Model() {
-        return new Model(GetWeapontypeModel(this.hash));
-    }
-    /**
-     * get weapon tint
-     *
-     * @constructor
-     */
-    get Tint() {
-        return GetPedWeaponTintIndex(this.owner.Handle, this.hash);
-    }
-    /**
-     * set weapon tint
-     *
-     * @param tint
-     * @constructor
-     */
-    set Tint(tint) {
-        SetPedWeaponTintIndex(this.owner.Handle, this.hash, tint);
-    }
-    /**
-     * get weapon group
-     *
-     * @constructor
-     */
-    get Group() {
-        return GetWeapontypeGroup(this.hash);
-    }
-    /**
-     * get weapon ammo type
-     *
-     * @constructor
-     */
-    get AmmoType() {
-        return GetPedAmmoTypeFromWeapon(this.owner.Handle, this.hash);
-    }
-    /**
-     * get weapon ammo count
-     *
-     * @constructor
-     */
-    get Ammo() {
-        if (this.IsUnarmed) {
-            return 1;
-        }
-        if (!this.IsPresent) {
-            return GetPedAmmoByType(this.owner.Handle, this.AmmoType);
-        }
-        return GetAmmoInPedWeapon(this.owner.Handle, this.hash);
-    }
-    /**
-     * set weapon ammo count
-     *
-     * @param count
-     * @constructor
-     */
-    set Ammo(count) {
-        if (this.IsUnarmed) {
-            return;
-        }
-        if (this.IsPresent) {
-            SetPedAmmo(this.owner.Handle, this.hash, count);
-        }
-        else {
-            GiveWeaponToPed(this.owner.Handle, this.hash, count, false, true);
-        }
-    }
-    /**
-     * get weapon max ammo
-     *
-     * @constructor
-     */
-    get MaxAmmo() {
-        if (this.IsUnarmed) {
-            return 1;
-        }
-        // GetMaxAmmo
-        // https://docs.fivem.net/natives/?_0xDC16122C7A20C933
-        // noinspection UnnecessaryLocalVariableJS
-        const amount = Citizen.invokeNative("0xDC16122C7A20C933", this.owner.Handle, this.hash, Citizen.pointerValueInt(), Citizen.resultAsInteger());
-        return amount;
-    }
-    /**
-     * get weapon max ammo in clip
-     *
-     * @constructor
-     */
-    get MaxAmmoInClip() {
-        if (this.IsUnarmed) {
-            return 1;
-        }
-        if (!this.IsPresent) {
-            return 0;
-        }
-        return GetMaxAmmoInClip(this.owner.Handle, this.hash, true);
-    }
-    /**
-     * get weapon default clip size
-     *
-     * @constructor
-     */
-    get DefaultClipSize() {
-        return GetWeaponClipSize(this.hash);
-    }
-    /**
-     * toggle weapon infinite ammo
-     *
-     * @param toggle
-     * @constructor
-     */
-    set InfiniteAmmo(toggle) {
-        if (this.IsUnarmed) {
-            return;
-        }
-        SetPedInfiniteAmmo(this.owner.Handle, toggle, this.hash);
-    }
-    /**
-     * toggle ped infinite ammo clip on all weapons
-     *
-     * @param toggle
-     * @constructor
-     */
-    set InfiniteAmmoClip(toggle) {
-        SetPedInfiniteAmmoClip(this.owner.Handle, toggle);
-    }
-    /**
-     * check weapon can use on parachute
-     *
-     * @constructor
-     */
-    get CanUseOnParachute() {
-        return CanUseWeaponOnParachute(this.hash);
-    }
-    /**
-     * Check weapon is Mk2 or not
-     *
-     * @constructor
-     */
-    get IsMk2() {
-        return Array.from(enumValues(Mk2WeaponHash)).some((x) => x === this.hash);
-    }
-    /**
-     * set weapon livery, only work for Mk2 weapon
-     *
-     * @param liveryId
-     * @param colorId
-     */
-    setLivery(liveryId, colorId) {
-        if (!this.IsMk2) {
-            console.log(`[ERROR]${this.setLivery.name} failed. Reason: non-Mk2 weapon`);
-            return;
-        }
-        const component = this.Components.getMk2CamoComponent(liveryId);
-        if (component.IsInvalid) {
-            console.log(`[ERROR]${this.setLivery.name} failed. Reason: invalid liveryId/Component`);
-            return;
-        }
-        component.Active = true;
-        SetPedWeaponLiveryColor(this.owner.Handle, this.hash, component.ComponentHash, colorId);
-    }
-    /**
-     * get weapon hud stats
-     *
-     * @constructor
-     */
-    get HudStats() {
-        return WeaponHudStats.get(this.hash);
-    }
-    /**
-     * get weapon display name / label by hash
-     *
-     * @param hash
-     */
-    static getDisplayNameFromHash(hash) {
-        if (!hash) {
-            return "WT_INVALID";
-        }
-        return WeaponDisplayNameByHash.get(hash) ?? "WCT_INVALID";
-    }
-    /**
-     * get component hashes belongs to weapon
-     *
-     * @param hash
-     */
-    static getWeaponComponentHashes(hash) {
-        const hashes = WeaponComponentHashesByWeaponHash.get(hash);
-        if (!hashes) {
-            return [];
-        }
-        return [...hashes];
-    }
-}

package/weapon/WeaponAsset.js

@@ -1,84 +0,0 @@
-import { Weapon } from "./Weapon";
-import { Game } from "../Game";
-import { Wait } from "../utils";
-/**
- * weapon asset
- *
- */
-export class WeaponAsset {
-    hash;
-    constructor(hash) {
-        this.hash = hash;
-    }
-    /**
-     * get weapon hash
-     *
-     * @constructor
-     */
-    get Hash() {
-        return this.hash;
-    }
-    /**
-     * check weapon is valid
-     *
-     * @constructor
-     */
-    get IsValid() {
-        return IsWeaponValid(this.hash);
-    }
-    /**
-     * check weapon assets is loaded
-     *
-     * @constructor
-     */
-    get IsLoaded() {
-        return HasWeaponAssetLoaded(this.hash);
-    }
-    /**
-     * request weapon asset
-     *
-     */
-    request() {
-        RequestWeaponAsset(this.hash, 31, 0);
-    }
-    /**
-     * request weapon asset async
-     *
-     * @param timeout
-     */
-    async requestAsync(timeout) {
-        this.request();
-        const start = GetGameTimer();
-        while (!this.IsLoaded) {
-            await Wait(100);
-            const now = GetGameTimer();
-            if (now - start >= timeout) {
-                return false;
-            }
-        }
-        return true;
-    }
-    /**
-     * unload weapon asset
-     *
-     */
-    dismiss() {
-        RemoveWeaponAsset(this.hash);
-    }
-    /**
-     * get weapon display name / label
-     *
-     * @constructor
-     */
-    get DisplayName() {
-        return Weapon.getDisplayNameFromHash(this.hash);
-    }
-    /**
-     * get weapon localized name
-     *
-     * @constructor
-     */
-    get LocalizedName() {
-        return Game.getGXTEntry(this.DisplayName);
-    }
-}

package/weapon/WeaponCollection.js

@@ -1,187 +0,0 @@
-import { Weapon } from "./Weapon";
-import { Prop } from "../models";
-/**
- * ped weapons
- *
- */
-export class WeaponCollection {
-    owner;
-    weapons = new Map();
-    constructor(owner) {
-        this.owner = owner;
-    }
-    [Symbol.iterator]() {
-        let pointer = 0;
-        const weapons = Array.from(this.weapons.values());
-        return {
-            next() {
-                if (pointer < weapons.length) {
-                    return { done: false, value: weapons[pointer++] };
-                }
-                else {
-                    return { done: true, value: null };
-                }
-            },
-        };
-    }
-    /**
-     * get weapon by hash
-     *
-     * @param hash
-     */
-    get(hash) {
-        let weapon = this.weapons.get(hash);
-        if (!weapon) {
-            if (!this.hasWeapon(hash)) {
-                return null;
-            }
-            weapon = this.createAndAddWeapon(hash);
-        }
-        return weapon;
-    }
-    /**
-     * get ped current weapon
-     *
-     * @constructor
-     */
-    get Current() {
-        const [, hash] = GetCurrentPedWeapon(this.owner.Handle, true);
-        if (this.weapons.has(hash)) {
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            return this.weapons.get(hash);
-        }
-        else {
-            return this.createAndAddWeapon(hash);
-        }
-    }
-    /**
-     * get ped current weapon object
-     *
-     * @constructor
-     */
-    get CurrentWeaponObject() {
-        if (this.Current.IsUnarmed) {
-            return null;
-        }
-        return new Prop(GetCurrentPedWeaponEntityIndex(this.owner.Handle));
-    }
-    /**
-     * get ped best weapon
-     *
-     * @constructor
-     */
-    get BestWeapon() {
-        const hash = GetBestPedWeapon(this.owner.Handle, false);
-        if (this.weapons.has(hash)) {
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            return this.weapons.get(hash);
-        }
-        else {
-            return this.createAndAddWeapon(hash);
-        }
-    }
-    /**
-     * check ped has weapon
-     *
-     * @param hash
-     */
-    hasWeapon(hash) {
-        return HasPedGotWeapon(this.owner.Handle, hash, false);
-    }
-    /**
-     * check weapon is valid
-     *
-     * @param hash
-     */
-    isWeaponValid(hash) {
-        return IsWeaponValid(hash);
-    }
-    /**
-     * give weapon to ped
-     *
-     * @param hash
-     * @param ammoCount
-     * @param equipNow
-     * @param isAmmoLoaded
-     */
-    give(hash, ammoCount, equipNow, isAmmoLoaded) {
-        let weapon = this.weapons.get(hash);
-        if (!weapon) {
-            weapon = this.createAndAddWeapon(hash);
-        }
-        if (weapon.IsPresent) {
-            this.select(weapon);
-        }
-        else {
-            GiveWeaponToPed(this.owner.Handle, weapon.Hash, ammoCount, equipNow, isAmmoLoaded);
-        }
-        return weapon;
-    }
-    /**
-     * set ped current weapon on hand
-     *
-     * @param weapon
-     */
-    select(weapon) {
-        if (weapon instanceof Weapon) {
-            if (!weapon.IsPresent) {
-                return false;
-            }
-            SetCurrentPedWeapon(this.owner.Handle, weapon.Hash, true);
-            return true;
-        }
-        else {
-            if (!this.hasWeapon(weapon)) {
-                return false;
-            }
-            SetCurrentPedWeapon(this.owner.Handle, weapon, true);
-            return true;
-        }
-    }
-    /**
-     * remove weapon from ped
-     *
-     * @param weapon
-     */
-    remove(weapon) {
-        if (weapon instanceof Weapon) {
-            if (this.weapons.has(weapon.Hash)) {
-                this.weapons.delete(weapon.Hash);
-            }
-            this.remove(weapon.Hash);
-        }
-        else {
-            RemoveWeaponFromPed(this.owner.Handle, weapon);
-        }
-    }
-    /**
-     * remove all weapons from ped
-     *
-     */
-    removeAll() {
-        RemoveAllPedWeapons(this.owner.Handle, true);
-        this.weapons.clear();
-    }
-    /**
-     * Drop ped current weapon?
-     * todo: this native seems does not work as expected, need to investigate
-     * refer1: https://docs.fivem.net/natives/?_0x6B7513D9966FBEC0
-     * refer2: https://forum.cfx.re/t/release-weapondrop/49856/8
-     *
-     */
-    drop() {
-        SetPedDropsWeapon(this.owner.Handle);
-    }
-    /**
-     * create weapon object and add to collection
-     *
-     * @param hash
-     * @private
-     */
-    createAndAddWeapon(hash) {
-        const uintHash = hash >>> 0;
-        const weapon = new Weapon(this.owner, uintHash);
-        this.weapons.set(uintHash, weapon);
-        return weapon;
-    }
-}