Use the invite link from your service provider. Required permissions: View Channels, Send Messages, Manage Messages, Manage Channels (for tickets), Embed Links, Attach Files, Read Message History, Add Reactions.
Enable in Discord Developer Portal โ Bot โ Privileged Gateway Intents: Server Members Intent, Message Content Intent.
/setup
admin_rolle: Admin
kontroll_kanal: nexus-control
spiele_kanal: nexus-spielesammlung
ankuendigungs_kanal: bekanntmachungen
willkommens_kanal: eingangshalle
poll_kanal_id: (right-click #polls โ Copy ID)
stammtisch_kanal_id: (right-click #bekanntmachungen โ Copy ID)
spielname_kanal_id: (right-click #gewinner-spiel โ Copy ID)
event_name: Game Night
bot_sprache: en
zeitzone: Europe/Berlin
/gameboard
/events eingabe: 31.12.25 20:00
Login via Discord OAuth at the URL provided by your service provider.
| Page | Function |
|---|---|
| Dashboard | Overview, system load, activity graph |
| Games | View, rename, delete games |
| Appointments | View appointments and pipeline status |
| Warnings | Manage user warnings |
| Notes | Admin notes |
| Announcements | Scheduled announcements |
| Tickets | Ticket list, transcripts, force-close (Pro) |
| Settings | All configuration |
| Bot Status | System gauges, task status (owner only) |
| Activity Log | Audit trail of web panel actions |
| Field | Description |
|---|---|
| Admin Role | Role(s) for bot commands. Multiple: Admin, Moderator |
| Bot Language | Discord messages: English or Deutsch |
| Timezone | For event input parsing (default: Europe/Berlin) |
| Event Name | Used in all automated messages |
| Field | Used For |
|---|---|
| Poll Channel ID | Game selection polls |
| Event Channel ID | Announcements, reminders, cancellations |
| Game Name Channel ID | Winning game name only |
| Warning Threshold DM Recipient | Discord User ID for threshold DMs |
Fully customizable. See Message Templates.
Automatic action when warning threshold is reached. See Settings โ Auto-Moderation.
See Ticket System.
All automated bot messages support placeholders.
| Placeholder | Value |
|---|---|
{event_name} |
Configured event name |
{weekday} |
Day of week in bot language |
{time} |
HH:MM |
{date} |
DD.MM.YYYY HH:MM |
{game} |
Winning game name |
{hours} |
Reminder hours |
{server} |
Server name |
{member} |
Member mention |
<t:{timestamp}:F> |
Discord auto-timezone timestamp (recommended) |
<t:{timestamp}:R> |
Relative time (e.g. "in 2 hours") |
Announcement: ๐ข **{event_name}** <t:{timestamp}:F>: The game is **{game}**!
Reminder: โฐ **Reminder:** {event_name} <t:{timestamp}:R> โ in {hours} hour(s)!
Cancellation: ๐ข The **{event_name}** scheduled for <t:{timestamp}:F> has been cancelled.
Welcome: ๐ Welcome to **{server}**, {member}!
Poll Title: ๐ฎ {event_name} ยท {date} (timestamps not supported in polls)
Available in the Pro plan.
Support,Purchase,Bug Report)Customize the welcome message
Run /ticketsetup #your-support-channel โ posts the panel embed with the Open Ticket button.
ticket-0001 โ visible only to the user, staff roles, and the bot/ticketclaim to take ownership/ticketadd <user> / /ticketremove <user>/ticketclose.txt file{user}, {topic}, {subject}, {number}, {server}
Controls all Discord-facing messages: game board, announcements, command responses.
- Set via /setup bot_sprache: en/de or Settings โ Bot Language
- Default: English
Used when parsing event times entered via /events or the web panel.
- Set via /setup zeitzone: Europe/Berlin or Settings โ Timezone
- Default: Europe/Berlin
- Full list: America/New_York, Asia/Tokyo, Australia/Sydney, etc.
All bot messages use <t:UNIX:F> format. Discord automatically converts these to each user's local timezone โ no configuration needed for readers.
Each admin can set their own display timezone (auto-detected from browser). Click ๐ in the sidebar to change. Affects how times are shown in the web panel โ independent from the guild timezone.
/setup independently/events scheduled
โ
โผ
T โ poll_before โ Game selection poll posted (default 1d 12h 30m)
Optional "Yes, but different game" button
โ
โผ
T โ reminder_before โ Reminder message (if reminder enabled, default 2h)
โ
โผ
T โ winner_before โ Poll closed, winner announced with Discord timestamp
Game name sent to game name channel
Alt-game suggestions listed (if enabled)
โ
โผ
T + delete_after โ Appointment deleted, vote counter updated (default 3h)
All four timings (poll start, winner/poll end, reminder, auto-delete) are fully configurable per guild via the web panel (Days / Hours / Minutes fields) or the /pipelineconfig command. The Discord poll duration is derived automatically as poll_before โ winner_before.
Tie handling: random selection among tied options, message notes the tie.
| Data | Purpose | Retention |
|---|---|---|
| Guild config | Bot operation | 30 days after bot removal |
| Game names & votes | Game board | Until deleted |
| User IDs (cooldowns) | Abuse prevention | Until reset |
| User IDs (warnings) | Moderation | Until cleared |
| Ticket records | Support history | Until deleted by admin |
| Ticket transcripts | Audit trail | Until deleted by admin |
| Activity log | Web panel audit | Last 500 entries |
| Deleted messages | Moderation log (Pro) | Last 500 entries / 7 days per guild |
| Ban appeals | Appeal tickets (Pro) | Until deleted by admin |
| XP / levels | Leveling (Pro) | Until manually reset |
See PRIVACY_POLICY.md / DATENSCHUTZ.md for full details.
Bot doesn't respond to commands
โ Check admin role is correct. Slash commands may take up to 1 hour to sync after first setup.
Game board button doesn't work after restart
โ Fixed automatically โ persistent views are re-registered on every bot restart.
Ticket channels not being created
โ Bot needs Manage Channels permission. Check that the ticket category ID is correct.
Ticket transcripts not appearing in log channel
โ Verify the log channel ID in Settings. Bot must have Send Messages + Attach Files permission there.
Discord timestamps show as plain text in polls
โ Known Discord limitation โ timestamps don't render in poll questions. Use {date} instead.
Times in web panel are wrong
โ Click ๐ in the sidebar and set your timezone manually.
Polls don't appear
โ Verify Poll Channel ID in Settings. Bot must have permission to send polls there.