HyTari Studios · Официальное руководство по настройке

My PvP Controls

Дайте игрокам выбор, не теряя контроль сервера.

PvP двусторонний: удар между игроками разрешен только когда у обоих фактически включен PvP. Сервер может оставить выбор игроку или принудительно задать ON/OFF.

НАЧАТЬ РУКОВОДСТВО СТРАНИЦА МОДА

ПЕРЕД НАЧАЛОМ

Начало работы

ШАГ 01

Установите одну сборку

Удалите старые PvPToggle/MyPvPControls, которые зарегистрировали бы тот же /pvp.

ШАГ 02

Настройте значения по умолчанию

Выберите состояние PvP, таймеры и начальные параметры риска.

ШАГ 03

Определите контроль

Для каждой настройки выберите PLAYER, FORCE_ON или FORCE_OFF.

Мод не заменяет серверные защиты: если другая система заблокировала удар, My PvP Controls не включает его обратно.

ГЛАВА 01 · 1 ПРИМЕРЫ

Двусторонний PvP

Как работает личная защита и когда удар разрешается.

01ЛОГИКА

Согласие должно быть взаимным

PvP разрешен только когда у обоих игроков фактически PvP ON.

ЛОГИКА

Атакующий OFF + Цель OFF  -> ЗАБЛОКИРОВАНО
Атакующий ON  + Цель OFF  -> ЗАБЛОКИРОВАНО
Атакующий OFF + Цель ON   -> ЗАБЛОКИРОВАНО
Атакующий ON  + Цель ON   -> РАЗРЕШЕНО

Правило runtime

ЧТО ЭТО ДЕЛАЕТ

PvP разрешен только когда у обоих игроков фактически PvP ON.

ВАЖНОЕ ПОВЕДЕНИЕ

Мод не принуждает удар, если другая защитная система уже его отменила.
PvE и смерти от окружения не превращаются в PvP.
Фактическое значение учитывает также серверные FORCE_ON/FORCE_OFF.

ГЛАВА 02 · 1 ПРИМЕРЫ

Значения по умолчанию и таймеры

Настройте начальное состояние, сохранение, combat lock и cooldown.

01JSON

Значения по умолчанию и защита по времени

Combat timer и cooldown не дают менять настройки во время или сразу после боя.

JSON

{
  "DefaultPvPEnabled": false,
  "DefaultPvPStatusSave": false,
  "CombatTimerSeconds": 10,
  "ToggleCooldownSeconds": 5
}

mods/MyPvPControls/config.json

ЧТО ЭТО ДЕЛАЕТ

Combat timer и cooldown не дают менять настройки во время или сразу после боя.

ВАЖНОЕ ПОВЕДЕНИЕ

CombatTimerSeconds блокирует изменения во время активного PvP-боя.
ToggleCooldownSeconds предотвращает быстрые ON/OFF-переключения.
Сохранение PvP-состояния отделено от других значений риска.

ГЛАВА 03 · 1 ПРИМЕРЫ

Риск и потеря предметов

Item Drop, Full Inventory Drop и Durability — отдельные настройки.

01JSON

Риск по умолчанию

Item Drop, Full Inventory Drop и Durability выбираются независимо.

JSON

{
  "DefaultItemDrop": false,
  "DefaultFullInventoryDrop": false,
  "DefaultItemDurability": true
}

mods/MyPvPControls/config.json

ЧТО ЭТО ДЕЛАЕТ

Item Drop, Full Inventory Drop и Durability выбираются независимо.

ВАЖНОЕ ПОВЕДЕНИЕ

Full Inventory Drop имеет приоритет над обычным Item Drop.
При выключенном Item Drop подходящие PvP-смерти используют нативный режим Hytale NONE.
Защита Durability действует в корректном PvP и не меняет обычный PvE-износ.

ГЛАВА 04 · 1 ПРИМЕРЫ

Контроль сервера

PLAYER, FORCE_ON и FORCE_OFF определяют окончательное решение.

01JSON

PLAYER, FORCE_ON и FORCE_OFF

Каждую настройку можно оставить игроку или зафиксировать сервером.

JSON

{
  "PvPControl": "PLAYER",
  "PvPStatusSaveControl": "PLAYER",
  "ItemDropControl": "PLAYER",
  "FullInventoryDropControl": "PLAYER",
  "ItemDurabilityControl": "PLAYER"
}

mods/MyPvPControls/config.json

ЧТО ЭТО ДЕЛАЕТ

Каждую настройку можно оставить игроку или зафиксировать сервером.

ВАЖНОЕ ПОВЕДЕНИЕ

PLAYER позволяет игроку выбирать.
FORCE_ON принудительно включает значение.
FORCE_OFF принудительно выключает значение.
GUI всегда показывает фактическое значение после серверных правил.

ГЛАВА 05 · 1 ПРИМЕРЫ

Данные игрока и журналы

Выберите storage backend, PvP-аудит и срок хранения.

01JSON

Хранение и аудит

Настройки могут храниться в папке мода или в профиле Hytale игрока.

JSON

{
  "PlayerData": {
    "Storage": "MOD_FOLDER"
  },
  "Logs": {
    "FileLogging": true,
    "ConsoleLogging": false,
    "AutoPurgeEnabled": true,
    "AutoPurgeDays": 30
  }
}

mods/MyPvPControls/config.json

ЧТО ЭТО ДЕЛАЕТ

Настройки могут храниться в папке мода или в профиле Hytale игрока.

ВАЖНОЕ ПОВЕДЕНИЕ

MOD_FOLDER использует читаемые JSON-файлы в playerdata/.
PLAYER_PROFILE полезен в сетях, уже синхронизирующих профили Hytale.
Смена backend не переносит существующие данные автоматически.
PvP-журнал записывает фактические значения в момент смерти.

ГЛАВА 06 · 1 ПРИМЕРЫ

Команды и администрирование

Панель /pvp, команды игрока и инструменты администратора.

01КОМАНДЫ

Команды игрока и администратора

Панель /pvp дает те же настройки, что и подкоманды.

КОМАНДЫ

/pvp
/pvp on | off | toggle | status
/pvp itemdrop <on|off|toggle>
/pvp fulldrop <on|off|toggle>
/pvp durability <on|off|toggle>
/pvp save <on|off|toggle>
/pvp admin config
/pvp admin set <key> <value>

Игровые команды

ЧТО ЭТО ДЕЛАЕТ

Панель /pvp дает те же настройки, что и подкоманды.

ВАЖНОЕ ПОВЕДЕНИЕ

Админ-команды требуют mypvpcontrols.admin.
Поддерживаемые админ-изменения сохраняются в config.json.
Правила в панели можно локализовать и редактировать по языкам.

Перед использованием примера

PvE и смерти от окружения по-прежнему обрабатываются Hytale и другими системами сервера.

PLAYER_PROFILE предназначен для сетей, которые уже синхронизируют профили игроков.

Текст правил в GUI можно менять в языковых файлах.

НАВЕРХ