Lineage Proxy

👺 What is Lineage?

Lineage is a security-first QUIC/TLS proxy designed to bring the flexibility of "BungeeCord/Velocity" networks to Hytale, without breaking the strict security model of the new protocol.

Traditional proxy forwarding (like HAProxy or Velocity's TCP forwarding) does not work with Hytale's QUIC implementation because of strict TLS handshakes and authenticated sessions. You cannot simply "Pipe" the connection transparently.

Lineage solves this by acting as a trusted component. Instead of fighting the protocol, it establishes an explicit trust chain with your backend servers, allowing you to route players seamlessly while keeping the official authentication flow intact.

🏮 Key Features

Security-First: Designed with strict auth in mind. No silent fallbacks, no insecure "offline mode" hacks.

Smart Routing: The proxy is control-plane aware. It knows who is connecting and where they should go.

High Performance: Written in Kotlin on top of Netty, ensuring low-latency packet processing for QUIC.

Agentless Backend: Does not require heavy agents on your backend servers. Simple token verification is enough.

Modding API: Extensible architecture for writing your own routing plugins.

🍱 Getting Started

Prerequisites

Java 21 or higher.

A Hytale server running in Authenticated mode.

Installation

Download the Proxy: Get the latest .jar file from the Files tab.

Run it: Start the proxy via command line: java -jar lineage-proxy-x.x.x.jar

Configure: Edit the generated config.toml to set up your listeners and backend servers.

Backend Setup:

Download the lineage-backend-mod jar.

Place it in your Hytale server's mods folder.

Ensure the proxy_secret in your backend config matches the one in your proxy config.

🔗 Links & Resources

Source Code: GitHub Repository

Documentation: Official Wiki & API Docs

Issues: Bug Tracker

Status: Alpha (v0.x.x). This project is in active development. APIs and config formats may change.