Skufy Ranks

Что умеет мод

Установка

1. Скопируйте папку @Skufy_Ranks на сервер и добавьте её в параметр запуска -mod= (клиентам — так же, или через Мастерскую Steam).
2. Ключ Skufy.bikey из папки @Skufy_Ranks/Keys положите в папку keys сервера.
3. Других модов не нужно: Community Framework не требуется.
4. Чтобы книги появлялись в луте, добавьте строки из @Skufy_Ranks/ServerFiles/types.xml в db/types.xml вашей миссии (14 книг). Без этого книги можно выдать только из админ-панели или наградой.
5. Запустите сервер один раз — мод создаст папку profiles/Skufy_Ranks со всеми файлами и готовым контентом: ранги, задания, ограничения, книги.
6. Впишите свой SteamID64 в Admins (см. Администраторы), перезапустите сервер, зайдите в игру и нажмите Num 1 + Num 4 — или кнопку АДМИН в меню рангов (O).

Администраторы

Админ-панель открывается только тем, чей SteamID64 (17 цифр, начинается с 7656119) есть в списке Admins файла Settings.json.

"Admins": [
    "76561198000000001",
    "76561198000000002"
],

• Добавлять админов удобнее в самой панели: НАСТРОЙКИ → АДМИНИСТРАТОРЫ РАНГОВ (SteamID64 через запятую).
• Ограничения по рангу на админов не действуют — пока не включён AdminsRestricted.
• В одиночной игре (оффлайн) админ — любой игрок: удобно для тестов.

Файлы конфига

Правила ручной правки

1. Проще всего — в админ-панели: там не ошибиться с запятыми и кавычками, а изменения сразу получают все игроки.
2. Файлы читаются при запуске сервера. Правите вручную — делайте это на выключенном сервере: при сохранении из панели сервер перезаписывает файлы.
3. Это JSON: строки в двойных кавычках, между элементами запятые, после последнего элемента запятой нет, комментариев нет. Переключатели — 1 или 0.
4. Все ID (ранги, задания, категории, ограничения) — латиница, цифры, _ и -. На ID ссылаются другие файлы: переименовывать удобнее в панели — она переименует и ссылки.
5. Если файл не читается, в логе сервера будет строка [Skufy_Ranks] Quests.json is broken… с причиной, а рядом появится копия .broken. Удалите файл целиком — мод создаст его заново с содержимым по умолчанию.

Как растёт ранг

• Опыт копится всегда и не пропадает: ранг — это самый высокий ранг, чей порог опыта набран и чьи аттестации (и аттестации всех рангов ниже) сданы.
• Если для следующего ранга нужна аттестация, опыт продолжает расти, а в окне ранга пишется «для «Сержант» нужна аттестация». Сдал экзамен — ранг выдаётся сразу, иногда через несколько ступеней.
• Награда за ранг выдаётся один раз — когда ранг получен впервые. Не влезает в инвентарь — появляется на земле у игрока.
• О новом ранге узнаёт весь сервер (NoAnnounce выключает объявление), игрок видит баннер повышения.
• Штраф за смерть (DeathPenalty, %) отнимает часть опыта, набранного внутри текущего ранга. Ранг при смерти не теряется никогда.
• Поменяли пороги или порядок рангов — ранг каждого игрока пересчитается при его следующем входе, без повторных наград.

Опыт по умолчанию

Ранги · Ranks.json

Порядок рангов в списке Ranks — это лестница снизу вверх. Первый ранг всегда начинается с 0 опыта, каждый следующий должен требовать больше предыдущего (если нет — мод сам поднимет порог на 1).

{
    "Id": "sergeant",
    "Name": "Сержант",
    "NameEn": "Sergeant",
    "Glyph": "ins_chev3r1",
    "Hex": "34D1BF",
    "Xp": 3100,
    "Desc": "Сдал аттестацию. Допущен к армейскому оружию.",
    "DescEn": "Passed the exam. Cleared for military rifles.",
    "Quests": [ "exam_sergeant" ],
    "Rewards": [
        { "Item": "Binoculars", "Count": 1 },
        { "Item": "Ammo_762x39", "Count": 40 }
    ]
}

Лестница по умолчанию

Ключи знаков (Glyph)

Задания · Quests.json

В файле два списка: Categories — разделы журнала и Quests — сами задания. По умолчанию 52 задания в 9 категориях, из них 4 — аттестации.

Категории

Поля задания

Цели (Goals)

Пример

{
    "Id": "patrol_cherno",
    "Title": "Патруль Черногорска",
    "TitleEn": "Chernogorsk patrol",
    "Desc": "Зачистите порт и отметьтесь на маяке.",
    "DescEn": "Clear the port and check in at the lighthouse.",
    "CatId": "combat",
    "Glyph": "",
    "MinRank": "private",
    "MaxRank": "",
    "MapName": "chernarusplus",
    "Xp": 400,
    "Repeat": 1,
    "Cooldown": 120,
    "TimeLimit": 60,
    "Disabled": 0,
    "Requires": [ "c_first" ],
    "Goals": [
        { "Kind": 0, "Count": 20, "Targets": [], "With": [], "Label": "", "LabelEn": "",
          "PosX": 7100, "PosZ": 2500, "Radius": 400 },
        { "Kind": 6, "Count": 1, "Targets": [], "With": [], "Label": "Маяк", "LabelEn": "Lighthouse",
          "PosX": 7480, "PosZ": 2290, "Radius": 40 }
    ],
    "Rewards": [ { "Item": "Ammo_762x39", "Count": 60 } ]
}

Как проходит задание

• Одновременно можно вести не больше MaxActive заданий (5 по умолчанию; готовые к сдаче тоже считаются).
• Цели «Иметь при себе», «Принести и сдать» и «Посетить место» проверяются сами каждые пару секунд.
• Награду игрок забирает в меню. С AutoClaim она выдаётся сразу, как только цели выполнены.
• От задания можно отказаться — прогресс сбрасывается.

Ограничения · Rules.json

Каждое ограничение запрещает что-то игрокам ниже указанного ранга. Запрещённое действие даже не предлагается в игре, а сервер проверяет всё ещё раз — модифицированный клиент ничего не даст. Игрок видит подсказку, с какого ранга откроется доступ.

Ограничения по умолчанию

{
    "Id": "tisy",
    "Title": "Военная база Тисы",
    "TitleEn": "Tisy military base",
    "Kind": 10,
    "MinRank": "sergeant",
    "Disabled": 0,
    "Classes": [],
    "Actions": [],
    "Zoned": 1,
    "PosX": 1650,
    "PosZ": 14000,
    "Radius": 500,
    "Msg": "",
    "MsgEn": ""
}

Книги · Books.json

Книгу берут в руки и изучают: полноценная анимация чтения на Seconds секунд, потом опыт. Во всплывающей подсказке предмета видно, сколько опыта он даст этому игроку или почему его пока нельзя изучить.

• Задержка между двумя любыми книгами одного игрока — BookCooldown (минуты) в Settings.json.
• Цель задания «Изучить книгу»: Skufy_RK_Manual_Base — любое пособие, Skufy_RK_Read_Base — любая книга библиотеки.
• Частота в луте — в @Skufy_Ranks/ServerFiles/types.xml: книги библиотеки встречаются чаще (города, деревни, школы, офисы), пособия — реже, старшие тома реже всего.

Settings.json

Общие настройки. В скобках под значением по умолчанию — допустимый диапазон: всё, что выходит за него, мод при загрузке поправит сам. Всё это есть на вкладке НАСТРОЙКИ админ-панели.

{
    "Version": 1,
    "Admins": [ "76561198000000001" ],
    "MaxActive": 5,
    "AutoClaim": 0,
    "DeathPenalty": 0,
    "NoHud": 0,
    "NoTop": 0,
    "TopSize": 20,
    "NoAnnounce": 0,
    "AdminsRestricted": 0,
    "NoHints": 0,
    "BookCooldown": 0,
    "ZoneWarn": 60,
    "XpZombie": 2,
    "XpAnimal": 5,
    "XpPlayer": 20,
    "XpCraft": 1,
    "XpBuild": 2,
    "XpHarvest": 2,
    "XpFish": 3,
    "PlayMinutes": 15,
    "PlayXp": 10
}

Профили игроков

Каждый игрок — файл Players/<SteamID64>.json. Сервер пишет его сам; менять опыт и ранг удобнее во вкладке ИГРОКИ админ-панели — она работает и с теми, кто сейчас не в игре.

Админ-панель (Num 1 + Num 4)

Открывается сочетанием клавиш или кнопкой АДМИН в меню рангов. Внизу — СОХРАНИТЬ и ОТМЕНИТЬ: сохранённое сразу записывается в файлы и уходит всем игрокам, рестарт не нужен.

Как играют игроки

Меню рангов — O

• ПРОФИЛЬ — значок и название ранга, полоса опыта, следующий ранг и нужная аттестация, статистика, активные задания, за что даётся опыт.
• ЗАДАНИЯ — фильтры «активные / доступные / выполненные / все», поиск, категории, карточка задания с целями, наградой и условиями. Задание можно взять, отказаться от него и следить — до 3 заданий показываются на экране.
• РАНГИ — вся лестница: пороги, аттестации, награды и что открывает каждый ранг.
• ДОСТУП — все ограничения сервера: что уже открыто, что закрыто и с какого ранга.
• ЛИДЕРЫ — лучшие игроки сервера и ваше место.

На экране

• Окно ранга: ранг, полоса опыта со вспышкой при получении, сколько до следующего ранга и отслеживаемые задания с расстоянием до точки. Прячется в меню, после смерти и когда HUD игры выключен.
• Угол окна игрок может поменять в своём файле Skufy_Ranks_Client.json (папка профиля DayZ): Corner — 0 левый верхний, 1 правый верхний, 2 левый нижний, 3 правый нижний; Hidden: 1 — скрыть окно.
• Уведомления: опыт, выполненные цели, награды, провал по времени, запреты с нужным рангом, закрытые зоны.

Если что-то не работает

Не открывается админ-панель

Проверьте, что ваш SteamID64 (17 цифр) есть в Admins файла Settings.json, и перезапустите сервер. Проверьте клавиши в «Настройки → Управление → Skufy Ranks». Кнопка АДМИН в меню рангов видна только админам.

Книг нет в луте

Добавьте строки из @Skufy_Ranks/ServerFiles/types.xml в db/types.xml миссии и перезапустите сервер. Книги можно выдать себе и из админ-панели: вкладка ПОСОБИЯ → ВЗЯТЬ.

Книгу нельзя изучить

Наведите на книгу в инвентаре — в подсказке написана причина: нужен другой ранг, книга уже изучена («Один раз»), не прошла задержка BookCooldown или книга выключена. Изучать нужно, взяв книгу в руки.

Опыта хватает, а ранг не растёт

Для следующего ранга нужна аттестация — в окне ранга написано «для «…» нужна аттестация». Выполните задание-экзамен из категории «Аттестация», и ранг выдастся сразу.

Поменял JSON, а в игре всё по-старому

Файлы читаются при запуске сервера. Правьте их на выключенном сервере — или меняйте в админ-панели: там изменения применяются сразу. Сохранение из панели перезаписывает файлы.

После правки пропали мои ранги или задания

Файл с ошибкой: мод работает на настройках по умолчанию и кладёт копию .broken, в логе — строка [Skufy_Ranks] … is broken с причиной. Исправьте ошибку в копии, переименуйте её обратно и перезапустите сервер.

Задание не видно игроку

Проверьте MinRank / MaxRank (старшим рангам задание с верхней границей не показывается), Requires (сначала нужны другие задания), MapName (задание для другой карты) и Disabled.

Ограничение не действует на меня

Вы админ: ограничения на админов не действуют, пока не включён AdminsRestricted. Для проверки включите его или зайдите не-админом.

Хочу вернуть всё как было

Удалите нужный файл (Ranks.json, Quests.json, Rules.json, Books.json) на выключенном сервере — при запуске мод создаст его заново с содержимым по умолчанию. Профили игроков лежат отдельно в Players/.