The control panel is the main interface. Start it with ptcgp-private-server.exe.
You can use a rooted Android emulator or a rooted physical phone. A phone can connect over USB or Wi-Fi ADB; follow the phone connection guide before starting Local mode. The device selector, account exclusivity, and mode controls work the same way for either kind of device.
Connect rooted Android device → Open panel → Prepare data if prompted → Local
→ Open a local profile → Finish playing → Official (or Stop all)
- Connect the Android device and open the control panel. On a new installation, wait for the game data import to finish; select the device if prompted.
- Select Local and wait for Private server active. Local mode is available only after preparation succeeds and the device is connected.
- Open an account from the Accounts page. To play on a second device, select it beside Refresh, enable Local, and open a different account. The first game keeps running. Accounts in use show their device in the account list and cannot be launched elsewhere.
- Make any profile or pack changes from the panel.
- Before using an official account, select Official.
- Use Stop all when you want to restore all managed devices and close the local tools.
Local and Official act only on the selected device. Stop all stops the servers and restores all managed devices, then closes the panel. If a device is disconnected, its restoration is deferred until it is reconnected. Switching the selected device never reruns the shared data import.
Do not launch an official account while Local mode is active.
After the first import, the panel can open Accounts using prepared data even when the device is offline. Reconnect it before enabling Local mode. If preparation stops or reports an error, use Retry preparation on the preparation page; see Preparation and updates for recovery details.
Local mode checks the supported client and patch hashes on the selected device, starts its private server, installs temporary Android routing and the local certificate, and creates its ADB tunnel. The server starts while Android is configured. If the device still carries a verified Local setup (for example after the panel restarted), only the server and the ADB tunnel are restored. Other devices keep their current mode. The game is not opened until you select Open account. While a switch runs, the control bar shows its current step.
Official mode closes the game on the selected device, restores its verified native-library backup, removes its local routing and Android certificate, and stops its private server. Its account becomes available on another emulator. Other game sessions continue running. Your profiles remain on disk and the control panel stays open.
Stop all closes the games and performs the same Android restoration as Official mode on every managed device, all at once, stops their private servers, and closes the control panel after successful shutdown. A device that was never switched to Local has nothing to restore: it is not searched for when it is missing. If a device with local changes is unavailable, its server stops immediately and Android restoration is recorded for the next time that device is detected by the launcher.
Settings → Remembered devices lists every device the panel has managed, connected or not. Forget removes an obsolete one (its ports, runtime files and account reservation). The selected device, a device whose server runs, and a device that still needs restoration cannot be forgotten: reconnect the latter and switch it to Official first.
The Accounts page manages profiles that exist only in the local database.
Select New account, then choose:
- Empty account for a clean inventory; or
- God account for cards, resources, and accessories, including the number of card copies per language.
Set the name, level, and experience, then create the account. You can duplicate an existing profile when you want a safe starting point for experiments.
Choose a profile in the left column. The editor is split into:
| Section | What it changes |
|---|---|
| Profile | Name, level, experience, tutorial state, icon, and emblems |
| Resources | Currencies and other item quantities |
| Cards | Collection quantities by card and language |
| Battle | Playmats, sleeves, and coins |
| Showcases | Binders and display boards |
Profile identity changes require Save profile. Inventory changes are applied from their own controls.
The selected device must be connected. Select the profile, then Open account: Local mode is enabled first when it is not already active. The launcher writes that device's local account state and starts its game. Opening another profile on the same device replaces that game session without repeating data preparation.
A profile can run on only one device at a time. Accounts in use display their device and cannot be opened elsewhere. Select Official on that device, or Stop all, to release the account. The panel also releases it after detecting that its game or server has stopped.
Deleting a local profile is permanent. It does not delete or change an official account. A profile in use must be released before it can be deleted.
Pack Studio controls the result of future local pack openings. Its active rule is shared by all local profiles.
- Official odds keeps the normal pack behavior.
- Force one table uses a chosen compatible draw table.
- Force one rarity guarantees a chosen rarity where available.
- Five cards defines an exact composition for a selected pack.
- Nonstandard pack can change pack count, cards per pack, duplicate rules, catalog filters, free openings, and the random seed.
Review the summary before selecting Activate this rule. A fixed seed is useful for reproducing the same random draw. Remove or replace experimental rules when you want normal behavior again.
The Traffic page follows the selected device's sanitized HTTP and gRPC exchanges while its local server is running. Saved traffic history also belongs to that emulator. You can pause the live view, filter by protocol or status, and inspect decoded request and response previews.
Sanitization reduces accidental exposure but is not a guarantee that every value is safe to publish. Review exported or copied traffic before sharing it.
The Logs page follows launcher and mode-change events. Filter by operation, show only warnings and errors, or export a text copy for your own diagnosis. Technical process output is available in the expandable section at the bottom.
Never publish logs without reviewing device identifiers, local paths, and account-related values.
Settings controls the interface language, light or dark appearance, theme
colors, and interface size. These preferences are stored in data/desktop.json
and do not change the game or local profiles.
- Select Stop all and wait for shutdown to complete.
- Confirm that no launcher or server process is running.
- Copy the entire
data/directory to a private backup location.
Keep data/ private. Do not back up or share certs/ unless you understand the
security implications; certificates are regenerated automatically for a fresh
installation.
ptcgp-private-server.exe rem Open the control panel
ptcgp-private-server.exe local rem Enable Local on the selected device and open the panel
ptcgp-private-server.exe online rem Restore Official on the selected device and open the panel
ptcgp-private-server.exe stop rem Restore all managed devices and stop everything
ptcgp-private-server.exe status rem Print the selected device's stateFor automation-friendly JSON and device-selection options, see the configuration reference.