GrumpyCore — Wiki

Willkommen im offiziellen Wiki für GrumpyCore, den Discord-Bot von Minetechworld.de.

Entwickelt von darksoon · GitHub

---

🚀 Schnellstart

1. Dateien auf den Pelican-Server hochladen
2. configs/config.yml ausfüllen → Konfiguration
3. Bot starten — Verify- und Ticket-Panels werden automatisch gepostet
4. Fertig!

Keine .env mehr nötig, keine Message-IDs mehr von Hand kopieren — alles läuft über configs/config.yml und die Datenbank.

---

🛠️ Tech Stack

Was	Womit
Framework	Sapphire.js 5.5
Datenbank	Prisma 7 — SQLite (Default) / MySQL / MariaDB / PostgreSQL
Validierung	Zod 4
Discord	discord.js 14
Node.js	20+
Sprachen	Deutsch 🇩🇪 / Englisch 🇬🇧

---

📚 Inhaltsverzeichnis

⚙️ Setup

• Installation — Pelican Panel, Bot starten, Console-Commands
• Konfiguration — config.yml, alle IDs eintragen

🔧 Core-Module

• Welcome — Welcome-Banner, Verifizierung, Leave-Nachrichten
• Moderation — Mod-Tools, Auto-Mod, Anti-Nuke, Reports, Server-Audit-Logger
• Tickets — Multi-Panel-System, Forms, Auto-Close, Reopen
• News — News per DM posten
• Voice — Join-to-Create Voice-Channels mit Owner-Rechten
• Music / Radio — Internet-Radio (TechnoBase.FM & Co.) im Voice-Channel
• Help — Auto-deployter Help-Hub mit Modul-Dropdown
• Custom Commands — Admin-definierte Slash-Commands (/cc add, /cmd)

🆕 Neue Module

• Reaction Roles — Self-Service Rollen per Button & Dropdown
• Leveling — XP, Rang-Karten, Leaderboard, Rollen-Belohnungen
• Suggestions — Vorschlagsystem mit 👍/👎-Voting & Status-Management
• Polls — Live-Abstimmungen mit bis zu 10 Optionen & Balkendiagramm
• Starboard — ⭐ Beste Nachrichten automatisch hervorheben
• Text-Trigger ("Tags") — Automatische Antworten auf Stichwörter, ohne Befehl nötig
• Invites — Invite-Tracking, Rangliste & Rollen-Belohnungen ab X Invites
• Embed-Builder — Embeds interaktiv per Buttons & Formularen bauen, ohne JSON von Hand
• Temp Roles — Rollen zeitlich befristet vergeben, automatischer Entzug nach Ablauf

🔔 Benachrichtigungen & Utility

• Reminders — Persönliche Erinnerungen (/remind)
• Birthdays — Geburtstage speichern + automatisch gratulieren
• RSS — Feed-Abos mit automatischem Posten neuer Einträge
• Giveaways — Gewinnspiele mit Toggle-Entry und automatischer Ziehung
• Serverstats — Live-Zähler-Channels (Mitglieder/Boosts/...)
• Announcements — Geplante Ankündigungen (einmalig/täglich/wöchentlich/monatlich)
• Events — Serverevents mit RSVP-Buttons und Start-Ping
• Settings — Zentrale Modul- und Channel-Konfiguration per Slash-Command
• YouTube — Upload-Benachrichtigungen, kein API-Key nötig
• Twitch — Live-Benachrichtigungen (braucht kostenlose Twitch-App-Zugangsdaten)

💬 Commands-Referenz

• Mod Commands — /mod warn · kick · ban · softban · note · mute · history · …
• Ticket Commands — /tickets & /ticket (close, claim, transfer, reopen, …)
• Voice Commands — /voice rename · lock · limit · kick · trust · transfer · claim · …
• Preview Commands — Welcome / Leave / Verify / CAPTCHA Vorschau

👥 Für Staff

• Berechtigungen — Wer darf was
• Mod-Workflow — Typischer Ablauf bei Regelverstößen

---

✨ Highlights der aktuellen Version

Neue Module (2026)

• Reaction Roles: Self-Service Rollen-Panels — Buttons oder Dropdowns, MaxSelections, ExclusiveRoles, RequiredRole. Setup per /reactionrole panel|group|role.
• Leveling: MEE6-kompatibles XP-System — Message-XP (mit Cooldown), Voice-XP (60s-Interval), Canvas-Rang-Karten, Canvas-Level-Up-Karten, Leaderboard mit Pagination, Rollen-Belohnungen.
• Suggestions: Vorschlagsystem mit 👍/👎, 5 Status-States, Admin-DM-Notify, Cooldown, Staff-Rollen-Config.
• Polls: Live-Voting mit Buttons, Vote wechseln/zurückziehen, Balkendiagramm bei Beendigung.
• Starboard: Automatische Hervorhebung beliebter Nachrichten, Self-Star-Schutz, Live-Zähler.

Neu seit Juli 2026

• URLhaus-Bedrohungsfeed: Anti-Phishing prüft Links jetzt zusätzlich gegen eine stündlich aktualisierte Liste bekannter Malware-/Phishing-URLs (abuse.ch, kostenlos).
• Message-Log: Zeigt den echten Inhalt gelöschter/bearbeiteter Nachrichten — auch bei Selbstlöschung durch den Autor, was Discords eigenes Audit-Log nicht kann.
• /mod nuke: Channel komplett zurücksetzen, umgeht Discords 14-Tage-Bulk-Delete-Limit.
• Boost-Ankündigungen & Sticky Roles: Eigene Nachricht bei neuem Server-Booster, automatische Rollen-Wiederherstellung bei Rejoin.
• Text-Trigger ("Tags"): Passive Keyword-Auto-Antworten ohne Befehl.
• 10 weitere Module dokumentiert: Reminders, Birthdays, RSS, Giveaways, Serverstats, Announcements, Events, Settings, YouTube, Twitch — siehe Inhaltsverzeichnis oben.

Core-Features

• Music-Modul: Internet-Radio im Voice-Channel — 7 vorkonfigurierte Stationen, Interactive- und Passive-Mode, Now-Playing-Status direkt unter dem Channel-Namen
• Configurable Presence: Rotierende Custom-Activities statt Discord's Auto-„Im Sprachchat"
• File-Logging: Minecraft-Style Log-Rotation (logs/latest.log → .log.gz), konfigurierbare Retention
• Config Auto-Heal: Beim Start ergänzt der Bot fehlende Addon-Toggles und Channel-Felder in config.yml
• Auto-Deployment: Verify-, Ticket- und Help-Panels werden automatisch (re-)gepostet
• Server-Audit-Logger: Channel-, Rollen-, Member-, Profil- und Message-Events im mod-log
• Console-Commands: stop / exit / quit / help in der Pelican-Konsole

---

📞 Support

Bei Fragen an darksoon wenden.

---

GrumpyCore — Wiki (English)

Welcome to the official wiki for GrumpyCore, the Discord bot for Minetechworld.de.

Developed by darksoon · GitHub

---

🚀 Quick Start

1. Upload files to the Pelican server
2. Fill in configs/config.yml → Configuration
3. Start the bot — verify and ticket panels are posted automatically
4. Done!

No .env needed, no message IDs to copy by hand — everything runs via configs/config.yml and the database.

---

🛠️ Tech Stack

What	With
Framework	Sapphire.js 5.5
Database	Prisma 7 — SQLite (default) / MySQL / MariaDB / PostgreSQL
Validation	Zod 4
Discord	discord.js 14
Node.js	20+
Languages	German 🇩🇪 / English 🇬🇧

---

📚 Table of Contents

⚙️ Setup

• Installation — Pelican Panel, starting the bot, console commands
• Configuration — config.yml, entering all IDs

🔧 Core Modules

• Welcome — Welcome banners, verification, leave messages
• Moderation — Mod tools, auto-mod, anti-nuke, reports, server audit logger
• Tickets — Multi-panel system, forms, auto-close, reopen
• News — Post news via DM
• Voice — Join-to-create voice channels with owner permissions
• Music / Radio — Internet radio (TechnoBase.FM & more) in voice channels
• Help — Auto-deployed help hub with module dropdown
• Custom Commands — Admin-defined slash commands (/cc add, /cmd)

🆕 New Modules

• Reaction Roles — Self-service roles via buttons & dropdowns
• Leveling — XP, rank cards, leaderboard, role rewards
• Suggestions — Suggestion system with 👍/👎 voting & status management
• Polls — Live voting with up to 10 options & bar charts
• Starboard — ⭐ Automatically highlight the best messages
• Text Triggers ("Tags") — Automatic replies to keywords, no command needed
• Invites — Invite tracking, leaderboard & role rewards at X invites
• Embed Builder — Build embeds interactively via buttons & forms, no hand-written JSON
• Temp Roles — Grant roles temporarily, automatically removed on expiry

🔔 Notifications & Utility

• Reminders — Personal reminders (/remind)
• Birthdays — Save birthdays + automatic congratulations
• RSS — Feed subscriptions with automatic posting of new entries
• Giveaways — Giveaways with toggle entry and automatic drawing
• Serverstats — Live counter channels (members/boosts/...)
• Announcements — Scheduled announcements (once/daily/weekly/monthly)
• Events — Server events with RSVP buttons and start ping
• Settings — Central module and channel configuration via slash command
• YouTube — Upload notifications, no API key needed
• Twitch — Live notifications (needs free Twitch app credentials)

💬 Command Reference

• Mod Commands — /mod warn · kick · ban · softban · note · mute · history · …
• Ticket Commands — /tickets & /ticket (close, claim, transfer, reopen, …)
• Voice Commands — /voice rename · lock · limit · kick · trust · transfer · claim · …
• Preview Commands — Welcome / Leave / Verify / CAPTCHA previews

👥 For Staff

• Permissions — Who can do what
• Mod Workflow — Typical process for rule violations

---

✨ Highlights of the Current Version

New Modules (2026)

• Reaction Roles: Self-service role panels — buttons or dropdowns, max selections, exclusive roles, required role. Set up via /reactionrole panel|group|role.
• Leveling: MEE6-compatible XP system — message XP (with cooldown), voice XP (60s interval), canvas rank cards, canvas level-up cards, paginated leaderboard, role rewards.
• Suggestions: Suggestion system with 👍/👎, 5 status states, admin DM notification, cooldown, staff role config.
• Polls: Live voting with buttons, vote switching/withdrawal, bar charts on close.
• Starboard: Automatic highlighting of popular messages, self-star protection, live counter.

New Since July 2026

• URLhaus threat feed: Anti-phishing now also checks links against an hourly-refreshed list of known malware/phishing URLs (abuse.ch, free).
• Message log: Shows the actual content of deleted/edited messages — even for self-deletes by the author, which Discord's own audit log can't do.
• /mod nuke: Fully resets a channel, bypassing Discord's 14-day bulk-delete limit.
• Boost announcements & sticky roles: A dedicated message on a new server booster, automatic role restoration on rejoin.
• Text triggers ("tags"): Passive keyword auto-replies, no command needed.
• 10 more modules documented: Reminders, Birthdays, RSS, Giveaways, Serverstats, Announcements, Events, Settings, YouTube, Twitch — see the table of contents above.

Core Features

• Music module: Internet radio in voice channels — 7 pre-configured stations, interactive and passive mode, now-playing status directly below the channel name
• Configurable presence: Rotating custom activities instead of Discord's auto "In voice chat"
• File logging: Minecraft-style log rotation (logs/latest.log → .log.gz), configurable retention
• Config auto-heal: On startup, the bot adds missing addon toggles and channel fields to config.yml
• Auto-deployment: Verify, ticket, and help panels are automatically (re-)posted
• Server audit logger: Channel, role, member, profile, and message events in mod-log
• Console commands: stop / exit / quit / help in the Pelican console

---

📞 Support

For questions, contact darksoon.