@cybermp-community/server-types 1.0.6 → 1.1.0

package/LICENSE

@@ -1,21 +1,19 @@
-MIT License
+Creative Commons Attribution-ShareAlike 4.0 International
 
 Copyright (c) 2026 CyberMP Community Developers
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
+International License. To view a copy of this license, visit
+https://creativecommons.org/licenses/by-sa/4.0/ or send a letter to
+Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+You are free to:
+- Share: copy and redistribute the material in any medium or format
+- Adapt: remix, transform, and build upon the material for any purpose,
+  even commercially
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Under the following terms:
+- Attribution: You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made.
+- ShareAlike: If you remix, transform, or build upon the material, you
+  must distribute your contributions under the same license as the original.

package/README.md

@@ -30,4 +30,4 @@ This repository is developed by [CyberMP Community Developers](https://gitlab.co
 
 ## ⚖️ License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the СС BY-SA 4.0 License - see the [LICENSE](LICENSE) file for details.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cybermp-community/server-types",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "TypeScript type definitions for the CyberMP server-side environment.",
-  "license": "MIT",
+  "license": "CC BY-SA 4.0",
   "author": {
     "name": "An1by",
     "url": "https://gitlab.com/an1by"
@@ -29,6 +29,9 @@
     "src"
   ],
   "scripts": {
+    "format": "biome format --write .",
+    "lint": "biome lint .",
+    "check": "biome check .",
     "bump": "npm version patch --no-git-tag-version",
     "pub": "npm publish --access public"
   },
@@ -40,5 +43,8 @@
     "server",
     "cp2077",
     "types"
-  ]
-}
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0"
+  }
+}

package/src/{commands.d.ts → commands.ts}

@@ -1,10 +1,10 @@
-import type { MpPlayer } from './entities/player';
+import type { MpPlayer } from './players';
 
 export interface MpCommands {
   /**
    * Register a command in the server scope.
    * @param commandName Command name without "/".
-   * @param callback Callback with id and args.
+   * @param callback Callback with player and args.
    */
   add(
     commandName: string,

package/src/entities/{entity.d.ts → entity.ts}

@@ -1,5 +1,9 @@
-import type { MpPlayer } from './player';
-import type { Rotation, Vector3 } from '../shared';
+import type { MpObject } from '../objects';
+import type { MpPed } from '../peds';
+import type { MpPickup } from '../pickups';
+import type { Rotation, Vector3 } from '../shared';
+import type { MpVehicle } from '../vehicles';
+import type { MpPlayer } from './player';
 
 export enum EntityType {
   Player = 1,
@@ -10,17 +14,25 @@ export enum EntityType {
   GameObject = 6,
 }
 
-export interface MpEntity {
-  readonly id: number;
-  readonly owner: MpPlayer;
-  readonly firstOwner: MpPlayer;
-  readonly position: Vector3;
-  readonly rotation: Rotation;
-  readonly yaw: number;
-  readonly type: EntityType;
-  readonly exist: boolean;
-
-  dimension: number;
+export type MpAnyEntity =
+  | MpPlayer
+  | MpVehicle
+  | MpObject
+  | MpPed
+  | MpPickup
+  | MpEntity<EntityType.GameObject>;
+
+export interface MpEntity<TEntityType extends EntityType = EntityType> {
+  readonly id: number;
+  readonly owner: MpPlayer;
+  readonly firstOwner: MpPlayer;
+  readonly position: Vector3;
+  readonly rotation: Rotation;
+  readonly yaw: number;
+  readonly type: TEntityType;
+  readonly exist: boolean;
+
+  dimension: number;
   streamingRadius: number;
 
   getMeta<T = any>(key: string): T;
@@ -31,4 +43,4 @@ export interface MpEntities<T extends MpEntity = MpEntity> {
   exists(entity: T | number): boolean;
 
   at(entity: T | number): T;
-}
+}

package/src/entities/{player.d.ts → player.ts}

@@ -1,16 +1,18 @@
-import type { MpEntities, MpEntity } from './entity';
+import type { EntityType, MpEntities, MpEntity } from './entity';
 import type { Vector3 } from '../shared';
 import type { MpVehicle } from '../vehicles';
 
-export type PlayerIdentifierType = 'steam' | 'ip';
+export type MpPlayerIdentifierType = 'steam' | 'ip';
+export type PlayerIdentifierType = MpPlayerIdentifierType;
 
-export interface MpPlayer extends MpEntity {
+export interface MpPlayer extends MpEntity<EntityType.Player> {
   readonly velocity: Vector3;
   readonly health: number;
   readonly nickname: string;
   readonly ping: number;
   readonly vehicle: MpVehicle | null;
   readonly lastVehicle: MpVehicle | null;
+  readonly ip: string;
 
   kick(reason?: string): void;
   getIdentifier(type: PlayerIdentifierType): string;

package/src/events/{events.d.ts → events.ts}

@@ -1,5 +1,5 @@
-import { MpPlayer } from "../entities";
-import { MpEventsMap } from "./map";
+import type { MpPlayer } from "../players";
+import type { MpEventsMap } from "./map";
 
 export interface MpEvents {
   /**
@@ -49,4 +49,4 @@ export interface MpEvents {
     eventName: string,
     ...args: any[]
   ): void;
-}
+}

package/src/events/index.ts

@@ -0,0 +1,3 @@
+export * from "./events";
+export * from "./map";
+export * from "./types";

package/src/events/map.ts

@@ -0,0 +1,102 @@
+import type { VehicleSeat } from '../vehicles';
+import type { EntityType } from '../entities';
+import type { GameHash, Vector3Object } from '../shared';
+import type {
+  DamageEventData,
+  DoorStateChangeEventData,
+  ExplosionEventData,
+  FireEventData,
+  LiftStateChangeEventData,
+  MeleeActionEventData,
+  PickupChangeEventData,
+  PickupCreateEventData,
+  PickupDespawnEventData,
+  PlayerAppearanceChangeEventData,
+  PlayerDeathEventData,
+  ShootActionEventData,
+  ThrowGrenadeEventData,
+  VehicleCustomizationChangeEventData,
+  VehicleDestructionChangeEventData,
+  VehicleHittedByPlayerEventData,
+  VehicleWeaponShootEventData,
+} from './types';
+
+export interface MpEventsMap {
+  anyResourceStart(resourceName: string): void;
+  anyResourceStop(resourceName: string): void;
+  anyServerResourceStart(resourceName: string): void;
+  anyServerResourceStop(resourceName: string): void;
+  resourceStart(): void;
+  resourceStop(): void;
+  resourcesRefresh(): void;
+
+  playerConnecting(tempId: number, name: string): void;
+  playerConnected(playerId: number, tempId: string): void;
+  playerSpawn(playerId: number): void;
+  playerRespawn(playerId: number, data: Vector3Object): void;
+  playerDespawn(playerId: number): void;
+  playerDeath(playerId: number, data: PlayerDeathEventData): void;
+  playerDisconnected(playerId: number, reason: string): void;
+  playerAppearanceChange(
+    playerId: number,
+    data: PlayerAppearanceChangeEventData,
+  ): undefined | boolean;
+  playerHealing(playerId: number): undefined | boolean;
+  playerKnockdown(playerId: number): undefined | boolean;
+
+  damage(playerId: number, data: DamageEventData): undefined | boolean;
+  meleeAction(playerId: number, data: MeleeActionEventData): undefined | boolean;
+  shootAction(playerId: number, data: ShootActionEventData): undefined | boolean;
+  weaponReload(playerId: number, weaponHash: GameHash): undefined | boolean;
+  throwGrenade(playerId: number, data: ThrowGrenadeEventData): undefined | boolean;
+
+  fire(playerId: number, data: FireEventData): undefined | boolean;
+  explosion(playerId: number, data: ExplosionEventData): undefined | boolean;
+
+  doorStateChange(
+    playerId: number,
+    data: DoorStateChangeEventData,
+  ): undefined | boolean;
+  liftStateChange(
+    playerId: number,
+    data: LiftStateChangeEventData,
+  ): undefined | boolean;
+
+  entitySpawn(id: number, type: EntityType): void;
+  entityDespawn(id: number, type: EntityType): void;
+  objectSpawn(id: number): void;
+  objectDespawn(id: number): void;
+  pedSpawn(id: number): void;
+  pedDespawn(id: number): void;
+  gameObjectSpawn(id: number): void;
+  gameObjectDespawn(id: number): void;
+
+  vehicleCustomizationChange(
+    playerId: number,
+    data: VehicleCustomizationChangeEventData,
+  ): void;
+  vehicleDestructionChange(
+    playerId: number,
+    data: VehicleDestructionChangeEventData,
+  ): void;
+  vehicleSpawn(id: number): void;
+  vehicleDespawn(id: number): void;
+  vehicleWeaponShoot(
+    id: number,
+    data: VehicleWeaponShootEventData,
+  ): undefined | boolean;
+  vehicleHittedByPlayer(
+    id: number,
+    data: VehicleHittedByPlayerEventData,
+  ): undefined | boolean;
+  exitVehicle(id: number): void;
+  enterVehicle(id: number, seat: VehicleSeat): void;
+
+  pickupChange(playerId: number, data: PickupChangeEventData): undefined | boolean;
+  pickupRaise(playerId: number, data: PickupDespawnEventData): undefined | boolean;
+  pickupDrop(playerId: number, data: PickupCreateEventData): undefined | boolean;
+  pickupSpawn(id: number): void;
+  pickupDespawn(id: number): void;
+}
+
+export type { MeleeActionType } from './types';

package/src/events/types.ts

@@ -0,0 +1,184 @@
+import type { GameHash, Vector3Object } from '../shared';
+
+export interface DamageEventData {
+  damageType: number;
+  weaponHash: GameHash;
+  totalDamage: number;
+  killerId: number;
+  victimId: number;
+  hitComponent: number;
+  hitPositionX: number;
+  hitPositionY: number;
+  hitPositionZ: number;
+  hitDirectionX: number;
+  hitDirectionY: number;
+  hitDirectionZ: number;
+  damageValues: number[];
+  flags: number[];
+  compName: string;
+  dismembermentParts: any[];
+  hitReactionZones: any[];
+  hitShapeTypes: any[];
+  hitShapeNames: string[];
+  physicsMaterials: string[];
+}
+
+export enum MeleeActionType {
+  QuickMelee = 1,
+  ComboAttack1 = 2,
+  ComboAttack2 = 3,
+  StrongAttack = 4,
+  FinalAttack = 5,
+  JumpAttack = 6,
+  SprintAttack = 7,
+  CrouchAttack = 8,
+}
+
+export type MeleeActionEventData = Vector3Object & {
+  type: MeleeActionType;
+  weaponHash: GameHash;
+  instigatorID: number;
+};
+
+export type ShootActionEventData = Vector3Object & {
+  weaponHash: GameHash;
+  instigatorID: number;
+};
+
+export interface ThrowGrenadeEventData {
+  weaponHash: GameHash;
+  type: number;
+  isQuickThrow: boolean;
+  accelerationZ: number;
+  initialVelocity: number;
+  forwardX: number;
+  forwardY: number;
+  forwardZ: number;
+  aimposX: number;
+  aimposY: number;
+  aimposZ: number;
+}
+
+export type DoorStateChangeEventData = Vector3Object & {
+  hashObject: GameHash;
+  state: boolean;
+};
+
+export type LiftStateChangeEventData = Vector3Object & {
+  hashObject: GameHash;
+  playerID: number;
+  targetFloor: number;
+  currentFloor: number;
+  maxFloor: number;
+};
+
+export type ExplosionEventData = Vector3Object & {
+  isVehicle: boolean;
+  vehicleID: number;
+  hashObject: GameHash;
+  objNetID: number;
+};
+
+export interface AppearancePropertyData {
+  meshType: number;
+  isEnabed: boolean;
+  pathToMesh: GameHash;
+  appearanceHash: GameHash;
+  chunkMask: GameHash;
+}
+
+export interface AppearanceWeightPropertyData {
+  targetHash: GameHash;
+  regionHash: GameHash;
+  weight: number;
+}
+
+export interface PlayerAppearanceChangeEventData {
+  skinneds: AppearancePropertyData[];
+  garments: AppearancePropertyData[];
+  morphs: AppearancePropertyData[];
+  weights: AppearanceWeightPropertyData[];
+}
+
+export interface PlayerDeathEventData {
+  killerId?: number;
+}
+
+export interface VehicleCustomizationChangeEventData {
+  isVehicleWasCustomized: boolean;
+  isEnabledVehCustomization: boolean;
+  isDisabledVehCustomizationByDamage: boolean;
+  lightsColorDefined: boolean;
+  lightsColorHue: number;
+  primaryColorR: number;
+  primaryColorG: number;
+  primaryColorB: number;
+  primaryColorDefined: boolean;
+  secondaryColorR: number;
+  secondaryColorG: number;
+  secondaryColorB: number;
+  secondaryColorDefined: boolean;
+  vehicleID: number;
+  hashAppearance: GameHash;
+}
+
+export interface VehicleDestructionChangeEventData {
+  vehicleID: number;
+  brokenGlass: number;
+  brokenLights: number;
+  flatTire: number;
+  windshieldShattered: boolean;
+}
+
+export interface VehicleWeaponShootEventData {
+  type: number;
+  numBullets: number;
+  vehicleType: number;
+  waeponHash: GameHash;
+  slotHash: GameHash;
+  animHash: GameHash;
+  weaponPosX: number;
+  weaponPosY: number;
+  weaponPosZ: number;
+  offsetPosX: number;
+  offsetPosY: number;
+  offsetPosZ: number;
+  tracePosX: number;
+  tracePosY: number;
+  tracePosZ: number;
+}
+
+export interface VehicleHittedByPlayerEventData {
+  componentNameHash: GameHash;
+  tweaponHash: GameHash;
+  byOwner: boolean;
+}
+
+export type FireEventData = Vector3Object & {
+  hashObject: GameHash;
+  dirX: number;
+  dirY: number;
+  dirZ: number;
+};
+
+export interface PickupChangeEventData {
+  pickupNetId: number;
+  pickupHash: GameHash;
+  pickupHashes: GameHash[];
+}
+
+export interface PickupDespawnEventData {
+  pickupNetId: number;
+  pickupHash: GameHash;
+  isBag: boolean;
+}
+
+export type PickupCreateEventData = Vector3Object & {
+  pickupNetId: number;
+  pickupHash: GameHash;
+  pickupHashes: GameHash[];
+  isBag: boolean;
+};
+
+export type PickupDropEventData = PickupCreateEventData;
+

package/src/index.ts

@@ -1,13 +1,15 @@
-export type * from './commands';
-export type * from './entities';
-export type * from './events';
-export type * from './hashes';
-export type * from './meta';
-export type * from './mp';
-export type * from './objects';
-export type * from './peds';
-export type * from './pickups';
-export type * from './resources';
-export type * from './shared';
-export type * from './vehicles';
-export type * from './voice-chat';
+export * from './commands';
+export * from './entities';
+export * from './events';
+export * from './exports';
+export * from './hashes';
+export * from './meta';
+export * from './mp';
+export * from './objects';
+export * from './peds';
+export * from './pickups';
+export * from './players';
+export * from './resources';
+export * from './shared';
+export * from './vehicles';
+export * from './voice-chat';

package/src/{meta.d.ts → meta.ts}

@@ -1,5 +1,5 @@
 import type { MpEntity } from './entities';
-import type { MpPlayer } from './entities/player';
+import type { MpPlayer } from './players';
 
 export interface MpMeta {
   setGlobalMeta(key: string, value: any, sync?: boolean): void;

package/src/mp/config.d.ts

@@ -1,38 +1,43 @@
-export namespace MpServer {
-    export type CoreOverrides = {
-        change_player_on_death_logic?: boolean;
-        disable_side_quests_notifications?: boolean;
-        change_vehicles_logic?: boolean;
-        disable_player_inventory_encumbrance?: boolean;
-        player_extended_customization?: boolean;
-        disable_time_skip?: boolean;
-        disable_turrets?: boolean;
-        disable_surveillance_cameras?: boolean;
-        disable_vending_machines?: boolean;
-        disable_generic_devices?: boolean;
-        disable_no_combat?: boolean;
-    };
-
-    export type CoreConfig = {
-        nametags?: boolean;
-        disable_switch_seats?: boolean;
-        delete_map_objects?: boolean;
-        default_gameplay_restrictions?: boolean;
-        disable_drop_points?: boolean;
-        disable_location_dependent_quests?: boolean;
-        disable_garage?: boolean;
-        overrides?: CoreOverrides;
-        files?: string[];
-    };
-
-    export type ServerConfig = {
-        tcp_host: string;
-        udp_host: string;
-        connection_host_addr: string;
-        max_players: number;
-        secret_token: string;
-        resources: string[];
-        disable_VoIP_server: boolean;
-        core?: CoreConfig;
-    };
-}
+export namespace MpServer {
+  export interface CoreOverrides {
+    change_player_on_death_logic?: boolean;
+    disable_side_quests_notifications?: boolean;
+    change_vehicles_logic?: boolean;
+    disable_player_inventory_encumbrance?: boolean;
+    player_extended_customization?: boolean;
+    disable_time_skip?: boolean;
+    disable_turrets?: boolean;
+    disable_surveillance_cameras?: boolean;
+    disable_vending_machines?: boolean;
+    disable_generic_devices?: boolean;
+    disable_no_combat?: boolean;
+  }
+
+  export interface CoreConfig {
+    nametags?: boolean;
+    death_autostand?: boolean;
+    disable_switch_seats?: boolean;
+    delete_map_objects?: boolean;
+    default_gameplay_restrictions?: boolean;
+    disable_drop_points?: boolean;
+    disable_location_dependent_quests?: boolean;
+    disable_garage?: boolean;
+    overrides?: CoreOverrides;
+    files?: string[];
+  }
+
+  export interface ServerConfig {
+    tcp_host: string;
+    udp_host: string;
+    connection_host_addr: string;
+    max_players: number;
+    secret_token: string;
+    resources: string[];
+    disable_VoIP_server: boolean;
+    core?: CoreConfig;
+  }
+}
+
+export type CoreOverrides = MpServer.CoreOverrides;
+export type CoreConfig = MpServer.CoreConfig;
+export type ServerConfig = MpServer.ServerConfig;

package/src/mp/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./multiplayer"
-export * from "./internal-multiplayer";
+export type { CoreConfig, CoreOverrides, ServerConfig } from "./config";
+export * from "./multiplayer";
+export * from "./internal-multiplayer";

package/src/mp/multiplayer.d.ts

@@ -1,16 +1,17 @@
 import type { MpCommands } from '../commands';
-import type { MpEntities } from '../entities';
+import type { MpEntities, MpEntity } from '../entities';
 import type { MpEvents } from '../events';
+import type { MpExports } from '../exports';
 import type { MpHashes } from '../hashes';
 import type { MpMeta } from '../meta';
-import type { MpObjects } from '../objects';
-import type { MpPeds } from '../peds';
-import type { MpPickups } from '../pickups';
-import type { MpPlayers } from '../entities/player';
+import type { MpObject, MpObjects } from '../objects';
+import type { MpPed, MpPeds } from '../peds';
+import type { MpPickup, MpPickups } from '../pickups';
+import type { MpPlayer, MpPlayers } from '../players';
 import type { MpResources } from '../resources';
-import type { MpVehicles } from '../vehicles';
+import type { Class } from '../shared';
+import type { MpVehicle, MpVehicles } from '../vehicles';
 import type { MpServer as MpServ } from './config';
-import type { MpExports } from '../exports';
 
 export interface MpServer {
   events: MpEvents;
@@ -26,6 +27,15 @@ export interface MpServer {
   peds: MpPeds;
   hashes: MpHashes;
 
+  cancelEvent(): void;
+
+  MpPlayer: Class<MpPlayer>;
+  MpEntity: Class<MpEntity>;
+  MpPickup: Class<MpPickup>;
+  MpVehicle: Class<MpVehicle>;
+  MpPed: Class<MpPed>;
+  MpObject: Class<MpObject>;
+
   /**
    * Checks if the code is running on the server.
    * @returns True if running on server, false otherwise.
@@ -35,4 +45,4 @@ export interface MpServer {
   config: MpServ.ServerConfig & Record<string, string>;
 }
 
-export const mp: MpServer;
+export const mp: MpServer;

package/src/{objects.d.ts → objects.ts}

@@ -1,19 +1,19 @@
-import type { MpEntities, MpEntity } from './entities';
+import type { EntityType, MpEntities, MpEntity } from './entities';
 import type { TweakDBID, Vector3 } from './shared';
 
-export interface MpObject extends MpEntity {
+export interface MpObject extends MpEntity<EntityType.GameObject> {
   readonly model: TweakDBID;
 
   destroy(): void;
 }
 
-export type CreateObjectOptions = {
+export interface CreateObjectOptions {
   model: TweakDBID;
   position: Vector3;
   yaw?: number;
   dynamic?: boolean;
   dimension?: number;
-};
+}
 
 export interface MpObjects extends MpEntities<MpObject> {
   create(options: CreateObjectOptions): MpObject;

package/src/{peds.d.ts → peds.ts}

@@ -1,7 +1,7 @@
-import type { MpEntities, MpEntity } from './entities';
+import type { EntityType, MpEntities, MpEntity } from './entities';
 import type { CName, TweakDBID, Vector3 } from './shared';
 
-export interface MpPed extends MpEntity {
+export interface MpPed extends MpEntity<EntityType.Ped> {
   readonly health: number;
   readonly model: TweakDBID;
   readonly appearance: CName;
@@ -9,14 +9,14 @@ export interface MpPed extends MpEntity {
   destroy(): void;
 }
 
-export type CreatePedOptions = {
+export interface CreatePedOptions {
   model: TweakDBID;
   appearance: CName;
   position: Vector3;
   health?: number;
   yaw?: number;
   dimension?: number;
-};
+}
 
 export interface MpPeds extends MpEntities<MpPed> {
   create(options: CreatePedOptions): MpPed;

package/src/{pickups.d.ts → pickups.ts}

@@ -1,4 +1,4 @@
-import type { MpEntities, MpEntity } from './entities';
+import type { EntityType, MpEntities, MpEntity } from './entities';
 import type { TweakDBID, Vector3 } from './shared';
 
 export enum PickupType {
@@ -7,14 +7,14 @@ export enum PickupType {
   Other = 3,
 }
 
-export interface MpPickup extends MpEntity {
+export interface MpPickup extends MpEntity<EntityType.Pickup> {
   readonly model: TweakDBID;
   readonly pickupType: PickupType;
 
   destroy(): void;
 }
 
-export type CreatePickupOptions = {
+export interface CreatePickupOptions {
   model: TweakDBID;
   type: PickupType;
   position: Vector3;

package/src/players.ts

@@ -0,0 +1 @@
+export * from './entities/player';

package/src/shared/index.ts

@@ -0,0 +1,7 @@
+export * from "./transform";
+export * from "./hash";
+
+export interface Class<T, Arguments extends unknown[] = any[]> {
+  prototype: Pick<T, keyof T>;
+  new (...arguments_: Arguments): T;
+}

package/src/shared/{transform.d.ts → transform.ts}

@@ -2,8 +2,8 @@ export type Vector3 = [x: number, y: number, z: number];
 export type Vector4 = [x: number, y: number, z: number, w: number];
 export type Rotation = [pitch: number, roll: number, yaw: number];
 
-export type Vector3Object = {
+export interface Vector3Object {
     posX: number;
     posY: number;
     posZ: number;
-};
+}

package/src/{vehicles.d.ts → vehicles.ts}

@@ -1,5 +1,6 @@
-import type { MpPlayer, MpEntities, MpEntity } from './entities';
-import type { CName, TweakDBID, Vector3 } from './shared';
+import type { EntityType, MpEntities, MpEntity } from "./entities";
+import type { MpPlayer } from "./players";
+import type { CName, TweakDBID, Vector3 } from "./shared";
 
 export enum VehicleSeat {
   Driver = 0,
@@ -8,27 +9,38 @@ export enum VehicleSeat {
   RearRight = 3,
 }
 
-export interface MpVehicle extends MpEntity {
+export interface MpVehicle extends MpEntity<EntityType.Vehicle> {
   readonly model: TweakDBID;
   readonly appearance: CName;
   readonly health: number;
   readonly velocity: Vector3;
   readonly angularVelocity: Vector3;
 
+  seats: MpVehicleSeats;
+
+  lastSeats: MpVehicleSeats;
+
   getPlayerInSeat(seat: VehicleSeat): MpPlayer | null;
   getLastPlayerInSeat(seat: VehicleSeat): MpPlayer | null;
 
   destroy(): void;
 }
 
-export type CreateVehicleOptions = {
+export interface MpVehicleSeats {
+  readonly driver: MpPlayer | null;
+  readonly passenger: MpPlayer | null;
+  readonly rearLeft: MpPlayer | null;
+  readonly rearRight: MpPlayer | null;
+}
+
+export interface CreateVehicleOptions {
   model: TweakDBID;
   appearance: CName;
   position: Vector3;
   yaw?: number;
   health?: number;
   dimension?: number;
-};
+}
 
 export interface MpVehicles extends MpEntities<MpVehicle> {
   create(options: CreateVehicleOptions): MpVehicle;

package/src/{voice-chat.d.ts → voice-chat.ts}

@@ -1,4 +1,4 @@
-import type { MpPlayer } from './entities';
+import type { MpPlayer } from './players';
 
 /**
  * Interface representing the voice chat management system on the server.
@@ -9,7 +9,7 @@ export interface MpVoiceChat {
    * @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;
+  mutePlayer(player: MpPlayer | number, state?: boolean): void;
 
   /**
    * Creates a new voice chat channel.

package/src/events/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./events";
-export * from "./map";

package/src/events/map.d.ts

@@ -1,180 +0,0 @@
-import type { EntityType } from '../entities';
-import type { GameHash, Vector3Object } from '../shared';
-
-export type DamageEventData = {
-  damageType: number;
-  weaponHash: GameHash;
-  totalDamage: number;
-  killerId: number;
-  victimId: number;
-  hitComponent: number;
-  hitPositionX: number;
-  hitPositionY: number;
-  hitPositionZ: number;
-  hitDirectionX: number;
-  hitDirectionY: number;
-  hitDirectionZ: number;
-  damageValues: number[];
-  flags: number[];
-  compName: string;
-  dismembermentParts: any[];
-  hitReactionZones: any[];
-  hitShapeTypes: any[];
-  hitShapeNames: string[];
-  physicsMaterials: string[];
-};
-
-export type DoorStateChangeEventData = Vector3Object & {
-  hashObject: GameHash;
-  state: boolean;
-};
-
-export type LiftStateChangeEventData = Vector3Object & {
-  hashObject: GameHash;
-  playerID: number;
-  targetFloor: number;
-  currentFloor: number;
-  maxFloor: number;
-};
-
-export type ExplosionEventData = Vector3Object & {
-  isVehicle: boolean;
-  vehicleID: number;
-  hashObject: GameHash;
-  objNetID: number;
-};
-
-export type AppearancePropertyData = {
-  meshType: number;
-  isEnabed: boolean;
-  pathToMesh: GameHash;
-  appearanceHash: GameHash;
-  chunkMask: GameHash;
-};
-
-export type AppearanceWeightPropertyData = {
-  targetHash: GameHash;
-  regionHash: GameHash;
-  weight: number;
-};
-
-export type PlayerAppearanceChangeEventData = {
-  skinneds: AppearancePropertyData[];
-  garments: AppearancePropertyData[];
-  morphs: AppearancePropertyData[];
-  weights: AppearanceWeightPropertyData[];
-};
-
-export type PlayerDeathEventData = {
-  killerId?: number;
-};
-
-export type VehicleCustomizationChangeEventData = {
-  isVehicleWasCustomized: boolean;
-  isEnabledVehCustomization: boolean;
-  isDisabledVehCustomizationByDamage: boolean;
-  lightsColorDefined: boolean;
-  lightsColorHue: number;
-  primaryColorR: number;
-  primaryColorG: number;
-  primaryColorB: number;
-  primaryColorDefined: boolean;
-  secondaryColorR: number;
-  secondaryColorG: number;
-  secondaryColorB: number;
-  secondaryColorDefined: boolean;
-  vehicleID: number;
-  hashAppearance: GameHash;
-};
-
-export type VehicleDestructionChangeEventData = {
-  vehicleID: number;
-  brokenGlass: number;
-  brokenLights: number;
-  flatTire: number;
-  windshieldShattered: boolean;
-};
-
-export type FireEventData = Vector3Object & {
-  hashObject: GameHash;
-  dirX: number;
-  dirY: number;
-  dirZ: number;
-};
-
-export type PickupChangeEventData = {
-  pickupNetId: number;
-  pickupHash: GameHash;
-  pickupHashes: GameHash[];
-};
-
-export type PickupDespawnEventData = {
-  pickupNetId: number;
-  pickupHash: GameHash;
-  isBag: boolean;
-};
-
-export type PickupCreateEventData = Vector3Object & {
-  pickupNetId: number;
-  pickupHash: GameHash;
-  pickupHashes: GameHash[];
-  isBag: boolean;
-};
-
-export interface MpEventsMap {
-  anyResourceStart(resourceName: string): void;
-  anyResourceStop(resourceName: string): void;
-  anyServerResourceStart(resourceName: string): void;
-  anyServerResourceStop(resourceName: string): void;
-  resourceStart(): void;
-  resourceStop(): void;
-  resourcesRefresh(): void;
-
-  playerConnecting(tempId: number, name: string): void;
-  playerConnected(playerId: number, tempId: string): void;
-  playerSpawn(playerId: number): void;
-  playerRespawn(playerId: number, data: Vector3Object): void;
-  playerDespawn(playerId: number): void;
-  playerDeath(playerId: number, data: PlayerDeathEventData): void;
-  playerDisconnected(playerId: number, reason: string): void;
-  playerAppearanceChange(
-    playerId: number,
-    data: PlayerAppearanceChangeEventData,
-  ): void;
-
-  damage(playerId: number, data: DamageEventData): void;
-  fire(playerId: number, data: FireEventData): void;
-  explosion(playerId: number, data: ExplosionEventData): void;
-
-  doorStateChange(playerId: number, data: DoorStateChangeEventData): void;
-  liftStateChange(playerId: number, data: LiftStateChangeEventData): void;
-
-  entitySpawn(id: number, type: EntityType): void;
-  entityDespawn(id: number, type: EntityType): void;
-
-  objectSpawn(id: number): void;
-  objectDespawn(id: number): void;
-
-  pedSpawn(id: number): void;
-  pedDespawn(id: number): void;
-
-  gameObjectSpawn(id: number): void;
-  gameObjectDespawn(id: number): void;
-
-  vehicleCustomizationChange(
-    playerId: number,
-    data: VehicleCustomizationChangeEventData,
-  ): void;
-  vehicleDestructionChange(
-    playerId: number,
-    data: VehicleDestructionChangeEventData,
-  ): void;
-  vehicleSpawn(id: number): void;
-  vehicleDespawn(id: number): void;
-
-  pickupChange(playerId: number, data: PickupChangeEventData): void;
-  pickupRaise(playerId: number, data: PickupDespawnEventData): void;
-  pickupDrop(playerId: number, data: PickupCreateEventData): void;
-  pickupSpawn(id: number): void;
-  pickupDespawn(id: number): void;
-}

package/src/shared/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./transform"
-export * from "./hash"