Skip to content

Budabot/Tyrbot

Repository files navigation

Tyrbot

Tyrbot is an in-game chatbot for the MMORPG Anarchy Online released by Funcom in 2001.

This is a rewrite of Budabot in Python 3.

Quickstart

  1. Download the bot: https://github.com/Budabot/Tyrbot/archive/master.zip
  2. Unzip the bot to a location on your computer
  3. Run start.bat
  4. The first time you run the bot it will ask some questions. You will need four pieces of information: username, password, character name, and superadmin. For any other question you can simply press <Enter> to use the default value.

Requirements

Tyrbot has been tested on Python 3.9 and 3.11. You may run into issues with other versions of Python.

Installation

Tyrbot is now ready for general use and is recommended over Budabot or any other bot for all new installations.

Currently there are no releases for Tyrbot but you can download the bot from here which will always have the very latest changes: https://github.com/Budabot/Tyrbot/archive/master.zip

Then simply unzip the bot somewhere before starting it.

Upgrade

If you are already running Tyrbot and simply want to upgrade to the latest version, follow these steps:

  1. Download the latest version from here: https://github.com/Budabot/Tyrbot/archive/master.zip
  2. Unzip the bot to a new location (do not just unzip it over the top of the old installation)
  3. From the old installation, copy the ./conf, ./data, and optionally, the ./logs directories to the new installation
  4. If you have any custom modules, copy the ./modules/custom/ directory over as well
  5. Start the bot and verify everything works and that all of your data has carried over
  6. In a few rare cases, the bot may not start because the config file format changed between versions and you may need to compare your config.hjson to the template version and make changes accordingly
  7. You can now delete the old installation

Note: If you are upgrading from Tyrbot 0.5 or earlier, the config file format has changed. The config.hjson file has been replaced by config.py and you will have to go through the setup wizard again to configure the new config file.

If you want to upgrade from Budabot, follow the instructions here: https://github.com/Budabot/Tyrbot/wiki/Migrating-From-Budabot

Starting Tyrbot

To start the bot, run either start.bat or start.sh.

If it is your first time running the bot, or if the config.py file does not exist, it will take you through the configuration wizard to configure the bot. You will need to have a character name that you you want to run the bot as along with the username and password for the account that has that character. If you want to run this bot as an org bot, the character that the bot runs as will need to already be a member of that org.

Support

If you need help or support with Tyrbot, join our discord channel: https://discord.gg/2x9WesJ

Discord Module Setup

If you would like to connect your bot to your Discord server, follow this guide: https://github.com/Budabot/Tyrbot/wiki/Discord-Setup

Writing Custom Modules

See the Wiki page: https://github.com/Budabot/Tyrbot/wiki/Writing-Custom-Modules

Running in Docker

See the Wiki page: https://github.com/Budabot/Tyrbot/wiki/Docker