The Boys Nuzlocke

El agente

Un único archivo de Node sin dependencias. Vigila tu archivo de guardado, espera a que el emulador termine de escribir y lo sube aquí. También manda latidos para saber si estás jugando y avisa si aparecen savestates.

1 · Descargar y arrancar

hace falta Node 20 o superior

macOS / Linux:

curl -fsSL https://www.guerratron.es/nuzlocke-agent.mjs -o nuzlocke-agent.mjs
node nuzlocke-agent.mjs

Windows (PowerShell):

iwr https://www.guerratron.es/nuzlocke-agent.mjs -OutFile nuzlocke-agent.mjs
node nuzlocke-agent.mjs
Descargar nuzlocke-agent.mjs

2 · Configuración inicial

  • URL del servidor: https://www.guerratron.es
  • Token: el que te dio quien montó el servidor (uno por jugador).
  • Archivo de guardado: el agente busca solo por las carpetas típicas de DeSmuME y melonDS y te lista los candidatos. Si no aparece, pega la ruta a mano; solo lo acepta si el archivo contiene de verdad un save de DS.
  • Carpeta de savestates: se propone automáticamente. Sirve para detectar soft resets.
  • Windows, macOS y Linux: el mismo archivo en los tres. Necesita Node 20 o superior. En Windows mira también en Documentos redirigidos a OneDrive y en %APPDATA%, y al instalarlo arranca oculto, sin ventana de consola.

Se guarda en ~/.the-boys-nuzlocke/config.json. Las siguientes veces arranca directo sin preguntar nada.

3 · Arranque automático

para no acordarte de arrancarlo nunca más
node nuzlocke-agent.mjs install

Crea un LaunchAgent en macOS, un servicio de usuario de systemd en Linux o un acceso en el arranque de Windows. Se desinstala con uninstall.

Comandos útiles

  • node nuzlocke-agent.mjs — arranca la vigilancia: sube el save si cambia, escucha nuevos cambios y manda latidos mientras se queda abierto.
  • node nuzlocke-agent.mjs setup — pregunta URL, token, ruta del save y carpeta de savestates, y guarda esa configuración para las siguientes veces.
  • node nuzlocke-agent.mjs status — imprime configuración, si el save es válido, savestates detectados, subidas hechas, cola pendiente y si el emulador y el servidor están activos.
  • node nuzlocke-agent.mjs scan — enseña qué carpetas mira y qué saves encuentra en ellas. Para cuando la autodetección no da con el archivo.
  • node nuzlocke-agent.mjs once — sube el save actual una sola vez y termina, sin quedarse vigilando.
  • node nuzlocke-agent.mjs install — instala arranque automático (LaunchAgent en macOS, servicio de systemd en Linux, entrada de inicio en Windows).
  • node nuzlocke-agent.mjs uninstall — quita ese arranque automático.