rescriptoon

tooncher

automates toontown rewritten's login process

Installation

$ pip3 install --user --upgrade tooncher

Optional: Install cpulimit to enable use of parameter --cpu-limit

$ sudo apt-get install cpulimit

Optional: Install xlib and psutil for python to enable extended controls:

$ sudo apt-get install python3-xlib python3-psutil

or

$ pip3 install --user xlib psutil

Configuration

# default path: $HOME/.tooncher
accounts:
- username: toon
  password: secret
- username: ceo
  password: golf
- username: cfo
  password: train
engine_path: '/opt/Toontown Rewritten/TTREngine'

Usage

$ tooncher [username]

tooncher --help shows all available options.

Extended Controls

To enable the use of WASD keys for walking, launch tooncher with the --extended-controls option:

$ tooncher --extended-controls username

While in the game press ` (grave) to enable extended controls. Press ` again to disable.

The command line parameter --extended-controls-toggle may be used to change the toggling key:

$ tooncher --extended-controls --extended-controls-toggle slash username

Extended controls require the X Window System (X11).

Examples

$ tooncher toon
$ tooncher --extended-controls ceo
$ tooncher --cpu-limit 70 cfo

Extended Controls Default Mappings

Key	Action	Target Window
`	turn Extended Controls on / off
w	walk forward	primary
s	walk backward	primary
a	turn left	primary
d	turn right	primary
i	walk forward	non-primary
k	walk backward	non-primary
j	turn left	non-primary
l	turn right	non-primary
/	jump	non-primary
space	jump	all
e	select elephant trunk in battle	primary
f	select fog in battle	primary