DisMineBridge – v0.1.0 (Initial Beta Release)

DisMineBridge is a comprehensive management and moderation plugin for Minecraft Java Edition (Paper 1.21.8). This first public release lays the foundation for a unified moderation and administration system with a future Discord connection in mind.

The plugin focuses on professional server management, consistent moderation workflows, and extensibility for future platform synchronization.

---

✨ Features

🔧 Core System

• Paper support (1.21.8) – Built specifically for modern Paper servers.
• Modular architecture – Moderation, administration, maintenance, and Discord systems are clearly separated for long-term scalability.
• UUID-based player handling – All player data is managed via UUIDs to ensure reliability across name changes.

---

🛡️ Moderation System

• Temporary and permanent punishments

  • Bans, mutes, kicks, and warnings
  • Time-based punishments with flexible duration syntax (e.g. 1h30m, 2d)

• Warning system

  • Tracks player behavior
  • Designed for progressive discipline

• Punish Menu

  • Graphical punishment interface
  • Select a player and apply moderation actions efficiently

Voice moderation synchronization is planned but not yet active (see Known Limitations).

---

🧑‍⚖️ Administrative Tools

• Advanced Admin Mode

  • Dedicated administration state for staff members
  • Separates normal gameplay from moderation tasks
  • Inventory handling is implemented but still has limitations (see Known Bugs)

• Vanish System

  • Makes administrators completely invisible to regular players
  • Hidden join and quit messages
  • Suitable for silent moderation and investigation

---

🔧 Server Management

• Maintenance Mode

  • Restricts server access during updates or configuration
  • Permission-based access for staff and trusted players

• Integrated Whitelist Management

  • Built-in whitelist system
  • Fully controllable via commands

• MOTD Configuration

  • Manage the server MOTD directly through the plugin configuration
  • No manual editing of server.properties required

---

👁️ Player Utilities

• InvSee (Online Players)

  • View inventories of online players for moderation purposes

Offline InvSee is currently disabled due to errors.

---

💬 Message & Configuration System

• Config-based messages

  • Many messages can already be customized
  • Message Manager integration is still in progress

---

🌉 Discord Integration (Planned)

• Discord Bot system (inactive)

  • Foundation for connecting Minecraft and Discord moderation
  • No Discord functionality is active in this release

---

📜 Commands Overview

Command names may be subject to change while the plugin is in active development.

🛡️ Moderation Commands

• /ban – Temporarily or permanently ban a player
• /mute – Mute text chat (voice sync planned)
• /kick – Remove a player from the server
• /warn – Issue a warning
• /punish – Open the punishment menu

🧑‍⚖️ Administration Commands

• /adminmode – Toggle Admin Mode
• /adminmode on – Enable Admin Mode
• /adminmode off – Disable Admin Mode and restore player state
• /vanish – Toggle vanish mode

🔧 Server Management Commands

• /maintenance – Toggle Maintenance Mode

• /maintenance on – Enable Maintenance Mode

• /maintenance off – Disable Maintenance Mode

• /whitelist add – Add a player to the whitelist

• /whitelist remove – Remove a player from the whitelist

• /whitelist list – Show all whitelisted players

ℹ️ Utility Commands

• /dmb – Show plugin information and version

---

🐞 Known Bugs & Limitations

The following issues are known and present in this release:

1. Admin Mode Inventory Loss After Restart

   • If the server restarts while a player is in Admin Mode, the player's items may be deleted.
   • Important: Do not log out or remain in Admin Mode when a restart is imminent.

2. Offline InvSee Not Available

   • Viewing inventories of offline players currently throws errors.
   • Feature is disabled until fixed.

3. Incomplete Message Customization

   • Not all messages can be edited via the config yet.
   • Message Manager is not fully integrated.

4. Discord Integration Not Implemented

   • No Discord bot functionality is active in this release.

---

🧪 Development Status

• Current Phase: Active Development
• This release represents an early stable foundation, not a final product.
• Internal APIs and systems may change.

Planned Features

• Full Discord bot integration with bidirectional communication
• Optional Simple Voice Chat dependency
• Extended moderation synchronization
• Additional administrative tools

---

🐛 Bug Reports & Issues

If you encounter bugs or unexpected behavior, please report them on GitHub:

👉 GitHub Repository https://github.com/MaxBrassLoud/DisMineBridgePlugin

Please include:

• Paper version
• Plugin version
• Steps to reproduce
• Error messages or stack traces

---

Thank you for testing and supporting DisMineBridge 🚀