Tags
Creators
Details
5.0.0
Compatibility
Changes
MailboxGUI 5.0.0 - Network Support Update
MailboxGUI 5.0.0 is a major update adding optional network support for multi-backend servers while keeping normal single-server setups fully supported.
Highlights
- Added optional MailboxGUI Network Mode for Velocity-style / multi-backend setups.
- Added shared MySQL/MariaDB support for network mail data.
- Added Redis-backed network sync for inbox refreshes, paper notifications, admin tools, reloads, and safety locks.
- Added network-aware recipient lookup for player and admin mail.
- Added
/mba networkindexto help index old backend playerdata for shared network recipient lookup. - Added network-aware admin tools for registered player mailboxes and Post Office boxes.
- Added server/world/status display in mailbox management while network mode is enabled.
- Added Remote Server status for mailboxes and PO boxes registered on other backend servers.
- Added network sync for inbox changes, admin inbox edits, mailbox removals, Post Office removals, signs, and paper notifications.
- Added a new
/mailbox unregisterGUI with Selection Mode and Manage Personal Mailboxes. - Added player-controlled online mail sound alerts.
- Added website-powered update checks and staged update commands.
- Added warning that network-mode updates must be staged on each backend separately.
- Added support for MailboxGUI-DiscBridge 1.0.0 network notification behavior.
- Completed final 5.0.0 language/config polish.
Network Setup Notes
Network mode is optional. Single-server setups do not need Redis and can continue using normal MailboxGUI features.
Network mode requires:
- MySQL/MariaDB shared storage
- Redis
- unique
server-idper backend - the same MailboxGUI version on every backend
MailboxGUI should be installed on backend servers that use mail. It does not need to be installed on the Velocity proxy itself.
For setup instructions, use the wiki:
https://plugins.imagine-craft.net/mailboxgui/wiki/
Upgrade Notes
Before enabling network mode:
- Back up your MailboxGUI data.
- Keep
network.enabled: false. - Convert storage to MySQL with
/mba convert MYSQL. - Confirm
/mba convert currentshows MySQL. - Configure
network/config.ymlon each backend. - Start one backend first, then the rest.
Storage conversion is disabled while network mode is active to protect shared mail data.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:34j7WS4b:anChQBdB"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:34j7WS4b:anChQBdB"
}

