PixelDisCraft

PixelDisCraft is a powerful bridge that connects your Minecraft server with Discord, allowing your community and server administration to interact in real time.

It consists of a Minecraft PaperMC plugin and a Discord bot working together through a secure bridge system.

This allows server events, chat messages, and commands to flow seamlessly between Minecraft and Discord.

Core Features

Minecraft ↔ Discord Chat Bridge

• Sync Minecraft chat directly to Discord channels
• Send Discord messages to Minecraft chat
• Clean formatting with webhook support
• Emoji support

Server Event Logging

PixelDisCraft can automatically send important events to Discord:

• Player join notifications
• Player leave notifications
• Death messages
• Server activity updates

This keeps your community informed even when they are not in the game.

Discord Server Commands

Control your Minecraft server directly from Discord using slash commands.

Examples:

/server
/mc command say Hello
/kick <player>
/ban <player>

Server administrators can manage the server without logging into the game.

Account Linking

Players can link their Minecraft account with their Discord account.

This allows:

• secure player identification
• role synchronization
• better moderation tools

Linking works through a one-time verification code system.

Role Synchronization

Automatically sync roles between Minecraft and Discord.

Example:

Minecraft rank → Discord role

This helps communities keep permissions consistent across platforms.

Player Statistics

Track and view player statistics from Discord.

Available stats:

• Playtime
• Kills
• Deaths

Example command:

/stats <player>

Screenshot System

Players can generate server-side screenshots and send them directly to a Discord channel.

Example:

/screenshot

This feature can be enabled or disabled in the configuration.

Architecture

PixelDisCraft uses a modular bridge architecture:

Minecraft Server ↓ PixelDisCraft Plugin ↓ Secure REST API Bridge ↓ Discord Bot ↓ Discord Server

All communication is handled asynchronously to prevent server lag.

Installation

1. Download the latest version from the Releases section.
2. Place the PixelDisCraft.jar file into your server's plugins folder.
3. Start the server to generate the configuration files.
4. Configure the plugin settings in config.yml.
5. Install and run the Discord bot.
6. Connect the plugin and bot using the bridge token.

Configuration Example

discord:
  guild-id: YOUR_GUILD_ID
  chat-channel-id: CHANNEL_ID

permissions:
  admin-role: Minecraft Admin

bridge:
  secret-token: YOUR_SECRET_TOKEN

Use Cases

PixelDisCraft is useful for:

• SMP communities
• public servers
• private servers
• Discord-centered communities
• remote server administration

Future Updates

Planned improvements may include:

• expanded Discord commands
• improved statistics tracking
• enhanced monitoring tools
• multi-server support

Support

If you encounter issues or have feature requests, please use the project repository or discussion section.

PixelDisCraft aims to provide a clean, powerful, and reliable bridge between Minecraft and Discord communities.