HyTari Studios · Guida ufficiale alla configurazione

My PvP Controls

Lascia scelta ai giocatori senza perdere il controllo del server.

Il PvP è bilaterale: un colpo tra giocatori è valido solo quando entrambi hanno PvP effettivamente attivo. Il server può lasciare ogni opzione al giocatore oppure forzarla ON/OFF.

INIZIA LA GUIDA PAGINA MOD

PRIMA DI INIZIARE

Per iniziare

PASSO 01

Installa una sola build

Rimuovi vecchie build PvPToggle/MyPvPControls che registrerebbero lo stesso /pvp.

PASSO 02

Definisci i default

Scegli stato PvP, timer e impostazioni di rischio iniziali.

PASSO 03

Decidi l'autorità

Per ogni opzione scegli PLAYER, FORCE_ON o FORCE_OFF.

La mod non deve sostituire le protezioni del server: se un altro sistema blocca un colpo, My PvP Controls non lo riabilita.

CAPITOLO 01 · 1 ESEMPI

PvP bilaterale

Come funziona la protezione personale e quando un colpo viene consentito.

01LOGICA

Il consenso deve essere reciproco

Un combattimento PvP è consentito soltanto se entrambi i giocatori hanno PvP effettivamente ON.

LOGICA
Attacker OFF + Target OFF  -> BLOCCATO
Attacker ON  + Target OFF  -> BLOCCATO
Attacker OFF + Target ON   -> BLOCCATO
Attacker ON  + Target ON   -> CONSENTITO

Regola runtime

COSA FA

Un combattimento PvP è consentito soltanto se entrambi i giocatori hanno PvP effettivamente ON.

COMPORTAMENTO IMPORTANTE

  • La mod non forza un colpo se un altro sistema di protezione lo ha già annullato.
  • PvE e morti ambientali non vengono trasformati in PvP.
  • Il valore effettivo tiene conto anche delle regole FORCE_ON/FORCE_OFF del server.

CAPITOLO 02 · 1 ESEMPI

Default e timer

Imposta stato iniziale, salvataggio, combat lock e cooldown.

01JSON

Default e sicurezza temporale

Combat timer e cooldown impediscono cambiamenti opportunistici durante o subito dopo un combattimento.

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

mods/MyPvPControls/config.json

COSA FA

Combat timer e cooldown impediscono cambiamenti opportunistici durante o subito dopo un combattimento.

COMPORTAMENTO IMPORTANTE

  • CombatTimerSeconds blocca le modifiche mentre il giocatore è in combattimento PvP attivo.
  • ToggleCooldownSeconds evita rapidi ON/OFF.
  • Il salvataggio dello stato PvP è separato dagli altri valori di rischio.

CAPITOLO 03 · 1 ESEMPI

Rischio e perdita oggetti

Item Drop, Full Inventory Drop e Durability sono controlli separati.

01JSON

Default del rischio personale

Item Drop, Full Inventory Drop e Durability possono essere scelti separatamente.

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

mods/MyPvPControls/config.json

COSA FA

Item Drop, Full Inventory Drop e Durability possono essere scelti separatamente.

COMPORTAMENTO IMPORTANTE

  • Full Inventory Drop ha priorità sul normale Item Drop.
  • Con Item Drop disattivato, le morti PvP qualificanti usano la modalità nativa NONE.
  • La protezione Durability riguarda il PvP valido; non modifica la normale usura PvE.

CAPITOLO 04 · 1 ESEMPI

Controlli del server

PLAYER, FORCE_ON e FORCE_OFF determinano chi ha l'ultima parola.

01JSON

PLAYER, FORCE_ON e FORCE_OFF

Ogni opzione può restare nelle mani del giocatore oppure essere bloccata dal server.

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

mods/MyPvPControls/config.json

COSA FA

Ogni opzione può restare nelle mani del giocatore oppure essere bloccata dal server.

COMPORTAMENTO IMPORTANTE

  • PLAYER lascia scegliere al giocatore.
  • FORCE_ON forza il valore attivo.
  • FORCE_OFF forza il valore disattivo.
  • La GUI mostra sempre il valore effettivo dopo l'applicazione delle regole server.

CAPITOLO 05 · 1 ESEMPI

Dati giocatore e log

Scegli storage, audit PvP e retention.

01JSON

Storage e audit

Le preferenze possono vivere nella cartella della mod o nel profilo Hytale del giocatore.

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

mods/MyPvPControls/config.json

COSA FA

Le preferenze possono vivere nella cartella della mod o nel profilo Hytale del giocatore.

COMPORTAMENTO IMPORTANTE

  • MOD_FOLDER usa JSON leggibili sotto playerdata/.
  • PLAYER_PROFILE è utile su reti che sincronizzano già i profili Hytale.
  • Il cambio di backend non migra automaticamente i dati esistenti.
  • Il log PvP registra i valori effettivi usati al momento della morte.

CAPITOLO 06 · 1 ESEMPI

Comandi e amministrazione

Pannello /pvp, comandi giocatore e strumenti admin.

01COMANDI

Comandi giocatore e admin

Il pannello /pvp espone gli stessi controlli disponibili tramite sottocomandi.

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

Comandi in gioco

COSA FA

Il pannello /pvp espone gli stessi controlli disponibili tramite sottocomandi.

COMPORTAMENTO IMPORTANTE

  • I comandi amministrativi richiedono mypvpcontrols.admin.
  • Le modifiche admin supportate vengono salvate in config.json.
  • Le regole visualizzate nel pannello sono localizzabili e modificabili per lingua.

Prima di usare un esempio

Le morti PvE e ambientali restano gestite da Hytale e dagli altri sistemi del server.

PLAYER_PROFILE è pensato per reti che sanno già sincronizzare i profili.

Le regole testuali mostrate nella GUI possono essere personalizzate nei file lingua.

TORNA SU