Neoline 🛜

Neoline is a Minecraft mod that establishes two simultaneous TCP connections to the same server, creating a faster and more stable multiplayer experience — completely automatically, with no setup required.

• Instead of relying on a single connection, Neo splits your network traffic across two sockets — critical packets like player movement and combat go through the primary connection, while heavier data like chunk loading and entity updates are handled separately. This keeps your gameplay smooth even when the server is under load.

• If one connection drops, Neo instantly falls back to the other — no disconnect, no interruption. A lightweight HUD shows you the latency of both connections in real time so you always know what's going on.

If a server only allows one connection per account, Neo automatically switches to single-connection mode.

TCP 🌐

TCP (Transmission Control Protocol) ensures reliable, ordered, and error-free data delivery between devices.

Key Functions

• Data Segmentation — Splits large data into smaller packets
• Connection-Oriented — Uses a three-way handshake before transmission
• Reliability — Automatically retransmits lost packets
• Ordered Delivery — Reassembles packets in the correct order
• Flow Control — Prevents overwhelming the receiver

---

The Two Connections🔗:

Neo runs two separate TCP connections to the server at the same time. Each one has a specific job — they never interfere with each other.

1. Connection A — Primary
   This is the most important connection. It stays open at all times and handles everything that needs to reach the server instantly:

• Player movement and position
• Combat — dealing and receiving damage
• Chat messages
• Keepalive packets — telling the server you are still online

If Connection A ever drops, Connection B takes over immediately with no disconnect.🔄

2. Connection B — Secondary
   This connection handles everything that is large or non-critical:

• Chunk loading — the world around you
• Entity updates — other players, mobs
• Inventory and block data

Because this data travels separately, it never slows down your movement or combat packets on Connection A.

How they work together🛡️:
Both connections run in parallel the entire time you are on a server. Neo constantly monitors the ping of both and can promote Connection B to primary if it becomes faster. A small reordering buffer makes sure all incoming data arrives in the correct order before it reaches the game — so Minecraft never notices there are two connections running underneath.

neoline-network.json 📡

{ "dual_tcp": true, "mode": "split", "prefer_lower_ping": true, "hud": true }

What each option does
"dual_tcp"

---

true false

Turns the entire mod on or off. Set to false to fall back to a normal single connection, without uninstalling the mod.

---

"mode"

split failover loadbalance
split — divides packets across both connections by type (recommended).
failover — uses only connection A, but instantly switches to B if A drops.
loadbalance — distributes all packets evenly across both connections for maximum throughput.

---

"prefer_lower_ping"

true false
When enabled, Neo automatically promotes whichever connection has the lower ping to primary. Useful if your network quality fluctuates.

---

"hud"

true false
Shows a small overlay in-game displaying the latency of both connections and the current mode. Set to false to hide it.

Packet structure: 🔦

Every packet Minecraft sends consists of three parts:

1. Length — how large the packet is, so the receiver knows when it ends

2. Packet ID — a number that defines what the packet is. For example:

0x00 → Keepalive (still connected)
0x14 → Player movement
0x21 → Chunk data
3. Payload — the actual data, for example the player's XYZ coordinates

Simplified, a packet looks like this:

[ Length ] [ Packet-ID ] [ Data... ]
   4 Byte     1-3 Byte    variable

How Neo uses this:

Neo only looks at the Packet ID and decides based on that which connection the packet gets routed to. The length and payload are never touched — the server receives the packet exactly as Minecraft built it.

— Frequently Asked Questions — ☎️

Will I get banned? → No
Neo does not modify gameplay or inject cheats. It only changes how the client manages network traffic.

Does it work on every server? → Mostly (if the server has the plugin)
Neo works on the vast majority of servers. If a server only allows one active connection per account, Neo automatically falls back to a standard single connection — so you will never get kicked because of the mod.

Does it make your game smoother? → Partly
Neo makes your connection more stable, not your FPS. Chunk loading feels faster and disconnects become much less frequent. However, if your issue is low FPS or server-side lag, Neo will not help with that — it is purely a network-level mod.

fun fact

fun fact: neoline aka neo (not funny tbh)

License 📜

Copyright (c) 2026 Neoline

All Rights Reserved.

You may not redistribute, modify, reupload, sell, or distribute this mod or any part of it without explicit written permission from the author.

---

Other versions coming soon! Please be pacient,

the mod is the plugin and the mod!