How forcebyte/terraria-tmodloader-server-arm works
This repository packages and operates a persistent Terraria tModLoader 1.4.4 dedicated server, with an ARM64-compatible container runtime. The main workflow is to launch the container, configure or select a world, and serve Terraria clients while retaining worlds, mods, and configuration on mounted storage. Separate capabilities cover automatic and interactive world creation, mod installation/enabling, and Docker Compose or Kubernetes deployment. The README documents these behaviors; source excerpts were unavailable, so internal script-to-script wiring is not inferred.
Main entry points: tModLoader tModLoader server · entrypoint.sh Container entrypoint · Dockerfile ARM64 server image · inject Console injection
Components 18
Server runtime
- ARM64 server image
Dockerfile - Container entrypoint
tModLoader/Scripts/entrypoint.sh - tModLoader server
tModLoader - Console injection
tModLoader/Scripts/inject - Config setup
tModLoader/Scripts/create-config.sh - Version retrieval
tModLoader/Scripts/get-tmodloader-144.sh - Terraria version lookup
tModLoader/Scripts/get-terraria-version.sh
Persistent server data
- Server configuration
tModLoader/serverconfig-example.txt - World files
tModLoader/Worlds - Mod configuration
tModLoader/Mods - Workshop ID list
tModLoader/Mods/install.txt - Enabled mods
tModLoader/Mods/enabled.json
Deployment and operations
- Compose example
examples/docker-compose/docker-compose-example.yml - Kubernetes deployment
examples/kubernetes/terraria-calamity
Other components
- Server operator
- Docker runtime
- Terraria clients
- Steam Workshop
Connections 20
- Server operator → Docker runtime: starts container
- Compose example → Docker runtime: configures deployment
- Kubernetes deployment → Docker runtime: deploys container
- Docker runtime → ARM64 server image: runs image
- ARM64 server image → Container entrypoint: starts
- Container entrypoint → tModLoader server: launches
- Docker runtime → World files: mounts persistent data
- Docker runtime → Mod configuration: mounts persistent data
- tModLoader server → World files: reads and writes
- tModLoader server → Mod configuration: reads mod settings
- Workshop ID list → Steam Workshop: identifies mods
- tModLoader server → Steam Workshop: obtains mods
- Server operator → Config setup: configures server
- Config setup → Server configuration: prepares configuration
- Server configuration → tModLoader server: configures
- Server operator → Console injection: issues commands
- Console injection → tModLoader server: sends console input
- Terraria clients → tModLoader server: connects to
- Container entrypoint → Version retrieval: retrieves version
- Version retrieval → Terraria version lookup: checks version