SoulvenDiscord

A comprehensive Minecraft Paper/Bukkit plugin that seamlessly bridges your server's events to Discord. It sends rich, color-coded embed notifications through Discord webhooks and provides an interactive Discord bot for searching player activity — all fully configurable.

Real-Time Discord Webhooks

Get instant Discord notifications for 11 different server events:

• Chat Messages — See what players are saying with world and location info

• Command Execution — Track all commands with configurable ignore list

• Player Join/Quit — Monitor joins and leaves with IP, ping, client version, and session duration

• Player Death — Get death messages with health, location, and killer info

• Advancement Unlock — Celebrate when players unlock advancements

• AFK Status — Track when players go idle and return (configurable timeout)

• World Change — Monitor dimension and world travel

• Ban/Unban — Log bans with reasons and source

• Kick — Track kicks with reasons

Interactive Discord Bot

• /search player slash command to look up any player's activity

• Button-based navigation with 11 categories: Commands, Chat, Deaths, Bans, Unbans, Kicks, Joins, Quits, AFK, Advancements, and World Changes

• Paginated results with Prev/Next buttons

• Command usage statistics showing most-used commands per player

JSON Data Logging

• All events saved to JSON files with full details

• Thread-safe read/write locks for concurrent access

• Auto-trimming to keep last 1,000 entries per event type

• Queryable by player UUID for the Discord bot search

Highly Configurable

• Enable/disable each event type independently

• Custom webhook URL per event type (route different events to different channels)

• Custom embed colors and titles

• Configurable AFK idle timeout and check interval

• Player avatar from Crafthead with UUID support

• Hot-reload config with /soulvendiscord reload or /svd reload

Technical Details

• API Version: Paper 1.20.6+ (API version 1.20)

• Java Version: 17

• Dependencies: JDA 5.0.0-beta.24, Gson 2.10.1

• Build System: Maven with Shade plugin (fat JAR with relocated dependencies)

• Async Webhooks: Non-blocking HTTP client with timeout handling

Installation

1. Download the plugin JAR

2. Place it in your server's plugins/ folder

3. Start the server — config.yml will be auto-generated

4. Edit config.yml with your Discord webhook URLs and bot token

5. Run /soulvendiscord reload or restart the server