Daffy's Mods
← All buildsBots

Toontown Classic with Bots

Toontown Online as it played at its September 2013 shutdown, on your own PC, with a town full of bot toons that play like real players.

  • Updated Oct 4, 2026
  • 6 pictures
  • 12 updates
Toontown Classic with Bots, first picture

About 420 bots start as fresh level-1 toons and level up by playing: they work their own ToonTasks, fight Cogs as a team, take back Cog buildings, run factories and boss battles with you, fish, ride the trolley and play every trolley game, dress up for Halloween, and answer the game’s own SpeedChat (“Follow me.”, “Can you help me?”, “Help!”). Under the bots is Open Toontown (the open-source Toontown client and server) plus my crash fixes and the server pieces that were still missing (estates, parties, fishing, the catalog, holidays). It is a non-commercial fan project for playing at home with friends.

Status: playable; we play it on a home server with about 420 bots. Bot levelling is new (2026-09-30) and still being play-tested; bot features not yet seen on the live server are marked below. The install steps follow the repo’s own scripts but have not been re-tested on a fresh PC. · Visibility: public · Last updated: 2026-10-04

Screenshots

A bot fights a Cog beside a player on a Donald’s Dock street A bot in a Halloween costume throws a pie in a street battle
A bot joins your street battle on its own (the Cog is aiming at the bot). Bots pick and throw their own gags.
Two bots and a player at the top floor of a Cog building as the Cogs come out of the elevator A bot fishing at the Toontown Central pond while another bot says “Let’s go fishing!”
Two bots took a three-floor Cog building with a player, floor by floor. Bots fish, and chat with the game’s own SpeedChat.
A bot in Halloween clothes says “I think this place is haunted.” A bot with a pumpkin head says “I need a Toon-Up.”
In October the bots dress up and add the Halloween SpeedChat lines. A pumpkin head from the Trick-or-Treat hunt, and a bot asking for a Toon-Up.

All shots are from the game itself (a test copy of my server, Halloween event on). The bots shown were all logged in and acting on their own; my test toon is the one with the blue name.

Contents

Bot features

All of this is in toontown/bots/ and runs on my server today, unless an item says otherwise. A bot does everything with the same messages a game client sends, so the game’s own server rules (prices, laff, carry limits, elevator checks, ToonTask rules, fishing catches) apply to bots exactly as they apply to you. The only things written straight into the database are a bot’s starting toon, the Cog HQ crew’s Cog suits and gags, and Halloween costumes.

Who the bots are

Life in town

Chat

Your commands (the game’s own SpeedChat)

Say these out loud near bots, or whisper them to one bot (a friend or not):

Asking for and giving help

Battles

Cog buildings, Cog HQ and bosses

Levelling up like a player

Fishing, the trolley, shops and estates

Halloween

On the server

Tools (toontown/bots/tools/)

Game features

Requirements

What Version / detail Where to get it
OS Windows 10/11 64-bit (server and client). Linux works for the server if you build Panda3D and Astron. macOS: upstream builds exist, not tested here.
Panda3D Open Toontown’s Panda3D 1.11.0 build with Python 3.9. It includes the libotp and libtoontown modules the game needs, so stock Panda3D from pip does not work. Windows installers and the macOS wheel: Open Toontown setup. Source: open-toontown/panda3d
Python packages pytz (requirements.txt) pip
Astron (server cluster) Included for Windows (astron/win32/astrond.exe) and macOS (astron/darwin/). Linux: build it yourself. Astron
Database Nothing to install. Astron uses its YAML backend (astron/databases/astrondb/). MongoDB is not needed.
Game resources Models, textures, sounds and music. Not in this repo. open-toontown/resources
Git To clone the two repos. git-scm.com
Network Only for players on other PCs: TCP port 7198 open on the server PC.

The server side is five processes on one PC (Astron, UberDOG, AI, bot AI, plus your game client). With the full bot pool, the bot AI is the busiest of them; lower the bot numbers (see Bot settings) if the server PC struggles.

Install

Windows (PowerShell)

  1. Install Git from git-scm.com.
  2. Install Open Toontown’s Panda3D 1.11.0 (Python 3.9, x86_64) using the Windows installer linked in the Open Toontown setup. Keep the default folder C:\Panda3D-1.11.0-x64.
  3. Get this repository and the game resources. <install-folder> below is the folder you choose:
    cd <install-folder-parent>
    git clone https://github.com/DaffyDabz/toontown-classic-bots.git
    cd toontown-classic-bots
    git clone https://github.com/open-toontown/resources.git resources
    The resources must end up in a folder called resources inside the repo (the game reads model-path resources).
  4. Point the scripts at Panda3D’s Python. The file PPYTHON_PATH holds the path, in quotes:
    Get-Content PPYTHON_PATH
    # "C:\Panda3D-1.11.0-x64\python\ppython.exe"
    If you installed Panda3D somewhere else, put your path in that file (keep the quotes).
  5. Install the Python package:
    $py = (Get-Content PPYTHON_PATH).Trim('"')
    & $py -m pip install -r requirements.txt

Linux

  1. Build Open Toontown’s Panda3D fork for Python 3.9 (see “Building Panda3D” in open-toontown/panda3d). The scripts run python3, so python3 must be the Python that has this Panda3D.
  2. Build Astron and put the astrond binary in astron/linux/ (the script expects astron/linux/astrond; create the folder).
  3. Get the code and resources, then the Python package:
    git clone https://github.com/DaffyDabz/toontown-classic-bots.git
    cd toontown-classic-bots
    git clone https://github.com/open-toontown/resources.git resources
    python3 -m pip install -r requirements.txt
    mkdir -p astron/linux && cp /path/to/astrond astron/linux/

macOS

Open Toontown’s macOS wheel (Python 3.9) and the darwin/ scripts come from upstream. They are kept but I have not tested them.

Run / Play

Start the parts in this order, each in its own window, and wait until each one has finished booting before you start the next:

Astron -> UberDOG -> AI (district) -> bot AI (optional) -> game client

Windows

Open a PowerShell window for each server. The .bat scripts must be started from the win32 folder.

cd <install-folder>\win32
.\start_astron_server.bat      # window 1: Astron (message director, client agent, state server, database)
cd <install-folder>\win32
.\start_uberdog_server.bat     # window 2: UberDOG (friends, parties, mail, codes, logins)
cd <install-folder>\win32
.\start_ai_server.bat          # window 3: AI for the district "Toon Valley" (restarts itself if it stops)
cd <install-folder>\win32
.\start_bot_ai.bat             # window 4: the bot toons (optional; restarts itself if it stops)

Then the game:

cd <install-folder>\win32
.\start_game.bat

Linux

cd <install-folder>/linux
./start-astron-server.sh       # window 1
./start-uberdog-server.sh      # window 2
./start-ai-server.sh           # window 3
./start-bot-ai.sh              # window 4: the bot toons (optional)

The bot AI must use the message director port in astron/config/astrond.yml (7199); the start scripts pass it.

First steps

Playing from another PC

  1. On the server PC, allow TCP port 7198 in through Windows Firewall (an administrator PowerShell):
    New-NetFirewallRule -DisplayName "Toontown Classic" -Direction Inbound -Protocol TCP -LocalPort 7198 -Action Allow
  2. On the other PC, install Panda3D, this repo and the resources as above, then start the client with its own account name and the server’s address:
    cd <install-folder>
    $env:LOGIN_TOKEN = "player2"
    $env:GAME_SERVER = "<server-ip>"
    $py = (Get-Content PPYTHON_PATH).Trim('"')
    & $py -m toontown.launcher.QuickStartLauncher

Anyone who can reach port 7198 can log in with any name, so keep the server on your home network.

Bot settings

Turning bots on and off

How many bots, and where

Add these keys to etc/Configrc.prc (the bot AI reads it) and restart the bot AI:

Key Default What it does
want-bot-toons #t #f = the bot AI starts no bots
bot-pool-size 480 how many bot toons exist in the database. Bots 301-360 are the Cog HQ crew, so below 361 the crew is partly or fully missing. Raising it adds new level-1 bots
bot-cap 420 most bots online at once
bot-create-per-sec 4.0 how fast new bot toons are written to the database
bot-logins-per-sec 5 how fast bots log in
bot-moves-per-sec 3 how many bots may move between areas per second
bot-rotate-every 2.0 seconds between rotation moves (bots moving between their home playground, streets and shared places)
bot-registry-file astron/databases/bots.json the list of bot accounts and toons (keep it with the database)
bot-run-dir ../run folder for the on/off switch, status and logs, relative to the folder you start the bot AI from. The default puts it next to the install folder; bot-run-dir run keeps it inside
halloween-all-october #f see Configuration; bots dress up for the season too

Example:

# etc/Configrc.prc - a smaller town
bot-pool-size 200
bot-cap 150
bot-run-dir run

Where bots go is decided once a second by the director (toontown/bots/BotDirector.py):

These are constants in the code, not config keys: change them there and restart the bot AI.

Status and logs (in the bot run folder)

File What
bots-status.txt / .json online bots, per-area counts, real players seen, errors (every 5 s)
bots-progress.txt / bots-progress.log levelling: tiers, ToonTasks held, every goal change and level-up
bots-picks.log one line per gag pick with the reason, plus help calls
bots-battle.txt, bots-coghq.txt, bots-life.txt, bots-p9.json, p6_trolley.json counters for battles, Cog HQ runs, playground life, player commands and the trolley
bots-space.json personal space counters (stops moved to a free spot, steps aside) and their cost, every 30 s

The bot AI also prints [TTBOTS] lines in its window ([TTBOTS-HWN] for Halloween).

Test switches (in the bot run folder)

These are for testing; nothing needs them in normal play.

File What it does
bots-coghq.cmd one run per line, e.g. factory 4 front, mint 3 coin, stage 4 a, cgc 4 front, vp 6: picks free eligible bots, sends them to that facility or boss and starts the run. bossruns on allows bot-only boss runs (off at every start). Renamed .done once read
bots-w2test.txt one line each, run once: phone auto, mailbox auto, friend auto (or a bot key / toon id) sends a bot on an estate phone or mailbox trip, or makes two bots friends
bots-street.on, bots-moves.on while the file exists, samples street life (bots-street.jsonl) or every finished move (bots-moves.jsonl)
bots-gaps.on while the file exists, every pair of toons standing closer than 2.5 ft (how long, what each was doing) and a count every 30 s go to bots-gaps.jsonl

Configuration

etc/Configrc.prc is read by the client, the AI, UberDOG and the bot AI. Restart the servers after editing it.

Key Value here Meaning
want-cogdominiums, want-new-cogs, want-new-species, want-photo-album, want-news-tab, want-minigame-difficulty, want-emblems #f never live in 2013, so off
want-chinese, want-checkers, want-findfour, want-game-tables #t picnic-table games, live in 2013
want-news-page #f the in-game news page crashed on click
accept-clock-skew 0 other toons (and bots) no longer step backwards
skip-friend-quest, skip-phone-quest true upstream’s TEMPORARY switches: the “make a friend” and estate-phone ToonTasks are skipped
halloween-all-october not set (off) add halloween-all-october #t to run the decorations, Trick-or-Treat, black cats and costumed characters from Oct 1 to Nov 1 and open the Halloween catalog on Oct 1. The Bloodsucker invasions keep their 2013 dates (Oct 31 / Nov 1). Off = the 2013 dates
game-server, server-port not set / 7198 client only: server address and port (the GAME_SERVER environment variable does the same)
accountdb-local-file astron/databases/accounts.json login name -> account
coderedemptiondb-local-file astron/databases/coderedemption.json redeemable codes (none are included)
server-data-folder data UberDOG data store (the Trick-or-Treat hunt is saved here)

Ports and channels (from astron/config/astrond.yml and the start scripts):

Part Address / channel
Client agent (players connect here) 0.0.0.0:7198
Message director (servers connect here) 127.0.0.1:7199
Event logger 127.0.0.1:7197
UberDOG / AI / bot AI channel ranges 1000000 / 401000000 / 402000000
State server / database control channels 4002 / 4003

How it works

 game clients ──TCP 7198──► Astron (client agent, message director, state server, YAML database)
                               ▲              ▲                 ▲
                         UberDOG          AI (district)      bot AI
                  (logins, friends,   (playgrounds, Cogs,  (every bot brain, the director,
                   parties, mail,      battles, ToonTasks,  walk maps, battle brain)
                   catalog, codes)     estates, holidays)

Project layout

Folder / file What lives there
toontown/ the game: client (Distributed*.py), AI (*AI.py) and UberDOG (*UD.py) code
toontown/bots/ the bot toons: BotAIStart.py (process), BotDirector.py, BotPool.py, BotToon.py, battlebrain.py, gagplan.py, taskplan.py, progress*.py, social.py, halloween.py
toontown/bots/activities/ what bots do: playground, street, battle, Cog buildings, Cog HQ, bosses, fishing, trolley, ToonTasks, home (estate phone and mailbox), help calls, player commands
toontown/bots/minigames/ a bot brain for each trolley minigame
toontown/bots/coghq/ Cog HQ levels, boss rounds, crew suits and gag loadouts
toontown/bots/walkmaps/, toontown/bots/tools/ baked walk maps and the tools that bake and check them
otp/ the OTP engine layer (login, avatars, chat, friends, settings)
etc/ Configrc.prc (settings), toon.dc and otp.dc (network object definitions)
astron/ Astron binaries (win32/, darwin/), config/astrond.yml, databases/ (game database, accounts, bot registry), logs/
win32/, linux/, darwin/ start scripts (and VS Code tasks) per OS
resources/ game art and sound: not included, clone open-toontown/resources here
PPYTHON_PATH Windows: the Panda3D Python the .bat scripts use
CHANGES.md file by file: every server file ported or fixed, where it came from, and the 2013 behaviour it restores

Development

Changes from Open Toontown

Everything in git log origin/develop..develop (101 commits, 2026-09-22 to 2026-10-01), grouped. CHANGES.md lists every server file ported or fixed, with its source and the 2013 behaviour it restores.

Merged Open Toontown pull requests

Server pieces filled in (files that were empty shells in Open Toontown, filled from Disney’s original 2013 server code with only Python 3 fixes, or built where no original exists)

Crash and freeze fixes

Client options - rebindable modern controls and camera, borderless full screen by default, accept-clock-skew 0.

Halloween - the halloween-all-october switch, the “Trick or Treat!” phrase given at login while Trick-or-Treat runs, bots in costume.

Bot toons (toontown/bots/, 2026-09-23 to 2026-10-01) - everything in Bot features: the bot AI process, friends and Details for bots, the pool and director, walk maps, playground and street life, fishing, trolley and every minigame, the battle brain, Cog buildings, Cog HQ and bosses, SpeedChat commands, load work for ~420 bots, battle sense, help calls, running from lost fights, levelling from 1 with ToonTasks, and Halloween.

Coming soon

Keep this list current: when an item ships, move it to Recent changes with the date, then add what is next.

Recent changes

Credits and license

License: BSD 3-Clause, see LICENSE (Open Toontown’s). My changes are released under the same terms.

More builds

BotsClub Penguin BotsBot penguins for a private Waddle Forever Club Penguin server.Updated Oct 28, 20263 picturesBotsCS:GO BotsSmarter bots for a private, offline CS:GO LAN server (the legacy 1.38.8.1 build).Updated Oct 28, 20262 picturesGames & modsCustom Toontown ServerMy own take on Toontown Online, built on Open Toontown (the open-source Toontown client and server).Updated Oct 28, 20266 pictures