HyTari Studios · Guide officiel de configuration

My PvP Controls

Laissez le choix aux joueurs sans perdre le contrôle du serveur.

Le PvP est bilatéral : un coup joueur contre joueur n'est valide que si les deux joueurs ont effectivement le PvP activé. Le serveur peut laisser chaque option au joueur ou la forcer ON/OFF.

COMMENCER LE GUIDE PAGE DU MOD

AVANT DE COMMENCER

Bien démarrer

ÉTAPE 01

Installer une seule build

Supprimez les anciennes builds PvPToggle/MyPvPControls qui enregistreraient le même /pvp.

ÉTAPE 02

Définir les valeurs par défaut

Choisissez l'état PvP, les timers et les paramètres de risque initiaux.

ÉTAPE 03

Choisir l'autorité

Pour chaque option, choisissez PLAYER, FORCE_ON ou FORCE_OFF.

Le mod ne remplace pas les protections serveur : si un autre système bloque un coup, My PvP Controls ne le réactive pas.

CHAPITRE 01 · 1 EXEMPLES

PvP bilatéral

Fonctionnement de la protection personnelle et conditions d'autorisation d'un coup.

01LOGIQUE

Le consentement doit être mutuel

Le combat PvP n'est autorisé que si les deux joueurs ont effectivement PvP ON.

LOGIQUE

Attaquant OFF + Cible OFF  -> BLOQUÉ
Attaquant ON  + Cible OFF  -> BLOQUÉ
Attaquant OFF + Cible ON   -> BLOQUÉ
Attaquant ON  + Cible ON   -> AUTORISÉ

Règle runtime

CE QUE ÇA FAIT

Le combat PvP n'est autorisé que si les deux joueurs ont effectivement PvP ON.

COMPORTEMENT IMPORTANT

Le mod ne force pas un coup si un autre système de protection l'a déjà annulé.
Les morts PvE et environnementales ne sont pas converties en PvP.
La valeur effective tient aussi compte des règles FORCE_ON/FORCE_OFF du serveur.

CHAPITRE 02 · 1 EXEMPLES

Valeurs par défaut et timers

Définissez l'état initial, la sauvegarde, le verrou de combat et le cooldown.

01JSON

Valeurs par défaut et sécurité temporelle

Le timer de combat et le cooldown empêchent les changements opportunistes pendant ou juste après un combat.

JSON

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

mods/MyPvPControls/config.json

CE QUE ÇA FAIT

Le timer de combat et le cooldown empêchent les changements opportunistes pendant ou juste après un combat.

COMPORTEMENT IMPORTANT

CombatTimerSeconds bloque les changements pendant un combat PvP actif.
ToggleCooldownSeconds empêche les bascules ON/OFF rapides.
La sauvegarde de l'état PvP est séparée des autres valeurs de risque.

CHAPITRE 03 · 1 EXEMPLES

Risque et perte d'objets

Item Drop, Full Inventory Drop et Durability sont des contrôles séparés.

01JSON

Risque personnel par défaut

Item Drop, Full Inventory Drop et Durability peuvent être choisis indépendamment.

JSON

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

mods/MyPvPControls/config.json

CE QUE ÇA FAIT

Item Drop, Full Inventory Drop et Durability peuvent être choisis indépendamment.

COMPORTEMENT IMPORTANT

Full Inventory Drop est prioritaire sur Item Drop normal.
Avec Item Drop désactivé, les morts PvP concernées utilisent le mode natif NONE de Hytale.
La protection Durability concerne le PvP valide et ne modifie pas l'usure PvE normale.

CHAPITRE 04 · 1 EXEMPLES

Contrôles serveur

PLAYER, FORCE_ON et FORCE_OFF déterminent qui a le dernier mot.

01JSON

PLAYER, FORCE_ON et FORCE_OFF

Chaque option peut rester sous le contrôle du joueur ou être verrouillée par le serveur.

JSON

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

mods/MyPvPControls/config.json

CE QUE ÇA FAIT

Chaque option peut rester sous le contrôle du joueur ou être verrouillée par le serveur.

COMPORTEMENT IMPORTANT

PLAYER laisse le joueur choisir.
FORCE_ON force la valeur active.
FORCE_OFF force la valeur inactive.
L'interface affiche toujours la valeur effective après application des règles serveur.

CHAPITRE 05 · 1 EXEMPLES

Données joueur et logs

Choisissez le stockage, l'audit PvP et la rétention.

01JSON

Stockage et audit

Les préférences peuvent être stockées dans le dossier du mod ou dans le profil Hytale du joueur.

JSON

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

mods/MyPvPControls/config.json

CE QUE ÇA FAIT

Les préférences peuvent être stockées dans le dossier du mod ou dans le profil Hytale du joueur.

COMPORTEMENT IMPORTANT

MOD_FOLDER utilise des fichiers JSON lisibles sous playerdata/.
PLAYER_PROFILE est utile aux réseaux qui synchronisent déjà les profils Hytale.
Changer de backend ne migre pas automatiquement les données existantes.
Le log PvP enregistre les valeurs effectives au moment de la mort.

CHAPITRE 06 · 1 EXEMPLES

Commandes et administration

Le panneau /pvp, les commandes joueur et les outils admin.

01COMMANDES

Commandes joueur et admin

Le panneau /pvp expose les mêmes contrôles que les sous-commandes.

COMMANDES

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

Commandes en jeu

CE QUE ÇA FAIT

Le panneau /pvp expose les mêmes contrôles que les sous-commandes.

COMPORTEMENT IMPORTANT

Les commandes administratives nécessitent mypvpcontrols.admin.
Les changements admin supportés sont enregistrés dans config.json.
Les règles affichées dans le panneau peuvent être localisées et éditées par langue.

Avant d'utiliser un exemple

Les morts PvE et environnementales restent gérées par Hytale et les autres systèmes du serveur.

PLAYER_PROFILE est destiné aux réseaux qui synchronisent déjà les profils joueurs.

Le texte des règles affiché dans l'interface peut être personnalisé dans les fichiers de langue.

RETOUR EN HAUT