rock-mod 0.20.0 → 0.21.0

package/dist/client/entities/ccmp/player/CCMPPlayersManager.js

@@ -0,0 +1,318 @@
+import { ClientInternalEventName } from "../../../net/common/events/types";
+import { CCMPPlayer } from "./CCMPPlayer";
+/**
+ * Реализация `IPlayersManager` под CCMP — single source of truth для
+ * `IPlayer`-инстансов и `rm::playerReady`/`rm::playerConnected`-эмиссий
+ * с настоящими `CCMPPlayer`-инстансами.
+ *
+ * ### Хранилище
+ *
+ * `Map<id, CCMPPlayer>`. У CCMP нет отдельных `id`/`remoteId` как в RageMP:
+ * один числовой `id` приходит от сервера, и он же используется везде.
+ * `findByID`/`findByRemoteID`/`findByRemoteId` маппятся на один lookup.
+ *
+ * ### Жизненный цикл local player'а
+ *
+ * `ccmp.players.local` (backed by `op_get_local_player_id`) валиден сразу
+ * после handshake'а — `PlayerManager::set_local_player_id` срабатывает до
+ * того, как scripts загружаются. Мы используем его, чтобы синхронно
+ * выпустить `rm::playerReady` как sticky-event (см. ниже):
+ *
+ *  1. **На конструкторе** — fast-path. Если local op возвращает игрока,
+ *     эмитим `rm::playerReady` через `emitInternalSticky` с реальным
+ *     `CCMPPlayer`-инстансом. Sticky-кэш гарантирует, что поздние
+ *     подписчики из async DI-bootstrap'а геймода тоже получат сигнал
+ *     при подписке.
+ *  2. **На `connectionStateChanged`** — fallback / handler реконнекта.
+ *     Если на конструкторе local ещё не был валиден (handshake race),
+ *     `connected = true` запустит retry fast-path. На `connected = false`
+ *     чистим _localPlayer и sticky-кэш, чтобы при следующем connect'е
+ *     эмитнуть с актуальным remoteId.
+ *
+ * `CCMPPlayer`-инстанс важен (а не структурный stub) потому что
+ * `RockModStateAdapter` в геймоде хранит `rockModPlayer`-ссылку и через
+ * неё вызывает методы (`setNoCollision`, etc). На структурном stub'е
+ * без методов это падало бы с `TypeError`.
+ *
+ * ### Remote-игроки
+ *
+ * Источники:
+ *  - `ccmp.players.all` — prepopulation для уже-существующих на момент
+ *    подключения (заполнен Rust'ом в `ClientScriptingService::init`).
+ *  - `rm::playerConnected`/`rm::playerDisconnected` internal events
+ *    (эмитит `CCMPEventsBridge` из нативных `ccmp.on('playerConnected'/...)`).
+ */
+export class CCMPPlayersManager {
+    constructor(events) {
+        var _a;
+        this._players = new Map();
+        this._localPlayer = null;
+        // Iterator реализован inline — у CCMP нет per-dimension/per-range
+        // фильтрации игроков на JS-уровне.
+        this._iterator = {
+            all: () => this._players.values(),
+            dimension: (value) => this._iterateDimension(value),
+            range2D: (center, range) => this._iterateRange2D(center, range),
+            range3D: (center, range) => this._iterateRange3D(center, range),
+        };
+        this._events = events;
+        // 1) Subscribe ПЕРВЫМ — чтобы между подпиской и prepopulation'ом не
+        // пропустить параллельный `rm::playerConnected`.
+        this._events.onInternal({
+            [ClientInternalEventName.PlayerReady]: (player) => {
+                // Если кто-то ещё эмитнул rm::playerReady (например, cooperation
+                // fallback в будущем) — синхронизируем своё состояние.
+                this._ensurePlayer(player.remoteId, player.name, /* isLocal */ true);
+            },
+            [ClientInternalEventName.PlayerConnected]: (player) => {
+                this._ensurePlayer(player.remoteId, player.name, /* isLocal */ false);
+            },
+            [ClientInternalEventName.PlayerDisconnected]: (player) => {
+                const existing = this._players.get(player.remoteId);
+                if (existing) {
+                    existing.markRemoved();
+                    this._players.delete(player.remoteId);
+                }
+            },
+        });
+        this._registerNativePlayerEvents();
+        // 2) Prepopulate уже-существующих remote-игроков из CCMP-runtime'а.
+        // `ccmp.players.all` исключает local (см. js_runtime.rs::setup_globals).
+        try {
+            for (const ccmpPlayer of ccmp.players.all) {
+                this._ensurePlayer(ccmpPlayer.id, (_a = ccmpPlayer.name) !== null && _a !== void 0 ? _a : "", /* isLocal */ false);
+            }
+        }
+        catch (error) {
+            console.warn("[CCMPPlayersManager] failed to prepopulate from ccmp.players.all:", error);
+        }
+        // 3) Fast-path: попытка эмитнуть rm::playerReady сразу. Если local не
+        // готов (handshake ещё не отработал) — пропускаем, дальше connectionStateChanged
+        // подберёт.
+        this._tryEmitLocalPlayerReady();
+        // 4) Retry-on-reconnect + reset-on-disconnect. Listener регистрируем
+        // через `ccmp.on` напрямую (не через bridge), чтобы наша логика была
+        // независимой от состояния других менеджеров.
+        ccmp.on("connectionStateChanged", (state) => {
+            if (state === null || state === void 0 ? void 0 : state.connected) {
+                this._tryEmitLocalPlayerReady();
+            }
+            else {
+                this._handleDisconnect();
+            }
+        });
+    }
+    // -- IPlayersManager ------------------------------------------------------
+    findLocalPlayer() {
+        // Кэшированный _localPlayer проставлен из rm::playerReady-эмиссии
+        // (либо нашей собственной из конструктора, либо чьей-то ещё).
+        // Если кэш пуст, lazy-retry: возможно local op теперь валиден.
+        if (this._localPlayer) {
+            return this._localPlayer;
+        }
+        this._tryEmitLocalPlayerReady();
+        return this._localPlayer;
+    }
+    getLocalPlayer() {
+        const player = this.findLocalPlayer();
+        if (!player) {
+            throw new Error("CCMPPlayersManager.getLocalPlayer: local player ещё не известен — handshake не завершён");
+        }
+        return player;
+    }
+    findByRemoteId(remoteId) {
+        var _a;
+        return (_a = this._players.get(remoteId)) !== null && _a !== void 0 ? _a : null;
+    }
+    getByRemoteId(remoteId) {
+        const player = this.findByRemoteId(remoteId);
+        if (!player) {
+            throw new Error(`CCMPPlayersManager.getByRemoteId: player remoteId=${remoteId} не найден`);
+        }
+        return player;
+    }
+    findByName(name) {
+        for (const player of this._players.values()) {
+            if (player.name === name) {
+                return player;
+            }
+        }
+        return null;
+    }
+    getByName(name) {
+        const player = this.findByName(name);
+        if (!player) {
+            throw new Error(`CCMPPlayersManager.getByName: player name="${name}" не найден`);
+        }
+        return player;
+    }
+    // -- IEntitiesManager -----------------------------------------------------
+    syncWithMpPool() {
+        // RageMP-pool API не существует под CCMP. Игроки управляются событиями
+        // `rm::playerConnected`/`rm::playerDisconnected`, prepopulation идёт
+        // из `ccmp.players.all` в конструкторе. No-op для соответствия интерфейсу.
+    }
+    registerById(id) {
+        // Под CCMP мы не можем "достать" игрока по id из глобального пула без
+        // дополнительных данных (name, isLocal). Возвращаем существующего или
+        // создаём минимальный stub. Корректный путь регистрации — через события.
+        return this._ensurePlayer(id, /* name */ "", /* isLocal */ false);
+    }
+    unregisterById(id) {
+        return this.deleteById(id);
+    }
+    // -- IBaseObjectsManager / IWorldObjectsManager ---------------------------
+    findByID(id) {
+        return this.findByRemoteId(id);
+    }
+    getByID(id) {
+        return this.getByRemoteId(id);
+    }
+    findByRemoteID(remoteId) {
+        return this.findByRemoteId(remoteId);
+    }
+    getByRemoteID(remoteId) {
+        return this.getByRemoteId(remoteId);
+    }
+    deleteById(id) {
+        const player = this.getByRemoteId(id);
+        player.markRemoved();
+        this._players.delete(id);
+        if (this._localPlayer === player) {
+            this._localPlayer = null;
+            this._events.clearInternalSticky(ClientInternalEventName.PlayerReady);
+        }
+        return player;
+    }
+    get iterator() {
+        return this._iterator;
+    }
+    // -- Внутреннее -----------------------------------------------------------
+    _registerNativePlayerEvents() {
+        ccmp.on("playerConnected", (ccmpPlayer) => {
+            var _a;
+            const player = this._ensurePlayer(ccmpPlayer.id, (_a = ccmpPlayer.name) !== null && _a !== void 0 ? _a : "", /* isLocal */ false);
+            this._events.emitInternal(ClientInternalEventName.PlayerConnected, player);
+        });
+        ccmp.on("playerDisconnected", (ccmpPlayer) => {
+            var _a, _b;
+            const player = (_a = this._players.get(ccmpPlayer.id)) !== null && _a !== void 0 ? _a : this._ensurePlayer(ccmpPlayer.id, (_b = ccmpPlayer.name) !== null && _b !== void 0 ? _b : "", /* isLocal */ false);
+            player.markRemoved();
+            this._players.delete(ccmpPlayer.id);
+            if (this._localPlayer === player) {
+                this._localPlayer = null;
+                this._events.clearInternalSticky(ClientInternalEventName.PlayerReady);
+            }
+            this._events.emitInternal(ClientInternalEventName.PlayerDisconnected, player);
+        });
+        ccmp.on("playerStreamIn", (ccmpPlayer) => {
+            var _a;
+            const player = this._ensurePlayer(ccmpPlayer.id, (_a = ccmpPlayer.name) !== null && _a !== void 0 ? _a : "", /* isLocal */ false);
+            this._events.emitInternal(ClientInternalEventName.EntityStreamIn, player);
+        });
+        ccmp.on("playerStreamOut", (ccmpPlayer) => {
+            var _a, _b;
+            const player = (_a = this._players.get(ccmpPlayer.id)) !== null && _a !== void 0 ? _a : this._ensurePlayer(ccmpPlayer.id, (_b = ccmpPlayer.name) !== null && _b !== void 0 ? _b : "", /* isLocal */ false);
+            this._events.emitInternal(ClientInternalEventName.EntityStreamOut, player);
+        });
+    }
+    /**
+     * Идемпотентная точка создания/обновления CCMPPlayer. Все источники
+     * (events, prepopulation, fast-path) проходят сюда.
+     */
+    _ensurePlayer(id, name, isLocal) {
+        const existing = this._players.get(id);
+        if (existing) {
+            if (name) {
+                existing.setNameInternal(name);
+            }
+            if (isLocal && !this._localPlayer) {
+                this._localPlayer = existing;
+            }
+            return existing;
+        }
+        const player = new CCMPPlayer({
+            id,
+            name,
+            isLocal,
+        });
+        this._players.set(id, player);
+        if (isLocal) {
+            this._localPlayer = player;
+        }
+        return player;
+    }
+    /**
+     * Пытается синхронно достать local player из CCMP, создать CCMPPlayer
+     * и эмитнуть rm::playerReady как sticky-event. Идемпотентна: повторный
+     * вызов после успешной эмиссии — no-op (`_localPlayer !== null`).
+     */
+    _tryEmitLocalPlayerReady() {
+        var _a;
+        if (this._localPlayer) {
+            return;
+        }
+        let nativeLocal;
+        try {
+            nativeLocal = ccmp.players.local;
+        }
+        catch (error) {
+            console.warn("[CCMPPlayersManager] ccmp.players.local read failed:", error);
+            return;
+        }
+        if (!nativeLocal) {
+            return;
+        }
+        const localPlayer = this._ensurePlayer(nativeLocal.id, (_a = nativeLocal.name) !== null && _a !== void 0 ? _a : "", /* isLocal */ true);
+        // Sticky: поздние подписчики из async DI-bootstrap'а геймода
+        // (например `RockModMultiplayerEventsAdapter` из NetworkModule.init)
+        // получат событие сразу при подписке.
+        this._events.emitInternalSticky(ClientInternalEventName.PlayerReady, localPlayer);
+    }
+    _handleDisconnect() {
+        if (this._localPlayer) {
+            this._localPlayer.markRemoved();
+            this._players.delete(this._localPlayer.id);
+            this._localPlayer = null;
+        }
+        // Чистим sticky-кэш — иначе новые подписчики после reconnect'а получат
+        // устаревший local-player stub с прошлым remoteId.
+        this._events.clearInternalSticky(ClientInternalEventName.PlayerReady);
+    }
+    *_iterateDimension(value) {
+        for (const player of this._players.values()) {
+            if (player.dimension === value) {
+                yield player;
+            }
+        }
+    }
+    *_iterateRange2D(center, range) {
+        const squaredRange = range * range;
+        for (const player of this._players.values()) {
+            if (!player.isExists || player.handle === 0) {
+                continue;
+            }
+            const position = player.position;
+            const dx = position.x - center.x;
+            const dy = position.y - center.y;
+            if (dx * dx + dy * dy <= squaredRange) {
+                yield player;
+            }
+        }
+    }
+    *_iterateRange3D(center, range) {
+        const squaredRange = range * range;
+        for (const player of this._players.values()) {
+            if (!player.isExists || player.handle === 0) {
+                continue;
+            }
+            const position = player.position;
+            const dx = position.x - center.x;
+            const dy = position.y - center.y;
+            const dz = position.z - center.z;
+            if (dx * dx + dy * dy + dz * dz <= squaredRange) {
+                yield player;
+            }
+        }
+    }
+}

package/dist/client/entities/ccmp/vehicle/CCMPVehiclesManager.d.ts

@@ -0,0 +1,64 @@
+import { type IVehicle } from "../../common/vehicle/IVehicle";
+import { type IVehicleCreateOptions, type IVehiclesManager } from "../../common/vehicle/IVehiclesManager";
+import { type IWorldObjectsIterator } from "../../common/worldObject/IWorldObjectsIterator";
+/**
+ * Реализация `IVehiclesManager` под CCMP — **пустой пул** + native helper.
+ *
+ * ### Почему пусто
+ *
+ * RageMP даёт `mp.vehicles.toArray()`/`mp.vehicles.at(id)` — JS-side pool из
+ * stream'нутых-в-радиус транспортных средств, заполняемый рантаймом. CCMP
+ * такого пула на client-side не экспонирует:
+ *  - `ccmp.natives.vehicle.createVehicle` создаёт локальный handle без id /
+ *    replication / managed lifecycle.
+ *  - `ccmp.vehicles.*` (server-side) спавнит реплицируемые vehicle-сущности,
+ *    но клиент видит их данные через game state, а не как managed-IVehicle-
+ *    инстансы в JS-pool'е.
+ *
+ * Поэтому iterator всегда пустой, `find*` возвращает null, `get*` и `deleteById` кидают.
+ *
+ * ### Hot path: `iterator.all()` на каждый render-tick
+ *
+ * Геймод-консьюмер `VehiclePartsInteractionController.syncVehicleProximity` →
+ * `VehiclePartsInteractionService.syncState` → `VehicleService.getNearbyVehicles`
+ * → `VehicleRepository.getNearby` → `VehicleRepository.getAll` → `iterator.all()`.
+ * До этой реализации `VehiclesManager` был `createNotImplementedProxy`, и каждый
+ * frame падал `CCMPVehiclesManager.iterator.all: not implemented yet`. Теперь
+ * iterator возвращает пустой итератор — interaction-сервис тихо деградирует
+ * (нет vehicles в радиусе → нет UI-хинтов / интеракций).
+ *
+ * ### `create(...)` под CCMP
+ *
+ * Не реализован осознанно: `VehicleRepository.create(...)` в геймоде ожидает
+ * `IRockModVehicle` с id/remoteId/position/etc, а CCMP-натив `createVehicle`
+ * возвращает только handle без id-mapping'а. Для корректной поддержки нужен
+ * полноценный `CCMPVehicle`-класс и интеграция с server-side `ccmp.vehicles.*`
+ * — отдельная задача. Сейчас бросаем понятную ошибку.
+ *
+ * ### `getDisplayNameFromVehicleModel`
+ *
+ * Этот метод **реализован** — натив `getDisplayNameFromVehicleModel`
+ * (`0xB215AAC32D25D019`) экспонирован в `ccmp.natives.vehicle.*` и работает
+ * без vehicle-pool'а (принимает только modelHash, возвращает GXT-ключ или
+ * "CARNOTFOUND" для unknown-моделей).
+ *
+ * TODO: когда понадобится spawning vehicles из клиента (миссии, тестовые
+ * объекты) — реализовать через `ccmp.natives.vehicle.createVehicle` + локальный
+ * id-counter + `CCMPVehicle`-обёртку. Для синхронизированных vehicles нужна
+ * server-side фабрика с `ccmp.vehicles.create` и net-events для распространения
+ * id-mapping'а.
+ */
+export declare class CCMPVehiclesManager implements IVehiclesManager {
+    create(options: IVehicleCreateOptions): IVehicle;
+    getDisplayNameFromVehicleModel(modelHash: number): string;
+    syncWithMpPool(): void;
+    registerById(id: number): IVehicle;
+    unregisterById(id: number): IVehicle;
+    findByID(id: number): IVehicle | null;
+    getByID(id: number): IVehicle;
+    findByRemoteID(remoteId: number): IVehicle | null;
+    getByRemoteID(remoteId: number): IVehicle;
+    deleteById(id: number): IVehicle;
+    get iterator(): IWorldObjectsIterator<IVehicle>;
+    private readonly _iterator;
+}

package/dist/client/entities/ccmp/vehicle/CCMPVehiclesManager.js

@@ -0,0 +1,105 @@
+/// <reference types="@classic-mp/types/client" />
+const EMPTY_VEHICLES = [];
+/**
+ * Реализация `IVehiclesManager` под CCMP — **пустой пул** + native helper.
+ *
+ * ### Почему пусто
+ *
+ * RageMP даёт `mp.vehicles.toArray()`/`mp.vehicles.at(id)` — JS-side pool из
+ * stream'нутых-в-радиус транспортных средств, заполняемый рантаймом. CCMP
+ * такого пула на client-side не экспонирует:
+ *  - `ccmp.natives.vehicle.createVehicle` создаёт локальный handle без id /
+ *    replication / managed lifecycle.
+ *  - `ccmp.vehicles.*` (server-side) спавнит реплицируемые vehicle-сущности,
+ *    но клиент видит их данные через game state, а не как managed-IVehicle-
+ *    инстансы в JS-pool'е.
+ *
+ * Поэтому iterator всегда пустой, `find*` возвращает null, `get*` и `deleteById` кидают.
+ *
+ * ### Hot path: `iterator.all()` на каждый render-tick
+ *
+ * Геймод-консьюмер `VehiclePartsInteractionController.syncVehicleProximity` →
+ * `VehiclePartsInteractionService.syncState` → `VehicleService.getNearbyVehicles`
+ * → `VehicleRepository.getNearby` → `VehicleRepository.getAll` → `iterator.all()`.
+ * До этой реализации `VehiclesManager` был `createNotImplementedProxy`, и каждый
+ * frame падал `CCMPVehiclesManager.iterator.all: not implemented yet`. Теперь
+ * iterator возвращает пустой итератор — interaction-сервис тихо деградирует
+ * (нет vehicles в радиусе → нет UI-хинтов / интеракций).
+ *
+ * ### `create(...)` под CCMP
+ *
+ * Не реализован осознанно: `VehicleRepository.create(...)` в геймоде ожидает
+ * `IRockModVehicle` с id/remoteId/position/etc, а CCMP-натив `createVehicle`
+ * возвращает только handle без id-mapping'а. Для корректной поддержки нужен
+ * полноценный `CCMPVehicle`-класс и интеграция с server-side `ccmp.vehicles.*`
+ * — отдельная задача. Сейчас бросаем понятную ошибку.
+ *
+ * ### `getDisplayNameFromVehicleModel`
+ *
+ * Этот метод **реализован** — натив `getDisplayNameFromVehicleModel`
+ * (`0xB215AAC32D25D019`) экспонирован в `ccmp.natives.vehicle.*` и работает
+ * без vehicle-pool'а (принимает только modelHash, возвращает GXT-ключ или
+ * "CARNOTFOUND" для unknown-моделей).
+ *
+ * TODO: когда понадобится spawning vehicles из клиента (миссии, тестовые
+ * объекты) — реализовать через `ccmp.natives.vehicle.createVehicle` + локальный
+ * id-counter + `CCMPVehicle`-обёртку. Для синхронизированных vehicles нужна
+ * server-side фабрика с `ccmp.vehicles.create` и net-events для распространения
+ * id-mapping'а.
+ */
+export class CCMPVehiclesManager {
+    constructor() {
+        // -- IVehiclesManager -----------------------------------------------------
+        // Iterator реализован inline и возвращает пустые итераторы — hot path
+        // `VehiclePartsInteractionController.syncVehicleProximity` → `VehicleRepository.getNearby`
+        // теперь тихо деградирует вместо падения на каждом render-tick'е.
+        this._iterator = {
+            all: () => EMPTY_VEHICLES[Symbol.iterator](),
+            dimension: () => EMPTY_VEHICLES[Symbol.iterator](),
+            range2D: () => EMPTY_VEHICLES[Symbol.iterator](),
+            range3D: () => EMPTY_VEHICLES[Symbol.iterator](),
+        };
+    }
+    create(options) {
+        void options;
+        throw new Error("CCMPVehiclesManager.create: создание vehicles на client-side под CCMP не поддерживается. " +
+            "Используйте server-side `ccmp.vehicles.create` (см. server/entities/ccmp/vehicle/*), " +
+            "либо вызывайте `ccmp.natives.vehicle.createVehicle` напрямую для локального vehicle-handle.");
+    }
+    getDisplayNameFromVehicleModel(modelHash) {
+        return ccmp.natives.vehicle.getDisplayNameFromVehicleModel(modelHash);
+    }
+    // -- IEntitiesManager -----------------------------------------------------
+    syncWithMpPool() {
+        // No-op: client-side vehicle pool под CCMP отсутствует, синхронизировать нечего.
+    }
+    registerById(id) {
+        throw new Error(`CCMPVehiclesManager.registerById(${id}): client-side vehicle pool под CCMP отсутствует, ` +
+            "регистрировать vehicle по id невозможно.");
+    }
+    unregisterById(id) {
+        throw new Error(`CCMPVehiclesManager.unregisterById(${id}): client-side vehicle pool под CCMP отсутствует, ` +
+            "разрегистрировать vehicle по id невозможно.");
+    }
+    // -- IBaseObjectsManager / IWorldObjectsManager ---------------------------
+    findByID(id) {
+        void id;
+        return null;
+    }
+    getByID(id) {
+        throw new Error(`CCMPVehiclesManager.getByID(${id}): vehicle не найден (пул пуст под CCMP).`);
+    }
+    findByRemoteID(remoteId) {
+        void remoteId;
+        return null;
+    }
+    getByRemoteID(remoteId) {
+        throw new Error(`CCMPVehiclesManager.getByRemoteID(${remoteId}): vehicle не найден (пул пуст под CCMP).`);
+    }
+    deleteById(id) {
+        throw new Error(`CCMPVehiclesManager.deleteById(${id}): vehicle не найден (пул пуст под CCMP).`);
+    }
+    get iterator() {
+        return this._iterator;
+    }
+}

package/dist/client/entities/common/entity/IEntity.d.ts

@@ -22,6 +22,9 @@ export interface IEntity extends IWorldObject {
     getBoneIndexByName(boneName: string): number;
     getWorldPositionOfBone(boneIndex: number): IVector3D;
     getVariable(name: string): unknown | null;
+    getSyncedMeta(key: string): unknown | undefined;
+    hasSyncedMeta(key: string): boolean;
+    getSyncedMetaKeys(): readonly string[];
     attachToEntity(target: IBaseObject, boneIndex: number, offset: IVector3D, rotation: IVector3D, p9: boolean, useSoftPinning: boolean, collision: boolean, isPed: boolean, vertexIndex: number, fixedRot: boolean): void;
     detach(useDetachVelocity: boolean, collision: boolean): void;
     getSpeed(): number;

package/dist/client/entities/ragemp/entity/RageEntity.d.ts

@@ -24,6 +24,9 @@ export declare abstract class RageEntity<T extends EntityMp> extends RageWorldOb
     getBoneIndexByName(boneName: string): number;
     getWorldPositionOfBone(boneIndex: number): IVector3D;
     getVariable(name: string): unknown | null;
+    getSyncedMeta(key: string): unknown | undefined;
+    hasSyncedMeta(key: string): boolean;
+    getSyncedMetaKeys(): readonly string[];
     attachToEntity(target: IBaseObject, boneIndex: number, offset: IVector3D, rotation: IVector3D, p9: boolean, useSoftPinning: boolean, collision: boolean, isPed: boolean, vertexIndex: number, fixedRot: boolean): void;
     detach(useDetachVelocity: boolean, collision: boolean): void;
     getSpeed(): number;

package/dist/client/entities/ragemp/entity/RageEntity.js

@@ -65,6 +65,17 @@ export class RageEntity extends RageWorldObject {
     getVariable(name) {
         return this.mpEntity.getVariable(name);
     }
+    getSyncedMeta(key) {
+        const value = this.mpEntity.getVariable(key);
+        return value === null ? undefined : value;
+    }
+    hasSyncedMeta(key) {
+        return this.mpEntity.getVariable(key) !== null;
+    }
+    getSyncedMetaKeys() {
+        // RageMP не экспонирует список ключей синхронно — возвращаем пустой массив.
+        return [];
+    }
     attachToEntity(target, boneIndex, offset, rotation, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot) {
         mp.game.entity.attachToEntity(this.handle, target.handle, boneIndex, offset.x, offset.y, offset.z, rotation.x, rotation.y, rotation.z, p9, useSoftPinning, collision, isPed, vertexIndex, fixedRot);
     }

package/dist/client/factories/ccmp/CCMPManagersFactory.d.ts

@@ -0,0 +1,46 @@
+import { type IManagersFactory } from "../common/IManagersFactory";
+type ManagerReturn<K extends keyof IManagersFactory> = IManagersFactory[K] extends (...args: never[]) => infer R ? R : never;
+export declare class CCMPManagersFactory implements IManagersFactory {
+    /**
+     * Сохраняем созданный `CCMPNetManager` потому что другим менеджерам
+     * (например, `CCMPPlayersManager`) нужен доступ к его событиям. Порядок
+     * создания в `RockMod` гарантирует, что `createNetManager` вызывается
+     * первым — мы можем безопасно полагаться на наличие `_netManager` в
+     * последующих фабричных методах.
+     */
+    private _netManager;
+    createNetManager(): ManagerReturn<"createNetManager">;
+    private _requireNetManager;
+    createBlipsManager(): ManagerReturn<"createBlipsManager">;
+    createColshapesManager(): ManagerReturn<"createColshapesManager">;
+    createMarkersManager(): ManagerReturn<"createMarkersManager">;
+    createObjectsManager(): ManagerReturn<"createObjectsManager">;
+    createPedsManager(): ManagerReturn<"createPedsManager">;
+    createPlayersManager(): ManagerReturn<"createPlayersManager">;
+    createUtilsManager(): ManagerReturn<"createUtilsManager">;
+    createVehiclesManager(): ManagerReturn<"createVehiclesManager">;
+    createBrowserManager(): ManagerReturn<"createBrowserManager">;
+    createChatManager(): ManagerReturn<"createChatManager">;
+    createCursorManager(): ManagerReturn<"createCursorManager">;
+    createGuiManager(): ManagerReturn<"createGuiManager">;
+    createRaycastingManager(): ManagerReturn<"createRaycastingManager">;
+    createVoiceChatManager(): ManagerReturn<"createVoiceChatManager">;
+    createCameraManager(): ManagerReturn<"createCameraManager">;
+    createStorageManager(): ManagerReturn<"createStorageManager">;
+    createGraphicsManager(): ManagerReturn<"createGraphicsManager">;
+    createNativeManager(): ManagerReturn<"createNativeManager">;
+    createStreamingManager(): ManagerReturn<"createStreamingManager">;
+    createLocalPlayerManager(): ManagerReturn<"createLocalPlayerManager">;
+    createControlsManager(): ManagerReturn<"createControlsManager">;
+    createKeysManager(): ManagerReturn<"createKeysManager">;
+    createGameplayManager(): ManagerReturn<"createGameplayManager">;
+    createGameCameraManager(): ManagerReturn<"createGameCameraManager">;
+    createUiManager(): ManagerReturn<"createUiManager">;
+    createNametagsManager(): ManagerReturn<"createNametagsManager">;
+    createPathfindManager(): ManagerReturn<"createPathfindManager">;
+    createZoneManager(): ManagerReturn<"createZoneManager">;
+    createWeaponManager(): ManagerReturn<"createWeaponManager">;
+    createGameObjectManager(): ManagerReturn<"createGameObjectManager">;
+    createConsoleManager(): ManagerReturn<"createConsoleManager">;
+}
+export {};