Magnus

Quick rating

Community listing page, reviews here may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

Magnus

By KroderDevOwner

No reviews yet

A modular, high-performance, and resilient synchronization suite for Minecraft Fabric servers. Features real-time inventory sync, cross-server chat, and global player management.

Tech
Storage & Organization
Mod Loaders
Fabric
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Show per page
10
25
50
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

CurseForge logo CurseForge Modrinth logo Modrinth

Compatibility

Supported Environments

Where It Runs
Client and Server

Must be installed on both the client and the server.

Unknown

The author has not specified where this runs.

Varies by version.

About

Project Details

Type
Mod
License
GNU Lesser General Public License v3.0 only
Latest Version
Magnus Sync v1.4.1

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

Magnus (Server-Side)

Build Status Minecraft Version Fabric Kotlin GitHub Release Modrinth Version CurseForge Version PostgreSQL Redis Trivy License

A modular, high-performance, and resilient synchronization suite for Minecraft Fabric servers. Features real-time inventory sync, cross-server chat, and global player management.

Features

Core Sync

  • Multi-Server Sync: Syncs Inventory, Ender Chest, Health, Hunger, XP, Potion Effects.
  • High Performance: Uses Redis for sub-millisecond data retrieval.
  • Persistence: Uses PostgreSQL for permanent reliable storage.
  • Fault Tolerance:
    • Circuit Breaker: Detects database failures automatically.
    • Local Fallback: Saves data to disk if the database goes down.
    • Auto-Recovery: "The Janitor" service automatically restores data when the database comes back online.

Modules

Module Description
Inventory Sync Core synchronization of inventory, ender chest, health, hunger, XP, and potion effects. Enabled by default.
Global Chat Syncs chat messages across all servers via Redis pub/sub. Raw text format for compatibility with LuckPerms, Stylist, etc.
Global Player List Maintains a global player count with heartbeat. Provides /glist command.
Session Lock Prevents concurrent logins by locking player sessions during sync. Players are held in queue until their data is safely transferred.

Security

Feature Default Description
Message Signing ✅ Enabled HMAC-SHA256 prevents message injection attacks
Auto-Generated Secret ✅ 32-byte cryptographic secret generated on first run
Replay Prevention 30 sec Messages older than 30 seconds are rejected
Payload Size Limits 64KB Prevents DoS via oversized messages
SSL/TLS Support Optional Encrypt Redis connections

Configuration

Magnus requires a PostgreSQL database and a Redis instance to function.

  1. Generate Config: Start your server once to generate the default configuration file at config/magnus.json.
  2. Edit Config: Stop the server and open config/magnus.json:
{
    "postgresUrl": "jdbc:postgresql://your-db-host:5432/magnus",
    "postgresUser": "your_user",
    "postgresPass": "your_password",
    "redisHost": "your-redis-host",
    "redisPort": 6379,
    "redisPass": null,
    "serverName": "survival",
    "enableInventorySync": true,
    "enableGlobalChat": false,
    "enableGlobalPlayerList": false,
    "enableSessionLock": false,
    "enableMessageSigning": true,
    "messageSigningSecret": "auto-generated-on-first-run",
    "redisSsl": false
}
  1. Launch: Restart your server. Magnus will automatically verify the connection and create the necessary database schema.

[!IMPORTANT] Multi-Server Setup: Copy the messageSigningSecret from the first server to all other servers. All servers must use the same secret.

Configuration Options

Option Default Description
serverName "default" Unique identifier for this server (e.g., "survival", "lobby")
enableInventorySync true Enable inventory/player data synchronization. Disable for lobby servers.
enableGlobalChat false Enable cross-server chat synchronization
enableGlobalPlayerList false Enable global player list and /glist command
enableSessionLock false Enable session locking to prevent concurrent logins
enableMessageSigning true Enable HMAC message signing (recommended)
redisSsl false Enable SSL/TLS for Redis connections

Commands

Command Description
/glist Shows total player count and players grouped by server (requires enableGlobalPlayerList)

Architecture

For detailed flow diagrams and behavior documentation:

Magnus (Server-Side)

Build Status Minecraft Version Fabric Kotlin GitHub Release Modrinth Version CurseForge Version PostgreSQL Redis Trivy License

A modular, high-performance, and resilient synchronization suite for Minecraft Fabric servers. Features real-time inventory sync, cross-server chat, and global player management.

Features

Core Sync

  • Multi-Server Sync: Syncs Inventory, Ender Chest, Health, Hunger, XP, Potion Effects.
  • High Performance: Uses Redis for sub-millisecond data retrieval.
  • Persistence: Uses PostgreSQL for permanent reliable storage.
  • Fault Tolerance:
    • Circuit Breaker: Detects database failures automatically.
    • Local Fallback: Saves data to disk if the database goes down.
    • Auto-Recovery: "The Janitor" service automatically restores data when the database comes back online.

Modules

Module Description
Inventory Sync Core synchronization of inventory, ender chest, health, hunger, XP, and potion effects. Enabled by default.
Global Chat Syncs chat messages across all servers via Redis pub/sub. Raw text format for compatibility with LuckPerms, Stylist, etc.
Global Player List Maintains a global player count with heartbeat. Provides /glist command.
Session Lock Prevents concurrent logins by locking player sessions during sync. Players are held in queue until their data is safely transferred.

Security

Feature Default Description
Message Signing ✅ Enabled HMAC-SHA256 prevents message injection attacks
Auto-Generated Secret ✅ 32-byte cryptographic secret generated on first run
Replay Prevention 30 sec Messages older than 30 seconds are rejected
Payload Size Limits 64KB Prevents DoS via oversized messages
SSL/TLS Support Optional Encrypt Redis connections

Configuration

Magnus requires a PostgreSQL database and a Redis instance to function.

  1. Generate Config: Start your server once to generate the default configuration file at config/magnus.json.
  2. Edit Config: Stop the server and open config/magnus.json:
{
    "postgresUrl": "jdbc:postgresql://your-db-host:5432/magnus",
    "postgresUser": "your_user",
    "postgresPass": "your_password",
    "redisHost": "your-redis-host",
    "redisPort": 6379,
    "redisPass": null,
    "serverName": "survival",
    "enableInventorySync": true,
    "enableGlobalChat": false,
    "enableGlobalPlayerList": false,
    "enableSessionLock": false,
    "enableMessageSigning": true,
    "messageSigningSecret": "auto-generated-on-first-run",
    "redisSsl": false
}
  1. Launch: Restart your server. Magnus will automatically verify the connection and create the necessary database schema.

[!IMPORTANT] Multi-Server Setup: Copy the messageSigningSecret from the first server to all other servers. All servers must use the same secret.

Configuration Options

Option Default Description
serverName "default" Unique identifier for this server (e.g., "survival", "lobby")
enableInventorySync true Enable inventory/player data synchronization. Disable for lobby servers.
enableGlobalChat false Enable cross-server chat synchronization
enableGlobalPlayerList false Enable global player list and /glist command
enableSessionLock false Enable session locking to prevent concurrent logins
enableMessageSigning true Enable HMAC message signing (recommended)
redisSsl false Enable SSL/TLS for Redis connections

Commands

Command Description
/glist Shows total player count and players grouped by server (requires enableGlobalPlayerList)

Architecture

For detailed flow diagrams and behavior documentation:

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Modrinth
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works