← Todas las guías

01 / Administración

PSM (Pro Server Manager)

Java 1.20.1 · Forge

PSM concentra herramientas de administración en el servidor: autenticación opcional, mantenimiento, control del chat, equipos, inventarios, invisibilidad, limpieza automática y alertas heurísticas de minería. Es exclusivamente server-side; los jugadores pueden conectarse con Minecraft vanilla y no necesitan instalar el mod.

Instalación y primer arranque

  1. Prepara Minecraft Java 1.20.1, Java 17 y Forge 47.4.28.
  2. Instala el JAR únicamente en mods/ del servidor y arranca el servidor para generar los archivos.
  3. Edita config/servermanager.json para cambiar opciones. Edita config/servermanager_messages_es.json para personalizar textos.
  4. Aplica cambios de configuración en caliente con /servermanager reload. El comando actualiza equipos, mensajes, marca del servidor, temporizadores y mantenimiento.

Autenticación de jugadores

La autenticación viene desactivada. Al activarla, cada jugador debe registrarse y autenticarse al entrar; hasta hacerlo no puede moverse, abrir interfaces, interactuar ni ejecutar otros comandos. El plazo predeterminado es 60 segundos y hay cinco intentos fallidos antes de desconectarlo. Las contraseñas deben tener entre 8 y 128 caracteres y se guardan como hashes PBKDF2-HMAC-SHA256 con salt, nunca en texto plano.

/servermanager auth on|off

Activa o desactiva el registro obligatorio para el servidor. OP nivel 4.

/register <clave> <repetir>

Registra una cuenta e inicia sesión. Solo funciona con la autenticación activada.

/login <clave>

Inicia sesión con una cuenta ya registrada.

/servermanager auth changepassword <actual> <nueva>

Cambia la contraseña propia después de validar la actual.

/servermanager auth unregister <jugador>

Elimina el registro del jugador objetivo. OP nivel 4.

/servermanager auth changepass <jugador> <nueva>

Asigna una contraseña nueva a otro jugador. OP nivel 4.

Administración del servidor

Todos estos comandos requieren OP nivel 4. on|off indica que debes elegir una de las dos palabras; los argumentos entre < > son obligatorios y los de [ ] opcionales.

/servermanager maintenance on|off

Activa o desactiva mantenimiento. Al activarlo, expulsa a jugadores no OP tras la cuenta atrás configurada y bloquea nuevas entradas no OP.

/servermanager chat on|off

Permite o bloquea los mensajes de chat normales. Los comandos continúan funcionando.

/servermanager brand [nombre]

Sin nombre muestra la marca actual; con nombre cambia lo que aparece como server brand en F3, también para quienes ya están conectados.

/servermanager vanish [on|off]

Alterna o fija la invisibilidad del administrador que ejecuta el comando. El valor se conserva entre sesiones.

/servermanager freeze <jugador>

Congela al jugador: bloquea movimiento, interacciones, objetos soltados, interfaces y, por defecto, comandos.

/servermanager unfreeze <jugador>

Libera a un jugador congelado.

/servermanager nametag hide|show <jugador>

Oculta o restaura el nombre sobre la cabeza del jugador.

/servermanager invsee <jugador> [readonly]

Abre inventario principal, armadura y mano secundaria. readonly impide editar. Acepta jugadores conectados o perfiles conocidos por nombre/UUID.

/servermanager endersee <jugador>

Abre el cofre de ender del jugador, también si está desconectado y su perfil es conocido.

/servermanager status

Resume el estado de autenticación, mantenimiento, chat, limpieza, equipos y detector xray.

/servermanager reload

Vuelve a leer ambos JSON y reinicia los sistemas que dependen de la configuración.

Las ediciones del inventario de un perfil offline se escriben de forma atómica en los datos del jugador del mundo actual. Cada cambio queda anotado en config/servermanager_inventory.log. No abras un perfil offline si el jugador vuelve a conectarse durante la edición.

Equipos

El mod sustituye el comando vanilla /team por su propio sistema. Un jugador solo puede pertenecer a un equipo. El líder puede invitar, cambiar nombre y color, expulsar miembros y disolver el equipo; los miembros pueden salir. La interfaz usa un menú de cofre vanilla y no requiere que los clientes instalen PSM.

/team ui

Abre la interfaz para crear un equipo pulsando un color, invitar y gestionar miembros.

/team create <nombre> <color>

Crea equipo con nombre de 2 a 16 letras, números o guion bajo y un color de Minecraft.

/team color <color>

Cambia el color del equipo propio. Solo líder.

/team rename <nombre>

Cambia el nombre del equipo propio. Solo líder.

/team invite <jugador> / /team accept

El líder invita a una persona conectada; esa persona acepta la invitación.

/team leave / /team kick <jugador>

Abandona el equipo o, como líder, expulsa a un miembro.

/team disband

Disuelve el equipo propio. Solo líder.

/team list / /team info

Lista los equipos o muestra el equipo al que perteneces.

/servermanager teams on|off / /team delete <equipo>

Activa equipos o elimina un equipo como administrador. Desactivar equipos borra todas las definiciones, membresías e invitaciones.

Limpieza automática de objetos

La limpieza recorre objetos cargados en las dimensiones del servidor. Avisa en chat a 30 y 10 segundos y muestra los últimos cinco segundos en la barra de acción. Antes de activar la función, agrega a itemWhitelist los identificadores de objetos que quieras conservar.

/servermanager clearitems on|off

Activa o desactiva la limpieza periódica.

/servermanager clearitems interval <minutos>

Define el intervalo entre 1 y 1440 minutos; al cambiarlo, el temporizador vuelve a empezar.

Detector heurístico de minería

Compara menas raras ocultas encontradas con bloques duros minados durante una ventana móvil. Considera diamante, esmeralda, oro y escombros ancestrales; ignora menas expuestas a aire/transparencias, herramientas con Fortuna o Toque de Seda y, por defecto, a OP. Una alerta incluye jugador, dimensión, coordenadas y acceso rápido de teletransporte. Es una heurística, no un anticheat: revisa cada aviso manualmente.

/servermanager xray on|off

Activa o desactiva el detector.

/servermanager xray threshold <menas> <bloques> <ratio>

Ajusta menas raras mínimas, bloques mínimos de la ventana y ratio mínimo. Ejemplo: 4 200 0.018.

/servermanager xray info <jugador>

Consulta estadísticas acumuladas y de la ventana para un jugador conectado.

/servermanager xray reset <jugador>

Reinicia sus estadísticas.

Solicitudes de ayuda

/help sustituye el comando vanilla: un jugador envía una solicitud privada al personal conectado de nivel OP 4. El mensaje incluye un botón [TP] para que el staff se teletransporte a quien pidió ayuda. El intervalo entre solicitudes se controla con helpCooldownSeconds.

Configuración del servidor

El archivo config/servermanager.json se crea automáticamente. Estos son los interruptores y valores iniciales principales; los valores persistentes de contraseñas, equipos y jugadores se gestionan automáticamente y no deben editarse a mano.

authEnabled: false

Requiere registro e inicio de sesión para entrar.

authTimeoutSeconds: 60

Tiempo para autenticarse; rango aceptado: 10–3600 segundos.

authMaxAttempts: 5

Intentos de contraseña fallidos antes de desconectar; rango: 1–20.

maintenance: false / maintenanceKickDelaySeconds: 5

Estado de mantenimiento y demora antes de expulsar a usuarios no OP; demora de 0–60 segundos.

chatEnabled: true

Permite el chat normal.

serverBrand: "ServerManager"

Nombre mostrado en la información F3 del cliente.

teamsEnabled: true / friendlyFire: false

Activa equipos y controla el daño entre miembros.

clearItemsEnabled: false / clearItemsIntervalMinutes: 3

Estado e intervalo de limpieza; el intervalo válido es de 1 a 1440 minutos.

itemWhitelist: []

Lista de identificadores de objetos que la limpieza nunca debe borrar.

excludeFreshDrops: false / freshDropSeconds: 30

Si se activa la exclusión, protege temporalmente objetos recién soltados durante los segundos configurados.

xrayEnabled: true
xrayWindowMinutes: 10 / xrayMinimumBlocks: 200

Duración de la ventana y mínimo de piedra, pizarra profunda, netherrack o toba antes de evaluar ratios.

xrayRareOreThreshold: 4 / xrayRatioThreshold: 0.018

Menas raras mínimas y ratio que disparan una alerta. Se pueden ajustar también con el comando xray threshold.

xrayIgnoreOperators: true
vanishVisibleToOperators: true / vanishSuppressAggro: true

Controla si OP ve a quien está oculto y si las criaturas dejan de seleccionarlo como objetivo.

frozenCommandsAllowed: false

Permite comandos a jugadores congelados. Por defecto también se bloquean sus comandos.

helpCooldownSeconds: 60

Espera entre solicitudes de ayuda; rango aceptado: 0–3600 segundos.

Los límites inválidos se ajustan al rango admitido al cargar el archivo. Al desactivar teamsEnabled se eliminan sus datos guardados. Las alertas xray también se añaden a config/servermanager_xray.log.

Notas y limitaciones