Distribution - kwsch/SysBot.NET GitHub Wiki

When trade bots do not have any trades to make, they will do nothing until another user enters the queue. If you prefer to keep the bots busy, you can use distribution trades to distribute Pokémon from a pool on a specific link code. Distribution trades only occur when nobody is in the queue.

Ledy Functions

In prior generations, trade bots were able to perform automated trades across the GTS.

  • Users would upload a Ledyba with a specific nickname.
  • When the bot sees their Ledyba with a specific nickname, it fulfills the trade with something matching their specific request.
  • With SysBot, we can optionally perform similar functions to allow your randomly matched trade partners some control in what is traded to them.

Setup

  1. Your bot must be configured as one of the trade bot types: LinkTrade, Seedcheck, Clone, Dump, or FlexTrade. Do not set your bot to "Idle" if you want it to do Distribution trades.
  2. Set the Distribution > DistributeWhileIdle field to True.
  3. Create a distribution folder and fill it with legal Pokémon files. They should be pk8 for SWSH, pb8 for BDSP, pa8 for LA, and pk9 for SV. Pokémon skipped by anti-spam checks or because they are title legendaries only affect Surprise Trade in SWSH, not Distribution Trades. You must have Pokémon from at least 2 different trainers.
    • Name your files in the distribution folder with unique names if you want to use Ledy Functions. Make sure they aren't bad words (wordfilter).
    • Read the logs for any errors when loading the distribution pool. Make sure you scroll all the way to the top for when the bot is first started.
  4. Set the path to the Distribution folder under Operation > Folder > DistributeFolder to specify where your files are stored.
  5. In the Distribution settings, set the LedySpecies the trade partner must offer in to unlock this function (default Wooloo).
    • To disable this restriction and allow any species (only check nicknames), set the LedySpecies to None.
  6. For each cycle, the bot will pick a Pokémon from the pool and attempt to trade it on the provided link codes. It will go in order the first round, then after every Pokémon has been attempted once, it will shuffle the order if the Shuffled setting is toggled.
    • If the trade partner shows a Pokémon with a nickname matching one of your magic filenames, the bot will swap and trade that Pokémon instead!

If you add new PKM files to the distribution folder, you must use $poolreload or restart the program to have it load them in!

Settings

  • DistributeWhileIdle: Toggles idle distribution on or off.
  • Shuffled: The bot will trade all Pokémon in the Distribution folder in order the first pass and then shuffle the order when it starts over each time.
  • LedySpecies: If set, the bot will require a matching species for a Ledy swap via nickname. If species does not match, then a random Pokémon will be sent. Set this to None if you accept any species.
  • LedyQuitIfNoMatch: When set to true, the bot will quit Random Distribution trades if the offered Pokémon does not match a nickname or the set species.
  • TradeCode / RandomCode: If RandomCode is enabled, the bot will randomize Link Codes with MinTradeCode and MaxTradeCode under the Trade category. Otherwise, it uses the code specified in TradeCode.
  • SynchronizeBots: If multiple distribution bots are active, this allows them to start trades at the same time. It is recommended to have all bots block each other to avoid matching.
  • SynchronizeDelayBarrier: Amount of time in seconds to wait once all bots are prepared to start a trade.
  • SynchronizeTimeout: Amount of time in seconds to wait before all bots are released, even if not all bots are ready.
  • RemainInUnionRoomBDSP: BDSP only. If true, instructs the bot to remain in the same Union Room to start new trades.