Codex Assistant — Настольный помощник для LSPD в GTA 5 RP

Codex Assistant — это оверлейное приложение-справочник для сотрудников правоохранительных органов на GTA 5 RP серверах. Мгновенный доступ ко всем кодексам, правилам и процедурным шаблонам прямо во время игры.

Возможности приложения

Полная база кодексов

• Уголовный кодекс (УК)
• Административный кодекс (АК)
• Дорожный кодекс (ДК)
• Процессуальный кодекс (ПК)
• Правила сервера (основные, события, организации)

Умный поиск

• Поиск по номеру статьи
• Поиск по названию
• Поиск по тексту статьи
• Поиск по наказанию
• Подсветка найденных совпадений

Удобство работы

• Копирование статей в один клик
• Авто-скрытие окна при потере фокуса
• Настраиваемая прозрачность (0-25%)
• Горячие клавиши (настраиваются)
• Офлайн-кэширование данных

RP шаблоны

• Права Миранды
• Вопросы для допроса
• Процедура задержания
• Заметки (локальное сохранение)
• Процедура "красного допроса"

Системные требования

• Операционная система: Windows 10 или 11 (64-bit)
• Оперативная память: от 50 MB
• Место на диске: 50 MB
• Интернет: требуется для загрузки обновлений законов

Установка

Вариант 1: Установщик

1. Скачайте Codex-Assistant-Setup-1.0.0.exe из релизов
2. Запустите установщик
3. Следуйте инструкциям

Вариант 2: Портативная версия

1. Скачайте Codex-Assistant-1.0.0-portable.exe
2. Запустите файл из любой папки
3. Настройки сохраняются в папке приложения

Настройка игры для оверлея

Для корректной работы оверлея включите в GTA 5 оконный режим без рамки:

Настройки GTA 5 → Графика → Тип экрана → "Оконный без рамки"

После этого приложение будет отображаться поверх игры.

Горячие клавиши

Комбинация	Действие
Ctrl+Shift+K	Открыть или скрыть окно поиска
Esc	Закрыть окно поиска (при авто-скрытии)

Горячую клавишу можно изменить в главном окне приложения. Поддерживаются комбинации с Ctrl, Shift, Alt.

Сборка из исходного кода

Клонирование репозитория: git clone https://github.com/onewizard-dev/codex-assistant.git cd codex-assistant

Установка зависимостей: npm install

Режим разработки: npm run dev

Сборка установщика: npm run build

Сборка портативной версии: npm run dist:portable

Сборка всех версий: npm run dist:all

Готовые файлы появятся в папке dist/.

Структура проекта

codex-assistant/ ├── main.js # Основной процесс Electron ├── preload.js # Безопасный мост с рендером ├── package.json # Зависимости и скрипты ├── electron-builder.yml # Конфигурация сборки ├── releases.json # История обновлений ├── src/ │ ├── index.html # Главное окно │ ├── search.html # Окно поиска │ ├── css/ │ │ └── styles.css # Все стили приложения │ └── js/ │ ├── app-core.js # Ядро приложения │ ├── main-window.js # Логика главного окна │ ├── search-window.js # Логика поиска │ ├── logger.js # Система логирования │ ├── error-boundary.js # Обработка ошибок │ ├── safe-utils.js # Утилиты безопасности │ └── analytics.js # Аналитика (только в main процессе) └── assets/ └── Icon/ └── icon.png # Иконка приложения

Конфигурация сборки

Файл electron-builder.yml содержит настройки для сборки приложения:

appId: com.onewizard.codex-assistant productName: Codex Assistant copyright: Copyright © 2026 onewizard-dev

directories: output: dist buildResources: build

files:

• main.js
• preload.js
• src/**/*
• assets/**/*
• package.json
• releases.json

win: target: - target: nsis arch: [x64] - target: portable arch: [x64] icon: assets/Icon/icon.png publisherName: onewizard-dev

nsis: oneClick: false perMachine: false allowToChangeInstallationDirectory: true createDesktopShortcut: true createStartMenuShortcut: true license: LICENSE

publish:

• provider: github owner: onewizard-dev repo: codex-assistant

Скрипты в package.json

{ "scripts": { "start": "electron .", "dev": "electron . --inspect", "build": "electron-builder", "dist": "electron-builder --win --x64", "dist:portable": "electron-builder --win --x64 -- portable", "dist:all": "electron-builder --win --x64 --ia32", "publish": "electron-builder --win --x64 --publish always" } }

Автоматические обновления

Приложение использует electron-updater для автоматического обновления. При выходе новой версии:

1. Обновите версию в package.json
2. Создайте новый тег в Git
3. Запустите npm run publish
4. GitHub Release создастся автоматически

Поддерживаемые серверы

Приложение поддерживает множество серверов с законами:

• New York 1-17
• Detroit 2
• Chicago 3
• San Francisco 4
• Atlanta 5
• San Diego 6
• Los Angeles 7
• Miami 8
• Las Vegas 9
• Washington 10
• Dallas 11
• Boston 12
• Houston 13
• Seattle 14
• Phoenix 15
• Denver 16
• Portland 17

Логирование

Логи приложения сохраняются в папке:

%APPDATA%\codex-assistant\logs\

Хранится до 5 файлов логов, каждый за день.

Офлайн-режим

Приложение кэширует законы и правила в localStorage. При отсутствии интернета используются сохраненные данные.

Безопасность

• Все IPC вызовы проходят через предзагрузочный скрипт
• Контекстная изоляция включена
• Content Security Policy настроена
• Нет доступа к Node.js из рендера

Часто задаваемые вопросы

Почему не работает оверлей?

Убедитесь, что в GTA 5 включен режим "Оконный без рамки". Также проверьте, не заблокировано ли приложение антивирусом.

Как сбросить настройки?

Удалите папку %APPDATA%\codex-assistant или файл config.json в портативной версии.

Почему не загружаются законы?

Проверьте подключение к интернету. Если проблема сохраняется, возможно, временные проблемы с GitHub.

Можно ли добавить свой сервер?

Да, данные законов хранятся в отдельном репозитории. Создайте Issue с запросом.

Лицензия

Проект распространяется под лицензией MIT. Подробнее см. в файле LICENSE.

Автор: Angellar Wakerz, 2026

Контакты и поддержка

• Telegram канал
• Группа ВКонтакте
• GitHub Issues
• Поддержать проект

Благодарности

• Всем пользователям за обратную связь
• Серверам Majestic RP за предоставленные данные
• Сообществу GTA 5 RP за поддержку

---

======= # laws-codex