-
-
Notifications
You must be signed in to change notification settings - Fork 381
Installation Instructions
Hello! Thanks for choosing TShock.
Warning: The wiki will be moving to confluence soon. While we transition pages over, editing will be restricted to those given accounts by Shank (@nicatronTg). This wiki will be turned off eventually, however, editing will be opened on Confluence when this happens. (See http://ci.tshock.co:8080/)
If you have any problems with this installation, post an issue on our Forums and if you encounter an unusual error that looks like a bug please post it on our Issue Tracker.
- Download the latest package of TShock from the TShock Downloads.
- This is the current version TShock 3.4.2.1233.zip — TShock 3.4, for Terraria 1.1.1
- Run TerrariaServer.exe. This is your server.
- Select the world you want to use or create a new one.
- After selecting your world, you will be asked for input on 3 settings: Max players, Server port, and Server password.
- Note: Default settings are: Max players (8), Server port (7777), and Server password (none). You may hit your ENTER key at each input to select the default setting in parenthesis ().
- Once the server starts the console window will have the following message: To become superadmin, join the game and type /auth [authcode]
- Run Terraria.exe, join your server, and enter: /auth [authcode]. This will give you the ability to create a user account on the server, giving you access to all commands.
- Note: In order to join your own server, you can enter: localhost or 127.0.0.1 (which are the same thing - assuming the server is being run on the same machine that you run Terraria), or you can use your own External IP address, which can be found simply by going to a website such as WhatIsMyIP.com.
- Next, enter: /user add [username]:[password] superadmin
- Example: /user add john:qwerty superadmin (remember to include the colon ":" between the username and password)
- Log in with the superadmin user you just created by entering: /login [username] [password] (without a colon)
- Example: /login john qwerty
- Finally, to remove the "auth" message on server startup, enter: /auth-verify
To add a new user or admin, enter the following: /user add [username]:[password] [group]
- Example #1 (Add a VIP user): /user add sarah:connor vip
- Example #2 (Add another Admin): /user add sarah:connor newadmin
Alternatively, if the user you wish to add has already registered (using /register [username] [password]) you may also edit that user's Usergroup in the C:\TShock\tshock\tshock.sqlite file (Users.Usergroup - see below). Users who have their access added or changed need only re-join the server for their permissions to take effect.
Your server should now be successfully running TShock. Here are a few things you may like to do:
- Familiarize yourself with the Commands & Permissions.
- Configure whatever options you choose in the C:\TShock\tshock\config.json file. For information on what each option does, check out Configuration file setup.
- Note: you can open the config.json file with Notepad, or its superior, Notepad++
- Make your server noticeable! With your External IP address (WhatIsMyIP.com), you can sign up to have your server listed on TerrariaNet.
- Convert your External IP into a DNS: Using a free service like No-IP.com, you can change your external IP address into a readable DNS name. In other words, instead of forcing your users to connect with 192.9.9.250, they can use "yourserver.no-ip.com".
- Protip: Because your IP will likely change once in a while, at some point your players will be unable to connect to you, and you may not even notice. You can download No-IP's Dynamic DNS Client to keep your IP in sync with the DNS name you make with them.
- Get yourself acquainted with TShock's data storage within the C:\TShock\tshock\tshock.sqlite file. All users, regions, permissions, and other data is kept here. Twitchy's TShock DB Editor is very user-friendly and
is consistently being updated, and SQLite Manager can be run directly through Firefox:
- Open Firefox, go to the Web Development Menu, and open SQLite Manager.
- In the menu at the top, select Database -> Connect Database
- Browse to C:\TShock\tshock and open tshock.sqlite. You may now click on Tables in the left panel, and double click on a database record in the Browse & Search tab to edit it. WARNING: Edit data with caution! Making mistakes inside this file can easily result in a corrupted database, which will prevent your server from functioning properly. Edit data at your own risk! It is highly recommended to make frequent backups of this file!
- Q: Function/class not found! A: Make sure you have the latest version of TShock and TerrariaServer.
- Q: Linux? A: As of version 3.2.8.0831, TShock can run in Mono.
- Q: Encryption/Hash algorithm not supported on Windows XP. A: In the configuration file, change the hash algorithm to sha256 or md5.