El staff sanciona con cuatro comandos o desde el panel. Los jugadores no tienen comandos: solo usan la tecla de interacción junto a la tarea.
Comandos
Los nombres son los de commands en shared/config.lua por defecto.
| Comando | Quién | Qué hace |
|---|---|---|
/sanciones | Staff | Abre el panel de sanciones. |
/comserv <id> <tareas> <motivo> | Staff | Pone tareas comunitarias al jugador con ese id de servidor. |
/endcomserv <id> | Staff | Retira los servicios comunitarios de ese jugador y lo lleva al punto de salida. |
/jaila <id> <minutos> <motivo> | Staff | Envía al jugador a la cárcel administrativa durante esos minutos. |
/endjail <id> | Staff | Libera a ese jugador de la cárcel y lo lleva al punto de salida de la cárcel. |
/taskcoords | Staff | Activa o desactiva la herramienta de mapeo de tareas. |
<id> es el id de servidor de un jugador conectado. <tareas> llega hasta comserv.maxTasks y <minutos> hasta jail.maxMinutes; los decimales se redondean hacia abajo. El motivo puede tener varias palabras, hasta admin.reasonMax caracteres.
/comserv, /endcomserv, /jaila y /endjail también funcionan desde la consola del servidor.
Reglas
- Desde comandos y panel, un personaje tiene una sanción cada vez.
/comservy/jailase rechazan mientras el jugador tenga comunitarias o cárcel activas. /endcomservy/endjailsolo actúan sobre un jugador que tenga esa sanción.- El staff y el jugador reciben una notificación de cada sanción puesta o retirada.
- Con Cuxial Chat en marcha, las sanciones puestas y cumplidas se anuncian en su canal de sanciones.
Panel de sanciones
/sanciones abre un panel con dos pestañas, comunitarias y cárcel. Cada pestaña lista a todos los personajes con una sanción activa de ese tipo, conectados o no.
| Acción | Qué hace |
|---|---|
| Buscar | Filtra por nombre o citizenid. |
| Elegir un registro | Muestra progreso, cumplido, restante, total, motivo, fecha y quién puso la sanción. |
| Retirar sanción | Pide confirmación y la retira. Un jugador conectado queda libre al momento; uno desconectado la encuentra retirada al entrar. |
| Aplicar | Elige un jugador conectado (búsqueda por nombre, id o citizenid), el tipo, las tareas o minutos y el motivo. |
| Actualizar | Recarga la lista. |
Esc cierra el diálogo abierto y después el panel. Cada petición del panel se vuelve a comprobar en el servidor, así que un jugador sin permiso no puede leer ni cambiar nada.
Qué ve el jugador sancionado
| Sanción | En pantalla |
|---|---|
| Servicios comunitarios | Tareas restantes, tarea actual, distancia hasta ella y el motivo. Blip con ruta, objeto resaltado y un marcador encima. |
| Cárcel | Tiempo restante y el motivo. |
Teclas
| Tecla | Dónde | Qué hace |
|---|---|---|
| E | Junto al objeto de la tarea, cuando sale el aviso | Empieza la tarea. La tecla es comserv.interactKey. |
| E | Herramienta de mapeo de tareas | Copia el objeto apuntado, o la posición del suelo si no se apunta a un objeto. |
| G | Herramienta de mapeo, apuntando a un objeto | Copia una tarea completa. |
| X | Herramienta de mapeo de tareas | Cierra la herramienta. |
La barra de progreso de una tarea no se puede cancelar. Mientras corre, el jugador no puede moverse, esprintar, pelear ni usar un vehículo.
Herramienta de mapeo de tareas
/taskcoords ayuda a escribir tareas sin teclear coordenadas a mano. Mientras está activa, una línea va desde tu personaje hasta el punto al que apuntas, hasta 50 metros. Los objetos se resaltan y su modelo y posición se muestran en pantalla.
| Pulsas | Se copia al portapapeles |
|---|---|
| E sobre un objeto | object = { model = ..., coords = vec3(...) }, |
| E sobre el suelo | coords = vec3(...), |
| G sobre un objeto | Una tarea completa con coords, name, object y progress, lista para pegar en una categoría de zones en data/tasks.lua. |
Tras pegar una tarea completa, cambia name y progress.label por tus propias claves, añádelas a los locales y ajusta duration y anim. Los campos se explican en Configuración.
Permisos
Los comandos y el panel pasan dos comprobaciones:
| Comprobación | Requisito |
|---|---|
| Acceso al comando | El jugador pertenece al grupo ACE de restricted del comando (group.mod por defecto), directamente o por herencia. |
| Permiso del bridge | El jugador tiene el permiso de admin.permission (mod por defecto). En ESX es el grupo del jugador. |
# Los moderadores tienen el permiso "mod"
add_ace group.mod mod allow
# Los admins heredan todo lo que pueden hacer los moderadores
add_principal group.admin group.mod
# Una línea por miembro del staff
add_principal identifier.license:xxxxxxxxxxxxxxxx group.mod