Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/open-toontown/open-toontown
Open source Toontown Online, based on the latest version of Disney's Toontown Online (sv1.0.47.38).
https://github.com/open-toontown/open-toontown
Last synced: 7 days ago
JSON representation
Open source Toontown Online, based on the latest version of Disney's Toontown Online (sv1.0.47.38).
- Host: GitHub
- URL: https://github.com/open-toontown/open-toontown
- Owner: open-toontown
- License: bsd-3-clause
- Created: 2019-11-02T22:24:38.000Z (about 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-09-12T00:57:58.000Z (2 months ago)
- Last Synced: 2024-09-13T06:47:36.867Z (2 months ago)
- Language: Python
- Size: 6.75 MB
- Stars: 148
- Watchers: 20
- Forks: 69
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/open-toontown/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, Last Updated: January 11, 2023)](https://mega.nz/file/6UsARa7R#pg5KgxW0NgkHEl_k0fK6NbBK8LfdEcDGZ6NsVeWwDKM)
[Panda3D SDK for Windows (Python 3.9, x86_64, Last Updated: January 11, 2023)](https://mega.nz/file/uAMxEKqL#yQfS9UPpYHzKYDR5vq-LF5gxxLa6HUmxLUp65uzneVo)
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)](https://drive.google.com/file/d/1_6WJxrkNfwisK5pe5ubJJy1psEp0IIft/view?usp=sharing)
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](https://brew.sh/) (Make sure that the xcode command line tools are installed first `xcode-select --install`):
```shell
$ brew install [email protected]
```
(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:
```shell
$ 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](https://github.com/open-toontown/panda3d) 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:
`Astron 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!](https://github.com/open-toontown/open-toontown/projects/1)
# 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)`