Iris — Advanced Minecraft ↔ Discord Integration





Secure Linking • DM 2FA • Role Sync • Rewards Automation

Iris is a premium Discord integration plugin built for Minecraft servers that want a modern user experience, stronger account trust, and less manual staff workload.

From first-time linking to long-term automation, Iris handles the full lifecycle:

- players link quickly with clean Discord UX,

• optional 2FA adds security without forcing every user,
• roles and rewards stay synchronized automatically.

Why Iris?

Most linking plugins stop at “account connected.”

Iris goes further with production-focused systems:

- polished slash-command + button UX

• optional per-player security controls
• DM-based verification flow
• automation for boosters, rewards, and role sync
• configurable messages/embeds for full brand alignment

Core Features

1) Fast, User-Friendly Account Linking

• - In-game /link generates a 6-digit code
• - Discord users complete linking with:
• - /linkcode <code> (recommended), or
• - plain 6-digit message flow
• - Built-in checks for invalid, expired, duplicate, or already-linked states
• - Designed to reduce confusion and support tickets

2) Discord Slash Command Experience

• /linkhelp for onboarding instructions
• /linkstatus for current account status
• /linkcode for direct linking
• Interactive buttons for link guidance and status actions

3) Optional Per-Player 2FA (Not Forced on Everyone)

• After linking, users are asked if they want to enable 2FA
• 2FA preference is persisted per player
• Players can manage preference later with /link2fa <on|off>
• Admins can override when needed with /discord 2fa <player|uuid> <on|off>

4) DM-Based 2FA Verification

• Verification prompts are sent via Discord DM
• One-click button confirmation flow
• Optional fallback to a configured channel if DM fails
• Supports stricter server policies while staying user-friendly
  
  

5) Verification Gate Controls

• Configurable movement blocking while 2FA is pending
• Configurable command blocking while 2FA is pending
• Optional immediate freeze right after linking for high-security setups
  
  

6) Rewards System + Configurable GUI

• In-game rewards menu with configurable layout/slots
• Claim-state tracking for linked and booster rewards
• Admin reward reset tools for support and event workflows
  
  

7) Nitro Booster Automation

• Detects boost/unboost changes
• Runs configured commands automatically
• Keeps booster perks consistent and fast without manual staff action

8) Role Sync Integration

• Sync Minecraft groups/ranks to Discord roles
• Scheduled sync + manual trigger
• Helps keep permissions/identity aligned across platforms
  
  

9) Detailed Logging & Operational Visibility

• Rich Discord logs for link, 2FA, and booster events
• Storage status visibility for admins
• Easier debugging and day-to-day maintenance
  
  
  
  

10) Flexible Storage Layer

• SQLite, MySQL, and MongoDB support
• Optional fallback backend
• Optional mirrored writes for stronger resilience
  
  

Commands

Player Commands (Minecraft)

• /link
• /unlink
• /link2fa <on|off>
• /rewards

Admin Commands (Minecraft)

• /discord help
• /discord reload
• /discord sync
• /discord link-embed
• /discord 2fa <player|uuid> <on|off>
• /discord rewards reset <player|uuid> <linked|booster|all>
• /discord storage status
• /discordmassupdate <command-with-{uuid}/{discord_id}>

Discord Commands

• /linkhelp
• /linkstatus
• /linkcode <code>

Requirements

• Java 21+
• Spigot / Paper / Folia-compatible server
• SkironCommons (required dependency)
• Optional integrations: PlaceholderAPI, LuckPerms

Typical Setup Time

Most servers are fully operational in minutes:

1. Install Iris + dependencies
2. Configure bot token, guild/channel IDs, and database
3. Start server
4. Run /discord link-embed
5. Test link + DM 2FA flow once


Security Notes

• Keep bot token, DB credentials, and license key private
• Restrict admin permissions to trusted staff only
• DM-based verification reduces public channel exposure
• Interaction checks ensure only linked users can confirm their own 2FA

Perfect For

• Servers with Discord-gated ranks/perks
• Communities with booster reward systems
• Networks that need cleaner account trust and automation
• Owners who want modern UX without sacrificing control

Iris delivers the balance most servers need:

clean player onboarding + practical security + strong automation.