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.json and edit it, basing it on config-example.json.
    • 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.
    • If override_image is added to the guild, its logo will be used instead.

Running the script

  • config.json 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.
  • Multiple guilds support.
  • Webhook URL configurable per guild.

Known Issues

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

Planned features

  • Configurable scan times.
  • Announce changes in guild attributes.



Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
guildwatcher-0.2.0-py3-none-any.whl (11.6 kB) Copy SHA256 hash SHA256 Wheel py3
guildwatcher-0.2.0.tar.gz (8.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page