Слоты персонажей

Больше персонажей — роли Discord, VIP-список или свои правила.

По умолчанию у всех несколько слотов (Config.DefaultCharacterSlots, с потолком Config.MaxCharacters). Если хватает — эту страницу можно пропустить.

Хотите, чтобы у supporters, staff или конкретных игроков было больше? Всё настраивается в rco-creator/config/server.lua на сервере — игроки этот файл не видят.

​

Как Creator выбирает число (прочитайте сначала)

Когда кто-то открывает выбор персонажа, Creator спрашивает в таком порядке и останавливается на первом ответе:

1. Ваша функция — если ResolveCustomSlots вернула число
2. Роли Discord — только когда интеграция Discord включена
3. Ручной список по license — PlayerSlots, но только когда Discord выключен
4. Лимит фреймворка — что сообщает RSG/VORP
5. По умолчанию — Config.DefaultCharacterSlots

Что бы ни победило — зажимается между 1 и Config.MaxCharacters.

Три частые путаницы:

1. Числа — это всего слотов, а не «базовые + бонус». VIP = 5 значит пять персонажей всего, а не четыре плюс один.
2. Discord включён = PlayerSlots игнорируется. Нужны оба? Обрабатывайте в ResolveCustomSlots.
3. Несколько ролей Discord не складываются. Creator берёт только самую высокую подходящую роль.

​

Дополнительные слоты одному игроку (без Discord)

Сопоставьте license с общим числом слотов:

CreatorServerConfig.PlayerSlots = {
    ['license:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b'] = 5,
}

License смотрите в админ-инструментах или консоли сервера при подключении.

​

Роли Discord

Привяжите слоты к ролям в Discord-сервере сообщества. Нужны бот и ID в server.lua.

Первый раз? Пошагово: Настройка ролей Discord.

CreatorServerConfig.Discord = {
    enabled = true,
    guildId = '123456789012345678',
    botToken = 'YOUR_BOT_TOKEN',
    defaultSlots = 1,
    cacheSeconds = 600,
    timeoutMs = 8000,
    roleSlots = {
        ['ROLE_ID_SUPPORTER'] = 3,
        ['ROLE_ID_VIP'] = 5,
    },
}

Supporter (3) + VIP (5) вместе = 5, не 8. Без привязанного Discord = defaultSlots.

Токен бота = пароль. Никогда в Discord, тикетах или публичных репозиториях. server.lua только на игровом сервере.

Discord включён, но пустые guildId или botToken → Creator не запустится.

​

Свои правила (Tebex, база, whitelist)

Используйте шаг 1 — верните число или nil, чтобы передать дальше:

CreatorServerConfig.ResolveCustomSlots = function(source, identifiers)
    -- identifiers.license, identifiers.discord доступны
    if identifiers.license == 'license:...' then
        return 5
    end
    return nil
end

Если функция падает с ошибкой, выбор не откроется для этого игрока — держите её простой.

​

Заблокированные слоты на экране выбора

Дополнительные слоты, которые игрок ещё не открыл, показываются бледными силуэтами. Скрыть их: Config.Selection.hideLockedSlotGhosts = true.