HyTari Studios · Oficjalny poradnik konfiguracji

My PvP Controls

Daj graczom wybór bez utraty kontroli serwera.

PvP jest dwustronne: trafienie między graczami jest poprawne tylko wtedy, gdy obaj mają faktycznie włączone PvP. Serwer może pozostawić wybór graczowi albo wymusić ON/OFF.

ZANIM ZACZNIESZ

Pierwsze kroki

KROK 01

Zainstaluj tylko jeden build

Usuń stare buildy PvPToggle/MyPvPControls, które rejestrowałyby ten sam /pvp.

KROK 02

Ustaw wartości domyślne

Wybierz stan PvP, timery i początkowe parametry ryzyka.

KROK 03

Wybierz kontrolę

Dla każdej opcji wybierz PLAYER, FORCE_ON lub FORCE_OFF.

Mod nie zastępuje zabezpieczeń serwera: jeśli inny system zablokuje trafienie, My PvP Controls nie włączy go ponownie.

ROZDZIAŁ 01 · 1 PRZYKŁADY

Dwustronne PvP

Jak działa osobista ochrona i kiedy trafienie jest dozwolone.

01LOGIKA

Zgoda musi być wzajemna

PvP jest dozwolone tylko wtedy, gdy obaj gracze mają faktycznie PvP ON.

LOGIKA
Atakujący OFF + Cel OFF  -> ZABLOKOWANE
Atakujący ON  + Cel OFF  -> ZABLOKOWANE
Atakujący OFF + Cel ON   -> ZABLOKOWANE
Atakujący ON  + Cel ON   -> DOZWOLONE

Reguła runtime

CO TO ROBI

PvP jest dozwolone tylko wtedy, gdy obaj gracze mają faktycznie PvP ON.

WAŻNE DZIAŁANIE

  • Mod nie wymusza trafienia, jeśli inny system ochrony już je anulował.
  • Śmierci PvE i środowiskowe nie są zamieniane na PvP.
  • Efektywna wartość uwzględnia też serwerowe FORCE_ON/FORCE_OFF.

ROZDZIAŁ 02 · 1 PRZYKŁADY

Domyślne wartości i timery

Ustaw stan początkowy, zapis, combat lock i cooldown.

01JSON

Domyślne wartości i bezpieczeństwo czasowe

Combat timer i cooldown zapobiegają zmianom ustawień w trakcie lub tuż po walce.

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

mods/MyPvPControls/config.json

CO TO ROBI

Combat timer i cooldown zapobiegają zmianom ustawień w trakcie lub tuż po walce.

WAŻNE DZIAŁANIE

  • CombatTimerSeconds blokuje zmiany podczas aktywnej walki PvP.
  • ToggleCooldownSeconds zapobiega szybkim przełączeniom ON/OFF.
  • Zapis stanu PvP jest oddzielony od pozostałych wartości ryzyka.

ROZDZIAŁ 03 · 1 PRZYKŁADY

Ryzyko i utrata przedmiotów

Item Drop, Full Inventory Drop i Durability są osobnymi ustawieniami.

01JSON

Domyślne ryzyko gracza

Item Drop, Full Inventory Drop i Durability można wybierać niezależnie.

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

mods/MyPvPControls/config.json

CO TO ROBI

Item Drop, Full Inventory Drop i Durability można wybierać niezależnie.

WAŻNE DZIAŁANIE

  • Full Inventory Drop ma priorytet nad zwykłym Item Drop.
  • Przy wyłączonym Item Drop odpowiednie śmierci PvP używają natywnego trybu Hytale NONE.
  • Ochrona Durability dotyczy poprawnego PvP i nie zmienia normalnego zużycia PvE.

ROZDZIAŁ 04 · 1 PRZYKŁADY

Kontrola serwera

PLAYER, FORCE_ON i FORCE_OFF określają, kto ma ostatnie słowo.

01JSON

PLAYER, FORCE_ON i FORCE_OFF

Każda opcja może pozostać pod kontrolą gracza albo zostać zablokowana przez serwer.

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

mods/MyPvPControls/config.json

CO TO ROBI

Każda opcja może pozostać pod kontrolą gracza albo zostać zablokowana przez serwer.

WAŻNE DZIAŁANIE

  • PLAYER pozwala graczowi wybierać.
  • FORCE_ON wymusza wartość aktywną.
  • FORCE_OFF wymusza wartość wyłączoną.
  • GUI zawsze pokazuje efektywną wartość po zastosowaniu reguł serwera.

ROZDZIAŁ 05 · 1 PRZYKŁADY

Dane gracza i logi

Wybierz storage backend, audyt PvP i retencję.

01JSON

Storage i audyt

Preferencje mogą być przechowywane w folderze moda lub profilu Hytale gracza.

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

mods/MyPvPControls/config.json

CO TO ROBI

Preferencje mogą być przechowywane w folderze moda lub profilu Hytale gracza.

WAŻNE DZIAŁANIE

  • MOD_FOLDER używa czytelnych plików JSON w playerdata/.
  • PLAYER_PROFILE jest przydatny w sieciach synchronizujących już profile Hytale.
  • Zmiana backendu nie przenosi automatycznie istniejących danych.
  • Log PvP zapisuje efektywne wartości w chwili śmierci.

ROZDZIAŁ 06 · 1 PRZYKŁADY

Komendy i administracja

Panel /pvp, komendy gracza i narzędzia admina.

01KOMENDY

Komendy gracza i admina

Panel /pvp udostępnia te same opcje co podkomendy.

KOMENDY
/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>

Komendy w grze

CO TO ROBI

Panel /pvp udostępnia te same opcje co podkomendy.

WAŻNE DZIAŁANIE

  • Komendy administracyjne wymagają mypvpcontrols.admin.
  • Obsługiwane zmiany admina są zapisywane w config.json.
  • Zasady w panelu można lokalizować i edytować dla każdego języka.

Przed użyciem przykładu

Śmierci PvE i środowiskowe nadal obsługuje Hytale oraz inne systemy serwera.

PLAYER_PROFILE jest przeznaczony dla sieci, które już synchronizują profile graczy.

Tekst zasad w GUI można zmieniać w plikach językowych.

DO GÓRY