tModloader

Game

tModLoader is essentially a mod that provides a way to load your own mods without having to work directly with Terraria's source code itself. This means you can easily make mods that are compatible with other people's mods, save yourself the trouble of having to decompile and recompile Terraria.exe, and escape from having to understand all of the obscure "intricacies" of Terraria's source code. It is made to work for Terraria 1.3+.

Author: parker@parkervcp.comSource: pterodactyl/game-eggsUpdated: 5/24/2026

Startup Command

./tModLoaderServer -ip 0.0.0.0 -port {{SERVER_PORT}} -maxplayers {{MAX_PLAYERS}} -password "{{SERVER_PASSWORD}}" -motd "{{MOTD}}" -lang {{LANGUAGE}} -world ~/saves/Worlds/{{WORLD_NAME}}.wld -worldname {{WORLD_NAME}} -autocreate {{WORLD_SIZE}} -config serverconfig.txt -savedirectory ~/ -tmlsavedirectory ~/saves -modpath ~/mods

Docker Images

Label	Image
Dotnet 8	ghcr.io/ptero-eggs/yolks:dotnet_8
Dotnet 6	ghcr.io/ptero-eggs/yolks:dotnet_6

Environment Variables

Name	Variable	Default	Rules
World Name The name for the world file.	WORLD_NAME	world	required\|string\|max:20
Max Players The maximum number of players a server will hold.	MAX_PLAYERS	8	required\|numeric\|digits_between:1,3
World Size Defines the worlds size. 3 sizes 1 (small), 2 (medium), 3 (large).	WORLD_SIZE	1	required\|string\|in:1,2,3
tModloader Version The version of tModloader that is to be used.	VERSION	latest	required\|string\|max:20
GitHub User GitHub user to use for api calls. This only needs to be set if you hit the GitHub API too often across multiple servers.	GITHUB_USER	none	string\|nullable
GitHub OAuth Token This can be either an OAuth or a Personal Access Token. This is required for the install is you set a user.	GITHUB_OAUTH_TOKEN	none	string\|nullable
Difficulty Sets the difficulty of the world when using auto-create. Options: 0(normal), 1(expert), 2(master), 3(journey)	DIFFICULTY	0	required\|string\|in:0,1,2,3
Server Password Server password for users to connect to your server. Can be empty for no password.	SERVER_PASSWORD	none	nullable\|string\|max:20
MOTD Message of the Day for the server	MOTD	Please don’t cut the purple trees!	required\|string\|max:40
Language Sets the server language 1:English, 2:German, 3:Italian, 4:French, 5:Spanish	LANGUAGE	1	required\|string\|in:1,2,3,4,5