Nexori

Build connected Hytale server networks without giving up control of your own servers.

What Is Nexori?

Nexori is a secure orchestration layer for connected Hytale servers.

It does not replace Hytale's native server transfer system, and it is not a proxy.

Nexori builds on top of Hytale's native referToServer(...) flow by adding server registration, signed travel context, verified payloads, inventory-aware transfers, portals, queues, instanced minigames, return-to-lobby flow, and optional backend integration.

The goal is simple:

Let creators connect multiple Hytale servers safely while keeping ownership of their worlds, gameplay, backend, economy, and community.

Main Features

Secure Server Travel

• Register trusted servers in-game.
• Create portals between servers.
• Move players through Hytale's native server referral flow.
• Sign and verify travel context so players cannot freely tamper with payload data.
• Transfer player inventory and selected player data between servers.
• Keep cross-server movement controlled by your network rules.

Portals And Connected Worlds

• Create lobby portals.
• Connect adventure worlds.
• Configure destinations from the in-game menu.
• Move players between separate servers without requiring a proxy.

Queues And Minigame Orchestration

• Create local queues for standalone servers.
• Use backend-driven queues when you need custom matchmaking.
• Configure games, arenas, instance templates, spawns, and return destinations.
• Launch players into instanced matches.
• Support backfill into active matches when your rules allow it.
• Clean up match runtimes after the game ends.

Backend Integration

Nexori can run without a backend, but it can also connect to your own backend when your network grows.

Use your backend for:

• custom matchmaking;
• ELO or ranking;
• regions;
• tournaments;
• player history;
• analytics;
• result processing;
• advanced queue logic.

Nexori handles sync, assignment execution, result reporting, retry behavior, and backend health visibility from inside the game.

Public Minigame API

Nexori includes a public API for third-party minigame and rules mods.

Minigames can:

• receive Nexori match lifecycle callbacks;
• create their own local game session when Nexori creates a match;
• track player arrival and placement;
• start gameplay when placement is complete;
• set player outcomes;
• use Nexori spectator runtime behavior;
• submit final match results;
• return players to the lobby;
• attach custom JSON stats to backend result reports.

Developers can compile against the standalone API artifact:

repositories {
    mavenCentral()
    maven { url = uri("https://jitpack.io") }
}

dependencies {
    compileOnly("com.github.hyjn-nexori:nexori-api:v2.4.0")
}

nexori-api is for developers only. Server owners should install the full nexori-plugin.jar.

Spectator Runtime

The public API includes setPlayerSpectator(...).

Nexori spectator mode can apply real runtime behavior:

• hide spectators from active players;
• keep spectators visible to other spectators;
• enable flight;
• prevent gameplay interaction;
• block item pickup;
• block item drops and inventory actions;
• apply temporary spectator model overrides.

This is useful for elimination-style minigames where a player should stay in the match as an observer without affecting active gameplay.

In-Game Administration

Nexori is designed to be configured in-game.

Use /nexorimenu to manage:

• servers;
• portals;
• queues;
• games;
• arenas;
• instance templates;
• spawn slots;
• backend options;
• recovery tools;
• network health.

No hand-edited config files are required for normal setup.

Example Minigames And Developer Projects

Capture The Zone

Capture The Zone is a working example minigame built for Nexori.

It demonstrates the recommended modern integration model:

• the minigame core can run without Nexori;
• Nexori integration loads only when Nexori is present;
• the adapter listens to Nexori lifecycle callbacks;
• the minigame reports results back through Nexori API commands;
• a small local mode exists for testing without Nexori.

Repository:

https://github.com/hyjn-nexori/nexori-capture-the-zone-minigame

Minigame Template

Use the official template if you want to create your own Nexori-compatible minigame.

Repository:

https://github.com/hyjn-nexori/nexori-minigame-template

Integration docs:

https://docs.hyjn-nexori.com/public-api/integrating-third-party-minigames

Source-Available

Nexori is source-available, not open source.

You can inspect the code, learn from the implementation, and verify what you are installing.

• Nexori plugin source: https://github.com/hyjn-nexori/nexori-plugin
• Nexori API artifact: https://github.com/hyjn-nexori/nexori-api
• Documentation: https://docs.hyjn-nexori.com/

Getting Started

1. Install Nexori on every server in your network.
2. Install required dependencies, including HyUI.
3. Join the server and run /nexorimenu.
4. Register your servers.
5. Create portals, queues, games, arenas, and spawn slots.
6. Test the full loop: lobby -> queue -> match -> return.
7. Add your own backend only when your project needs advanced matchmaking or result processing.

Required Dependency

Nexori requires HyUI for its HUD and in-game UI features.

When installing Nexori from CurseForge, make sure HyUI is installed on the server as a required dependency.