Pudel

Pudel is a modular, AI-powered Discord bot framework built on Java 25, Spring Boot 4, and JDA 6, designed to operate as a long-running service (SaaS-style) with strong separation between core functionality and third-party plugins.

Pudel acts as a personal maid/secretary for Discord guilds — capable of natural conversation, intelligent command handling, moderation, and extensibility through a robust annotation-based plugin system.

Features (Core Framework)

🤖 AI-Powered Conversations

• Local LLM Integration via Ollama (phi-3, gemma-2b, or any compatible model)
• LangChain4j for text analysis, intent detection, and sentiment analysis
• Per-guild personality customization — biography, preferences, dialogue style
• Memory system with vector embeddings (pgvector + IVFFlat)
• Passive context tracking — Pudel listens and remembers without requiring mentions
• Agent Tools API — Extend AI capabilities with custom tools

🔧 Annotation-Based Plugin System

• Spring Boot-like annotations — @Plugin, @SlashCommand, @TextCommand
• Automatic command registration — No manual registerCommand() calls
• Automatic Discord sync — Commands appear instantly (guild) or within 1 hour (global)
• Hot-reload support — Update plugins without restarting the bot
• Graceful shutdown — @OnShutdown returns boolean for cleanup control
• Interaction handlers — @ButtonHandler, @ModalHandler, @SelectMenuHandler

🛡️ Enterprise Features

• Per-guild PostgreSQL schemas for data isolation
• Plugin database access — Isolated storage per plugin
• RSA JWT authentication for secure API access
• REST API for external integrations
• Docker-ready deployment with volume support for plugins

Plugin Feature (Official Instance)

Basic Pudel - Pudel's Embed Builder Messages

an interactive embed builder. Built entirely with Discord's Components v2 system, this plugin provides users with a rich, modern interface to build and preview messages directly within Discord.

Features

• Interactive Interface: The plugin uses Discord's Components v2 (Container, TextDisplay, Section, MediaGallery, etc.) to create a modern builder interface.
• Live Previews: Users can see a live visual preview of their embed that updates automatically as they make changes.
• Single Command Entry: The entire builder is accessed through a single slash command: /embed.
• Button-Based Editing: All content editing, including titles, descriptions, colors, fields, and images, is handled via interactive buttons and modals.
• Integrated Channel Selection: Users can select the target destination for their embed directly through the UI.
• Classic Output: Once finished, the final result is posted to the selected channel as a classic MessageEmbed.

Basic Pudel - Pudel's Music

A unified music player module designed for provides users with a centralized "Music Box" interface built entirely using Discord's modern Components v2 system.

Features

• Single Command Interface: The entire music experience is accessed through a single /music slash command, which opens the interactive Music Box.
• Now Playing Display: Shows the current track's artwork, playback progress, and active loop or shuffle status.
• Playback Controls: Features interactive buttons to easily Pause, Skip, Loop (toggle between Queue, Track, or Off), and Shuffle the current queue.
• Advanced Queuing & Search: Users can add songs via a modal by pasting a URL or entering a search query. The search supports auto-detection, YouTube, and SoundCloud sources, returning a selectable menu of tracks.
• Quick Queuing: /music [search] to quick queue without using Modal through music box.
• Queue Management: Includes a paginated queue view (displaying 10 tracks per page) where users can view upcoming songs, remove specific tracks, shuffle the remaining queue, or clear it entirely.
• Playback History: Features a paginated history view that logs and displays previously played tracks along with their timestamps.
• State Persistence: Saves the active queue and history to a database, which allows the bot to recover stale queues and resume playback even after a plugin reload or bot restart.
• Smart Voice Integration: Automatically joins the user's voice channel when a song is queued (if not already connected) and gracefully destroys the audio player if the bot leaves the channel.

Basic Pudel - Pudel's Playful Time

A fun, interactive plugin for the Pudel Discord Bot that allows users to create their own collections of "pranks" (harmless image/GIF reactions) with custom placeholder messages.

Whether you want to "bonk", "slap", or "hug" your friends, this plugin lets you organize your favorite reaction GIFs into custom containers and fire them at random with personalized text!

Features

• Interactive Control Panel: A fully UI-driven ephemeral control panel using Discord's modern UI components.
• Custom Containers: Group your pranks by theme (e.g., "bonk", "hug", "high-five").
• Flexible Uploads: Add images/GIFs by directly uploading files or pasting hosted URLs.
• Dynamic Messages: Use placeholders to automatically mention the person using the command and their target.
• Import/Export: Easily share your prank collections with others or back them up using JSON files!
• Randomized Selection: Firing a prank container randomly selects one of the images/GIFs inside it to keep things fresh.

Basic Pudel - Pudel's Role Color

A plugin that allows users to easily set and manage custom color roles for their profiles. Built using the JDA library, it manages user assignments and role creation dynamically while tracking everything via a database to prevent cluttering the server with unused roles.

Features

• Custom Colors via Hex: Users can customize their name color in the server by inputting standard 6-character hex color codes (e.g., FF0000 for red).
• Color Reset: Users can easily remove their custom color role at any time to return to their default appearance.
• Strict Color Enforcement: The plugin enforces a strict "1 color per user per guild" rule, automatically removing a user's previous color role when they select a new one.
• Role Reusability: To keep the server's role list clean, the plugin reuses existing custom color roles. If multiple users request the exact same hex color in the same server, they are assigned the same Discord role.
• Automatic Role Cleanup: The bot constantly monitors role assignments. If a managed color role drops to 0 assigned users, the plugin automatically deletes the role from both the Discord server and the database.