Skip to content
Nathaniel Fuhr edited this page Jun 13, 2020 · 5 revisions

Toontown Setup Wiki page

This wiki will provide you with the neccessary information to get a Toontown server setup in a (Unix) style environment, as well as how to run the client in a Unix style environment OR Windows environment.

If you have any questions or issues, feel free to contact me at our Discord server. Toontown Developer Server


Toontown Quick Installation

Windows

Windows Server installation

  • Due to Astron not being well supported on Windows, we will be going a different route and using Windows Subsystem for Linux (WSL), This will allow us to setup the server in a Unix style environment. Please refer to this article for information on setting up WSL for Windows. Installing Windows subsystem for Linux

    Note; Our recommendation is to use Ubuntu 20.04 when choosing a distribution.

  • After installing and setting this feature up, it will give you a fully functional Unix environment to use on Windows, and will allow you to use the quick installation bash script for Linux, or manually setup the Toontown server for yourself.

    Please refer to "Linux environment or WSL" to continue setting up the server.


Windows Client installation

To run the client on a Windows environment, you will need to install a copy of Panda3D from this fork, https://github.com/nate97/panda3d/ Compilation information can be found under: Building Panda3d ---> Windows README

If you don't want to compile Panda3D for yourself, a compiled binary installation can be found here: Panda3D Installer

Once Panda3D has been installed, you will need to install the dependencies found below

Once you have downloaded the resources repository, make sure that you rename the folder to "resources", and to place it alongside the toontown-src-py3.0 folder.

If the above has been done incorrectly, the client will not find the resources folder and the client will give you an error similar to this "No such file or directory"

To install PyYAML,

  • If you have installed P3D to the standard location, open a CMD window in this directory "C:\Panda3D-1.11.0-x64\python\Scripts"
  • Type in pip3.exe install pyyaml and hit enter.

To start up the application, go to the win32 folder and make any necessary changes to the .bat files (Pointing the IP to YOUR server) and launch the bat file.


Linux environment or WSL

Linux Server & Client installation

For people who are beginners or just want a quick way to get a Toontown server setup on Linux or Windows subsystem for Linux, I have created a bash script that will install and compile all necessary dependencies. This script can be found here, and has been verified to work with Ubuntu 20.04

Quick installation script

Once this has been completed, change directory into the astron/linux folder, and you will see the bash files to start up the three main servers (Astron, Uberdog, AI) Astron must be started first. If you wish to use the start-all-services.sh bash script, you will need to install tmux.

After your servers have been launched, you can now start your client.


Toontown Dependencies

This section will provide you with the required dependencies to get Toontown running.

Server and client dependencies

Server dependencies