diff --git a/modules/billing/docs/terraria/index.php b/modules/billing/docs/terraria/index.php index d8d4bbf7..c5c944f1 100644 --- a/modules/billing/docs/terraria/index.php +++ b/modules/billing/docs/terraria/index.php @@ -1,68 +1,360 @@ -

Terraria Server Guide

- -

Overview

-

Terraria is available for hosting on our platform. This guide covers the basics of setting up and managing your Terraria server.

-
-

Server Information

- -

- Note: When running on a VPS or dedicated server, you can use the default port or configure a custom port in your server configuration file. -

+

Navigation

+
+ Quick Info + Installation + Configuration + TShock + Troubleshooting + Performance +
-

Getting Started

-

To create a Terraria server:

-
    -
  1. Navigate to the Game Servers page
  2. -
  3. Find Terraria in the list
  4. -
  5. Select your preferred configuration (slots, duration, etc.)
  6. -
  7. Add to cart and complete checkout
  8. -
  9. Your server will be automatically provisioned within minutes
  10. -
+

Terraria Dedicated Server Hosting Guide

-

Server Configuration

-

After your server is created, you can configure it through the control panel:

+

Overview

+

Terraria is a 2D action-adventure sandbox game developed by Re-Logic. With over 5000 items, bosses, NPCs, and extensive building mechanics, Terraria offers rich multiplayer experiences. This comprehensive guide covers hosting a Terraria dedicated server on a VPS or dedicated server.

+ +

Quick Info

+
+ +
+ +

Installation & Setup

+ +

System Requirements

-

Common Tasks

+

Windows Installation

+
1. Locate Terraria installation directory:
+   C:\Program Files (x86)\Steam\steamapps\common\Terraria\
 
-

Starting Your Server

-

Servers are automatically started after creation. You can stop/start your server from the control panel.

+2. Find TerrariaServer.exe in the main folder -

Connecting to Your Server

-

Use your server's IP address and port to connect from the game client.

+3. Run TerrariaServer.exe + - Follow the setup wizard + - Choose existing world or create new + - Set max players + - Set port (default 7777) + - Set password (optional) -

Managing Files

-

Access your server files via FTP using the credentials provided in your control panel.

+4. Server will start and display connection information +
-

Support

-

If you need assistance with your Terraria server:

+

Linux Installation

+
# Download Terraria server files
+wget https://terraria.org/api/download/pc-dedicated-server/terraria-server-1449.zip
+
+# Extract files
+unzip terraria-server-1449.zip
+cd 1449/Linux/
+
+# Make executable
+chmod +x TerrariaServer*
+
+# Run server
+./TerrariaServer.bin.x86_64
+
+# Or for headless/background:
+screen -S terraria ./TerrariaServer.bin.x86_64
+# Detach with Ctrl+A, D
+# Reattach with: screen -r terraria
+
+ +

macOS Installation

+
# Download server files from terraria.org
+# Extract and navigate to Mac folder
+cd ~/terraria-server/Mac/
+
+# Make executable
+chmod +x TerrariaServer*
+
+# Run server
+./TerrariaServer.bin.osx
+
+ +

Server Configuration

+ +

Configuration File (serverconfig.txt)

+

Create serverconfig.txt in the server directory:

+
# World Configuration
+world=/path/to/Worlds/MyWorld.wld
+autocreate=3
+worldname=MyWorld
+
+# Server Settings
+maxplayers=16
+port=7777
+password=YourPassword
+motd=Welcome to my Terraria server!
+
+# Security
+banlist=banlist.txt
+secure=1
+
+# Network
+priority=1
+npcstream=60
+
+ +

Configuration Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionValues
worldPath to world file/path/to/world.wld
autocreateAuto-create world size1=Small, 2=Medium, 3=Large
maxplayersMaximum player slots1-255 (8-16 typical)
portServer portDefault: 7777
passwordServer passwordAny string (optional)
motdMessage of the dayText message
difficultyWorld difficulty0=Normal, 1=Expert, 2=Master
securePrevent cheating0=Off, 1=On
npcstreamNPC update frequencyDefault: 60
+ +

Port Forwarding

+
# Forward TCP port 7777 (or your configured port)
+# Linux firewall (UFW):
+sudo ufw allow 7777/tcp
+sudo ufw reload
+
+# Windows Firewall:
+New-NetFirewallRule -DisplayName "Terraria Server" -Direction Inbound -Protocol TCP -LocalPort 7777 -Action Allow
+
+ +

TShock Server Framework

+ +

What is TShock?

+

TShock is a server modification that adds extensive administrative features, permissions, anti-grief protection, and plugin support to Terraria servers.

+ +

Installing TShock

+
# Download TShock from https://github.com/Pryaxis/TShock/releases
+
+# Extract TShock files
+unzip TShock.zip
+
+# Run TShock server
+./TShock.Server
+
+# First run creates configuration files
+# Configure in tshock/config.json
+
+ +

TShock Features

+ +

Common TShock Commands

+
/user add USERNAME PASSWORD GROUP
+/group add GROUPNAME "permissions"
+/region define REGIONNAME
+/whitelist add USERNAME
+/ban add USERNAME reason
+/give PLAYER ITEMID AMOUNT
+/time set 12:00
+/butcher - Kill all hostile NPCs
+
+ +

Troubleshooting

+ +

Server Won't Start

+

Problem: Server fails to launch or crashes immediately.

+

Solutions:

+ + +

Players Cannot Connect

+

Problem: Players can't join the server.

+

Solutions:

+ + +

Lag and Performance Issues

+

Problem: Server experiences lag or stuttering.

+

Solutions:

+ + +

World Corruption

+

Problem: World file corrupted or won't load.

+

Solutions:

+ + +

Mod/Plugin Issues

+

Problem: Mods not loading or causing crashes.

+

Solutions:

+ + +

Performance Optimization

+ +

Server Sizing Guidelines

+ + +

Backup Strategy

+
# Linux backup script
+#!/bin/bash
+WORLD_DIR="/path/to/Terraria/Worlds"
+BACKUP_DIR="/path/to/backups"
+DATE=$(date +%Y%m%d_%H%M%S)
+
+# Create backup
+tar -czf $BACKUP_DIR/terraria_backup_$DATE.tar.gz $WORLD_DIR
+
+# Keep only last 14 days
+find $BACKUP_DIR -name "terraria_backup_*.tar.gz" -mtime +14 -delete
+
+ +

Automated Restarts

+

Set up daily restarts for optimal performance:

+
# Linux crontab for 4 AM restart
+0 4 * * * /path/to/restart_terraria.sh
+
+# restart_terraria.sh:
+#!/bin/bash
+pkill -9 TerrariaServer
+sleep 5
+cd /path/to/terraria
+screen -dmS terraria ./TerrariaServer.bin.x86_64 -config serverconfig.txt
+
+ +

World Management

+ + +

Modding Resources

+ +

TModLoader

+

TModLoader is a mod loader for Terraria that allows players to create and play mods.

+ +

Popular Mods

+ + +

Additional Resources

+

Important Notes

\ No newline at end of file