> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baimoqilin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso en multijugador

> Opera MineClawd en servidores dedicados con permisos claros, controles de visibilidad y patrones de despliegue seguros.

## 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)

<Info>
  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.
</Info>

## 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

```bash theme={null}
/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:

```bash theme={null}
/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.

<Warning>
  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.
</Warning>

## Base recomendada para operadores

| Objetivo                             | Ajuste sugerido                 |
| ------------------------------------ | ------------------------------- |
| Reducir ruido en el chat             | `broadcast-requests-to ops`     |
| Evitar bucles largos de herramientas | `limit-tool-calls true`         |
| Mantener los bucles acotados         | `tool-call-limit 8` a `12`      |
| Depurar solo incidentes              | `debug-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

* [/commands/overview](/commands/overview)
* [/commands/config](/commands/config)
* [/configuration/complete-config](/configuration/complete-config)
* [/resources/troubleshooting](/resources/troubleshooting)