Minecraft Integration

Overview

Connect your Minecraft server to Discord with professional features. Get real-time monitoring, chat synchronization, account verification, proximity voice chat, and advanced event notifications.

✓ Web Dashboard✓ Multi-Server Support

Key Features

🔄 Chat Synchronization

Bidirectional chat relay using Discord webhooks - displays Minecraft usernames & avatars in Discord

🔗 Account Verification

Per-server verification system with Discord role rewards

📊 Live Server Stats

Real-time TPS, player count, and uptime monitoring with charts

🖥️ Console Forwarding

Real-time console logs in Discord with sensitive data filtering

🔔 Event Notifications

Join/quit, deaths, and achievements sent to Discord channels

👍 Vote Rewards

Track votes and reward with credits & Discord roles

💰 Economy Integration

Unified credit system between Discord and Minecraft

✨ Booster Rewards

Auto-assign in-game ranks to Discord Server Boosters

Setup

Add Server in Dashboard

Go to Dashboard → Your Server → Minecraft → Add Server

Download & Install Plugin

Download modora-plugin.jar and place in plugins/ folder

Configure Plugin

Edit plugins/Modora/config.yml with your API credentials

Restart Server

Restart Minecraft server or run /reload confirm

Configure Features

Go to Advanced Settings in dashboard to enable chat sync, events, console forwarding, etc.

Plugin Configuration

Example config.yml: config.yml:

config.yml

modora:
  # API Configuration (from dashboard)
  api_url: "http://bot.modora.gg"
  server_id: "1"
  api_key: "your_api_key_here"
  api_secret: "your_api_secret_here"

  # Core Features
  chat_sync_enabled: true
  vote_rewards_enabled: true
  economy_enabled: false

  # Advanced Features
  join_quit_enabled: true
  death_messages_enabled: true
  achievements_enabled: true
  console_enabled: false  # Staff only!

  # Settings
  heartbeat_interval: 30
  chat_format: "&9[Discord] &f%username%: %message%"
  verification_timeout: 300
  # Optional: run one or more commands after a player links their account
  verification_reward_enabled: true
  verification_reward_command:
    - "eco give {player} 100"
    - "lp user {player} parent add verified"
  # Reward execution mode for proxy/Bungee/Velocity networks
  # - any_server: execute rewards on the server where /modora verify is used
  # - lobby_only: let players verify on any gamemode, but execute reward commands only on the lobby
  verification_reward_mode: "lobby_only"
  lobby_server_name: "lobby"
  debug: false

Proxy / Bungee / Velocity networks

Players can use /modora verify <code> on any gamemode/server.

The Modora API decides (via grant_reward) if this is the first verification for that Discord user in the guild (proxy-wide check).

With verification_reward_mode: "lobby_only", reward commands are only executed on the server whose server-name matches lobby_server_name.

This ensures players can link from survival/skyblock/etc., but their 1x coins (for example PlayerPoints via shared database) are only granted once on the lobby.

Chat & event proxy modes (optional)

yaml

chat_sync_mode: "direct" | "proxy_bridge"
chat_bridge_server_name: "lobby"
events_sync_mode: "direct" | "proxy_bridge"
events_bridge_server_name: "lobby"

Discord Commands

/minecraft link

Show setup instructions for server linking

/minecraft verify

Get verification code to link your Minecraft account (per-server)

/minecraft status

View all Minecraft servers and their current status

/minecraft info

View your linked accounts and verification status

/minecraft vote

Get vote links to earn rewards

/minecraft balance

Check your Modora credit balance

/minecraft unlink

Unlink your Minecraft account from this server

In-Game Commands

/modora verify <code>

Link your Discord account with verification code

/modora status

View your Modora connection status

/modora balance

Check your credit balance (if economy enabled)

/modora vote

Get vote links to support the server

/modora info

View linked Discord guild information

Available Features

Core Features

Chat Synchronization - Minecraft ↔ Discord chat relay with webhooks (shows Minecraft username & avatar)
Account Verification - Link Discord to Minecraft (per-server)
Live Server Status - Real-time monitoring in dashboard
Dashboard MOTD - Configure your Minecraft server MOTD directly from the Modora dashboard
Join/Quit Notifications - Player events in Discord
Death Messages - All deaths forwarded to Discord
Achievement Alerts - Major achievements celebrated
Vote Rewards - Basic vote tracking and credits
Economy Commands - Check balance in-game

Advanced Features

Tip

Console Forwarding - Real-time server console in Discord
Advanced Analytics - Historical data & trends
Booster Rewards - Auto-rank for Discord boosters
Role Synchronization - Minecraft ranks ↔ Discord roles (Coming Soon)
Webhook Support - Custom vote webhooks (Coming Soon)

Complete Feature Set

✓ Core Integration

Bidirectional chat synchronization
Join/quit notifications with avatars
Death messages forwarding
Achievement alerts (smart filtering)
Console log forwarding
Account linking & verification
Channel topic auto-updates
Role synchronization (LuckPerms)
Proximity voice chat (dynamic channels)

Advanced Features

Web Dashboard - No config files needed
Vote Rewards - Automated voting system
Economy - Unified credit system
Console Commands - Execute from Discord
Role Sync - Bidirectional MC ↔ Discord
Voice Proximity - Dynamic spatial audio
Real-time Graphs - TPS & player analytics
Booster Rewards - Auto-rank boosters
Security Filtering - Auto-hide sensitive data

Role Synchronization

Automatically sync Discord roles with Minecraft groups (LuckPerms required).

🎮 Minecraft → Discord

When a player's Minecraft group changes, their Discord role is automatically updated.

Code

lp user Steve parent set admin → Steve gets @Admin role in Discord

💬 Discord → Minecraft

When a Discord role is added/removed, the player's Minecraft group is updated via LuckPerms.

Code

Give @Moderator to Steve → lp user Steve parent set moderator

Info

Setup: Configure role mappings in Advanced Settings. Map Minecraft groups (admin, moderator, vip) to Discord roles. Requires LuckPerms plugin installed on your server.

Voice Proximity Chat

Dynamic Discord voice channels based on in-game proximity - hear players who are near you!

Dynamic Channels

Players are automatically moved to voice channels based on their in-game position.

Configurable Range

Set horizontal (40 blocks), vertical (25 blocks), and falloff (10 blocks) ranges.

Real-time Updates

Voice groups update as players move around the world.

Tip

Voice proximity requires a Discord category and lobby channel. Solo players are moved to the lobby, while groups get their own proximity channels.

Advanced Configuration

All features can be configured via the web dashboard without editing config files!

📟 Console Forwarding

Enable → Select private staff channel → Save

Warning

⚠️ Only grant access to trusted staff - console contains sensitive server information

🔔 Event Notifications

Each event type (join/quit, deaths, achievements) can have its own Discord channel

👍 Vote Rewards

Create custom reward tiers with credits and Discord role rewards

✨ Booster Rewards

Auto-assign LuckPerms rank to Discord Server Boosters

Requirements

Minecraft Server

Paper 1.19+ (recommended)
Spigot 1.19+
Bukkit 1.19+
Java 17+

Optional Plugins

LuckPerms - For booster rewards
Vault - Economy compatibility

Troubleshooting

Support

Info

Need help setting up Minecraft integration? Join our Discord server or check the API documentation.

Join Discord

FeaturesFiveM Integration FeaturesMusic FeaturesLogging