Перейти к содержимому
CXGdocs.РУКОВОДСТВА
cxg-tattoosНастройка
CXG DOCUMENTATION

Настройка

Параметры этой страницы находятся в config.lua. Изменяйте поля существующих таблиц и перезапустите ресурс, чтобы применить изменения.

Начальные значения и сохранённые настройки

Магазины и правила прогрессии в файле служат начальными настройками. После сохранения через административную панель их действующие значения сохраняются между перезапусками. Изменение файла автоматически не заменяет сохранённые данные: обновляйте магазины, правила и параметры уже инициализированной системы через панель.

Язык, providers, bridge-модули, камера и одежда для предпросмотра настраиваются в файле. Источники и татуировки описаны в разделе Каталог и наборы.

Общий язык

Код
Config.Locale = 'es'
Config.LocaleFallback = 'en'

Locale задаёт язык интерфейса и сообщений для всех игроков. После его изменения перезапустите ресурс; игрок не может менять язык через NUI. LocaleFallback задаёт резервный язык.

Доступны языки: en, es, pt-BR, fr, de, it, pl, ru, tr, th и ar. Для арабского интерфейса используется направление письма справа налево.

Система идентификации

Config.Identity настраивает интеграцию с системой идентификации сервера. Здесь задаётся способ получения идентификатора персонажа или учётной записи, который ресурс использует для сохранения и загрузки татуировок, XP и чертежей.

Код
Config.Identity.mode = 'auto'
Config.Identity.qbxResource = 'qbx_core'
РежимНазначение
autoВ Qbox используется идентификатор активного персонажа (citizenid). На других серверах — стабильный идентификатор FiveM.
qbx_characterЯвно использует идентификатор персонажа Qbox (citizenid).
licenseИспользует лицензию FiveM как идентификатор учётной записи. Персонажи одной учётной записи используют общие татуировки, XP и чертежи.

Выберите режим до того, как открыть ресурс игрокам. После смены режима данные будут запрашиваться по другому идентификатору; автоматического переноса данных между режимами не происходит. Не выбирайте license, если татуировки должны храниться отдельно для каждого персонажа учётной записи.

Подсказка взаимодействия

Код
Config.HelpText.enabled = true
Config.HelpText.provider = 'auto'
Config.HelpText.position = 'left-center'
ПолеЗначения или эффект
enabledПоказывает или скрывает подсказку взаимодействия у магазина с маркером.
providerauto, ox_lib или native. auto использует TextUI, если он доступен, иначе — встроенную подсказку.
positionДля TextUI: left-center, right-center, top-center или bottom-center.
styleЦвета, граница, тень, шрифт и внутренние отступы TextUI.

Пример стиля:

Код
Config.HelpText.style.backgroundColor = '#172328'
Config.HelpText.style.color = '#eef3f3'
Config.HelpText.style.fontSize = '15px'

Начальные магазины

В Config.Shops указаны шесть местоположений. Чтобы изменить начальную запись, сохраните её структуру:

Код
{
    label = 'Tattoo Studio',
    coords = vector3(322.62, 180.34, 103.59),
    heading = 156.2,
    drawDistance = 10.0,
    interactDistance = 1.5,
    shopRadius = 4.0,
    marker = {
        type = 1,
        scale = vector3(1.0, 1.0, 1.0),
        color = { r = 255, g = 100, b = 0, a = 100 },
    },
},
ПолеНазначение
labelНазвание магазина.
coords, headingПоложение и направление.
drawDistanceДистанция отображения маркера.
interactDistanceДистанция взаимодействия.
shopRadiusРадиус, в пределах которого разрешены операции магазина.
marker.type, scale, colorВнешний вид маркера.

Значение interactDistance не должно превышать shopRadius. Для уже созданных магазинов используйте раздел магазинов в административной панели; изменение файла не пересоздаст и не заменит такие магазины.

Уровни и XP

Параметр Config.LevelsНачальное значениеНазначение
enabledtrueВключает прогрессию, требования и скидки.
maxLevel10Максимальный уровень.
defaultXpPerTattoo10XP за татуировку, для которой не указано Xp.
thresholdsУровни с 1 по 10Накопленное количество XP, необходимое для каждого уровня.
formula.base, formula.exponent100, 1.5Параметры альтернативной формулы порогов.
zoneRequirements1 для каждой зоныТребование для зоны, если для татуировки не задано отдельное.
discountsВключены, 3 за уровень, максимум 25Скидка в процентах.
blueprintSlotsОснова 5, прирост 3Количество слотов чертежей в зависимости от уровня.

Пороги должны начинаться с уровня 1 и 0 XP, идти без пропусков, а необходимое количество XP должно возрастать:

Код
Config.Levels.thresholds = {
    { level = 1, xpRequired = 0 },
    { level = 2, xpRequired = 100 },
    { level = 3, xpRequired = 250 },
}
Config.Levels.maxLevel = 3

Размер скидки рассчитывается как уровень × perLevel и ограничивается значением maxDiscount. При начальных настройках на 5-м уровне скидка составляет 15 %, максимальная — 25 %.

Количество слотов рассчитывается как base + (уровень - 1) × perLevel. При начальных настройках на 1-м уровне доступно 5 слотов, на 5-м — 17.

Индивидуальный RequiredLevel в каталоге имеет приоритет над требованием зоны. См. раздел Поля каталога.

При отключении уровней не применяются ограничения по уровню, XP и скидки; лимит чертежей задаётся через Config.Blueprints.maxPerPlayer. Отключение системы сохраняет накопленные XP. В уже настроенных установках обновите также действующий статус через панель.

Чертежи

Чертежи сохраняют группы татуировок и позволяют делиться ими с помощью кодов. Начальные ограничения находятся в Config.Blueprints:

ПолеНачальное значениеНазначение
enabledtrueВключает систему.
codePrefixINKПрефикс кодов, например INK-A3X9.
codeLength4Число символов после префикса.
maxPerPlayer20Число слотов при отключённой прогрессии.
maxTattoosPerBlueprint50Максимум татуировок в одной группе.
nameMaxLength60Максимальная длина названия.

Активация кода подготавливает татуировки к покупке, но не предоставляет бесплатную покупку. Экономика настраивается в разделе Интеграции.

Камера

ТаблицаЧто настраивает
CameraOffsetsЦелевую кость, расстояние, смещения и поле зрения для каждой зоны.
CameraFramingОбщую композицию и смещение точки фокусировки.
CameraFramingBySideДополнительные настройки вида спереди и сзади.
CameraManualControlsРучное управление, шаги перемещения, вращение, масштабирование и ограничения.

Настроены зоны ZONE_HEAD, ZONE_TORSO, ZONE_LEFT_ARM, ZONE_RIGHT_ARM, ZONE_LEFT_LEG и ZONE_RIGHT_LEG.

Примеры точечных изменений:

Код
Config.CameraOffsets['ZONE_TORSO'].fov = 50.0
Config.CameraFraming.screenOffset = 0.35
Config.CameraManualControls.enabled = true
Config.CameraManualControls.step = 0.035
Config.CameraManualControls.zoomStep = 0.08

Положительное значение screenOffset смещает персонажа влево, освобождая место для меню справа. Параметр lookAtOffsetX/Y/Z меняет точку фокусировки; camOffsetX/Y/Z в настройках сторон меняет положение камеры.

Для ручного управления параметры horizontalDegrees и rotationStepDegrees задают вращение. ranges.y/z, radialClamp и maxDistance ограничивают смещения. zoomCompositionMinBias настраивает центрирование при приближении. Изменяйте по одному значению и проверяйте все шесть зон на мужских и женских персонажах.

Одежда для предпросмотра

Config.PreviewOutfit позволяет освободить области с татуировками, пока открыт интерфейс:

Код
Config.PreviewOutfit.enabled = true
Config.PreviewOutfit.useDefaultVariation = false
Config.PreviewOutfit.presets['mp_m_freemode_01'].components[11] = {
    drawable = 15,
    texture = 0,
}

Включённые пресеты различаются для mp_m_freemode_01 и mp_f_freemode_01. Для каждого компонента указываются drawable и texture; clearProps снимает аксессуары на время предпросмотра. Настройте индексы в соответствии с одеждой на сервере. Оставьте useDefaultVariation = false, если нужно применить только компоненты пресета, не сбрасывая внешний вид целиком.

Права доступа, экономика и Qbox

Параметры Config.Permissions, Config.AdminCommand, Config.Purchases и Config.QbxMulticharacterPreview описаны в разделе Интеграции. Укажите фактические имена ресурсов, если они отличаются от используемых по умолчанию.

Диагностика

Config.Debug включает общую диагностику. Config.Permissions.debug помогает проверять решения о доступе. После проверки отключите оба параметра.

Config.DebugCommands.clientTattooCommand изначально отключён. Включайте эту визуальную команду только для тестирования: она не сохраняет татуировки и не заменяет покупку.

Перейти к каталогу.

CXG · ДокументацияХорошая основа. Безграничные возможности.
Настройка · cxg-tattoos · CXG Docs