🌉 Yggdrasil Bridge

Complete integration of Minecraft with the Yggdrasil Network and a fix for IPv6 addresses in local networks.

📜 Description

Yggdrasil Bridge is a client-side mod for Minecraft Fabric that solves two key tasks:

Fixes incorrect IPv6 address formatting in the game's LAN discovery system, eliminating server duplication and connection errors.
Provides full integration with the decentralized Yggdrasil Network, allowing you to discover and display game servers running on this network directly in the Minecraft interface.

⚠️ Important: The mod works in tandem with a server-side announcer. For a Yggdrasil server to appear in the list, it must be announced by a dedicated program.

✨ Features

🔧 IPv6 Fix (Works automatically)

Correct Format: Automatically converts addresses like fe80::1:25565 to the proper [fe80::1]:25565.
Eliminates Duplicates: Prevents the same servers from appearing multiple times in the list due to different address parsing.

🌐 Yggdrasil Network Integration

Automatic Search: When opening the multiplayer screen, the mod sends queries to known Yggdrasil announcers.
Custom Names: Replaces the standard "LAN World" label with a customizable network name (e.g., "Yggdrasil Network") for servers in the 200::/3 range.
Flexible Configuration: All query and display parameters are configured via a configuration file.

📥 Installation and Usage

1. Prerequisites

Your computer must have:

-Minecraft 1.21.11

-Fabric Loader for this version.

-Fabric API for this version. *(The mod depends on it for stable operation)*

-Yggdrasil Client and a configured Yggdrasil network.


2. Installing the Mod

1.  Download the latest version of yggdrasil-bridge-<version>.jar.

2.  Place the file in your Minecraft client's mods folder (usually %appdata%/.minecraft/mods).

3.  Launch the game.


3. Configuration (Optional)

On the first launch, a file named yggdrasil-servers.json will be created in the .minecraft/config/ folder.


No configuration is needed for basic operation. To change the list of announcers or the network name, edit this file:

{
"announcementServers": [
"200:89c7:3e08:ccbc:6c71:f774:1e4e:3b52"
],
"enabled": true,
"queryIntervalMs": 5000,
"showYggdrasilLabel": true,
"customNetworkName": "Yggdrasil Network"
}

⚙️ For Server Administrators (How to Make a Server Visible)

For your Minecraft server to appear in the Yggdrasil network through this mod, you need to:
1. Install and configure Yggdrasil on the machine running the Minecraft server.
2. Launch an announcer, for example, yggdrasil-announcer-minecraft.
3. Provide the announcer's IPv6 address to players. They will need to add this address to the announcementServers array in their client configuration.
Interaction Architecture:

[Yggdrasil Bridge Client] → (sends discovery query) → [Yggdrasil Network / Announcement Server] → (sends back server list) → [Yggdrasil Bridge Client] → (displays) → [Player's Minecraft Server List]

Yggdrasil Bridge is a client-only tool and cannot announce servers.

❓ Frequently Asked Questions

Q: My server is not visible on the network. What should I check?
A: Ensure three things:
1. Client: Players have the mod installed, the Yggdrasil client is running, and your announcer's address is added to their yggdrasil-servers.json.
2. Server: The Yggdrasil announcer is launched, configured, and running on the server machine.
3. Network: There are no routing issues in the Yggdrasil network between the client and the announcer.
Q: Is Fabric API definitely required?
A: Yes. The mod uses Fabric API's capabilities for stable work with the network stack and mixins. Without it, the mod may not start.
Q: Will the mod work on the server?
A: No, this is a client-side mod. Its task is to correct the display and request information on the client. A separate announcer is required for the server part.
Q: Are IPv6 addresses in the local network (LAN) also fixed?
A: Yes, the mod corrects the format of any IPv6 addresses discovered through the game's LAN search, regardless of the Yggdrasil network.

🔨 Technical Details

Minecraft Version: 1.21.11
Modloader: Fabric
Dependencies: Fabric API
Language: Java 21+
Configuration: .minecraft/config/yggdrasil-servers.json
License: MIT

📂 Project Structure and Contribution

The mod's source code, bug reports, and contribution opportunities are available on GitHub: https://github.com/tribetmen/yggdrasil-bridge