Guide

Adding it, setting it up, and what to do when nothing shows up.

What the bot does

It posts games that are currently free (Epic Games, Steam, GOG) and games with a steep discount (Steam, GOG). Every server decides what arrives, which channel it lands in and how the posts look. The bot is free and does not need administrator rights.

Setup

You need the “Manage Server” permission on your server. Takes about two minutes.

  1. Add the bot.
    Use the button above or go to dealgecko.de/bot. Discord asks which server. The list only shows servers where you have the right to do this.
  2. Pick your channels: /setup
    One channel for free games, one for deals. The same channel for both works too. Optionally a role to ping on new posts.
  3. Set your filters: /filter deals
    Minimum discount, maximum price, minimum rating and how many deals per day at most. Without filters everything arrives, on some days well over a hundred offers.
  4. Check it: /test
    Shows a sample post with your settings, visible only to you. With /test im_kanal:true it really posts to your configured channels, without pinging anyone.

Prefer a browser?

At dealgecko.de/bot you can sign in with Discord and set everything up there. You also get a preview of the posts and can try your filters against today's real offers – before anything lands in your server.

Commands

The command names are German even when the bot is set to English. Discord can only translate command names per user, not per server, and a name that changes depending on who is looking causes more confusion than it solves. Everything the bot writes follows your server's language.

CommandWhat it does
/setupChannels and ping roles
/einstellungenEverything at a glance, with buttons and menus to change it
/filter gratisMinimum regular price; only games that stay in your library
/filter dealsMinimum discount, maximum price, rating, minimum reviews, deals per day
/filter woerterWords that are never posted, e.g. simulator, demo
/filter zuruecksetzenAll filters back to default. Channels, pings and profile stay.
/spracheEnglish or German for this server
/profil aendernYour own name, avatar, banner and profile text for your server
/profil zuruecksetzenBack to DealGecko's own name and avatar
/testSample post with your settings
/pauseStop and resume posting
/gratis, /dealsCurrent offers, open to everyone
/zuruecksetzenDelete every setting of this server
/hilfeShort overview inside Discord

Everything except /gratis, /deals and /hilfe is visible only to members with “Manage Server” by default. To change that: Server Settings → Integrations → DealGecko.

Permissions the bot needs

PermissionWhat for
View ChannelTo find the channel you configured at all
Send MessagesTo write the posts
Embed LinksWithout it the posts arrive as plain text, no cover image
Change NicknameOnly if you give it its own name with /profil aendern

It does not need administrator, so don't give it. It reads no messages and no member lists, and it never asked Discord for those permissions.

Nothing shows up

  • The bot lacks permissions in that channel. By far the most common case, and it goes unnoticed because the bot cannot tell you. It is not allowed to write. Open the channel's “Permissions” and check that the DealGecko role has View Channel, Send Messages and Embed Links there. Easy to miss in channels set to read-only for @everyone: that restriction applies to the bot as well unless it has its own exception.
  • The ping does not arrive. Discord only allows a role to be mentioned when “Allow anyone to @mention this role” is on for that role (Server Settings → Roles). The posts still arrive, just without the ping.
  • Your filters are too tight. 90% minimum discount together with a “very good” rating leaves nothing on most days. /einstellungen shows every value at a glance, /filter zuruecksetzen puts them back. At dealgecko.de/bot you can see how many offers a setting lets through today.
  • There is simply nothing right now. Free games do not come along every day. /gratis and /deals show what is running at this moment. If those return something and your channel stays empty, it is one of the points above.
  • The bot is paused. /einstellungen shows it at the top. /pause switches it back on.

Data

Stored: your server ID, the server name, the channels and roles to pick from, and your settings. No messages, no member lists, no user profiles. Remove the bot and your server's data is deleted. The details are in the terms and the privacy policy (German).

Still stuck?

Ask in #hilfe on our Discord server. Someone reads it.

Powered by DealGecko.de · Our channels · Terms · Privacy