badomens

✨ ¿Qué es badomens?

Es un gestor de servidores Minecraft que reúne en un solo programa todo lo que antes hacías a mano:

• 🧩 Elige motor (Paper, Fabric, Forge, NeoForge o Vanilla) y versión.
• 🗺️ Dale un mundo, una semilla, recursos, whitelist, ops y plugins.
• 🐳 Levanta cada servidor en Docker Compose, aislado del resto.
• 🔒 Publica los puertos solo en tu red Tailscale (nunca en todas las interfaces).
• 📊 Supervisa TPS, CPU y RAM y crea backups con checksum.
• 🖥️ Óperalo y créalo desde una TUI interactiva o desde el CLI.

[!NOTE] 👉 Esta es la reescritura en Go del antiguo proyecto Bad Omens (Python). Un solo binario, sin interfaz web: CLI primero, TUI después, y listo para usarse desde Emiria (asistente Jamcord) por CLI, bot de Discord, agente de IA y MCP.

🚦 Estado del proyecto

[!IMPORTANT] Todo el plan está implementado ✅. Las fases se construyeron y verificaron una a una:

🏗️ Cómo encaja todo

flowchart LR
  subgraph Tu casa
    
    subgraph Operator["👤 Operador"]
      CLI["⌨️ badomens CLI"] 
      TUI["🖥️ badomens tui"]
    end

    subgraph Emiria["🤖 Emiria / Jamcord"]
      BOT["💬 Bot de Discord"]
      AGENT["🦾 Agente de IA"]
      MCP["🔌 MCP"]
    end
  end

  Operator --> BIN["🧱 badomens (binario único)"]
  Emiria ---|"JSON estable"| BIN

  BIN --> D["🐳 Docker Compose"]
  D --> S1["📦 servidor demo"]
  D --> S2["📦 servidor survival"]
  D --> S3["📦 ... hasta N"]

  S1 <-->|"🔒 solo tailnet"| TS["🛜 Tailscale"]
  S2 <--> TS
  S3 <--> TS
  TS --> J1["👥 tus amigos"]
  TS --> J2["🎮 tú"]

✅ Requisitos

[!TIP] No necesitas Go ni Python (ni nada más): badomens es un solo archivo listo para ejecutar.

🚀 Instalación

🧭 Opción A — Instalador de un comando

curl -fsSL https://raw.githubusercontent.com/MrZudro/badomens/main/scripts/install.sh | sh

irm https://raw.githubusercontent.com/MrZudro/badomens/main/scripts/install.ps1 | iex

[!NOTE] Se usa la ruta raw.githubusercontent.com porque el repositorio publica pre-releases y la URL corta …/releases/latest/download/install.ps1 solo estará disponible cuando exista una release estable.

[!WARNING] Windows 11 con Smart App Control activo puede bloquear el .exe («Una directiva de Control de aplicaciones bloqueó este archivo»): los ejecutables de badomens aún no están firmados y SAC no tiene botón de «ejecutar de todas formas». El veredicto va ligado a la reputación del fichero exacto, así que no es determinista (medido: el descargado se bloqueó 4 de 4 veces y, de 24 binarios compilados localmente, 21 arrancaron). Alternativas: probar a compilar (go install), usar WSL2/Docker (determinista), desactivar SAC (irreversible) o esperar a que los binarios vayan firmados. Detalle en docs/setup-install.md.

Los instaladores descargan el binario correcto para tu sistema, verifican el checksum contra checksums.txt y lo dejan listo en /usr/local/bin/badomens (macOS/Linux) o %LOCALAPPDATA%\Programs\badomens (Windows). En Windows el instalador añade el directorio a tu PATH de usuario automáticamente (reabre la terminal para usarlo); en macOS/Linux /usr/local/bin ya suele estar en el PATH.

🧭 Opción B — Desde las releases

Descarga el binario de tu sistema desde la última release: tenemos binarios para Windows, macOS y Linux, en amd64 (Intel/AMD) y arm64 (Apple Silicon y ARM moderno).

[!NOTE] Solo se publican binarios de arquitecturas vigentes. No hay versiones deprecadas de 32 bits (386, arm) ni ensamblados antiguos.

🧭 Opción C — Desde el código

Necesitas Go 1.27+:

go install github.com/MrZudro/badomens/cmd/badomens@latest

🔄 Actualizar y 🧹 desinstalar

• Actualizar: badomens update te dice si hay una versión nueva; badomens update --apply la descarga (verificando el checksum) y reemplaza el binario. Al abrir la TUI, badomens comprueba (una vez cada 12 h) si hay novedades y te pregunta si actualizar; se desactiva con BADOMENS_UPDATE_CHECK=0, update_check: false en config.yaml o --no-preflight.
• Desinstalar: badomens uninstall elimina el binario y la configuración y conserva tus datos (instancias, mundos, backups). Usa badomens uninstall --purge para borrarlos también, y --dry-run para ver qué haría. También hay scripts en scripts/uninstall.{sh,ps1}.

🏁 Inicio rápido

# 🔍 ¿está todo listo? Docker, Tailscale y configuración
badomens doctor

# 🖥️ ¿cuánta CPU/RAM tienes y cuántas instancias caben?
badomens capacity

# ⚙️ crea la configuración global (+ tu carpeta de datos)
badomens config --init

# 🧩 crea y arranca un servidor (interactivo si no le pasas flags)
badomens setup --name "Survival" --engine paper --memory 6G --no-start
badomens -i survival start

# 📊 un vistazo general en la TUI
badomens tui

# 🗃️ backups y mantenimiento
badomens -i survival backup create
badomens instance close survival

[!TIP] Puedes tener hasta 5 instancias registradas y 3 corriendo a la vez (ajustables en config.yaml). Cada una con su mundo, motor, versión y puerto.

🗂️ Comandos

[!TIP] Todos los comandos aceptan --json para una salida estable (lo que consume Emiria).

📜 Contrato de salida

Cada comando imprime un único documento JSON en stdout:

{
  "ok": true,
  "exit_code": 0,
  "action": "doctor",
  "message": "doctor terminó sin problemas",
  "data": { "checks": [ ... ] },
  "timestamp": "2026-01-01T00:00:00Z"
}

• ✅ Códigos de salida: 0 éxito · 1 aviso · 2 error.
• ❌ En un error: ok: false y error: { code, message, hint }.
• 🔑 Códigos de error estables: error_usage, error_not_found, error_dependency_missing, error_capacity_exceeded, error_unavailable, error_general.

[!IMPORTANT] Este contrato es la base de la integración con Emiria/Jamcord. No lo rompas. Detalle completo en docs/contrato-json.md.

🤖 Integración con Emiria (Jamcord)

badomens es autónomo. Jamcord lo consume ejecutando el binario y leyendo su JSON estable, igual que hace con SeedMap. Así Emiria puede:

• 💬 Pedirte el estado por lenguaje natural (Discord/agente).
• ⚡ Usar el comando /mc.
• 🔌 Conectarse por MCP.

Ver docs/integracion-jamcord.md.

🛠️ Desarrollo

make build     # 🏗️ compila bin/badomens
make test      # 🧪 pruebas unitarias
make lint      # 🧹 golangci-lint
make run       # ▶️ ejecuta en desarrollo
make doctor    # 🩺 diagnóstico rápido

[!NOTE] En Windows con Smart App Control activo, a veces los binarios recién compilados se bloquean; make test compila las pruebas con -ldflags=-w para evitarlo.

Consulta también AGENTS.md (guía para agentes de IA) y docs/.

❓ Preguntas frecuentes

⚖️ Licencia

MIT — ver LICENSE, CONTRIBUTING.md y SECURITY.md.

Proyecto hecho con 💜, no afiliado a Mojang, Microsoft, PaperMC ni a los demás proyectos de servidores mencionados. Minecraft es una marca de Mojang Synergies AB.