The development team performed a scheduled framework update (Core/Api) from version **2.2.2 to 2.3.0** on **2026-05-17 (05:00 to 05:30 UTC+0)**. During this window, Pudel services were temporarily suspended until maintenance was completed.

**Changelog:**

**[Framework]**
- Update dependency version.
- Maintain transitive dependency version. ()
- **New API** ContextMenu now support with auto register by @annotation. (Still maintain legacy interface-based)
- Refactor spring boot component loader.
- Update Javadocs with more correct syntax.
- Bump Version to 2.3.0

**[Other]**
* .env.example Add note about branding for self-hosted

---

***Note:** The full changelog can be found in the latest Pull Request on the main branch, timestamped prior to this announcement.*
***Note:** Maintenance may be extended without prior notice. Please check the official website for real-time status updates on Pudel’s health.*

[Pudel] Schedule for Update Framework (Core/Api) Version 2.2.2 -> 2.3.0

The development team performed a scheduled framework update (Core) from version **2.2.1 to 2.2.2** on **2026-04-05 (05:00 to 05:30 UTC+0)**. During this window, Pudel services were temporarily suspended until maintenance was completed.

**Changelog:**

**[Framework]**
- Update dependency version.
- Update JDA 6.3.2 -> 6.4.0 (Add Support for Checkbox & Radio Group)
- Replace dependency of com.google.code.gson.gson with org.json.json
- Append User-Agent of Pudel's properties into JDA RestConfig
- Bump Version to 2.2.2

**[Other]**
* .env.example Add note about branding for self-hosted

---

***Note:** The full changelog can be found in the latest Pull Request on the main branch, timestamped prior to this announcement.*
***Note:** Maintenance may be extended without prior notice. Please check the official website for real-time status updates on Pudel’s health.*

[Pudel] Schedule for Update Framework (Core) Version 2.2.1 -> 2.2.2

The development team performed a scheduled framework update (Core) from version **2.2.0 to 2.2.1** on **2026-03-22 (05:00 to 05:30 UTC+0)**. During this window, Pudel services were temporarily suspended until maintenance was completed.

**Changelog:**

**[Framework-Core]**
* Removed `/help` and `/ping` commands. Please use !help & !ping instead.
* Updated "Join Guild" strings to reflect the removal of `/help` and `/ping`.
* Reduced log verbosity for JWT expiration errors.
* Implemented protections against ReDoS (Regular Expression Denial of Service) attacks within AI functions.
* Improved safety handling for race conditions.
* Updated dependency versions.
* Bumped version to 2.2.1.

**[Other]**
* Updated documentation to reflect recent changes.
* Fixed the workflow for the `javadocs-api` release page.
* Added Docker CLI support to push the `main` branch to Docker Hub.
* Tuned `script.sh` to use the correct options flag for restarting without data loss.

---

***Note:** The full changelog can be found in the latest Pull Request on the main branch, timestamped prior to this announcement.*
***Note:** Maintenance may be extended without prior notice. Please check the official website for real-time status updates on Pudel’s health.*

[Pudel] Schedule for Update Framework (Core) Version 2.2.0 -> 2.2.1

Infrastructure team performed a planned reboot of the instance(s) maintenance on 2026-03-19 (02:00 UTC+0). Result as Pudel became stop service until maintenance finished.

Details
- Infrastructure firmware update

Please check on official Pudel's health on [official webpage](https://worldstandard.group/)

[Server] Pudel has scheduled a firmware update maintenance event.

Infrastructure team performed an unplanned reboot of the instance(s) indicated due to maintenance on the underlying infrastructure. Result as Pudel became stop service until maintenance finished.

Please check on official Pudel's health on [official webpage](https://worldstandard.group/)

This project has a complementary web interface that you can use to control or configure your experience

Web Interface

This bot can also be added as a user app, letting you use it outside servers where it’s installed.

Installable as User App

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

# Pudel
![GitHub Release](https://img.shields.io/github/v/release/World-Standard-Group/Pudel-Spring-Boot?label=Release)
![Maven Central](https://img.shields.io/maven-central/v/group.worldstandard/pudel-api)
![Java](https://img.shields.io/badge/JDK-25-green)
![License](https://img.shields.io/github/license/World-Standard-Group/Pudel-Spring-Boot)
[![Javadoc](https://img.shields.io/badge/javadoc-latest-blue.svg)](https://world-standard-group.github.io/Pudel-Spring-Boot/)

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

Pudel

Pudel is AI bot that build & drive by community, fall or rise depend on use case.
!help - to list out which command available.

为Pudel投票

你想要支持我们吗？