Skip to main content
← back to extensions

@keeb/terraria

v2026.04.22.3

Control a Terraria (tModLoader) server running in a Docker container with tmux over SSH, including shutdown warnings, player status, and Prometheus metrics.

Repository

https://github.com/keeb/swamp-terraria

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

terrariagamingserver

Contents

modelsskills

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/terraria

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/terraria/serverv2026.02.14.1terraria_server.ts

Global Arguments

ArgumentTypeDescription
sshHost?stringSSH hostname/IP (set via CEL from lookup model)
sshUserstringSSH user (default 'root')
containerNamestringDocker container name running tModLoader
serverNamestringResource instance name for writeResource
warnShutdownBroadcast a shutdown warning to Terraria players and wait 30 seconds
statusQuery Terraria server status: player count and names
collectMetricsCollect player metrics and write Prometheus textfile + JSON log

Resources

server(infinite)— Terraria server operation result
metrics(infinite)— Terraria player metrics collection result

terraria1 file