Pokemon TCG Pocket Bot - Arturo-1212/PTCGPB GitHub Wiki
Discord for further updates.
As of April 22, 2025: DeNA has released an update that has affected the state of rerolling. Please follow theRunning the bot
Feature 1: Rolling for God Packs (GPs) π
- Rerolls accounts opening 1 to 5 packs in mere minutes, from account creation to deletion stopping an instance if it gets a god pack.
- It can run behind windows in the background (not minimized) and does not take control of your mouse or keyboard!
- Gif of a bot run
Feature 2: God Pack (GP) Test π§ͺ
This feature is available on the Main instance only and is so you can verify if a god pack is alive or not. When toggled on, the bot will automatically remove all non-VIP friends (i.e., friends that may have pulled a live GP). When all non-VIP friends have been removed, the bot will pause, giving you the opportunity to navigate to Wonder Picks and look for God Packs. When you're ready to continue, simply toggle "GP Test" mode off. VIP friends are specified in the vip_ids.txt
file. List friend codes each on their own line.
Why would you want this?
Managing your friend list is as easy as one click! π±οΈ The bot will automatically take care of removing dead accounts, dud accounts, or simply accounts that just haven't finished rolling.
Feature 3: Extract and Inject Accounts π±
In the Accounts folder you will find an inject and extract ahk script. This is so you can inject or extract XML data which is where the accounts log-in info is saved. Run it and input the required info.
Install
Step 1: Install AutoHotKey
- Download and install AutoHotKey v1.x
Step 2: Set-Up MuMu Player
-
Download and install MuMu Player
-
Once you have downloaded Mumu Player, you can skip the entire settings part of Step 2 and all of Step 3 by downloading a preloaded instance here. [Do not touch any settings in this instance] (Current as of version 1.2.0, if the app is updated past this version, go to the Discord for the latest news and updates on the bot and the app.)
-
To set this instance up, open MuMu Multi-instance 12 and click the "+ New" button, then click on Import. Import the downloaded instance. All settings are preloaded and the app is preloaded in this instance.
-
Recommended Settings (βBold = Required)
- CPU: 2
- RAM: 2
- Less resource usage
- Forced use of discrete graphics
- βCustom: 540 (W) x 960 (H) 220 DPI
- βScreen brightness: 50
- βScreen style: Common
- FPS: 60 - Decreasing frames can reduce system resources, but might make swiping less consistent
- βDo not turn on the FPS display
- Close system sound
- βUncheck: Keep running in the background
- βCheck: Enable Root Permissions
- Exit directly
-
ποΈTODO: Setting for remember last position
-
Clone and then name your instances "1", "2", "3", "4", etc. without the quotes. π NOTHING ELSE! JUST THE NUMBER! π
- You can clone them after doing step 3, or even step 6, to give root access only once.
- Make sure there are no other instances named the same, even if they aren't running!
-
The very first instance in the multi-instance window is incompatible. just name another one 1.
Step 3: Install PTCGP
- Download the PTCGP Speed Mod APK. Latest supported PTCGP version is v1.2.0.
- Drag and drop into your MuMu instance.
- Do not move the app from where it is placed on the home screen.
- Manually open the game.
- Click the "PM" logo in top left > cog wheel > save preferences > cog wheel > minimize.
- Go through the game until it finishes downloading the initial ~1000 mb download.
Step 4: Windows settings
- βChange scale to 125% or 100% in your windows settings. Press windows key > Type "display settings" > Look for the scale setting and change it to 100% or 125% for all of your monitors.
- All Windows color filters off
- HDR off
Step 5: Download the PTCGP Bot
- Download the PTCGP Bot Latest Release zip.
- Extract it by right clicking the zip > extract.
Step 6: Start the Bot
- Run
PTCGPB.ahk
- See Bot Setup for detailed configuration options
- Press "START BOT" when ready.
- βAllow adb to run and through the firewall if it asks you
- βOn first run after pressing start you will be prompted for super user access in each instance. Select to allow forever. If you are not prompted make sure you have root settings enabled then try again.
Bot Setup
1) Friend ID
Enter the Friend ID (a.k.a. Friend Code) for your main account. This setting is typically used when not rolling in a group.
Alternatively, you can list Friend Codes for any main accounts you want to add in ids.txt
. If you are using ids.txt
, you can leave this field blank.
2) Instance Settings
- Instances - Number of MuMu rolling instances you are running.
- Columns - Number of columns when tiling instances on the screen.
- Start Delay (sec) - Delay (in seconds) between launching each AHK bot script for each instance. This can be useful to help stagger resources and friend invites.
- Run Main(s) (checkbox/field) - Check this box to run the bot for your Main instance. This will accept friend requests from rolling instances. If you are running more than one Main (i.e., alt accounts), enter the total number in the field.
3) Time Settings
- Action Delay (ms) - Standard delay (in milliseconds) between bot actions. For slower systems or connections, you may need to increase this number. For particularly fast systems, you may want to decrease this number.
- Swipe Speed (ms) - Time (in milliseconds) to execute the pack opening swipe. Again, depending on the speed of the system you may need to tune this number. If it regularly requires more than one swipe to open a pack, try adjusting this setting.
- Wait Time (sec) - Time (in seconds) the bot will wait after setting all friend requests. This gives main instances time to accept the request(s).
- Base Game Compatibility (checkbox) - When unchecked (default), the bot will attempt to run the PTCGP game at 3x speed. When checked, the bot assume you are using the base game without a speed mod.
4) System Settings
- Monitor - The monitor you want to position the MuMu windows on.
- Scale - Your Windows display scale. This should match the setting from Step 4: Windows settings
- Folder Path - Path to your MuMu install. It will default to
C:\Program Files\Netease
. If you installed MuMu in a different location, be sure to update this. - OCR and Client language - The language used for OCR and in the game.
- Launch All Mumu Delay - When using the "Launch All MuMu", this will add a delay between each instance launch. This can help stagger resource use and prevent errors.
- Auto Launch Monitor (checkbox) - When checked, the bot will also monitor roll instances and automatically restart them (both MuMu and the bot) whenever a run doesn't complete after 15 minutes.
5) God Pack Settings
- Min. 2 Stars - Minimum number of 2 star cards (usually reported as X/5) for a GP to be considered valid. GPs with fewer 2 stars will be considered invalid by the bot. π§ͺ
- 2* for SR (i.e., Minimum 2 stars for valid GPs from Shining Revelry booster) - Same as above, but only applies to Shining Revelry booster packs. π§ͺ
- Method (dropdown)
- 3 Pack - A new account will be created and 3 packs will be opened.
- 5 Pack - A new account will be created, 3 packs will be opened, friends will be removed and re-added (to minimize testing), then 2 more packs will be opened.
- 5 Pack (Fast) - A new account will be created and 5 packs will be opened.
- Inject - Existing account XML will be injected and 2 stamina packs will be opened.
- 1 Pack Method (checkbox) - Compatible with "Inject" or "Pack" methods above. When checked only 1 pack will be opened during each run.
- Menu Delete Account (checkbox) - Only compatible with "Pack" methods. When checked, roll accounts will be deleted, rather than removing friends at the end of a run. When not checked, account XML will be saved off for later use with the "Inject" method.
π§ͺ Note on GP Test Mode:
- When clearing accounts from Main for GP Test mode, packs with star counts not matching your threshold will be ignored (i.e., they will not be counted as VIP accounts and will be removed).
- If pack name is "Shining", it will take the minimum 2 star setting for Shining Revelry pack
- If pack name is any other pack, it will take the regular minimum 2 star setting.
- If pack name is empty, it will take the lowest setting of minimum 2 stars between Shining Revelry pack and other packs
6) Pack Selection
Check any booster pack(s) you wish for the bot to open. Each run, packs will be chosen randomly from those selected here.
- Shining, Arceus, Palkia, Dialga, Pikachu, Charizard, Mewtwo, Mew (checkboxes)
7) Card Detection
- Single Full Art, Single Rainbow, Single Trainer (checkboxes) - When checked, non-GP packs opened with these cards will be saved and treated as a valid pack.
- Double 2 Star (a.k.a. "Demigod pack") (checkbox) - When checked, non-GP packed opened with at least two 2 star card will be saved and treated as a valid pack.
- Only for Shining Booster (checkbox) - When checked the above settings will only apply to Shining Revelry booster packs.
- Ignore Invalid Packs (checkbox) - Typically card detection option above don't account for other cards in the pack which may invalidate. When checked, Crowns, Shinies, and Immersives, will be invalidate an otherwise valid pack.
- Save Crowns, Save Shiny, Save Immersives - These cards will invalidate a God Pack and typically the account will not be saved. When checked, these invalid GPs will still be saved.
8) Discord Settings
- Discord ID - Your Discord ID.
- Webhook URL - Discord Webhook URL to use for sending found pack alerts.
- Send Account XML (checkbox) - When checked, the extracted account XML for rolling accounts is included Discord found pack alert. This can be useful for GP rolling groups, as anyone can inject the account to check for WP thanks.
9) Heartbeat Settings
- Discord Heartbeat (checkbox) - When checked, the bot will also send periodic "heartbeat" messages with the current status of all instances, to show the bot is active.
- Name - Identifier used in the heartbeat messages. Many groups use Discord ID here, but others may prefer a more readable identifier.
- Webhook URL - Discord Webhook URL to use for sending heartbeat messages.
- Heartbeat Delay (min) - Time (in minutes) between each heartbeat message. You should never make this number lower than your average run time. Default is 30min and nothing under 10min is recommended.
10) Download Settings
- ids.txt API - Friend IDs (codes) for each rolling instance to add (see Friend ID above). Each friend code should be listed on it's own line. For example:
0732320089993732
8076495484487199
2666277997152062
- vip_ids.txt (GP Test Mode) API π§ͺ - Friend IDs (codes) to keep during GP testing. Non-VIP accounts will be unfriended by main (see God Pack (GP) Test above). Supported data elements are friend ID (code), friend name (in game name), star count of found pack, booster of found pack. At a minimum, you must include either the friend ID (code) or friend name (in game name). Including both will improve account matching accuracy. Including the star count and/or booster will apply additional filtering (see Note on GP Test mode above for details). If pack star information is not provided, the account will NOT be excluded from the VIP list. Example file content:
0735520049083732 | Nate0562 | 1/5 | Shining
8076495483324199 | CheryS6334 | 4/5 | Arceus
2666277563052062 | CCdarumaka | 3/5 |
| CCdarumaka | 3/5
0432320089993732
9113546477664971 | | 5/5 | Charizard
Troubleshooting
FAQ
License
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0), which allows you to use, modify, and share the software only for non-commercial purposes. Commercial use, including using the software to provide paid services or selling it (even if donations are involved), is not allowed under this license.