Instalación y primeros pasos

Descarga #

Antes de instalar, revisá los requisitos: Spigot o Paper 1.16.5 – 26.3, y Java 8 o superior. Folia no es compatible.

Instalación #

1. Poné AFKWarden-1.0.1.jar en la carpeta plugins/ de tu servidor.

2. Reiniciá el servidor. No uses /reload.

3. Mirá la consola. Al arrancar, AFK Warden muestra un pequeño banner que termina con su versión y su plan (con banner: false en config.yml, solo esa última línea):

      _   ___ _  __   __      ___   ___ ___  ___ _  _
     /_\ | __| |/ /   \ \    / /_\ | _ \   \| __| \| |
    / _ \| _|| ' <     \ \/\/ / _ \|   / |) | _|| .` |
   /_/ \_\_| |_|\_\     \_/\_/_/ \_\_|_\___/|___|_|\_|
   AFK Warden v1.0.1 · Free · coolapps.fyi

El primer arranque crea config.yml, messages_en.yml y messages_es.yml en plugins/AFKWarden/. Desde ese momento se sigue a los jugadores, con los tiempos por defecto: AFK a los 5 minutos, un aviso a los 19 y el kick a los 20. No hay base de datos que instalar.

Los comandos de esta guía están escritos para el juego, con barra (/afkwarden list). En la consola del servidor, escribilos sin la barra (afkwarden list). El alias corto /afkw funciona en lugar de /afkwarden (/afkw list).

Primeros pasos #

1. Empezá solo con marcas AFK #

Los primeros días, dejá que AFK Warden marque a los jugadores sin kickear a nadie. En plugins/AFKWarden/config.yml:

kick-after: 0

Corré /afkwarden reload (los contadores de inactividad se conservan), mirá /afkwarden list durante unos días y después definí el tiempo de kick que quieras, en segundos (1200 son 20 minutos).

2. Dejá apagado el kick por inactividad de vanilla #

Dejá player-idle-timeout=0 en server.properties, así el servidor no corre un segundo kick por inactividad propio, más débil.

3. Eximí a tu staff #

Por defecto nadie está exento, ni siquiera los operadores, y essentials.afk.kickexempt no tiene efecto sobre AFK Warden. Dale afkwarden.bypass a quien nunca deba quedar marcado como AFK, recibir un aviso ni recibir un kick. Con LuckPerms, desde la consola:

lp group staff permission set afkwarden.bypass true

También se pueden eximir modos de juego y mundos (exempt-gamemodes, exempt-worlds; los espectadores vienen exentos de fábrica). Mirá Configuración.

4. EssentialsX #

Con EssentialsX instalado, AFK Warden le pasa su estado AFK a Essentials, así el indicador AFK de la tab list, el dormir y la recolección de ítems lo siguen. Essentials tiene que dejar de decidir el AFK por su cuenta; si no, los dos plugins no coinciden. En plugins/Essentials/config.yml:

auto-afk: -1
auto-afk-timeout: -1        # en versiones viejas de EssentialsX se llama auto-afk-kick
cancel-afk-on-move: false
cancel-afk-on-interact: false
cancel-afk-on-fish: false   # no existe en versiones viejas de EssentialsX
cancel-afk-on-chat: true
broadcast-afk-message: false

Después corré ess reload en la consola. Al arrancar, AFK Warden registra una línea de advertencia por cada uno de estos ajustes que todavía no esté aplicado. Los detalles, en Configuración.

5. Tiempos por rango (opcional) #

Con LuckPerms, la sección ranks de config.yml les da a los rangos sus propios tiempos, o los exime del plugin:

ranks:
  vip:
    afk-after: 600
    kick-after: 2400

Free aplica la primera entrada de la sección; Pro, todas. Mirá Ajustes por rango.

6. Pro (opcional) #

Activá tu clave en la consola con afkwarden license activate <key>; la respuesta llega un momento después. Mirá Licencias y pago.

Actualizar #

AFK Warden le pregunta a Modrinth si hay una versión nueva poco después de que arranca el servidor y después una vez por día. Cuando la hay, la consola lo avisa, y el staff con afkwarden.admin recibe una línea en el chat al entrar. Nunca descarga nada por su cuenta: para actualizar, reemplazá el jar de plugins/ por el nuevo y reiniciá el servidor. update-check: false en config.yml desactiva el chequeo.

Cuando una versión nueva suma ajustes, tu config.yml los recibe en el siguiente arranque, agregados al final con sus comentarios. Tus valores nunca se cambian.