Comandos
Resumen de comandos
Cómo se organizan los comandos de sofyCore, la sintaxis común para jugadores, duraciones y acciones silenciosas, y el índice completo.
Convenciones
- Nombres por defecto. Esta documentación usa los nombres de comando por defecto. La mayoría de nombres y alias se cambian en el YAML de cada módulo (
commands,command,aliases) o, en moderación, con/punish config. Si otro plugin ya tiene un nombre, sofyCore conserva el comando del otro plugin y avisa en consola. - Comando raíz. Los comandos del core usan
identity.command-alias(por defecto/sofycore). - Jugadores.
<player>acepta un nombre conocido o una UUID. sofyCore nunca inventa una UUID a partir de un nombre: el jugador debe haber entrado a la red al menos una vez. - Duraciones. Enteros positivos con unidad:
30s,10m,2h,7d. Muchos comandos aceptan tambiénpermanent. - Acciones silenciosas. Los comandos de moderación aceptan
-spara limitar el aviso al staff con permiso. - Jerarquía. Actuar sobre otro jugador requiere un rango estrictamente superior. La consola siempre puede.
- Solo consola. Algunas operaciones, como dar el rango owner o migrar desde LuckPerms o PermissionsEx, solo se aceptan desde la consola real.
Notación de la sintaxis
| Notación | Significado |
|---|---|
<valor> | Argumento obligatorio |
[valor] | Argumento opcional |
a|b | Elige una de las opciones |
... | El resto de la línea (texto libre) |
Los subcomandos y argumentos de los comandos se escriben siempre en inglés, como en el juego.
Índice de comandos
| Comando | Permiso | Descripción |
|---|---|---|
| /sofycore module | sofycore.module.reload | Recarga la configuración y el ciclo de vida de un único módulo. Los demás conservan su estado. No hay recarga global. |
| /sofycore settings | sofycore.settings.preferences.announcements | Muestra o cambia si recibes anuncios. Los anuncios forzados llegan siempre. Solo jugadores. |
| /playtime [player] | sofycore.playtime | Muestra tu tiempo de juego en la red. El de otro jugador necesita sofycore.playtime.others. |
| /mentions [on|off|toggle] | sofycore.settings.mentions | Activa o desactiva el sonido de mención. Se guarda para todos los servidores. |
| /rankdisplay [global|local|toggle] | sofycore.settings.rankdisplay | Elige si tu prefijo muestra el rango global o el rango local del servidor actual. |
| /access status | — | Disponibilidad (READY, o SUSPENDED con LuckPerms o PermissionsEx instalado), alcance GLOBAL/LOCAL_SQLITE y revisión. |
| /access help | — | Resumen de todas las ramas y su sintaxis principal. |
| /access setup | — | Instala la plantilla opcional: vip, helper, moderator y admin con herencia básica. Se rechaza entera si ya existe alguno de esos IDs. |
| access owner | Solo consola | Concede el rango owner permanente. Solo la consola puede hacerlo; ser OP o tener * nunca basta. |
| access uuid | Solo consola | Muestra la UUID que esta red tiene registrada para un nombre. No crea identidades. |
| /access rank | sofycore.ranks.view | Lista los rangos, diez por página. |
| /access rank | sofycore.ranks.view | Tipo, autoridad, peso, herencias y apariencia de un rango. |
| /access rank | sofycore.ranks.view | Permisos combinados, identificando directos y heredados/default. |
| /access rank | sofycore.ranks.manage | Crea un rango global. IDs: 1–32 caracteres en minúscula que empiezan por letra. |
| /access rank | sofycore.ranks.manage | Edita un rango: nombre visible, tipo, autoridad (STAFF/ADMIN, solo rangos STAFF), peso, prefijo, sufijo o color de nombre. `clear` vacía estilos. |
| /access rank | sofycore.ranks.manage | Concede, deniega o quita uno o varios permisos de un rango. Se aceptan comodines finales como sofycore.chat.*. |
| /access rank | sofycore.ranks.manage | Añade o retira una herencia. Las herencias circulares se rechazan. |
| /access rank | sofycore.ranks.manage | Permisos y herencias condicionados con duración y condiciones (servidor, mundo, modo de juego, región/flags de WorldGuard). `global` significa sin condición. |
| /access rank | sofycore.ranks.manage | Elimina un rango. Sus grants pasan a RANK_DELETED y el ID queda retirado para siempre. |
| /access user | sofycore.ranks.grant | Añade un grant independiente. Se rechaza si ya hay uno igual activo (usar extend). |
| /access user | sofycore.ranks.grant | Concede un rango solo bajo ciertas condiciones. |
| /access user | sofycore.ranks.grant | Retira exactamente un grant. |
| /access user | sofycore.ranks.grant | Extiende un grant o lo hace permanente. Suma desde el vencimiento si sigue activo, o desde ahora si venció. |
| /access user | sofycore.ranks.view | UUID, autoridad y revisión; grants con IDs, estado y vencimiento; excepciones individuales. |
| /access user | sofycore.ranks.manage | Excepciones individuales de permisos. Las reglas individuales aplicables tienen prioridad sobre las de rangos. |
| /access user | sofycore.ranks.view | Explica de dónde sale un permiso. DEFAULT indica que no hay regla explícita. |
| /color [0-f|#rrggbb|reset] | sofycore.ranks.color | Consulta o cambia tu color de nombre. Acceso directo a /access color; abre un menú con el módulo de menús. |
| access migration | Solo consola | Analiza una exportación de LuckPerms 5.x y genera un plan. Después: report, status, apply <plan> confirm, resume <plan> confirm. |
| access migration | Solo consola | Analiza un permissions.yml de PermissionsEx desde plugins/sofyCore/migrations/pex/ y genera un plan. Después: report, status, apply <plan> confirm, resume <plan> confirm. |
| /ban <player|uuid> | sofycore.sanctions.ban | Ban global de la cuenta. -c vacía antes el inventario del objetivo (mismo servidor, sofycore.sanctions.clear). |
| /ipban <ip|player> | sofycore.sanctions.ipban | Banea esa IP exacta. Un jugador se resuelve a su última IP registrada. |
| /mute <player|uuid> | sofycore.sanctions.mute | Silencio global en chat y mensajes privados. |
| /warn <player|uuid> | sofycore.sanctions.warn | Advertencia que caduca. Las activas pueden disparar consecuencias automáticas (por defecto 3 → mute 10 min, 5 → ban 1 h). |
| /kick <online-player> | sofycore.sanctions.kick | Expulsa esa conexión confirmada. |
| /unban | | sofycore.sanctions.unban | Quita la sanción activa (permisos sofycore.sanctions.unban, .unipban, .unmute). Quitar la de otro emisor requiere rango superior al suyo. |
| /unwarn <player|uuid> | sofycore.sanctions.unwarn | Quita una advertencia activa. |
| /blacklist <add|remove|list> | sofycore.sanctions.blacklist | Lista negra permanente de nombres o IPs literales. /unblacklist es la misma acción de borrado. |
| /history <player|uuid|ip|name:nick> | sofycore.sanctions.history | Historial completo, incluidas vencidas, reemplazadas y retiradas. Sin argumentos (o /punishinfo) muestra el tuyo, con sofycore.sanctions.history.own. |
| /staffhistory <player|uuid|console> | sofycore.sanctions.history | Acciones realizadas por un miembro del staff. |
| /ips <player|uuid> | sofycore.sanctions.ips | Hasta 16 IPs recientes de una cuenta y cuentas vistas en una IP. No las sanciona. |
| /punish config | sofycore.moderation.configure | Ajustes de moderación guardados y propagados a la red: idioma, nombres de comandos, duración de warns, umbrales y tipos de reporte. |
| /report <online-player> | sofycore.reports.use | Crea un reporte (espera de 60 s). Tipos iniciales: killaura, reach, fly, speed, antiknockback, xray, autoclicker, other. Abre un menú si solo se indica el jugador y los menús están activos. |
| /reports <list|inspect|take|release|resolve|dismiss> | sofycore.reports.manage | Cola de reportes abiertos: ver, tomar, devolver, resolver o descartar. |
| /helpop <message...> | sofycore.helpop.use | Envía un mensaje al staff de todos los servidores (espera de 30 s). |
| /chat <mute|unmute> | sofycore.chat.mute | Bloquea o desbloquea el chat público local de este servidor. |
| /chat slow | sofycore.chat.slow | Tiempo mínimo entre mensajes públicos. |
| /staffchat [message] | sofycore.chat.staff | Canal staff de toda la red por Redis. Los mensajes que empiezan por ! también. Sin texto alterna el canal (sofycore.chat.channel.toggle). |
| /adminchat [message] | sofycore.chat.admin | Canal de administradores de toda la red. Los mensajes que empiezan por @ también. |
| /chat channel | sofycore.chat.channel.toggle | Selecciona tu canal de chat para esta sesión. |
| /message <player> | sofycore.message | Mensaje privado, también entre servidores si cross-server está activo. |
| /reply <text...> | sofycore.message | Responde a tu última conversación confirmada. |
| /ignore <player> | sofycore.message.ignore | Lista persistente de ignorados para privados. sofycore.message.ignore.bypass la salta. |
| /tags [list | sofycore.tags.use | Lista, elige o quita tu tag. |
| /tags <create|edit|delete|reload> | sofycore.tags.manage | Administra el catálogo compartido de tags. |
| /tagsimports | sofycore.tags.import | Fusiona el archivo local tags.yml con el catálogo compartido. |
| /sout <interval|once> | sofycore.announcements.global.create | Anuncio recurrente de red por Redis (s/m/h, hasta 365 días), o de una sola vez con once (sofycore.announcements.global.once). |
| /sout <list | sofycore.announcements.global.list | Lista los anuncios recurrentes o borra uno por su ID de 4 caracteres (delete: sofycore.announcements.global.delete). |
| /freeze <player> | sofycore.staff.freeze | Congela a un jugador en cualquier servidor de la red. Se mantiene al cambiar de servidor o reconectar. |
| /unfreeze <player> | sofycore.staff.unfreeze | Descongela, aunque el jugador esté desconectado. |
| /vanish | sofycore.staff.vanish | Invisible para rangos inferiores en toda la red; los de rango igual o superior te siguen viendo. |
| /staffmode | sofycore.staff.mode | Guarda tu inventario y estado, te da la hotbar protegida de staff y activa vanish. Ejecutarlo otra vez lo devuelve todo. |
| /follow <player> | — | Solo en modo staff: te sienta sobre un jugador y lo sigue entre servidores. |
| /servermanager <server|*> | sofycore.staff.servermanager.run | Ejecuta un comando de consola en un servidor o en todos. |
| /servermanager <listservers | sofycore.staff.servermanager.list | Servidores de la red con jugadores, slots y TPS, detalle de uno y conexión a él (connect: sofycore.staff.servermanager.connect). |
| /staffonline | sofycore.staff.list | Staff conectado en la red. Pulsar un nombre necesita sofycore.staff.list.goto. |
| /gamemode <mode> | sofycore.essentials.gamemode | survival/s/0, creative/c/1, adventure/a/2, spectator/sp/3. Otros jugadores necesitan .others y rango superior. |
| /heal [player] | sofycore.essentials.heal | Vida máxima, hambre llena y sin fuego; o hambre y saturación (sofycore.essentials.feed). |
| /fly [player] | sofycore.essentials.fly | Alterna el vuelo, o el modo dios (sofycore.essentials.god; se pierde al desconectarse). |
| /more | sofycore.essentials.more | Ítem en la mano: llenar el stack, renombrar (colores &, &#RRGGBB en 1.16+), editar lore, ponerlo de sombrero. |
| /skull [player] | sofycore.essentials.skull | Tu cabeza, o la de otro jugador (.others). |
| /broadcast <message> | sofycore.essentials.broadcast | Mensaje en el chat de este servidor; /alert añade título en pantalla y sonido (sofycore.essentials.alert). |
| /sudo <player> | sofycore.essentials.sudo | Fuerza a un jugador de rango inferior a ejecutar un comando o hablar. |
| /invsee [player] | sofycore.essentials.invsee | Inventario o enderchest en vivo de un jugador conectado de rango inferior (.modify para editar). Sin jugador, abre el contenedor que miras (.containers). |
| /tp <player> | sofycore.essentials.tp | Teletransportes con comprobación de jerarquía. /back vuelve al lugar previo al último teletransporte o muerte. |
| /spawn [player] | sofycore.essentials.spawn | Spawn del servidor (guardado en essentials-spawn.yml) y spawns de otros mundos. |
| /clear [player] | sofycore.essentials.clear | Vacía inventario, armadura, mano secundaria y cursor; entrega ítems hasta give-limit (sofycore.essentials.give). |
| /speed <1-10|reset> | sofycore.essentials.speed | Velocidad al andar o de vuelo; 1 es normal y 10 el máximo. |
| /vippoints | sofycore.vippoints.balance | Muestra tu saldo global de puntos VIP. |
| /vipshop [list | sofycore.vippoints.shop | Lista plantillas, muestra qué pasará y el precio, y confirma o cancela. Sin argumentos abre el menú de la tienda si los menús están activos. |
| /vpadmin <balance|give|take|set|history|recover> | sofycore.vippoints.admin.view | Administra saldos, también offline (give/take/set/history/recover tienen su propio nodo). take nunca baja de cero. |
| /vptemplate <list|create|set|delete|max> | sofycore.vippoints.templates | Crea y edita plantillas de la tienda (rango, duración, precio, nombre) y el saldo máximo global. |
| /bossbars [on|off|toggle] | sofycore.bossbar.toggle | Muestra u oculta la bossbar de la red para ti, en todos los servidores. |
| /bossbaradmin <list|info|create|edit|delete|toggle|group|refresh> | sofycore.bossbar.admin.* | Administra las bossbars de la red: textos, color, estilo, duración, orden, animación, alcance (global, server:<nombre>, group:<grupo>) y grupos de servidores. |
| /maintenance on | sofycore.maintenance.manage | Mantenimiento de toda la red: expulsa a quien no tenga bypass, bloquea entradas nuevas y, por defecto, congela el reloj de rangos. |
| /maintenance off | sofycore.maintenance.manage | Reabre la red; un bonus opcional mantiene el reloj de rangos parado más tiempo. |
| /maintenance status | sofycore.maintenance.status | Estado, motivo, quién y desde cuándo, y el estado del reloj de rangos. |
| /settings | sofycore.menus.settings | Menú de preferencias (anuncios, privados, bossbar, menciones...). |
| /profile | sofycore.menus.profile | Tu menú de perfil. |
| /player <player> | sofycore.staff.panel | Panel de staff de un jugador: perfil, sanciones, rangos y, con sofycore.staff.panel.address, última IP. |
| /players | sofycore.menus.players | Jugadores o staff conectados en la red (sofycore.menus.stafflist para el staff). |
| /menu <id> | sofycore.menus.open.<id> | Abre un menú personalizado definido en menus.yml. |