Установка

Пять минут. Готовить базу данных не нужно: всё, что запоминает этот ресурс, хранится в двух JSON-файлах внутри его собственной папки.

Перед началом

Что нужно	Зачем
ESX, QBCore или QBox	Проверки администратора, работы, уведомления и используемые предметы берутся из фреймворка
Свежая сборка игры	Краски хамелеон относятся к более новому набору цветов транспорта
Инвентарь, поддерживающий используемые предметы фреймворка	Только если вам нужны предметы-краски

1. Поместите папку в ресурсы

Скачайте mic_chameleon из ваших выданных ассетов Cfx.re и переместите папку в ресурсы, например в resources/[mic]/mic_chameleon.

Папки data/ и stream/ оставьте на месте. В data/ лежат определения цветов (carcols_gen9.meta, carmodcols_gen9.meta, carmodcols.ymt), а в stream/ — vehicle_paint_ramps.ytd, текстуры, благодаря которым краски с 223 по 242 переливаются.

2. Запустите после фреймворка

В server.cfg добавьте ensure mic_chameleon на строку ниже es_extended, qb-core или qbx_core (и ниже вашего инвентаря, если вы используете предметы).

Всё сработало, если консоль выводит три строки [Camaleon]: найденный фреймворк (ESX или QBCore — QBox отображается как QBCore), сообщение о том, что права загружены, и Registered 82 chameleon paint items + reset item. Первые две выводятся на языке Config.Locale, который по умолчанию испанский, — ESX Framework detectado automáticamente. означает ту же хорошую новость.

Если в первой строке сказано, что совместимый фреймворк не обнаружен, ресурс запустился раньше вашего фреймворка. Переместите строку ниже.

3. База данных — ничего делать не нужно

Ресурс сам создаёт permissions.json и vehicle_original_colors.json, если их нет. Единственный SQL-файл в папке нужен для определений предметов ESX (см. ниже), и он требуется только на ESX без ox_inventory.

4. Предметы (необязательно)

Пропустите этот шаг, если вам нужно только меню, либо установите Config.UseItems = false.

Предмет	Что делает
`chameleon_paint_161` … `chameleon_paint_242`	По одному на каждый цвет, всего 82. Если использовать сидя в машине, расходуется и красит машину в этот цвет
`chameleon_reset`	Расходуется и возвращает машине цвет, который был до первой покраски

Определения готовы в папке items/. Скопируйте тот файл, который подходит вам:

Ваш инвентарь	Файл	Куда добавить
ox_inventory	`items/ox.lua`	В `ox_inventory/data/items.lua`
qb-inventory (QBCore)	`items/qb.lua`	В `qb-core/shared/items.lua`
Стандартный инвентарь ESX	`items/sql.sql`	Один раз импортируйте в базу данных; он добавит предметы в таблицу `items`

Каждый файл целиком закомментирован, чтобы безвредно лежать в ресурсе, — копируйте записи, а не маркеры комментариев.

Всё сработало, если вы выдали себе chameleon_paint_200, сели в машину, использовали предмет, и машина сменила цвет, а предмет исчез.

5. Фреймворк и бридж

Настраивать ничего не нужно. Config.Framework = "auto" находит es_extended или qb-core. QBox определяется так же — через слой совместимости с QBCore (qbx_core предоставляет qb-core). Если хотите задать значение принудительно, установите "esx" или "qbcore" ("qbcore" на QBox); тогда ресурс не станет угадывать и сообщит в консоли, если этот фреймворк не запущен.

6. Первый тест

Сядьте в любую машину.
Введите /chameleon.
С конфигом из поставки меню открывается только у тех, кто есть в списке прав или имеет работу mechanic либо police. Будучи администратором, сначала введите /chameleongive и свой собственный серверный ID.

Всё сработало, если появилась сетка образцов, клик по образцу красит машину, а Reset возвращает исходный цвет. Esc или X закрывает меню.

Перед открытием сервера

Очистите список прав. permissions.json поставляется с примерными Steam ID. Удалите файл; при следующем запуске ресурс создаст новый, пустой.
Очистите память о цветах. vehicle_original_colors.json тоже поставляется с примерными записями. Удалите его таким же образом.
Выберите язык. В конфиге из поставки стоит Config.Locale = "es". Задайте "en" или нужный вам язык.
Переместите или удалите два маркера мастерских в Config.Locations — они стоят в примерных координатах.
Решите, кто красит. Прочитайте таблицу прав в разделе Настройка.