Open source Toontown Online, based on the latest version of Disney's Toontown Online (sv1.0.47.38).
Go to file
Leo e22fee8fa8 tutorial: Cleanup and fix floating Flunky in battle
The following has been cleaned up:
- Import statements
- Whitespace
- Small unnecessary comments

Futhermore, I have added Anesidora documentation to the Tutorial files that did not have them.
2026-01-31 17:22:21 -05:00
config config: Don't use HarfBuzz for now 2024-11-20 22:00:54 -05:00
darwin remove some astron stuff 2022-01-20 12:54:16 -05:00
linux remove some astron stuff 2022-01-20 12:54:16 -05:00
otp ai: Some fixes 2024-09-11 19:19:18 -04:00
otpgo general: Loads to TTC! 2024-09-21 16:43:27 -04:00
toontown tutorial: Cleanup and fix floating Flunky in battle 2026-01-31 17:22:21 -05:00
win32 remove some astron stuff 2022-01-20 12:54:16 -05:00
.gitignore ToontownClient: Handle interest 2024-09-08 19:30:58 -04:00
LICENSE general: Add LICENSE 2019-11-08 18:57:25 -05:00
PPYTHON_PATH win32/linux: Add start up scripts and add win32 Astron binaries. 2021-06-05 01:23:03 -03:00
README.md Update README.md 2022-01-20 16:23:04 -05:00
requirements.txt Create requirements.txt 2019-12-30 20:54:25 -05:00
vscode.code-workspace general: more vsc stuff 2021-07-30 23:15:41 -04:00

README.md

Open Toontown

This repository contains the code for Open Toontown, based on the latest version of Disney's Toontown Online (sv1.0.47.38).

Setup

After cloning the repository, you will need to clone the resources repository inside the directory where you cloned the source repo.

Secondly, you would have to install and use a specific version of Panda3D, which includes libotp and libtoontown. You can use the prebuilt installers for your operating system here:

Windows

You can install Panda3D SDK through the 32-bit (x86) or 64-bit (x86_64) installers here:

Panda3D SDK for Windows (Python 3.9, x86)

Panda3D SDK for Windows (Python 3.9, x86_64)

If you install Panda3D outside the default directory (or use the x86 installer), you may have to change the PPYTHON_PATH file located in the root directory and change it to your install directory.

macOS 10.9+

Panda3D Wheel for macOS 10.9+ (Python3.9, x86_64)

Installing the provided Panda3D wheel requires Python 3.9, which is not installed on your system by default whatsoever. We recommend installing Python 3.9 through Homebrew (Make sure that the xcode command line tools are installed first xcode-select --install):

$ brew install python@3.9

(This will symlink Python 3.9 to python3.9 and pip to pip3).

After installing Python 3.9. You can then install the wheel by using pip:

$ pip install panda3d-1.11.0-cp39-cp39-macosx_10_9_x86_64.whl

Linux (Building your own)

If you use Linux, or are interested in building Panda3D yourself, head on over to our Panda3D fork and read the "Building Panda3D" section on the README file there.

Starting the Server and Game

To start the server and run the game locally, go to your platform directory (win32 for Windows, darwin for Mac and linux for Linux), and make sure you start the following scripts in order:

OTP Server -> UberDOG (UD) Server -> AI (District) Server -> Game Client

Be sure to wait till the servers have finished booting before starting the next. If done correctly, you should be able to make your toon and play the game! There is no support for Magic Words (commands) yet, but it is currently in the works!

Contributing

Submitting issues and Pull Requests are encouraged and welcome.

How you commit changes is your choice, but please include what you did and a basic description so that we know exactly what was modified. Here are some examples:

  • minigames: Fix crash when entering the trolley
  • racing: Fix possible race condition when two racers tied
  • golf: Refix wonky physics once and for all (hopefully)