HyTari Studios · Offizielle Konfigurationsanleitung

My PvP Controls

Gib Spielern Wahlfreiheit, ohne die Serverkontrolle aufzugeben.

PvP ist bilateral: Ein Treffer zwischen Spielern ist nur gültig, wenn beide effektiv PvP aktiviert haben. Der Server kann jede Option dem Spieler überlassen oder ON/OFF erzwingen.

ANLEITUNG STARTEN MOD-SEITE

BEVOR DU BEGINNST

Erste Schritte

SCHRITT 01

Nur einen Build installieren

Entferne alte PvPToggle/MyPvPControls-Builds, die denselben /pvp-Befehl registrieren würden.

SCHRITT 02

Standards definieren

Lege PvP-Zustand, Timer und anfängliche Risikowerte fest.

SCHRITT 03

Autorität festlegen

Wähle für jede Option PLAYER, FORCE_ON oder FORCE_OFF.

Die Mod ersetzt keine Server-Schutzsysteme: Wenn ein anderes System einen Treffer blockiert, aktiviert My PvP Controls ihn nicht wieder.

KAPITEL 01 · 1 BEISPIELE

Bilaterales PvP

Wie persönlicher Schutz funktioniert und wann ein Treffer erlaubt wird.

01LOGIK

Zustimmung muss gegenseitig sein

PvP-Kampf ist nur erlaubt, wenn beide Spieler effektiv PvP ON haben.

LOGIK

Angreifer OFF + Ziel OFF  -> BLOCKIERT
Angreifer ON  + Ziel OFF  -> BLOCKIERT
Angreifer OFF + Ziel ON   -> BLOCKIERT
Angreifer ON  + Ziel ON   -> ERLAUBT

Laufzeitregel

WAS ES MACHT

PvP-Kampf ist nur erlaubt, wenn beide Spieler effektiv PvP ON haben.

WICHTIGES VERHALTEN

Die Mod erzwingt keinen Treffer, wenn ein anderes Schutzsystem ihn bereits abgebrochen hat.
PvE- und Umwelttode werden nicht in PvP umgewandelt.
Der effektive Wert berücksichtigt auch FORCE_ON/FORCE_OFF-Regeln des Servers.

KAPITEL 02 · 1 BEISPIELE

Standards und Timer

Lege Anfangszustand, Speicherung, Combat-Lock und Cooldown fest.

01JSON

Standards und zeitliche Sicherheit

Combat-Timer und Cooldown verhindern opportunistische Änderungen während oder direkt nach einem Kampf.

JSON

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

mods/MyPvPControls/config.json

WAS ES MACHT

Combat-Timer und Cooldown verhindern opportunistische Änderungen während oder direkt nach einem Kampf.

WICHTIGES VERHALTEN

CombatTimerSeconds sperrt Änderungen während aktivem PvP-Kampf.
ToggleCooldownSeconds verhindert schnelles ON/OFF-Umschalten.
Das Speichern des PvP-Zustands ist von den anderen Risikowerten getrennt.

KAPITEL 03 · 1 BEISPIELE

Risiko und Itemverlust

Item Drop, Full Inventory Drop und Durability sind getrennte Kontrollen.

01JSON

Standardwerte für persönliches Risiko

Item Drop, Full Inventory Drop und Durability können unabhängig gewählt werden.

JSON

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

mods/MyPvPControls/config.json

WAS ES MACHT

Item Drop, Full Inventory Drop und Durability können unabhängig gewählt werden.

WICHTIGES VERHALTEN

Full Inventory Drop hat Vorrang vor normalem Item Drop.
Bei deaktiviertem Item Drop verwenden passende PvP-Tode Hytales native NONE-Option.
Durability-Schutz gilt für gültiges PvP und verändert normalen PvE-Verschleiß nicht.

KAPITEL 04 · 1 BEISPIELE

Serverkontrollen

PLAYER, FORCE_ON und FORCE_OFF bestimmen, wer das letzte Wort hat.

01JSON

PLAYER, FORCE_ON und FORCE_OFF

Jede Option kann beim Spieler bleiben oder vom Server festgesetzt werden.

JSON

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

mods/MyPvPControls/config.json

WAS ES MACHT

Jede Option kann beim Spieler bleiben oder vom Server festgesetzt werden.

WICHTIGES VERHALTEN

PLAYER lässt den Spieler wählen.
FORCE_ON erzwingt den aktiven Wert.
FORCE_OFF erzwingt den deaktivierten Wert.
Das GUI zeigt immer den effektiven Wert nach Anwendung der Serverregeln.

KAPITEL 05 · 1 BEISPIELE

Spielerdaten und Logs

Wähle Storage-Backend, PvP-Audit und Aufbewahrung.

01JSON

Storage und Audit

Einstellungen können im Mod-Ordner oder im Hytale-Profil des Spielers gespeichert werden.

JSON

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

mods/MyPvPControls/config.json

WAS ES MACHT

Einstellungen können im Mod-Ordner oder im Hytale-Profil des Spielers gespeichert werden.

WICHTIGES VERHALTEN

MOD_FOLDER verwendet lesbare JSON-Dateien unter playerdata/.
PLAYER_PROFILE ist für Netzwerke nützlich, die Hytale-Profile bereits synchronisieren.
Ein Wechsel des Backends migriert vorhandene Daten nicht automatisch.
Das PvP-Log zeichnet die effektiven Werte zum Todeszeitpunkt auf.

KAPITEL 06 · 1 BEISPIELE

Befehle und Administration

Das /pvp-Panel, Spielerbefehle und Admin-Werkzeuge.

01BEFEHLE

Spieler- und Admin-Befehle

Das /pvp-Panel bietet dieselben Kontrollen wie die Unterbefehle.

BEFEHLE

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

Ingame-Befehle

WAS ES MACHT

Das /pvp-Panel bietet dieselben Kontrollen wie die Unterbefehle.

WICHTIGES VERHALTEN

Admin-Befehle benötigen mypvpcontrols.admin.
Unterstützte Admin-Änderungen werden in config.json gespeichert.
Die im Panel angezeigten Regeln können pro Sprache lokalisiert und bearbeitet werden.

Vor der Verwendung eines Beispiels

PvE- und Umwelttode werden weiterhin von Hytale und anderen Serversystemen behandelt.

PLAYER_PROFILE ist für Netzwerke gedacht, die Spielerprofile bereits synchronisieren.

Der im GUI angezeigte Regeltext kann in den Sprachdateien angepasst werden.

NACH OBEN