Comandos TShock: guía rápida de instalación, grupos, admin y anti-grief

Estos comandos TShock cubren lo que un admin de Terraria escribe cada semana: la primera configuración, grupos, baneos y protección de regiones, comprobados en el código de TShock 6.2.1. Antes de nada: 1up no ofrece TShock hoy. Nuestros servidores de Terraria usan vanilla o tModLoader, y nuestra guía del servidor de Terraria gratis compara las tres opciones.

• Prefijo: los comandos empiezan por /. Con . el mismo comando se ejecuta en silencio. En la consola del servidor puedes omitir el prefijo.
• Primer arranque: /setup <código>, luego /user add <nombre> <contraseña> owner, /login y otra vez /setup para cerrar la configuración.
• Grupos: guest → default → vip → newadmin → admin → trustedadmin → owner, y cada uno hereda del anterior.
• Baneos: /ban add <jugador> [motivo] [duración], permanente salvo que indiques una duración como 10d30m0s.
• Anti-grief: /region protege construcciones, /itemban bloquea objetos y /antibuild congela todo el mapa.

Cómo funcionan los comandos de TShock

TShock es un plugin de servidor para Terraria. Su README lo describe como una caja de herramientas con antitrampas, personajes guardados en el servidor, grupos, permisos, baneo de objetos y una larga lista de comandos. La versión actual, TShock 6.2.1, es compatible con Terraria 1.4.5.8.

Tres reglas se aplican a todos los comandos de esta guía:

• Prefijo. El CommandSpecifier por defecto es / y el CommandSilentSpecifier es ., según TShockConfig.cs. Un comando silencioso se salta el aviso en el chat que hacen algunos comandos: /mute con punto silencia a alguien sin anunciarlo a todo el servidor. La documentación antigua habla de ! para los comandos silenciosos; el código actual dice ..
• Consola. En la consola del servidor, TShock añade la / si no la pones, así que user add ... funciona tal cual. La consola ejecuta los comandos con todos los permisos.
• Ayuda. /help lista los comandos que tu grupo puede usar, /help <comando> explica uno y /aliases <comando> muestra sus otros nombres, tal como están definidos en Commands.cs.

Cada comando va ligado a un nodo de permiso de Permissions.cs. Si a un jugador le sale «You do not have access to this command», lo que falta es un permiso, no otro comando.

Instalación y primeros comandos

TShock no es un mod que instalen tus jugadores. Sustituye al servidor que arrancas, y los jugadores se conectan con su juego normal.

1. Descarga el zip de tu sistema en la versión 6.2.1: Windows x64, Linux x64, Linux ARM y ARM64 o macOS x64. También hay imagen de Docker: ghcr.io/pryaxis/tshock:stable.
2. Instala el runtime de .NET. TShock 6 pasó a .NET 9, según las notas de la versión 6.0.
3. Descomprime todo en una misma carpeta y arranca TShock.Server.exe (o TShock.Server en Linux y macOS). La documentación oficial indica que crea una carpeta tshock para su base de datos y su configuración, y después hace las preguntas habituales sobre el mundo.
4. Para saltarte las preguntas, arráncalo con -world <ruta al .wld> -port 7777 -maxplayers 8, como muestra la página de parámetros.

En el primer arranque TShock escribe «To setup the server, join the game and type /setup» seguido de un código, y lo guarda en tshock/setup-code.txt (TShock.cs). Después:

• /setup <código>: te da acceso temporal para ejecutar un solo comando.
• /user add <nombre> <contraseña> owner: crea tu cuenta permanente en el grupo owner.
• /login <nombre> <contraseña>: inicia sesión.
• /setup: desactiva el sistema de configuración inicial.

Los comandos de cuenta que usan tus jugadores:

• /register <contraseña>: crea una cuenta con el nombre de su personaje. La contraseña mínima es de 4 caracteres por defecto.
• /login <contraseña> o /login <nombre> <contraseña>: inicia sesión.
• /logout y /password <antigua> <nueva>.

Los archivos que vas a editar están en la carpeta tshock (FileTools.cs): config.json, sscconfig.json para los personajes en el servidor, motd.txt, rules.txt y whitelist.txt. Haz copia también de tshock.sqlite: la documentación avisa de que si lo pierdes tendrás que configurar TShock de nuevo.

Grupos y permisos

TShock crea sus grupos por defecto la primera vez que genera su base de datos (GroupManager.cs). Cada uno hereda del anterior:

• guest: jugadores sin sesión iniciada. Pueden construir, chatear, registrarse e iniciar sesión.
• default: jugadores registrados. Suma warps, mensajes privados, pintar, pilones, invocar jefes y cambiar su contraseña.
• vip: suma una plaza reservada, renombrar PNJ e iniciar invasiones.
• newadmin: suma /kick, /mute, editar la protección del punto de aparición y /time.
• admin: suma /ban, /whitelist, /broadcast, los comandos de teletransporte, generar jefes y monstruos, e inmunidad a expulsiones.
• trustedadmin: suma el mantenimiento del servidor, todos los nodos tshock.cfg.* y tshock.world.*, objetos, modo dios e inmunidad a baneos.
• owner: suma /group, /region, /itemban, /tileban, /projban, /antibuild, /su y /tempgroup.

Existe además un grupo insecure-guest y un superadmin interno con todos los permisos: es el que usan la consola y /setup.

Los subcomandos de /group, según su propia ayuda:

• /group add <nombre> [permisos]: crea un grupo.
• /group addperm <grupo> <permisos...>: añade nodos. Usa * como nombre de grupo para añadirlos a todos.
• /group delperm <grupo> <permisos...>: quita nodos.
• /group parent <grupo> <padre>: cambia de quién hereda.
• /group list y /group listperm <grupo>: para revisar.
• /group prefix, suffix, color <grupo> <rrr,ggg,bbb>, rename y del.

Para mover jugadores entre grupos:

• /user group <cuenta> <grupo>: cambio permanente.
• /tempgroup <jugador> <grupo> [tiempo]: temporal, con tiempos como 1d o 10h-30m+2m.
• /su: un owner pasa a superadmin durante 10 minutos. /sudo <comando> ejecuta un solo comando como superadmin.

El propio /user necesita tshock.superadmin.user, que no tiene ninguno de los grupos por defecto. Ejecútalo desde la consola o después de /su.

Los nodos siguen el patrón tshock.<área>.<acción>. Ejemplos del código: tshock.admin.kick, tshock.admin.ban, tshock.admin.region, tshock.world.modify (poder construir) y tshock.canchat. Un * al final cubre una rama entera, como el tshock.world.time.* por defecto.

Comandos de administración

Moderación, con la sintaxis que imprime TShock:

• /kick <jugador> [motivo]: expulsa a un jugador.
• /ban add <objetivo> [motivo] [duración] [opciones]: la duración usa 0d0m0s, por ejemplo 10d30m0s. Sin duración, el baneo es permanente.
• Opciones del baneo: -a cuenta, -u UUID, -n nombre del personaje, -ip dirección IP, -e identificador exacto. Sin opciones, TShock usa -a -u -ip.
• /ban list, /ban details <ticket>, /ban del <ticket>: el número de ticket sale de /ban add o de /ban list.
• /ban help examples: ejemplos completos, como banear una cuenta desconectada con "acc:<nombre>" y -e.
• /mute <jugador> [motivo]: impide hablar; el mismo comando quita el silencio.
• /who -i: la lista de conectados con su índice, útil para nombres difíciles de escribir.
• /userinfo <jugador> y /accountinfo <cuenta>: IP, grupo y datos de la cuenta.
• /displaylogs: activa o desactiva el registro del servidor en tu chat.

Gestión del servidor:

• /broadcast <mensaje> (también /bc y /say): mensaje para todo el servidor.
• /save: guarda el mundo en ese momento.
• /off [motivo]: guarda y apaga. /off-nosave apaga sin guardar.
• /reload: recarga configuración, permisos y regiones; algunos cambios siguen necesitando reinicio.
• /serverpassword "<nueva contraseña>": cambia la contraseña de acceso.
• /time day, night, noon, midnight o hh:mm: cambia la hora.

Arreglar problemas en el mundo:

• /butcher [nombre o ID del PNJ]: mata a los PNJ hostiles, o a un tipo concreto.
• /clear <item|npc|projectile> [radio]: elimina objetos tirados, PNJ o proyectiles.
• /tp <jugador> [jugador 2] y /tphere <jugador>: teletransportes.
• /warp add <nombre>, /warp <nombre>, /warp del <nombre>: lugares guardados.
• /item <nombre o ID> [cantidad] y /give <objeto> <jugador> [cantidad]: repartir objetos.
• /heal <jugador> [cantidad] y /godmode [jugador].

Anti-grief: regiones, baneos y bloqueo total

Las regiones protegen construcciones: quien no tenga permiso en una región protegida no puede modificarla.

1. /region set 1 y golpea un bloque para marcar la primera esquina.
2. /region set 2 y golpea la esquina opuesta.
3. /region define <nombre>: crea la región. En RegionManager.cs, las regiones nuevas se guardan como protegidas.
4. /region allow <cuenta> <región> o /region allowg <grupo> <región>: deja entrar a quien construye.
5. /region protect <nombre> false: vuelve a abrir una región.

Más: /region list, /region info <región>, /region name (golpea un bloque para saber en qué región está), /region resize <región> <u/d/l/r> <cantidad> y /region delete <nombre>. Los cofres no quedan protegidos salvo que pongas RegionProtectChests en true en config.json; viene desactivado.

Baneo de objetos, bloques y proyectiles:

• /itemban add <nombre del objeto>: nadie puede usarlo.
• /itemban allow <nombre del objeto> <grupo>: salvo ese grupo.
• /tileban add <ID del bloque> y /projban add <ID del proyectil>: lo mismo para bloques colocados y proyectiles.

Interruptores de bloqueo:

• /antibuild: activa o desactiva DisableBuild, que impide colocar y quitar bloques.
• /protectspawn: activa o desactiva SpawnProtection, que impide colocar bloques a menos de SpawnProtectionRadius casillas del punto de aparición (10 por defecto).
• /whitelist <ip[/rango]>: añade una dirección a whitelist.txt. Solo tiene efecto con EnableWhitelist en true.

Ajustes de config.json que conviene activar (TShockConfig.cs):

• RequireLogin: los jugadores tienen que registrarse o iniciar sesión antes de jugar. Desactivado por defecto.
• TileKillThreshold y TilePlaceThreshold: 200 bloques por segundo por defecto; por encima, TShock desactiva al jugador y revierte lo que hizo. Activa KickOnTileKillThresholdBroken si prefieres expulsarlo.
• Personajes en el servidor: Enabled en sscconfig.json guarda los inventarios en el servidor en lugar de en el cliente. Desactivado por defecto.

¿Puedo usar TShock en 1up?

Hoy no. Nuestros servidores de Terraria ofrecen dos plantillas, Vanilla 1.4.5.8 y tModLoader, y ninguna ejecuta TShock. Si tu grupo son unos pocos amigos, vanilla con contraseña y los permisos de Journey bloqueados que aplicamos por defecto suele bastar; la guía principal de Terraria explica cómo configurarlo. Si llevas un servidor público y necesitas todo lo anterior, aloja tú mismo TShock 6.2.1 desde la página de versiones.

Verificado con el código fuente de TShock 6.2.1 (Terraria 1.4.5.8), 2026-10-04.

Historial de cambios

• 2026-10-04: primera versión.