Документация разработчика VIMP

VIMP предоставляет типизированный JavaScript runtime для авторитетной серверной логики, клиентской интеграции с GTA и пользовательских интерфейсов на CEF. Документация описывает актуальный runtime VIMP 2.x.

С чего начать

• Установите game server и запустите его локально.
• Создайте первый gamemode на TypeScript.
• Разберитесь, как взаимодействуют server, client и CEF.
• Подключите add-on транспорт или карту/MLO.
• Используйте полный scripting API reference.

Модель системы

Сервер владеет постоянным multiplayer-состоянием. Он создаёт сетевые сущности и решает, какие действия разрешены игроку. Каждый клиент получает состояние ближайших сущностей, выполняет client scripts, вызывает GTA natives и отображает CEF-страницы. Именованные события передают JSON-совместимые данные между этими контекстами.

server/main.js  ← custom events →  client/main.js  ← UI events →  CEF page
      │                                  │
 авторитетное состояние          streamed GTA world

Среды выполнения

Контекст	Runtime	Основной API
Server	Встроенный Node.js 22	@vimp-mp/types/server
Client	JavaScript runtime VIMP	@vimp-mp/types/client
CEF UI	Chromium page	@vimp-mp/types/ui

Пакет деклараций нужен только при разработке. Не импортируйте из него runtime values: VIMP устанавливает globalThis.vimp до загрузки скриптов.