JadePaperBridge implements the server side of the Jade mod's network protocol on Paper.
Jade is a client mod that shows a tooltip for the block or entity you are looking at. Some of that information only exists on the server: furnace progress, chest contents, villager restocks, absorption hearts, pet owners and more. Normally Jade only gets it from a server that runs Jade too, so on Paper these options say "This feature requires the server to have Jade installed".
With this plugin, Jade clients get the same server data they would get on a modded server. Players don't need anything extra, and players without Jade aren't affected.
Unofficial. This project is not affiliated with or endorsed by Snownee or the Jade project. Please don't report problems with this plugin to the Jade issue tracker.
Requirements
- Paper 26.3 (or forks like Purpur), Java 25. Spigot is not supported.
- Players use Jade for Fabric 26.3.x
Supported features
All server features of Jade's built-in vanilla plugins.
Blocks
| Jade option | What the client shows |
|---|---|
| Furnace | Input, fuel, output and cooking progress (furnace, smoker, blast furnace) |
| Brewing stand | Remaining fuel and brewing time |
| Beehive | Number of bees inside |
| Campfire | Items and their remaining cooking time |
| Command block | The command (operators only) |
| Hopper lock | Whether a hopper is locked by redstone |
| Jukebox | The disc that is playing |
| Lectern | The book on the lectern |
| Redstone | Comparator output, calibrated sculk sensor input |
| Shelf | The book / item in the looked-at slot |
| Trial spawner | Cooldown |
| Item storage | Contents of chests (incl. double chests), barrels, shulker boxes, hoppers, dispensers, your own ender chest, … plus "loot not generated" and "locked" hints |
| Fluid storage | Cauldron contents |
| Object name | Custom names of renamed blocks |
Entities
| Jade option | What the client shows |
|---|---|
| Health | Absorption hearts |
| Potion effects | Active status effects |
| Animal owner | Owner of tamed animals |
| Mob growth | Time until a baby grows up (incl. tadpoles) |
| Mob breeding | Breeding cooldown, "in love", allay duplication cooldown |
| Villager restock | Restocks today and time until the next restock |
| Next entity drop | Next egg, armadillo scute, sniffer sniff |
| Zombie villager | Remaining curing time |
| Pet armor | Body armor of pets |
| Waxed | Whether a copper golem is waxed |
| Item storage | Inventories of chest minecarts, chest boats, donkeys, mules, llamas |
The harvest tool hint also works. The plugin reads the blocks that need shears from the server's loot tables.
Not supported: the short fade-in of status effects (Jade records it with a mixin), modded storages/energy/progress (there are no mods on Paper), and Jade's debug loot table option.
Configuration
plugins/JadePaperBridge/config.yml:
# How many blocks beyond the player's interaction range a request may target.
max-position-deviation: 21
# Provider ids that are not offered to clients.
disabled-providers: []
# - minecraft:command_block
# Jade plugin options forced on every client (shown as locked in Jade's settings).
config-overrides: []
# - "minecraft:item_storage.normal_amount=9"
# Log handshakes and errors of individual providers.
debug: false
Run /jpb reload after editing. Connected Jade clients get the new settings right away.
Commands
| Command | Description |
|---|---|
/jpb reload |
Reload the config and resync all Jade clients |
/jpb status |
List online players that use Jade |
/jpb overlay <player> <show|hide> |
Turn a player's Jade overlay on or off |
All commands require jadepaperbridge.admin (default: op).
Protections
The same limits as in Jade: one request per player every 50 ms, no data beyond the player's reach, responses limited to 16 KiB, command block contents only for operators. Malformed packets are ignored instead of kicking the player.
Credits and license
Jade is made by Snownee and contributors and is licensed under CC BY-NC-SA 4.0. This plugin contains code adapted from Jade and is distributed under the same license, CC BY-NC-SA 4.0: free to share and adapt, non-commercial, with credit, under the same license.
Source code and issues: GitHub
Pinned Versions
- R26.3
Pages
Requires on the client
Members
1
Owner