━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Features

Two-Way Chat Synchronization

• Minecraft ↔ Discord chat messages
• Customizable message formats
• Permission-based filtering

Account Linking System

• Secure 6-character link codes
• GUI-based account management
• Automatic code expiration (5 minutes)

Event Broadcasting

• Join/leave messages
• Death messages (optional)
• Advancement notifications (optional)

Discord Commands

• !online - Show online players
• !tps - Display server performance
• !link <code> - Link accounts

Command Logging

• Staff command monitoring with Discord alerts
• Console command tracking
• Optional separate log channel
• Role-based categorization

Beautiful GUI Interfaces

• 3-layer border design with sound effects
• Protected items (untakeable/unmoveable)
• Dynamic status indicators

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements

Requirement	Version
Minecraft	1.20+
Java	17+
Server	Spigot/Paper
Dependencies	None (PlaceholderAPI optional)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation
Prerequisites

• Minecraft server running Spigot or Paper 1.20+
• Java 17 or higher
• Discord bot with proper permissions

Step 1: Download and Install

1. Download zDiscord-1.0.0.jar
2. Place in /plugins/ folder
3. Restart server to generate configuration files

Step 2: Create Discord Bot

1. Visit Discord Developer Portal
2. Create a new application and bot
3. Copy the bot token (keep this secret!)
4. Invite the bot to your Discord server with permissions:
   • Send Messages
   • Read Messages
   • Manage Messages
   • Embed Links
   • Read Message History

Step 3: Configure the Plugin

1. Stop your server
2. Edit plugins/zDiscord/config.yml:
   
   Code (Text):

   
   discord:
     bot-token: "YOUR_BOT_TOKEN_HERE"
     chat-channel-id: "YOUR_CHANNEL_ID_HERE"
    
   logging:
     log-channel-id: "OPTIONAL_LOG_CHANNEL_ID"
    
3. Start your server

Step 4: Get Channel IDs

1. Enable Developer Mode in Discord (User Settings > Advanced > Developer Mode)
2. Right-click your channel and select "Copy ID"
3. Paste the ID in your config file

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Configuration
Discord Settings
Chat Synchronization
Message Formats
Account Linking
Command Logging
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands & Permissions



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Message Formats
Available placeholders:

• {player} - Player name
• {displayname} - Player display name
• {user} - Discord username
• {message} - Chat message
• {deathmessage} - Death message
• {advancement} - Advancement name
• PlaceholderAPI placeholders supported

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Discord Commands

Command	Description
!online	List online players and server status
!tps	Show server TPS (if available)
!link <code>	Link Discord account to Minecraft
!help	Show available commands

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

GUI Features
Main Discord GUI

• Clean 3-layer border design
• Sound effects for interactions
• Protected items (cannot be moved/taken)
• Dynamic status indicators

Account Linking

• Secure 6-character codes
• Visual feedback system
• Automatic expiration handling
• Step-by-step guidance

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Command Logging System
Console Logging:

• All player commands with timestamps
• Staff member command tracking
• Console command monitoring
• Role-based categorization (Admin/Mod/Helper)

Discord Integration:

• Staff commands sent to Discord with ⚠️ alerts
• Console command notifications
• Optional separate log channel support
• Formatted log messages with timestamps

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ File Structure
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ Troubleshooting
Bot Not Connecting

1. Verify bot token is correct
2. Check bot has proper permissions
3. Ensure channel ID is valid
4. Review console for error messages

Messages Not Syncing

1. Confirm bot can send messages in channel
2. Check if bot has "Send Messages" permission
3. Verify channel ID matches configuration
4. Test with /zdiscord test command

Linking Issues

1. Enable linking in configuration
2. Check code expiration settings
3. Verify player has linking permission
4. Review console for linking errors

Command Logging Problems

1. Check logging configuration settings
2. Verify log channel ID (if using separate channel)
3. Ensure bot has permissions in log channel
4. Review staff permission settings

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Performance
Server Impact

• Minimal CPU usage with async operations
• Efficient memory management
• Optimized Discord API calls
• Lightweight GUI system

Recommendations

• Use separate log channel for high-activity servers
• Enable only needed logging features
• Regular configuration reviews
• Monitor console for warnings

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Updates

1. Download the new version
2. Stop your server
3. Replace the old JAR file
4. Start your server
5. Check console for any configuration changes needed

The plugin includes automatic update checking.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support
Getting Help

• Check console logs for detailed error messages
• Verify all configuration settings are correct
• Ensure Discord bot has proper permissions
• Test with minimal configuration first

Common Issues

• "Channel not found": Check channel ID and bot permissions
• "Bot offline": Verify token and bot status
• "Commands not logging": Check logging configuration
• "GUI items moveable": Update to latest plugin version

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ Build Information

• Build Tool: Maven
• Java Version: 17
• JDA Version: 5.0.0-beta.18
• Compiled Size: ~14MB (includes all dependencies)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

‍ Author & License
Made with ❤️ by GamingHuzai

• Discord: huzaidev
• Version: 1.0.0

This plugin is provided as-is for educational and server administration purposes.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━