Skip to main content

A library for making Terraria bots in a event driven manner

Project description


PyPI version

Terrabot is a Terraria bot API written in Python.
It is designed to be easy to use and uses the event-listener pattern.


Install the module using pip:

pip3 install terrabot

Current features

  • Joining servers
  • Chatting
  • Triggering various events, like joining, tiledata and itemdrops
  • Parsing server data to keep classes up-to-date
  • Moving the bot by teleporting


The following is a very basic bot, which will connect and handle chat.

from terrabot import TerraBot
from import Events

#Create a TerraBot object
bot = TerraBot('')
event = bot.get_event_manager()

#Connect a function to an event using a decorator
def chat(event_id, msg):
    #Do something with the message
    #In this case, stop the bot if the word "Stop" occurs
    if "stop" in msg:

#Start the bot

#And wait
while bot.running:

More examples can be found under the ‘examples’ directory. Also check the wiki for more information about the inner workings of the bot and how to interface with it.


If you want to contribute, that’s great! I would really appreciate the help. Just send a pull request and i’ll quickly check and accept it. These are some areas that need work:

  • NPC packet parsing
  • Item dropping
  • Teleporting other players (>:D)
  • Synchronizing packets like health and update-player-packets
  • Placing tiles (!)

For information about the packets, see this link.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for terrabot, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size terrabot-1.0.3.tar.gz (11.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page