MTW PlayTime Limiter

Main Mechanics

• Time Limit: Each player is allotted a specific amount of playtime (10 hours by default). Once this time runs out, the server imposes a penalty.
• The Hunter (Anti-Escape): If enabled, a custom entity spawns to pursue the player when their time expires. It destroys blocks if it gets stuck, teleports if the player flees too far away or too high up, and instantly kicks the player from the server upon physical contact (collision).
• Dynamic HUD: The remaining time appears at the top center of the screen within an inventory-style interface. It displays for 10 seconds whenever the time changes (featuring a smooth sliding animation as it fades out) and remains fixed in red when 5 minutes or less remain.
• Rewards: If the administrator configures the Hunter to be killable, a player who successfully defeats it earns extra playtime and avoids being banned.

Mecánicas Principales

• Límite de Tiempo: Cada jugador recibe una cantidad de tiempo de juego (por defecto 10 horas). Al agotarse, el servidor aplica un castigo.
• El Cazador (Anti-Escape): Si esta opción está activada, aparece una entidad personalizada que persigue al jugador al acabarse su tiempo. Destruye bloques si se queda atascada, se teletransporta si el jugador huye muy lejos o muy alto, y lo expulsa del servidor al instante mediante contacto físico (colisión).
• HUD Dinámico: El tiempo restante aparece en el centro superior de la pantalla con una interfaz estilo inventario. Se muestra durante 10 segundos al cambiar de hora (con una suave animación de deslizamiento al desaparecer) y se queda fijo en color rojo cuando restan 5 minutos o menos.
• Recompensas: Si el administrador configura al Cazador como mortal, el jugador que logre derrotarlo con éxito ganará tiempo extra de juego y evitará el baneo.

Comands/Comandos:

/mytime : (ALL)TODOS, (Displays the exact time remaining for the player in the chat, without needing to wait for the HUD)Muestra en el chat el tiempo exacto que le queda al jugador sin necesidad de esperar al HUD.

/playtime add <jugador> <minutos> : ADMIN, (Add minutes to a connected player's counter)Suma minutos al contador de un jugador conectado.

/playtime remove <jugador> <minutos>: ADMIN, (Subtracts minutes from a connected player's timer)Resta minutos al contador de un jugador conectado.

/playtime set <jugador> <minutos>: ADMIN, (Set the timer to an exact number of minutes)Fija el contador en una cantidad exacta de minutos.

/playtime reset <jugador>: ADMIN, (Resets the counter and restarts the player's cycle)Restaura el contador y reinicia el ciclo del jugador.

/playtime interval <jugador> <días>: ADMIN, (Change the time reset frequency, the default is every 7 days)Cambia la frecuencia de reinicio de tiempo (por defecto es cada 7 días).

/playtime punishment <jugador> <true/false>: ADMIN,  (true = Summons the Hunter. false = Traditional direct expulsion)true = Invoca al Cazador. false = Expulsión directa tradicional.

/playtime offline add <nombre> <minutos>: ADMIN, (Extra minutes are scheduled for a disconnected player. They apply upon re-entry)Programa minutos extra para un jugador desconectado. Se aplican al entrar.

/playtime offline reset <nombre>: ADMIN, (Schedule a cycle restart for a disconnected player)Programa un reinicio de ciclo  para un jugador desconectado.

Server Configuration (TOML)

Settings are modified in the `playtime_limiter-server.toml` file, located in the `saves/TuMundo/serverconfig/` folder. Changes are applied automatically without the need to restart the server.

HunterSettings:

• hunterMobId: The identifier of the entity that will act as the hunter. It supports vanilla mobs (e.g., "minecraft:zombie", "minecraft:creeper") or entities from other mods (e.g., "cobblemon:gengar").
• hunterInvincible: true to make it completely immortal, false to allow players to try to kill it.
• hunterSpeed: Movement speed. A value of 0.45 makes it extremely fast compared to regular mobs.
• hunterHealth: Hunter's maximum health if invincibility is disabled.
• hunterDamage: Base attack damage; useful if invincibility is disabled and a prolonged fight is desired (the knockback from contact works independently of this damage).

Configuración del Servidor (TOML)

Los ajustes se modifican en el archivo playtime_limiter-server.toml, ubicado en la carpeta saves/TuMundo/serverconfig/ .Los cambios se aplican automáticamente sin necesidad de reiniciar el servidor.

Ajustes del Cazador (HunterSettings):

• hunterMobId: El identificador de la entidad que actuará como cazador. Permite mobs vanilla (ej. "minecraft:zombie", "minecraft:creeper") o entidades de otros mods (ej. "cobblemon:gengar").
• hunterInvincible: true para hacerlo totalmente inmortal, false para permitir que los jugadores intenten matarlo.
• hunterSpeed: Velocidad de movimiento. Un valor de 0.45 lo hace extremadamente rápido en comparación con mobs regulares.
• hunterHealth: Vida máxima del cazador si la invencibilidad está desactivada.
• hunterDamage: Daño de ataque base, útil si la invencibilidad está desactivada y se busca un combate prolongado (la expulsión por roce funciona independientemente de este daño).

(The mod is still a work in progress; I would appreciate any suggestions or bug reports). El mod esta en progreso todavia, agradeceria cualquier sugerencia o reporte de bugs.