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

💬 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.

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

💬 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.

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.