WristHub - V1 Beta

Heads up: this is the first public beta. The main features are working, but you may still run into a weird avatar, a preview that falls back to a silhouette, or something that needs more headset tuning. I am actively improving it, and there will be more features and cleaner updates after V1.

Hey! I made WristHub because I wanted a simple way to find, download, preview, and equip BONELAB avatars without constantly leaving the game or digging through folders.

It puts an avatar library right above your wrist. You can browse everything you already have, search BONELAB mod.io, download new avatar packs, preview compatible avatars in 3D, and equip them from the same menu.

Quick tutorial

1. Install WristHub and launch BONELAB.
2. Look directly at your left wrist and keep looking for about 1.5 seconds.
3. A cyan progress circle will fill up, followed by a PUSH ME button.
4. Touch PUSH ME with your fingertip or controller tip.
5. Choose Avatars to browse your library, or Search Avatars to look for something new.
6. Use All Avatars to scroll through everything, or Groups to browse by downloaded mod pack.
7. To search, touch the search field, type with the tablet keyboard, and press Search. WristHub searches your installed avatars and the BONELAB avatar section of mod.io automatically.
8. If you do not own a result yet, press Download and watch the live progress bar. WristHub will open the downloaded pack when it is ready; it will never equip something automatically.
9. Press Equip, or grip/pinch a working 3D preview, pull it toward your chest, and release it to equip.
10. Press the X to close the menu. Look away from your wrist before activating it again.

The left wrist is the default. You can switch to the right wrist, change the UI scale, reduce motion, choose the starting library view, or recenter everything from Options.

What is included in V1

• A physical wrist launcher with gaze progress and fingertip controls.
• All-avatar and mod-pack group browsing.
• Zero-setup BONELAB avatar search; players do not need to enter an API key.
• Safe mod.io downloads with progress, retry, cancel, platform checks, archive validation, and integrity checking.
• One focused avatar view with artwork, details, height, and compatible 3D previews.
• Direct Equip and grip/pinch-to-chest equipping.
• Pack deletion with recoverable trash protection.
• Remembered browser settings and avatar persistence across compatible scene changes.
• LabFusion-aware avatar swapping and local wrist controls.

Beta notes

This is V1, so I would rather be honest than pretend every community avatar is built perfectly. Some avatars have unusual rigs, missing materials, huge effects, or broken preview information. WristHub contains those previews and uses a safe fallback when it cannot build a reliable 3D model. The normal Equip button remains available.

The online catalog is also new. Search results are cached and rate-limited so everyone can use it without setup. Advanced users can optionally save a personal read-only mod.io key in UserData/WristHub/modio-api-key.txt as an automatic backup, but regular players do not need one.

If something feels off, send the newest file from BONELAB/MelonLoader/Logs along with a short explanation of what you were doing. Please never post an API key.

Fusion

WristHub does not require LabFusion. When Fusion is installed, WristHub keeps its interface local and uses the compatible avatar-swap route when available. Other players still need Fusion's custom-avatar downloading enabled to see avatar content they do not already have.

Updating from BoneHub

WristHub copies compatible settings, download history, and avatar history from the old UserData/BoneHub folder on first launch. Remove BoneHub.dll and BoneHub.Core.dll before manually installing WristHub; do not load both versions together.

Manual installation

1. Install MelonLoader and BoneLib for the current BONELAB patch.
2. Copy WristHub.dll and WristHub.Core.dll into BONELAB/Mods.
3. Remove the two old BoneHub DLLs if they are present.
4. Launch BONELAB and follow the wrist tutorial above.

Online content is provided through mod.io and is subject to the mod.io Terms of Use and Privacy Policy.

Thanks for trying the first beta. This is only the start - I have more ideas for the wrist hub, better previews, smoother controls, and more useful tools in future updates. Have fun with it.

WristHub is an independent community mod and is not affiliated with Stress Level Zero, mod.io, Thunderstore, or the LabFusion team.

Changelog

2.0.1 - Cleaner download progress hotfix

• Replaces the two competing download indicators with one rounded progress capsule directly beneath the Download/Cancel action.
• Keeps the live state and percentage inside the same capsule for a calmer, easier-to-read tablet layout.
• Removes the duplicate changing percentage from the status area while preserving readable failures and Retry behavior.
• Keeps the existing secure download, installation, cancellation, and progress smoothing behavior unchanged.

2.0.0 - V2 Beta

This public V2 release includes the complete WristHub rebuild completed since the last uploaded version, 1.2.3.

Wrist launcher and tablet

• Rebuilt the menu around a 1.5-second wrist-gaze progress ring, physical PUSH ME prompt, compact hub, and readable wrist-following tablet.
• Added left/right wrist selection, recentering, manual UI scale, Reduced Motion, automatic equipped-avatar height scaling, look-away rearming, and immediate closing on player death.
• Added cleaner rounded controls, bounded text, dedicated pages, fingertip touch feedback, haptics, and safer input transitions that prevent one press from activating a control on the next page.
• Added a lightweight pooled forearm projection and tablet reveal that can be dimmed or disabled.

Library and search

• Added All Avatars browsing across every installed pack and Groups browsing by mod pack, with Remember Last, All, and Groups startup choices.
• Added stable previous/next navigation, recent-first ordering, pack drill-down, position counters, and refresh recovery for libraries containing thousands of avatars.
• Replaced the unreliable external keyboard flow with an in-tablet QWERTY search page.
• Search now filters local avatar and pack names immediately, queries the BONELAB avatar catalog on mod.io, merges duplicates, and returns directly to focused results.
• Added zero-setup public search so normal players do not need an API key; a personal read-only key remains an optional fallback.

Downloads and installation

• Added live progress, status, cancellation, retry, integrity checking, archive validation, platform checks, dependency handling, and readable failures.
• Added support for named BONELAB manifests such as <pack>.pallet.json, plus targeted pallet loading after installation.
• Fixed completed downloads remaining stuck on LOADING; WristHub now binds the selected result to its real runtime crate and exposes EQUIP, or provides a visible Rescan action if the pallet needs attention.
• Added separate Windows and Android file discovery with PC + QUEST, PC ONLY, and QUEST ONLY availability labels.
• Added permanent non-null artwork fallbacks, corrupt-cache recovery, coalesced thumbnail requests, and stale-callback protection.

3D previews and interaction

• Rebuilt previews as a single safe render-only hierarchy using declared body, head, and hair renderers without third-party scripts, physics, audio, weapons, cameras, or effects.
• Restored consistent facing, live renderer measurement, repeated center correction, and an exact shared 16 cm display height so normal, tiny, giant, and offset-root avatars stay in the same preview area.
• Added full-color materials, BONELAB native preview-mesh fallback, controlled silhouettes, renderer/complexity limits, and clear limited-preview states that do not falsely block Equip.
• The height ruler now reports the avatar's original BONELAB in-game height in meters rather than the normalized preview height.
• Added controller-grip and tracked-hand pinch dragging with hand-relative offsets, late pose updates, Fusion rig-replacement recovery, smooth return, and release-at-chest equipping.
• Removed incomplete Marrow grip components that caused hand-hover error loops.

Equipping and persistence

• Equipping now uses BONELAB's guarded native avatar path, retains the current avatar for rollback, and quarantines a failed crate until its pallet reloads.
• Added the native BodyLog avatar-change effect without duplicating the cord animation or swapping twice.
• Saves successful avatar choices through BONELAB's current-avatar persistence path so they survive compatible level changes and game restarts.
• Separates preview compatibility from equip compatibility, allowing valid community avatars with limited preview metadata to remain equipable.

Pack deletion

• Replaced the small trash action with a clear DELETE PACK control and confirmation page.
• Deletes the complete containing pack, related pallet sidecars, WristHub state, recents, preview caches, and multiplayer registration through a recoverable transaction.
• Safely switches away from a currently worn pack before deletion and supports subscribed-pack cleanup, rollback, and Undo.
• Windows-locked packs are hidden immediately and queued for safe deletion during the next launch rather than failing with an access-denied message.

Fusion multiplayer sharing

• Added ModioModNetworker 2.8.1 as a required dependency for its established Fusion lobby download flow.
• Generates and repairs Networker-compatible metadata containing the exact pallet/mod.io pairing and genuine PC/Quest file targets.
• Restored the proven registration-before-equip gate in live Fusion sessions so the exact pallet is known before the avatar announcement peers receive.
• Uses Fusion's official avatar sender and ModioModNetworker's normal patch exactly once; WristHub does not directly invoke Harmony patches or run a competing peer downloader.
• Keeps pending sharing state through lobby joins and Fusion rig replacement, then performs one official resend only when registration was delayed.
• Recipient auto-download, maturity, blacklist, size, subscription, and platform choices remain fully respected.

Performance, reliability, and branding

• Renamed BoneHub to WristHub across the UI, DLLs, logs, settings, logo, and Thunderstore presentation, with automatic migration of compatible BoneHub data.
• Pooled UI and hologram geometry, batched large-library refreshes, delayed expensive preview work during rapid paging, cancelled stale work, and removed avoidable per-frame allocations and logging.
• Split browser updates into guarded subsystems so a projection, touch, preview, download, or installation failure cannot stop the rest of the tablet.
• Added throttled, sanitized diagnostics without logging search contents or API keys.
• Added scene, respawn, avatar-swap, and Fusion-rig recovery while preserving installer security and native rollback protections.

Feedback

• Found a bug or want to request a new feature? Message me on Discord at @parzival3d.

1.2.3 - Avatar download repair

• Fixed valid BONELAB avatar packs being rejected when they use a named manifest such as PCGenie.Chappie.pallet.json.
• Updated installation checks and runtime pallet loading to support both pallet.json and <pack>.pallet.json.
• Preserved archive traversal, executable-content, platform, size, and integrity protections.

1.2.2 - Thunderstore install fix

• Corrected the BONELAB Thunderstore package layout so both WristHub DLLs install into the game Mods folder.
• Kept the V1 beta features, zero-setup avatar search, and BoneLib dependency unchanged.

1.2.1 - V1 Beta

• Marked WristHub clearly as the first public beta and added a complete left-wrist tutorial.
• Added the hosted WristHub avatar catalog so every player can search and download immediately without entering an API key.
• Restricted the public service to read-only BONELAB avatar metadata routes with input validation, caching, and rate limiting.
• Kept personal local API keys as an optional automatic fallback if the hosted catalog is temporarily unavailable.

1.2.0 - WristHub

• Renamed BoneHub to WristHub across the in-game interface, logs, DLLs, settings folder, and release branding.
• Added automatic migration from the legacy BoneHub UserData folder without deleting the old copy.
• Added a new WristHub icon and Thunderstore-ready storefront package.
• Kept the tablet browser, search keyboard, normalized 3D previews, grab-to-chest equip, All/Groups library, downloads, trash recovery, persistence, and Fusion synchronization.

1.1.10

• Centered installed avatar previews using their visible renderer bounds.
• Added safe pack removal with confirmation and recoverable trash.
• Restored the selected avatar after scene and local-rig changes.
• Added Fusion's native avatar-swap path when available.