Emily's Workshop

Wowtoken.app GoblinBot

GoblinBot is a Discord bot that lets you sign up for alerts on the token price, using data from wowtoken.app, and is a part of the wowtoken.app project.

If you want to get started using the bot, jump to the section below.

Please note, this is an early beta rendition of this project, and you may encounter outages, errors, or otherwise incorrect data. I have done my best to be robust in engineering it but I am certainly not infallible.

If you have been invited to the beta by me, welcome. This is a public beta, so even if you weren’t privately invited, I hope you enjoy.

This stores as minimal data as it can for it’s functionality, right now just your discord ID so it can message you when an alert fires, and what alerts you are subscribed to.

Source

The source for GoblinBot is currently only available on my Gitea repository. When this is promoted to a 1.0 release, it will be mirrored to GitHub and requests for features will be able to be made there, much like the wowtoken.app main site:

Roadmap

Currently the project is pre-1.0 release, and is in a public beta. The following are features and when they were implemented, as well as planned features and when they are planned to be implemented

Planned:

  • Future
    • Remove the need for intermediate Discord server for initial bot registration (have the bot immediately initiate a DM with the user if possible)
  • 1.1
    • Specific Price alerts (alert when token hits a specific price point)
  • 1.0
    • Initial Feature complete
    • Major bugs squashed

Done:

  • 0.9.3
    • Localize timestamps using Discord’s timestamp format
    • Log when alerts are being sent so container updates can happen when that’s not happening
      • Ideally we would catch the stop signal as well but that’s going to be a future me problem
  • 0.9.2
    • Suppress a new bug introduced by 4cd7e6284b which itself was a bug fix (this suppresses the error output to Discord but the 404 from one of the components still exists and should be investigated)
  • 0.9.1
    • Remove redundant registration flow, register the user when they add their first alert
  • 0.9
    • User Registration and de-registration
    • Alert addition and removal
    • Alerting through DMs
    • Listing of subscribed alerts
    • Ability to query current price of Token

Getting Started & Help

Registering with the Tracker

The tracker is a Discord User Application, meaning you have to add it as an integration to your Discord account. This gives it permission to send you DMs, and allows you to use the commands anywhere, though the responses are ephemeral so only you see them.

  1. Add the app to your Discord account here. It should look like this:
  2. (Optional) Visit the Wowtoken.app Bot Discord here. This is a temporary measure so you can immediately start interacting with the application, but may be used for enhanced functionality in the future. You do not need to stay in the Discord to use the bot
    • You should have access to the bot commands regardless, this just makes it immediate in case your Discord client does not immediately add them to your command list
  3. Add your first alert using /add-alert (see below)

Adding an Alert

Currently you can add up to 25 alerts.

  1. Run /add-alert
    • If you have not added an alert before, you will be prompted to chose a region first.
  2. Select a version of WoW
  3. Select the kind of alert
  4. Select a time period to alert on
  5. You’ll now start to receive alerts when those thresholds are hit

Listing Alerts

You can list all of the alerts you have registered for using /list-alerts. It will show all alerts you have as well as some information about the last time those alerted.

Removing Alerts and Registration

You can individually remove alerts or your entire registration.

To remove a given alert, use /remove-alert and select the alert from the list of registered alerts.

To remove your entire registration, deleting all data associated with you and this application, use /remove-registration

Current Command

The /current and the /current_classic commands will retrieve the latest price of the token (up to date within about a minute of the live price) and display it for you, along with some other information about it and display it conveniently in Discord.