MPCombatLog

MPCombatLog – Plugin de Prevención de Desconexiones en Combate de Hytale

Este mod asegura que ningún jugador abandone un combate, y si lo hace, será eliminado al desconectarse.

Características

Detección Automática de Combate – Detecta automáticamente cuando los jugadores reciben o infligen daño.
Duración de Combate Configurable – Establece cuánto tiempo los jugadores permanecen en combate.
Modo PvP/PvE – Opción para permitir el registro de desconexiones en combate PvE.
Prevención de Registro de Combate – Elimina a los jugadores que se desconectan mientras están en combate.
Mensajes de Estado de Combate – Mensajes personalizables para entrar/salir de combate.
Comando de Recarga – ¡Recarga el plugin desde el juego! No es necesario reiniciar el servidor.
Soporte para Etiquetas de Color – Usa &0-9 y &a-f para colores en la configuración (¡Estilo Minecraft!).
API para Desarrolladores – API sencilla para que otros plugins verifiquen el estado de combate.

Permiso de CombatLog

Si no deseas ser etiquetado en combate, utiliza este permiso combatlog.bypass.

Configuración

La configuración se encuentra en mods/MP_CombatLog/config.json:

{
    "onlyPlayerDamageLog": true, // Establecer en falso para habilitar el registro de combate PvE
    "combatTime": 30, // Tiempo en segundos que los jugadores permanecen en combate
    "showCombatTitle": true, // Establecer en falso para desactivar el título de combate
    "messages": {
        "prefix": "&l&7[&c&lCL&l&7] &7>> ",
        "combatEnter": "&c¡Has entrado en combate! &7¡No te desconectes!",
        "combatExit": "&aYa no estás en combate.",
        "combatTimeRemaining": "&6Combate: &e%seconds%s &7restantes",
        "combatLogBroadcast": "&e%player% &cha sido eliminado por desconectarse en combate!",
        "commandReloadSuccess": "&a¡Configuración recargada con éxito!",
        "commandReloadFailed": "&cError al recargar la configuración: %error%",
        "commandInfo": "&7Ejecutando &eMPCombatLog &7v%version%",
        "combatTitleMain": "&cEN COMBATE",
        "combatTitleSub": "&7%seconds%s restantes"
    }
}

Comandos

Comando	Descripción	Permiso
`/combatlog`	Mostrar información del plugin	Todos
`/combatlog help`	Mostrar comandos disponibles	Todos
`/combatlog reload`	Recargar configuración	Solo Ops

API para Desarrolladores

MPCombatLog proporciona una API sencilla para que otros plugins verifiquen y gestionen el estado de combate.

Agregar como Dependencia

Maven

Agrega MPCombatLog como una dependencia en tu pom.xml:

<dependency>
    <groupId>com.minimalpulse.combatlog</groupId>
    <artifactId>MPCombatLog</artifactId>
    <version>1.0.2</version>
    <scope>provided</scope>
</dependency>

Manifiesto de Hytale

Agrega MPCombatLog como una dependencia en tu manifest.json:

{
  "Dependencies": {
    "com.minimalpulse.combatlog": "*"
  }
}

O como una dependencia opcional si deseas que tu plugin funcione sin él:

{
  "OptionalDependencies": {
    "com.minimalpulse.combatlog": "*"
  }
}

Uso de la API

Todos los métodos de la API son estáticos y accesibles a través de CombatLogAPI:

import com.minimalpulse.combatlog.api.CombatLogAPI;

// Verificar si el plugin está cargado
if (CombatLogAPI.isAvailable()) {
    // El plugin está cargado y listo
}

// Verificar si un jugador está en combate
UUID playerUuid = player.getUuid();
if (CombatLogAPI.isInCombat(playerUuid)) {
    player.sendMessage(Message.raw("¡No puedes hacer eso mientras estás en combate!"));
    return;
}

// Obtener el tiempo restante de combate en segundos
int secondsLeft = CombatLogAPI.getRemainingCombatTime(playerUuid);

// Obtener la duración de combate configurada
int combatDuration = CombatLogAPI.getCombatDuration();

// Poner manualmente a un jugador en combate
CombatLogAPI.enterCombat(playerUuid, worldName);

// Eliminar manualmente a un jugador del combate
CombatLogAPI.exitCombat(playerUuid);

Métodos de la API

Método	Descripción	Retorna
`isAvailable()`	Verificar si MPCombatLog está cargado	`boolean`
`isInCombat(UUID)`	Verificar si el jugador está en combate	`boolean`
`getRemainingCombatTime(UUID)`	Obtener los segundos restantes en combate	`int`
`getCombatDuration()`	Obtener la duración de combate configurada	`int`
`enterCombat(UUID, String)`	Poner al jugador en combate con seguimiento del mundo	`void`
`exitCombat(UUID)`	Eliminar al jugador del combate	`void`