HyTari Studios · Guia oficial de configuração

My PvP Controls

Dê escolha aos jogadores sem perder o controle do servidor.

O PvP é bilateral: um golpe entre jogadores só é válido quando ambos têm PvP efetivamente ativado. O servidor pode deixar cada opção para o jogador ou forçá-la ON/OFF.

INICIAR O GUIA PÁGINA DO MOD

ANTES DE COMEÇAR

Primeiros passos

ETAPA 01

Instale apenas uma build

Remova builds antigas de PvPToggle/MyPvPControls que registrariam o mesmo /pvp.

ETAPA 02

Defina os padrões

Escolha estado PvP, temporizadores e configurações iniciais de risco.

ETAPA 03

Escolha a autoridade

Para cada opção, escolha PLAYER, FORCE_ON ou FORCE_OFF.

O mod não substitui as proteções do servidor: se outro sistema bloquear um golpe, o My PvP Controls não o reativa.

CAPÍTULO 01 · 1 EXEMPLOS

PvP bilateral

Como a proteção pessoal funciona e quando um golpe é permitido.

01LÓGICA

O consentimento deve ser mútuo

O combate PvP só é permitido quando os dois jogadores têm PvP efetivo em ON.

LÓGICA

Atacante OFF + Alvo OFF  -> BLOQUEADO
Atacante ON  + Alvo OFF  -> BLOQUEADO
Atacante OFF + Alvo ON   -> BLOQUEADO
Atacante ON  + Alvo ON   -> PERMITIDO

Regra em runtime

O QUE FAZ

O combate PvP só é permitido quando os dois jogadores têm PvP efetivo em ON.

COMPORTAMENTO IMPORTANTE

O mod não força um golpe se outro sistema de proteção já o cancelou.
Mortes PvE e ambientais não são convertidas em PvP.
O valor efetivo também considera as regras FORCE_ON/FORCE_OFF do servidor.

CAPÍTULO 02 · 1 EXEMPLOS

Padrões e temporizadores

Defina estado inicial, salvamento, bloqueio de combate e cooldown.

01JSON

Padrões e segurança temporal

O temporizador de combate e o cooldown impedem mudanças oportunistas durante ou logo após uma luta.

JSON

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

mods/MyPvPControls/config.json

O QUE FAZ

O temporizador de combate e o cooldown impedem mudanças oportunistas durante ou logo após uma luta.

COMPORTAMENTO IMPORTANTE

CombatTimerSeconds bloqueia mudanças enquanto o jogador está em combate PvP ativo.
ToggleCooldownSeconds impede alternâncias ON/OFF rápidas.
O salvamento do estado PvP é separado dos outros valores de risco.

CAPÍTULO 03 · 1 EXEMPLOS

Risco e perda de itens

Item Drop, Full Inventory Drop e Durability são controles separados.

01JSON

Padrões de risco pessoal

Item Drop, Full Inventory Drop e Durability podem ser escolhidos independentemente.

JSON

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

mods/MyPvPControls/config.json

O QUE FAZ

Item Drop, Full Inventory Drop e Durability podem ser escolhidos independentemente.

COMPORTAMENTO IMPORTANTE

Full Inventory Drop tem prioridade sobre Item Drop normal.
Com Item Drop desativado, mortes PvP qualificadas usam o modo nativo NONE do Hytale.
A proteção de Durability se aplica a PvP válido e não altera o desgaste PvE normal.

CAPÍTULO 04 · 1 EXEMPLOS

Controles do servidor

PLAYER, FORCE_ON e FORCE_OFF determinam quem tem a palavra final.

01JSON

PLAYER, FORCE_ON e FORCE_OFF

Cada opção pode ficar sob controle do jogador ou ser travada pelo servidor.

JSON

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

mods/MyPvPControls/config.json

O QUE FAZ

Cada opção pode ficar sob controle do jogador ou ser travada pelo servidor.

COMPORTAMENTO IMPORTANTE

PLAYER deixa o jogador escolher.
FORCE_ON força o valor ativo.
FORCE_OFF força o valor desativado.
A GUI sempre mostra o valor efetivo após aplicar as regras do servidor.

CAPÍTULO 05 · 1 EXEMPLOS

Dados do jogador e logs

Escolha armazenamento, auditoria PvP e retenção.

01JSON

Armazenamento e auditoria

As preferências podem ficar na pasta do mod ou no perfil Hytale do jogador.

JSON

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

mods/MyPvPControls/config.json

O QUE FAZ

As preferências podem ficar na pasta do mod ou no perfil Hytale do jogador.

COMPORTAMENTO IMPORTANTE

MOD_FOLDER usa arquivos JSON legíveis em playerdata/.
PLAYER_PROFILE é útil em redes que já sincronizam perfis Hytale.
Trocar o backend não migra automaticamente os dados existentes.
O log PvP registra os valores efetivos usados no momento da morte.

CAPÍTULO 06 · 1 EXEMPLOS

Comandos e administração

Painel /pvp, comandos do jogador e ferramentas de admin.

01COMANDOS

Comandos do jogador e admin

O painel /pvp expõe os mesmos controles disponíveis por subcomandos.

COMANDOS

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

Comandos no jogo

O QUE FAZ

O painel /pvp expõe os mesmos controles disponíveis por subcomandos.

COMPORTAMENTO IMPORTANTE

Comandos administrativos exigem mypvpcontrols.admin.
Alterações de admin suportadas são salvas em config.json.
As regras exibidas no painel podem ser localizadas e editadas por idioma.

Antes de usar um exemplo

Mortes PvE e ambientais continuam sendo tratadas pelo Hytale e pelos outros sistemas do servidor.

PLAYER_PROFILE é destinado a redes que já sincronizam perfis de jogadores.

O texto das regras exibido na interface pode ser personalizado nos arquivos de idioma.

VOLTAR AO TOPO