Better List Integration

Server-side companion plugin for the Better List Fabric mod.

It enables the mod's party progress sync on Bukkit-family servers. The plugin is a thin relay: it manages party membership in memory and forwards the mod's bml:sync messages between party members. It never inspects or stores the synced build data.

🔌 You only need this plugin if your server is Bukkit-based (Paper, Purpur, Spigot…). On a Fabric server, just install the BML mod itself server-side instead — no plugin required. Without either, all single-player features of the mod still work.

✨ What it does

• Party management — invite / accept / leave / kick, with sensible guards:
  • you can only accept a party you were actually invited to
  • only the party leader can invite or kick
  • the leader leaving disbands the party
• Packet relay — forwards all SYNC_* messages unchanged between party members, so the mod's data format can evolve without plugin updates.
• Robust — malformed packets are safely ignored (no console spam), all data stays in memory.

📥 Installation

1. Make sure your players have the BML — Better Material List mod installed.
2. Drop the plugin jar into your server's plugins/ folder.
3. Restart the server. You should see: BML Integration enabled. Listening on the bml:sync channel.

✅ Compatibility

• Paper (recommended), Purpur, Spigot, and forks/hybrids exposing the Bukkit API.
• Built against the Bukkit API for Minecraft 26.1.2.

License

All Rights Reserved.