Skip to main content

A discord webhook to track Tibia guild changes.

Project description


A discord webhook that posts guild changes (member joins, members leaves, member promoted) in a Discord channel.

Travis (.org) GitHub (pre-)release PyPI PyPI - Python Version PyPI - License


Install and update using pip:

pip install guildwatcher -U


Install the latest version from GitHub

pip install git+ -U


Download/Clone files, install requirements and run

pip install -r requirements.txt

Configuring Webhooks

  1. On the desired channel, go to its settings and click on the Webhooks section.
  2. Click on Create Webhook.
  3. Customize the avatar as needed.
  4. Copy the webhook's URL.
  5. Create a file named config.yml and edit it, basing it on config-example.yml.
    • The top level webhook_url will be used, but if you want another guild to use a different URL, you can specify one for that guild.

Running the script

  • config.yml must be in the same directory you're running the script from.
  • The script generates .data files, named after the guilds, these save the last state of the guild, to compare it with the current state.

If installed using pip, you can run the script in one of two ways:



python -m guildwatcher

Current Features

  • Announces when a member joins.
  • Announces when a member leaves or is kicked.
  • Announce when a member is promoted or demoted.
  • Announce when a member changes name.
  • Announce when a member's title is changed.
  • Announce when a new character is invited.
  • Announce when an invitation is revoked or rejected.
  • Announce when the guildhall changes.
  • Multiple guilds support.
  • Configurable scan times.
  • Webhook URL configurable per guild.

Known Issues

  • Renaming a rank would trigger all rank members getting announced as leaving and joining back.

Planned features

  • Announce changes in guild attributes.
    • Application status
    • Disband warning



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 guildwatcher, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size guildwatcher-1.0.0-py3-none-any.whl (9.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size guildwatcher-1.0.0.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page