CAPIdaptor is a transparent proxy server interface that allows legacy Battle.net chat clients to connect to the modern chat API. It can be found on GitHub as a compiled EXE or python source package.
I DO NOT RECOMMEND USING THE SERVER OF ANYONE HOSTING THIS OR A SIMILAR SERVICE PUBLICLY. YOU WILL BE POTENTIALLY GIVING THEM FULL CONTROL OVER YOUR CHANNEL. ONLY CONNECT TO THE SERVER THAT YOU ARE RUNNING YOURSELF.
How To Use
- Login to the account that owns the channel you want to register a bot for, join the channel, and use the /register-bot command.
- Check the email that the account is registered to and follow the steps to get an API key.
- Download and run capidaptor.exe from the GitHub page linked above.
- Set your bot’s server setting to ‘localhost’ (instead of ‘useast.battle.net’ or whatever it was before).
- Set your username to the API key that you acquired from the email. You may need to use the /setname command or modify your config directly for it to be accepted.
- Set your bot to use a product that doesn’t require a CD key (recommended) or that you have a valid CD key for (it will not actually be used the bot just has to accept it).
- Connect your bot. It should join the channel you registered. You can now interact with it like a normal bot.
- The API is not yet fully product-aware, so product or game based functions will not work (including client bans and tag bans).
- The API does not support changing channels or interacting with users outside of your channel. This includes banning people not in the channel (unbanning works though).
- Information such as ping and icons are not sent over the API so any commands of functions based on these will not work correctly.
Help & Support
Please direct any issues or support questions to the project’s GitHub issue tracker.
This adapter has been tested and is confirmed working with the following bots: