knot126/Katten
2
1
Fork 0
Code Issues Pull requests Activity
Reverse engineering of the server for the Plus+ social gaming network and Touch Pets series of games
44 commits 1 branch 0 tags 260 KiB
  • Python 100%
Find a file
knot126 bb70659896
 Exprimental importing pets from cached data
2026-03-21 21:27:27 +00:00
docs Initial commit for clean repo 2025-02-13 07:08:15 +00:00
plus Pet import work 2026-03-21 20:47:33 +00:00
res Initial commit for clean repo 2025-02-13 07:08:15 +00:00
router Ability to run dogs2 server 2026-03-13 16:21:29 +00:00
tools Pet import work 2026-03-21 20:47:33 +00:00
touchpet Exprimental importing pets from cached data 2026-03-21 21:27:27 +00:00
.gitignore Moving to sqlalchemy part 1 2026-02-11 04:05:13 +00:00
LICENSE Initial commit for clean repo 2025-02-13 07:08:15 +00:00
NEWS.md Various bug fixes for things introduced during refactor 2026-02-14 19:25:14 +00:00
README.md things sometimes happen 2026-03-08 06:51:48 +00:00
run.py Ability to run dogs2 server 2026-03-13 16:21:29 +00:00

README.md

Katten Project

Katten is a reverse engineering and reimplementation of the server software for the Plus+ social gaming network and the Touch Pets series of games.

If you want to discuss or help with reverse engineering Plus+, please consider joining the Plus+ Discord server.

Status

Katten is currently in its early stages. See the project news and the Plus+ server readme for status updates and what works.

Game Status

These games are tested. Other games may work, but YMMV.

Game Notes
Touch Pets Cats (2010)
Touch Pets Dogs 2 (2010)
Touch Pets Dogs1 (2009) 		Relies on touchpet server
Rolando 2 (2009)
Topple 2 Plus (2009)
Rolando (2008) 		Only needs Plus+ server, mostly working

1 Not actually tested, but very similar to supported games and should work with minor tweaking.

Setup

Requirements

  • Up to date Linux distro
  • Jailbroken iPhone running iOS 6 or older with AppSync Unified installed
    • Newer iOS versions are not generally compatible with Plus+ games
    • Plus+ games don't run on touchHLE (yet)
    • You can probably jailbreak your device with Legacy iOS Kit
  • An IPA for the game you want to play, if it's not already installed
    • If you have the app on an old device, please consider dumping the IPA of the app before starting if you already have it on your device.
    • If it's not already installed, you will also need the Terminal and the command line version of installipa installed. You may also want to use iFile to upload the IPA to your device.

Server

Clone repo

Firstly, in a terminal, clone the Katten repo and enter the directory:

git clone https://github.com/knot126/Katten
cd Katten

Install dependencies

Install:

  • flask
  • sqlalchemy
  • argon2-cffi (optional)
  • mitmproxy (optional, for development)

On Arch Linux, you can run:

sudo pacman -Syu python-flask python-sqlalchemy python-argon2_cffi mitmproxy

Starting the server

Use run.py which will start all needed servers:

./run.py

To start the server using mitmproxy, use the --mitm argument with the mitmproxy command you prefer:

./run.py --mitm mitmweb

You can also start only the Plus+ server:

./run.py --no-touch-pets

Configuration and file storage

By default, Katten will use SQLite for its database, and everything will be stored in the .katten folder of your home directory.

Currently Katten cannot be easily confiured without editing each server's config.py.

Game

Games need to have a slight patch applied so they don't use HTTPS. There is a generic patch script provided in the tools directory that can do this. To patch a game:

  • Extract your game's main binary from the IPA; this is usually a file with the same name as the .app folder with no extension
  • Open a terminal in the tools folder
  • Run the patch script on your game's binary: ./nohttpspatch.py <path to game binary>
  • This puts out one file for each architecture the game binary supports. Choose the one that matches what your phone has.
  • Either:
    • Replace the binary in the IPA with the patched one and install it
    • Upload the binary directly to the installed app dir using iFile (just make sure it's correctly named and has the execute bit set after uploading)