You are viewing a potentially older version of this package. View all versions.
Quartz-FusionPresence-1.0.0 icon

FusionPresence

Posts to a Discord webhook when you join, host or leave a Fusion lobby, with the map, live player count and full roster. Reads other players' names.

By Quartz
Date uploaded 3 days ago
Version 1.0.0
Download link Quartz-FusionPresence-1.0.0.zip
Downloads 18
Dependency string Quartz-FusionPresence-1.0.0

This mod requires the following mods to function

bonelib-BoneLib-3.2.2 icon
bonelib-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.2.2
Lakatrazz-Fusion-1.14.2 icon
Lakatrazz-Fusion

A multiplayer mod for BONELAB, taking advantage of its physical interaction.

Preferred version: 1.14.2

README

Fusion Presence

Posts to a webhook whenever you join, host, or leave a Fusion lobby.

Each post carries your name, the lobby name and host, the current map, the live player count, and the full roster at that moment. Built for Discord webhooks out of the box, with a flat-JSON mode if you'd rather point it at your own endpoint.

Useful if you want a channel that quietly logs where you've been playing, or a group that wants to see when someone's lobby is live.


⚠️ What data leaves your game

Read this before installing.

This mod sends data to a URL you configure. Nothing is sent anywhere until you set one, and there is no default endpoint — nothing phones home to me.

What it sends, when it's enabled:

  • Your Steam/platform username
  • The usernames and nicknames of everyone else in the lobby
  • The lobby name, host name, privacy setting and player count
  • The current map
  • Optionally, the lobby join code (off by default)

That second one is the point worth pausing on. Those names are already visible to anyone in the lobby, but they're going somewhere the other players didn't choose. If that matters for wherever your webhook points, turn off Player list under Message Contents — everything else still works.

The join code is off by default because anyone who can read the channel your webhook posts to could use it to join your lobby.


Setup

  1. In Discord: Server Settings → Integrations → Webhooks → New Webhook → Copy URL.
  2. In game: BoneMenu → Fusion PresenceWebhookSet URL and paste it with the VR keyboard.
  3. Press Send test message. The status line right underneath tells you what happened.

After that it's passive. Join a lobby and a post appears.

The menu never shows the full URL again — the token in it is a credential, so it only displays the last six characters.

What gets posted

Event Default
You join a lobby on
You start hosting on
You leave on
A player joins or leaves off
The lobby changes map on

Player join/leave is off by default because it's chatty; when on, a burst of joins is debounced into a single post.

Message contents are individually toggleable: player list, nicknames, permission levels, level barcode, join code.

Notes

  • Nothing HTTP runs on the game thread. Posts go through a bounded queue drained by a background thread, so a slow or dead webhook can't cost you a frame in VR.
  • Requests are spaced out and back off on Discord's rate limit.
  • The join post is deliberately delayed a few seconds, so the host's lobby info and the full roster have arrived before it fires. You can tune this under Timing.
  • Player names are stripped of rich text and escaped before they're sent, so a name with colour tags or markdown in it can't mangle the post.
  • Settings live in UserData/MelonPreferences.cfg under [FusionPresence] if you'd rather edit them outside VR.

Requirements

  • BONELAB Patch 6
  • MelonLoader
  • BoneLib
  • Fusion

Fusion is a soft dependency — the mod loads and the menu works without it, it just has nothing to report.

Credits

Made by Quartz.

CHANGELOG

Changelog

1.0.1

  • Fixed: the webhook URL wasn't saving. BoneMenu's string element doesn't fire its callback when the keyboard submits, so the typed URL was dropped unless you happened to click the element a second time. There's now an explicit Save URL button, and the value is read directly from the element.
  • Fixed: toggles didn't persist. Settings were only written on a clean exit, so a crash or alt-F4 reverted everything you'd changed. Every toggle now saves the moment you flip it.
  • Fixed: long level barcodes wrapped mid-word in the embed. The barcode is now its own full-width field.
  • Added Diagnostics → Dump settings to log for troubleshooting. It omits the webhook URL.

1.0.0

  • Initial release.
  • Posts to a webhook on lobby join, host, leave, roster change and map change.
  • Discord embed and flat-JSON payload modes.
  • BoneMenu configuration: webhook URL, per-event toggles, message contents, timing, diagnostics.
  • Background send queue with rate-limit backoff; nothing HTTP touches the game thread.