Saltar al contenido principal

Modelo de despliegue

  • Instala MineClawd en el servidor para habilitar /mineclawd y /mclawd.
  • La instalación en cliente es opcional para el uso básico de comandos.
  • La instalación en cliente es obligatoria para:
    • El paquete de apertura de GUI de /mineclawd config
    • La interfaz de libro de /mineclawd history
    • La interfaz emergente de preguntas de ask-user-question
    • La GUI de superposición (orbe AssistiveTouch, vista de streaming, sesiones y activos)
Si un jugador no tiene el mod de cliente, MineClawd aún ofrece un flujo alternativo de preguntas en el chat (/mineclawd choose ...). Todos los comandos funcionan desde el chat sin la superposición.

Modelo de permisos y control de administración

  • Las raíces de comando de MineClawd están protegidas por el permiso vanilla 2 (source.hasPermissionLevel(2)).
  • No existen nodos de permisos personalizados por subcomando.
  • Resultado práctico: da OP solo a operadores de confianza.
Si tu stack permite reasignación de permisos por comando, expón /mineclawd y /mclawd únicamente al rol de operador de IA.

Controles de visibilidad para servidores concurridos

/mineclawd config broadcast-requests-to <self|all|ops>
  • self: solo quien hace la solicitud ve el eco del prompt y el estado de la tarea.
  • all: todos lo ven.
  • ops: solo lo ven los operadores.
Este ajuste se guarda en mineclawd/player-settings.json y se aplica por UUID de jugador. También puedes cambiarlo en la pantalla de configuración GUI, dentro de la sección “Misc”, como “Broadcast requests to”.

Propiedad de sesiones en multijugador

  • Los datos de sesión están aislados por clave de propietario.
  • Los comandos de jugador operan sobre el conjunto de sesiones de ese jugador.
  • Los comandos de consola usan un espacio de nombres de propietario separado.
Para operaciones en equipo, decide pronto si cada operador mantiene sesiones personales o si todos comparten una cuenta.

Registro dinámico en servidores dedicados

Por defecto, dynamic-registry-mode está en AUTO. En AUTO, el runtime de marcadores dinámicos se deshabilita en servidores dedicados. Para habilitarlo forzosamente:
/mineclawd config dynamic-registry-mode enabled
Luego reinicia el servidor.

Qué cambia cuando se habilita

  • Los marcadores dinámicos para ítems, bloques y fluidos están disponibles en runtime.
  • Se envía la sincronización de estado dinámico a los clientes.
  • El estado persistente del mundo guarda los datos de las ranuras dinámicas.
  • Los clientes también deben instalar MineClawd para unirse al servidor dedicado.
Habilita el registro dinámico en producción solo tras una prueba por etapas. El requisito de cliente introduce un cambio de compatibilidad estricto para todos los jugadores.

Base recomendada para operadores

ObjetivoAjuste sugerido
Reducir ruido en el chatbroadcast-requests-to ops
Evitar bucles largos de herramientaslimit-tool-calls true
Mantener los bucles acotadostool-call-limit 8 a 12
Depurar solo incidentesdebug-mode true temporalmente

Checklist de despliegue para propietarios de servidor

  1. Define tu rol de operador y política de OP.
  2. Configura credenciales de proveedor y modelo.
  3. Establece la política de difusión (self, ops o all).
  4. Decide si el registro dinámico se queda en auto o pasa a enabled.
  5. Prueba con dos cuentas reales (operador y no operador) antes del lanzamiento público.

Páginas relacionadas