Repack

This guide will explain how to set up a fully working TSWoW development environment with a working server that you can connect to from your local computer.

Notes

  • For Windows, TSWoW must be installed to an NTFS drive (necessary for symlinks created by npm)

Prerequisites

You will need to install the following programs:

  • World of Warcraft 3.3.5a client

    • Currently, I can only verify that the enGB and enUS clients work, please make an issue if you use another locale and you face any problems.

    • Please make sure there are no spaces anywhere in the pathname to your WoW client or the TSWoW installation.

  • All the following versions of VCRedist:

  • VSCodium version 1.60

  • (Optional) To compile live scripts to a C++ backend, you will also need Visual Studio 2022 Community. The default livescript backend is Lua, so you rarely need this when just starting out.

    • When installing Visual Studio, you will be asked to choose what packages to install in a window similar to the following. The only package that is necessary for building Live Scripts is Desktop development with C++, as shown below. The only toggle you need to select is in the red square, everything else can use default settings.

Installation

Note: Just like many tools in WoW development, TSWoW does not permit spaces in filepaths. Make sure your installation path and client files do not contain any spaces

  1. Download the latest version of TSWoW from here

  2. Extract the TSWoW archive. The installation folder should contain (roughly) the following files and folders:

     package-lock.json
 package.json
 bin
 coredata
 modules
 node_modules

  3. Start the VSCodium editor. Press F1 and type “Open folder”, select the first option and select your TSWoW installation folder. This is your new development environment.

  4. Configure your client path. Open the file node.conf (shortcut. press Ctrl+P and type node.conf) and fill in the Default.Client field. This should be the directory that contains your client executable. Keep in mind that backslashes need to be doubled:

valid:

Default.Client = "C:\\dev\\wow\\335\\client"

valid:

Default.Client = "/home/myuser/wow/335/client"

not valid:

Default.Client = "C:\dev\wow\335\client"

Starting the server

  1. Inside VSCodium, press Ctrl+` OR press F1 and type Toggle Terminal and select the first option. This should open a terminal inside VSCodium.

  2. This terminal should be inside your TSWoW installation directory. If not, navigate to it using cd commands.

  3. Run the command ./start (if using cmd, run the command start.bat). This will start the automatic installation and then start the server.

  4. Wait for the core database installation. This is a long process on the first installation and can take a long time depending on your machine. 20-30 minutes isn’t rare. You know the installation is done when you see a message similar to TrinityCore rev. 2a67a101096e 2021-04-23 09:24:53 +0200 (tswow branch) (Win64, RelWithDebInfo, Dynamic) (worldserver-daemon) ready....

  5. To create a gm account, type create account myuser mypassword 3 (this commands requires that at least one worldserver is currently running)

  6. You can now start the client with the command start client and log in to the game.