TimePlayerControl

Limita el tiempo de juego por jugador en servidores de Valheim (BepInEx). Incluye HUD en cliente, ranking top 5 y desconexión limpia al menú cuando se acaba el tiempo.

Características

• Tiempo diario (o por bloque) por SteamID, configurable en JSON
• Bloques y umbral de pausa por día de la semana (DailyRules)
• HUD compacto / detalle (tecla F1 por defecto, configurable)
• Top 5 de mayor tiempo jugado acumulado (sigue contando en pausa colectiva)
• Auto-ocultado del HUD con inventario, mapa y menú
• Mensaje «Te has quedado sin tiempo» y vuelta al menú de inicio
• Jugadores VIP/admin exentos (IsExempt)

Instalación

Con gestor (r2modman / Thunderstore Mod Manager)

1. Instala el pack en el perfil del cliente y en el del servidor dedicado
2. Asegúrate de que ambos usen la misma versión del mod

Manual

Copia el contenido de plugins/ a:

BepInEx/plugins/

Archivos incluidos:

• TimePlayerControl.dll
• Newtonsoft.Json.dll

Reinicia cliente y servidor.

Importante: cliente + servidor

El mod debe estar en ambos. El servidor gestiona tiempos y kicks; el cliente muestra el HUD y recibe el sync.

Configuración

Al iniciar se crea:

BepInEx/config/TimePlayerControl.json

• Servidor: tiempos, resets, jugadores, TotalPlayedSeconds, idioma de mensajes (Language)
• Cliente: layout del HUD e idioma del HUD (Language)

Idioma

"Language": "ES"

• ES — español (default)
• EN — inglés

El del cliente afecta el HUD; el del servidor afecta kick/chat//tiempo.

Tiempo y pausa (servidor)

Los valores globales aplican a todos los días. Con DailyRules podés cambiar el bloque y el % de pausa solo algunos días. Los días que no listes siguen usando el global.

El día se calcula con la medianoche local de ResetHourUtc (con 3 = 00:00 Chile).

"DefaultBlockSeconds": 21600,
"PauseTimeMinOnlineRatio": 0.75,
"DailyRules": {
  "Monday": {
    "DefaultBlockSeconds": 18000,
    "PauseTimeMinOnlineRatio": 0.8
  },
  "Friday": {
    "DefaultBlockSeconds": 28800,
    "PauseTimeMinOnlineRatio": 0.5
  },
  "Saturday": {
    "DefaultBlockSeconds": 28800
  }
}

• DefaultBlockSeconds — segundos del bloque (21600 = 6 h, 18000 = 5 h)
• PauseTimeMinOnlineRatio — fracción online/registrados para pausar el descuento (0.75 = 75 %)
• En un día podés omitir un campo: se usa el global
• Nombres de día: Monday…Sunday o Lunes…Domingo

HUD (cliente)

Jugadores (servidor)

• RemainingSeconds / AssignedSeconds — bloque actual
• TotalPlayedSeconds — acumulado (no se resetea cada día; también suma durante la pausa colectiva)
• IsExempt — sin límite
• NextResetTime — próxima renovación

Uso en juego

• F1 (o tu HudToggleKey): compacto ↔ detalle
• Panel detalle: restante, asignado, usado, total jugado, renovación y top 5
• Chat: /tiempo, /tiempos, /hud

Código fuente

https://github.com/Pedrox1591/TimePlayerControl-Valheim

Notas

• Probado con BepInEx 5 (pack Valheim)
• Tras actualizar el mod, actualiza cliente y servidor