promotional bannermobile promotional banner
premium banner
Hytale server network solution that powers multi-server networking, seamless player transfers, and instance-based arena matchmaking using a Redis-based communication system.

Description

NetworkManager

Designed to fit servers of all sizes. A networking solution for smaller scale projects, but with the architecture to support large server networks. Provides an extensive API for developers to create games which neatly exist within the network.

This plugin is server-side focused: it is meant to run across multiple Hytale servers that together form one network. Players connect to the network through the Hub, and the plugin handles routing between servers and arenas.

Setup and Features Guides

Features

Network Architecture

The network primarily uses Redis to handle quick network communication, with optional Postgres/MySQL support for extensive custom data storage and durability.

Matchmaking and Queueing

Provides a complete matchmaking solution using the /queue command. Routes players to the best available arena in the specified server group, or enters player into a queue if no arenas are available. Parties and Party Queue are also supported, allowing players to play with their friends!

Staff Network Panel

An extensive UI designed to bypass command jungles. Designed to be straightforward and easy to use. Provides powerful features such as the Role-intergrated permissions system and network-synched configs.

Moderation

The NetworkPlugin support network bans and mutes. The Staff Network Panel provides a list of active actions as well as a Player Manager tool for pushing moderation actions, in addition to the /netban and /netmute commands.

Persistence and Data Safety (Redis + SQL)

NetworkManager keeps Redis as the realtime runtime layer (queueing, pub/sub, coordination) and adds optional SQL durability (Postgres/MySQL) for long-term persistence and advanced data storage. Default behavior can stay Redis-first, then be migrated safely to SQP when needed.

  • Flexible persistence modes: REDIS_ONLY, Redis+SQL mirror, and SQL-authoritative cache (per namespace).
  • Namespace safety controls: explicit registration, mode/ready flags, and protections for unregistered namespaces.
  • Structured migration workflow: /netdebug persistence migrate|restore|verify|cutover with scope targeting and dry-run support.

This gives you low-latency network behavior now, with a controlled path to stronger durability as your network grows.

API for Developers

The NetworkManager provides an extensive NetworkAPI, enabling you to create games that take advantage of the NetworkManager's features. Documentation does not currently exist and is being worked on.


Manage Your Network Through The Staff Network Panel (/netpanel)

image

Manage Player Actions and Role Grants

image

Dedicated and Automatically Managed Network-Wide Staff Chat for Coordination

image

View All Active Network-Wide Actions

image

Create Feature-Complete Roles for Your Network

image

Send Announcements to All Servers in Your Network

image

Automatically Detected and Network-Wide Config Manager

image

Manager Netowrk-Wide Permissions, Integrated With Roles

image

Create Player Parties and Queue Together

image

Private Party Chats

image