Home›Java›Mods›JadeBridge
JadeBridge
ModsJava

JadeBridge

Java mod listed for Minecraft 26.x. Downloads from the MC Java Mods app on Android.

by DarkSpirit006 · on Modrinth

⬇ Download on Modrinth

Jade works well in singleplayer. On a multiplayer server, though, most of its useful information disappears: the client can't see inside a chest or read a furnace's burn timer, because that data lives on the server and a vanilla server never sends it.

JadeBridge fills that gap. It speaks Jade's protocol, answers the client's requests, and supplies the data the client can't get on its own. Players install Jade as usual, you install this, and the overlay matches what they'd see in singleplayer.

Requirements

Minecraft 26.3
Server Paper 26.3 (built against development bundle build 142)
Jade (client) 26.3.x, protocol version 9
Java 25

Purpur 26.3 is intended to be compatible, since nothing fork-specific is used, but it hasn't been tested separately. Older Minecraft versions aren't supported.

If a player's Jade uses a different protocol version, the handshake simply won't match and nothing happens: no errors and no half-working overlay.

What it shows

Blocks and containers

Entities

Other

Everything Jade can work out on the client is left alone, since there's no point duplicating it: health and armor bars, crop growth, note blocks, TNT, signs, player heads, item frames and paintings, horse stats, villager professions, and breaking progress.

Anything built on vanilla block entities works without changes, including datapack-modified blocks. Custom GUIs that aren't real block entities won't appear, because there's nothing for the server to read.

Config overrides

Jade reads some of its settings from the client, so a player can hide health numbers or show twenty potion effects at once. If you'd rather control that for your server, config-overrides pushes values to the client during the handshake. This is the feature I'm happiest with, and I haven't seen it in other server-side tooltip plugins.

config-overrides:
  'minecraft:entity_health': true
  'minecraft:potion_effects.limit': 4

Keys are Jade config IDs, and values can be booleans, numbers, or strings. Invalid entries are logged and skipped, so they never break the handshake.

Installation

  1. Drop the jar into plugins/.
  2. Start or restart the server.
  3. Make sure players have Jade 26.3.x on their client.

plugins/JadeBridge/config.yml is created on first start.

Configuration

enabled: true
debug: false

bstats:
  enabled: true

rate-limit:
  block-requests: 20
  entity-requests: 20

max-position-deviation: 21

config-overrides: {}

Commands

All commands require jadebridge.admin, which defaults to ops. Grant it to other roles through your permissions plugin.

Command Description
/jadebridge status Protocol version, active sessions, and request counts
/jadebridge providers Lists registered block and entity providers
/jadebridge reload Reloads the config and resets request counters
/jadebridge update Checks the latest stable Modrinth release and shows the install link
/jadebridge debug Shows the current debug setting
/jadebridge debug on / off Enables or disables debug logging

Can players use this to cheat?

This question comes up with anything that shows hidden information, so here is how it works.

Known limitations

Support and source

Found a bug, or a provider gives bad output on your setup? Open an issue on GitHub with your server build and Jade version and I'll take a look. The repo also has architecture notes, protocol notes, and a full provider list, plus build instructions if you'd like to compile it yourself. Licensed under MIT.

Usage stats

bStats Statistics

JadeBridge collects anonymous, aggregate usage data through bStats: server count, player counts, and Java and Minecraft versions. Nothing identifying and no player data. Set bstats.enabled: false in the config to opt out.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more