rock-mod 0.19.0 → 0.21.0

package/dist/client/entities/ragemp/vehicle/RageVehicle.js

@@ -129,4 +129,40 @@ export class RageVehicle extends RageEntity {
     setCheatPowerIncrease(value) {
         mp.game.vehicle.setCheatPowerIncrease(this.handle, value);
     }
+    toggleMod(modType, toggle) {
+        this.mpEntity.toggleMod(modType, toggle);
+    }
+    setTyreSmokeColor(r, g, b) {
+        this.mpEntity.setTyreSmokeColor(r, g, b);
+    }
+    setModColor1(paintType, color, p3) {
+        this.mpEntity.setModColor1(paintType, color, p3);
+    }
+    setExtraColours(pearlescentColor, wheelColor) {
+        this.mpEntity.setExtraColours(pearlescentColor, wheelColor);
+    }
+    setHeadlightColor(colorIndex) {
+        // _SET_VEHICLE_HEADLIGHT_COLOUR — no RAGEMP wrapper, invoke native by hash
+        mp.game.invoke("0xE41033B25D003A07", this.handle, colorIndex);
+    }
+    setDashboardColor(colorIndex) {
+        // SET_VEHICLE_DASHBOARD_COLOUR — no RAGEMP wrapper, invoke native by hash
+        mp.game.invoke("0x6089CDF6A57F326C", this.handle, colorIndex);
+    }
+    setInteriorColor(colorIndex) {
+        // SET_VEHICLE_INTERIOR_COLOUR — no RAGEMP wrapper, invoke native by hash
+        mp.game.invoke("0xF40DD601A65F7F19", this.handle, colorIndex);
+    }
+    getMaxBraking() {
+        return this.mpEntity.getMaxBraking();
+    }
+    getAcceleration() {
+        return this.mpEntity.getAcceleration();
+    }
+    getMaxTraction() {
+        return this.mpEntity.getMaxTraction();
+    }
+    getModelMaxSpeed() {
+        return mp.game.vehicle.getVehicleModelMaxSpeed(this.mpEntity.model);
+    }
 }

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 {};

package/dist/client/factories/ccmp/CCMPManagersFactory.js

@@ -0,0 +1,149 @@
+import { CCMPNetManager } from "../../net/ccmp/CCMPNetManager";
+import { CCMPBrowserManager } from "../../game/ccmp/browser/CCMPBrowserManager";
+import { CCMPStorageManager } from "../../game/ccmp/storage/CCMPStorageManager";
+import { CCMPKeysManager } from "../../game/ccmp/keys/CCMPKeysManager";
+import { CCMPNametagsManager } from "../../game/ccmp/nametags/CCMPNametagsManager";
+import { CCMPChatManager } from "../../game/ccmp/chat/CCMPChatManager";
+import { CCMPControlsManager } from "../../game/ccmp/controls/CCMPControlsManager";
+import { CCMPPlayersManager } from "../../entities/ccmp/player/CCMPPlayersManager";
+import { CCMPPedsManager } from "../../entities/ccmp/ped/CCMPPedsManager";
+import { CCMPVehiclesManager } from "../../entities/ccmp/vehicle/CCMPVehiclesManager";
+import { CCMPUtilsManager } from "../../utils/ccmp/CCMPUtilsManager";
+import { CCMPGraphicsManager } from "../../game/ccmp/graphics/CCMPGraphicsManager";
+import { CCMPUiManager } from "../../game/ccmp/ui/CCMPUiManager";
+import { CCMPPathfindManager } from "../../game/ccmp/pathfind/CCMPPathfindManager";
+import { CCMPZoneManager } from "../../game/ccmp/zone/CCMPZoneManager";
+import { CCMPNativeCallerManager } from "../../game/ccmp/native/CCMPNativeCallerManager";
+import { CCMPGuiManager } from "../../game/ccmp/gui/CCMPGuiManager";
+import { CCMPRaycastingManager } from "../../game/ccmp/raycasting/CCMPRaycastingManager";
+import { CCMPSyncedMetaBridge } from "../../net/ccmp/events/CCMPSyncedMetaBridge";
+import { CCMPCameraManager } from "../../entities/ccmp/camera/CCMPCameraManager";
+import { CCMPStreamingManager } from "../../game/ccmp/streaming/CCMPStreamingManager";
+import { CCMPCursorManager } from "../../game/ccmp/cursor/CCMPCursorManager";
+import { CCMPGameObjectManager } from "../../game/ccmp/object/CCMPGameObjectManager";
+import { CCMPGameplayManager } from "../../game/ccmp/gameplay/CCMPGameplayManager";
+import { createNotImplementedProxy } from "./createNotImplementedProxy";
+export class CCMPManagersFactory {
+    constructor() {
+        /**
+         * Сохраняем созданный `CCMPNetManager` потому что другим менеджерам
+         * (например, `CCMPPlayersManager`) нужен доступ к его событиям. Порядок
+         * создания в `RockMod` гарантирует, что `createNetManager` вызывается
+         * первым — мы можем безопасно полагаться на наличие `_netManager` в
+         * последующих фабричных методах.
+         */
+        this._netManager = null;
+    }
+    createNetManager() {
+        this._netManager = new CCMPNetManager();
+        return this._netManager;
+    }
+    _requireNetManager(forMethod) {
+        if (!this._netManager) {
+            throw new Error(`CCMPManagersFactory.${forMethod}: ` +
+                "createNetManager() ещё не вызывался. Это нарушение контракта порядка " +
+                "фабричных методов в RockMod-конструкторе.");
+        }
+        return this._netManager;
+    }
+    createBlipsManager() {
+        return createNotImplementedProxy("CCMPBlipsManager");
+    }
+    createColshapesManager() {
+        return createNotImplementedProxy("CCMPColshapesManager");
+    }
+    createMarkersManager() {
+        return createNotImplementedProxy("CCMPMarkersManager");
+    }
+    createObjectsManager() {
+        return createNotImplementedProxy("CCMPObjectsManager");
+    }
+    createPedsManager() {
+        return new CCMPPedsManager();
+    }
+    createPlayersManager() {
+        const netManager = this._requireNetManager("createPlayersManager");
+        const playersManager = new CCMPPlayersManager(netManager.events);
+        // Bridge для `streamSyncedMetaChange` создаётся здесь — ему нужен
+        // players manager для резолва `entityId → CCMPPlayer`, а events bus
+        // — для эмиссии `rm::syncedMetaChange` (на который уже подписан
+        // `CCMPDataHandler`, инстанцированный в `CCMPNetManager`).
+        new CCMPSyncedMetaBridge(netManager.events, playersManager).register();
+        return playersManager;
+    }
+    createUtilsManager() {
+        return new CCMPUtilsManager();
+    }
+    createVehiclesManager() {
+        return new CCMPVehiclesManager();
+    }
+    createBrowserManager() {
+        return new CCMPBrowserManager();
+    }
+    createChatManager() {
+        return new CCMPChatManager();
+    }
+    createCursorManager() {
+        return new CCMPCursorManager();
+    }
+    createGuiManager() {
+        return new CCMPGuiManager();
+    }
+    createRaycastingManager() {
+        return new CCMPRaycastingManager();
+    }
+    createVoiceChatManager() {
+        return createNotImplementedProxy("CCMPVoiceChatManager");
+    }
+    createCameraManager() {
+        return new CCMPCameraManager();
+    }
+    createStorageManager() {
+        return new CCMPStorageManager();
+    }
+    createGraphicsManager() {
+        return new CCMPGraphicsManager();
+    }
+    createNativeManager() {
+        return new CCMPNativeCallerManager();
+    }
+    createStreamingManager() {
+        return new CCMPStreamingManager();
+    }
+    createLocalPlayerManager() {
+        return createNotImplementedProxy("CCMPLocalPlayerManager");
+    }
+    createControlsManager() {
+        return new CCMPControlsManager();
+    }
+    createKeysManager() {
+        return new CCMPKeysManager();
+    }
+    createGameplayManager() {
+        return new CCMPGameplayManager();
+    }
+    createGameCameraManager() {
+        return createNotImplementedProxy("CCMPGameCameraManager");
+    }
+    createUiManager() {
+        return new CCMPUiManager();
+    }
+    createNametagsManager() {
+        return new CCMPNametagsManager();
+    }
+    createPathfindManager() {
+        return new CCMPPathfindManager();
+    }
+    createZoneManager() {
+        return new CCMPZoneManager();
+    }
+    createWeaponManager() {
+        return createNotImplementedProxy("CCMPWeaponManager");
+    }
+    createGameObjectManager() {
+        return new CCMPGameObjectManager();
+    }
+    createConsoleManager() {
+        return createNotImplementedProxy("CCMPConsoleManager");
+    }
+}

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

@@ -0,0 +1 @@
+export declare const createNotImplementedProxy: <T extends object>(name: string) => T;

package/dist/client/factories/ccmp/createNotImplementedProxy.js

@@ -0,0 +1,24 @@
+const createNotImplementedError = (path) => new Error(`${path}: not implemented yet`);
+const createProxy = (path) => {
+    function notImplementedProxyTarget() {
+        throw createNotImplementedError(path);
+    }
+    return new Proxy(notImplementedProxyTarget, {
+        apply() {
+            throw createNotImplementedError(path);
+        },
+        construct() {
+            throw createNotImplementedError(path);
+        },
+        get(_target, property) {
+            if (property === "then") {
+                return undefined;
+            }
+            return createProxy(`${path}.${String(property)}`);
+        },
+        set(_target, property) {
+            throw createNotImplementedError(`${path}.${String(property)}`);
+        },
+    });
+};
+export const createNotImplementedProxy = (name) => createProxy(name);

package/dist/client/game/ccmp/browser/CCMPBrowserManager.d.ts

@@ -0,0 +1,22 @@
+import { type IBrowserHandle, type IBrowserManager } from "../../common/browser/IBrowserManager";
+/**
+ * Реализация `IBrowserManager` поверх нативного CCMP browser API.
+ *
+ * CCMP предоставляет полноценное CEF-управление через `ccmp.browsers` —
+ * это прямое соответствие RageMP'шному `mp.browsers`. Маппинг:
+ *  - `create(url)` → `ccmp.browsers.create(url)` → возвращает `Browser` с
+ *    числовым `id`, который мы храним для последующих `execute`/`destroy`.
+ *  - `execute(code)` → `Browser.executeJavaScript(code)`.
+ *  - `destroy()` → `Browser.destroy()`.
+ *
+ * Геймод-консьюмер (`BrowserService` → один логический браузер на гейм-mod)
+ * управляет только одним инстансом одновременно, поэтому держим ссылку
+ * на единственный созданный браузер.
+ */
+export declare class CCMPBrowserManager implements IBrowserManager {
+    private _browser;
+    create(url: string): void;
+    createInstance(url: string): IBrowserHandle;
+    destroy(): void;
+    execute(code: string): void;
+}

package/dist/client/game/ccmp/browser/CCMPBrowserManager.js

@@ -0,0 +1,66 @@
+class CCMPBrowserHandle {
+    constructor(url) {
+        this._browser = ccmp.browsers.create(url);
+    }
+    get isAlive() {
+        return this._browser !== null;
+    }
+    destroy() {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.destroy();
+        this._browser = null;
+    }
+    execute(code) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.executeJavaScript(code);
+    }
+    setOrderId(orderId) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.setOrderId(orderId);
+    }
+}
+/**
+ * Реализация `IBrowserManager` поверх нативного CCMP browser API.
+ *
+ * CCMP предоставляет полноценное CEF-управление через `ccmp.browsers` —
+ * это прямое соответствие RageMP'шному `mp.browsers`. Маппинг:
+ *  - `create(url)` → `ccmp.browsers.create(url)` → возвращает `Browser` с
+ *    числовым `id`, который мы храним для последующих `execute`/`destroy`.
+ *  - `execute(code)` → `Browser.executeJavaScript(code)`.
+ *  - `destroy()` → `Browser.destroy()`.
+ *
+ * Геймод-консьюмер (`BrowserService` → один логический браузер на гейм-mod)
+ * управляет только одним инстансом одновременно, поэтому держим ссылку
+ * на единственный созданный браузер.
+ */
+export class CCMPBrowserManager {
+    constructor() {
+        this._browser = null;
+    }
+    create(url) {
+        this.destroy();
+        this._browser = this.createInstance(url);
+    }
+    createInstance(url) {
+        return new CCMPBrowserHandle(url);
+    }
+    destroy() {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.destroy();
+        this._browser = null;
+    }
+    execute(code) {
+        if (!this._browser) {
+            return;
+        }
+        this._browser.execute(code);
+    }
+}

package/dist/client/game/ccmp/chat/CCMPChatManager.d.ts

@@ -0,0 +1,26 @@
+import { type IChatManager } from "../../common/chat/IChatManager";
+/**
+ * No-op реализация `IChatManager` под CCMP.
+ *
+ * У RageMP клиента есть `mp.gui.chat.activate(state)` (разрешает игроку
+ * печатать в чат по T) и `mp.gui.chat.show(state)` (видимость чат-окна).
+ * У CCMP **нет JS API для управления чатом** — только встроенное событие
+ * `chatMessage` на приём входящих сообщений и `ccmp.notify(text)` для HUD-
+ * уведомлений (не относится к чату).
+ *
+ * Бросать нельзя: геймод-консьюмер `RockModChatAdapter.activate` вызывается
+ * из `ChatService.onModuleInit` — исключение поднимет весь bootstrap DI.
+ * Поэтому игнорируем + один раз пишем warn, чтобы было видно в логах что
+ * фича недоступна.
+ *
+ * Следствие: под CCMP программное управление чатом не работает. Чат-UI
+ * (если он есть) рисуется самим CCMP-клиентом на Rust-стороне и реагирует
+ * на свои клавиши. Когда (если) CCMP добавит JS-API для чата — заменим.
+ */
+export declare class CCMPChatManager implements IChatManager {
+    private _warned;
+    activate(state: boolean): void;
+    show(state: boolean): void;
+    push(text: string): void;
+    private _warnOnce;
+}

package/dist/client/game/ccmp/chat/CCMPChatManager.js

@@ -0,0 +1,41 @@
+/**
+ * No-op реализация `IChatManager` под CCMP.
+ *
+ * У RageMP клиента есть `mp.gui.chat.activate(state)` (разрешает игроку
+ * печатать в чат по T) и `mp.gui.chat.show(state)` (видимость чат-окна).
+ * У CCMP **нет JS API для управления чатом** — только встроенное событие
+ * `chatMessage` на приём входящих сообщений и `ccmp.notify(text)` для HUD-
+ * уведомлений (не относится к чату).
+ *
+ * Бросать нельзя: геймод-консьюмер `RockModChatAdapter.activate` вызывается
+ * из `ChatService.onModuleInit` — исключение поднимет весь bootstrap DI.
+ * Поэтому игнорируем + один раз пишем warn, чтобы было видно в логах что
+ * фича недоступна.
+ *
+ * Следствие: под CCMP программное управление чатом не работает. Чат-UI
+ * (если он есть) рисуется самим CCMP-клиентом на Rust-стороне и реагирует
+ * на свои клавиши. Когда (если) CCMP добавит JS-API для чата — заменим.
+ */
+export class CCMPChatManager {
+    constructor() {
+        this._warned = false;
+    }
+    activate(state) {
+        this._warnOnce("activate", state);
+    }
+    show(state) {
+        this._warnOnce("show", state);
+    }
+    push(text) {
+        ccmp.notify(text);
+    }
+    _warnOnce(method, state) {
+        if (this._warned) {
+            return;
+        }
+        this._warned = true;
+        console.warn(`[CCMPChatManager] ${method}(${String(state)}) вызван, но CCMP не ` +
+            `предоставляет JS API для управления чатом. Дальнейшие вызовы ` +
+            `activate/show будут проигнорированы молча.`);
+    }
+}

package/dist/client/game/ccmp/controls/CCMPControlsManager.d.ts

@@ -0,0 +1,33 @@
+import { type IControlsManager } from "../../common/controls/IControlsManager";
+/**
+ * Реализация `IControlsManager` поверх натива-обёртки CCMP `ccmp.natives.pad.*`.
+ *
+ * Все четыре метода — прямой passthrough к соответствующим GTA V-нативам
+ * (`DISABLE_CONTROL_ACTION`, `IS_CONTROL_PRESSED`, `IS_DISABLED_CONTROL_PRESSED`,
+ * `GET_DISABLED_CONTROL_NORMAL`) с сохранением порядка аргументов:
+ *
+ *   IControlsManager.disableControlAction(padIndex, control, disable)
+ *     → ccmp.natives.pad.disableControlAction(padIndex, control, disable)
+ *
+ * Семантика и значения индексов идентичны RageMP — гейм-mod консьюмеры
+ * (`ControlsService` / `WeaponService.disableControlActions`) используют те
+ * же константы `Control.*` (см. `@shared/common/enums/Control`).
+ *
+ * **Hot path:** `disableControlAction` вызывается на каждый render-tick из
+ * `WeaponController.onRender`. CCMP-native — это синхронный вызов V8 op'а,
+ * стоимость порядка единиц микросекунд; никакой буферизации не нужно.
+ *
+ * Имена параметров `CcmpNativesPad.disableControlAction(control, action, ...)`
+ * **обманчивы** — это generic-renames из натив-генератора. Фактически первый
+ * аргумент — `padIndex` (0..2), второй — `control` (Control.*), третий —
+ * `disable: boolean`. См. https://docs.fivem.net/natives/?_0xFE99B66D43DA8E7B.
+ */
+export declare class CCMPControlsManager implements IControlsManager {
+    disableControlAction(padIndex: number, control: number, disable: boolean): void;
+    isDisabledControlPressed(padIndex: number, control: number): boolean;
+    isDisabledControlJustPressed(padIndex: number, control: number): boolean;
+    isControlPressed(padIndex: number, control: number): boolean;
+    isControlJustPressed(padIndex: number, control: number): boolean;
+    isControlJustReleased(padIndex: number, control: number): boolean;
+    getDisabledControlNormal(padIndex: number, control: number): number;
+}

package/dist/client/game/ccmp/controls/CCMPControlsManager.js

@@ -0,0 +1,47 @@
+/// <reference types="@classic-mp/types/client" />
+/**
+ * Реализация `IControlsManager` поверх натива-обёртки CCMP `ccmp.natives.pad.*`.
+ *
+ * Все четыре метода — прямой passthrough к соответствующим GTA V-нативам
+ * (`DISABLE_CONTROL_ACTION`, `IS_CONTROL_PRESSED`, `IS_DISABLED_CONTROL_PRESSED`,
+ * `GET_DISABLED_CONTROL_NORMAL`) с сохранением порядка аргументов:
+ *
+ *   IControlsManager.disableControlAction(padIndex, control, disable)
+ *     → ccmp.natives.pad.disableControlAction(padIndex, control, disable)
+ *
+ * Семантика и значения индексов идентичны RageMP — гейм-mod консьюмеры
+ * (`ControlsService` / `WeaponService.disableControlActions`) используют те
+ * же константы `Control.*` (см. `@shared/common/enums/Control`).
+ *
+ * **Hot path:** `disableControlAction` вызывается на каждый render-tick из
+ * `WeaponController.onRender`. CCMP-native — это синхронный вызов V8 op'а,
+ * стоимость порядка единиц микросекунд; никакой буферизации не нужно.
+ *
+ * Имена параметров `CcmpNativesPad.disableControlAction(control, action, ...)`
+ * **обманчивы** — это generic-renames из натив-генератора. Фактически первый
+ * аргумент — `padIndex` (0..2), второй — `control` (Control.*), третий —
+ * `disable: boolean`. См. https://docs.fivem.net/natives/?_0xFE99B66D43DA8E7B.
+ */
+export class CCMPControlsManager {
+    disableControlAction(padIndex, control, disable) {
+        ccmp.natives.pad.disableControlAction(padIndex, control, disable);
+    }
+    isDisabledControlPressed(padIndex, control) {
+        return ccmp.natives.pad.isDisabledControlPressed(padIndex, control);
+    }
+    isDisabledControlJustPressed(padIndex, control) {
+        return ccmp.natives.pad.isDisabledControlJustPressed(padIndex, control);
+    }
+    isControlPressed(padIndex, control) {
+        return ccmp.natives.pad.isControlPressed(padIndex, control);
+    }
+    isControlJustPressed(padIndex, control) {
+        return ccmp.natives.pad.isControlJustPressed(padIndex, control);
+    }
+    isControlJustReleased(padIndex, control) {
+        return ccmp.natives.pad.isControlJustReleased(padIndex, control);
+    }
+    getDisabledControlNormal(padIndex, control) {
+        return ccmp.natives.pad.getDisabledControlNormal(padIndex, control);
+    }
+}

package/dist/client/game/ccmp/cursor/CCMPCursorManager.d.ts

@@ -0,0 +1,6 @@
+import { type ICursorManager } from "../../../game";
+import { Vector2D } from "../../../../shared/common/utils";
+export declare class CCMPCursorManager implements ICursorManager {
+    show(_freezeControls: boolean, state: boolean): void;
+    getPosition(): Vector2D;
+}

package/dist/client/game/ccmp/cursor/CCMPCursorManager.js

@@ -0,0 +1,15 @@
+/// <reference types="@classic-mp/types/client" />
+import { Vector2D } from "../../../../shared/common/utils";
+export class CCMPCursorManager {
+    show(_freezeControls, state) {
+        if (state) {
+            ccmp.cursor.show();
+            return;
+        }
+        ccmp.cursor.hide();
+    }
+    getPosition() {
+        const position = ccmp.cursor.getPosition();
+        return new Vector2D(position.x, position.y);
+    }
+}

package/dist/client/game/ccmp/gameplay/CCMPGameplayManager.d.ts

@@ -0,0 +1,6 @@
+import { type IGameplayManager } from "../../../game";
+import { type IVector3D } from "../../../../shared/common/utils";
+export declare class CCMPGameplayManager implements IGameplayManager {
+    setFadeOutAfterDeath(toggle: boolean): void;
+    getGroundZFor3dCoord(position: IVector3D, ignoreWater: boolean, waterLevelCheck: boolean): number;
+}

package/dist/client/game/ccmp/gameplay/CCMPGameplayManager.js

@@ -0,0 +1,10 @@
+/// <reference types="@classic-mp/types/client" />
+export class CCMPGameplayManager {
+    setFadeOutAfterDeath(toggle) {
+        ccmp.natives.misc.setFadeOutAfterDeath(toggle);
+    }
+    getGroundZFor3dCoord(position, ignoreWater, waterLevelCheck) {
+        const result = ccmp.natives.misc.getGroundZFor3dCoord(position.x, position.y, position.z, ignoreWater, waterLevelCheck);
+        return result.groundz;
+    }
+}

package/dist/client/game/ccmp/graphics/CCMPGraphicsManager.d.ts

@@ -0,0 +1,58 @@
+import { type IGraphicsManager, type ILoopedParticleFxAtCoordOptions, type IParticleFxAtCoordOptions, type IScreenTextOptions } from "../../common/graphics/IGraphicsManager";
+import { type IVector2D, type IVector3D } from "../../../../shared/common/utils";
+/**
+ * Реализация `IGraphicsManager` под CCMP.
+ *
+ * RageMP даёт высокоуровневые обёртки `mp.game.graphics.drawText` /
+ * `world3dToScreen2d` / etc. У CCMP таких помощников нет — есть только
+ * сырые GTA V натив-биндинги в `ccmp.natives.{hud,graphics}.*`. Этот класс
+ * собирает их в эквивалент RageMP API.
+ *
+ * ### `drawText` — мульти-нативная цепочка
+ *
+ * Стандартная GTA V последовательность:
+ *  1. `SET_TEXT_FONT/SCALE/COLOUR/OUTLINE/CENTRE` — стиль текста
+ *  2. `BEGIN_TEXT_COMMAND_DISPLAY_TEXT('STRING')` — открыть text command
+ *  3. `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME(text)` — добавить содержимое
+ *  4. `END_TEXT_COMMAND_DISPLAY_TEXT(x, y, 0)` — отрисовать
+ *
+ * **Hot path:** вызывается каждый render-tick из `HudController.onRender`
+ * (ammo, nametags, etc). Все вызовы синхронны (V8-ops), общая стоимость —
+ * единицы микросекунд на текст.
+ *
+ * **Ограничение длины:** `ADD_TEXT_COMPONENT_SUBSTRING_PLAYER_NAME` усекает
+ * вход на 99 символов. Для типичных HUD-меток (ammo "30/120", имена игроков)
+ * не критично; для длинных строк нужно разбивать на чанки последовательными
+ * `ADD_*` вызовами. Сейчас не реализовано — добавим если понадобится.
+ *
+ * ### `world3dToScreen2d`
+ *
+ * `getScreenCoordFromWorldCoord` возвращает `{return, screenx, screeny}` —
+ * `return=false` означает, что точка вне frustum'а; маппим в `null` для
+ * совпадения с RageMP-семантикой.
+ *
+ * ### `getActiveScreenResolution`
+ *
+ * Маппится на `getActualScreenResolution` (GTA native `0x873C9F3104101DD3`),
+ * который возвращает физическое разрешение рендера — то же, что RageMP'шный
+ * `getActiveScreenResolution` (это один и тот же натив, переименованный по-
+ * разному в разных биндингах).
+ *
+ * ### `startScreenEffect` / `stopScreenEffect`
+ *
+ * Маппятся на `animpostfxPlay` / `animpostfxStop` (`ANIMPOSTFX_PLAY`/`STOP`) —
+ * это и есть GTA V натив для screen effect'ов (по-старому называвшийся
+ * `START_SCREEN_EFFECT`).
+ */
+export declare class CCMPGraphicsManager implements IGraphicsManager {
+    drawText(text: string, position: IVector2D, options?: IScreenTextOptions): void;
+    world3dToScreen2d(position: IVector3D): IVector2D | null;
+    startScreenEffect(effectName: string, duration: number, looped: boolean): void;
+    stopScreenEffect(effectName: string): void;
+    setPtfxAssetNextCall(assetName: string): void;
+    startParticleFxNonLoopedAtCoord(options: IParticleFxAtCoordOptions): boolean;
+    startParticleFxLoopedAtCoord(options: ILoopedParticleFxAtCoordOptions): number;
+    stopParticleFxLooped(handle: number, p1: boolean): void;
+    getSafeZoneSize(): number;
+    getActiveScreenResolution(): IVector2D;
+}