BlueSage QoL Tweaks - Beta

Active-development QoL toolkit for On-Together: Virtual Co-Working.

Current package: v0.0.7

This is for players and hosts who want small quality-of-life fixes without juggling five separate helper mods. It is not the big-lobby mod. For 64-player rooms, the host still needs BlueSagePatched PlayerLimitLift.

Beta note: this package is still active-development, so early 0.0.x re-uploads may happen quickly when player feedback catches real UI or lobby-edge bugs.

Community link: https://discord.gg/tthqADQAKa

Quick Start

Install it, launch the game, and use these first:

• Press Home or type /qolmenu to open the friendly settings menu.
• /styleui opens the color/name/status helper.
• Type @name in chat and press Tab to autocomplete a readable ping.
• Click minimap dots to open ID cards when BlueSage can safely match the player.
• Use /hh run as host for a quiet lobby-health check.
• Use /as now if a long session feels heavy.

What is on by default

Chat, names, and room text

• Chat send cap is raised from vanilla 250 to 1500 characters.
• Name, ID-card, and room-name fields default to 1500 characters.
• Power users can raise up to 4000 in /qolmenu, but longer text can wrap, clip, or behave weirdly after game updates.

Ping Mentions

• Type @partialname, press Tab, and BlueSage completes it to plain @FullName.
• Pinged messages get a visible [PING] marker.
• Mention text renders ping-yellow by default instead of inheriting rainbow/status name colors.
• @lobby can ping everyone who is running a compatible mention mod like this one.
• Sound is on by default. Sound modes: click, change, error, task, ticket.

Helpful commands:

• /setpingcolor FF66CC
• /pingsound status
• /pingsound task
• /pingsound off

Enhanced Player Panel

• Adds local @ and ID helper buttons to player rows.
• Buttons sit left of the native/Pomodoro/PomoSync action cluster so report, ignore, kick, and ban controls stay reachable.
• ID-card lookup uses safer row/index/SteamID/name fallbacks for larger lobbies instead of trusting the old vanilla 16-player assumptions.
• If another EnhancedPlayerPanel-style mod is already loaded, BlueSage skips safely instead of fighting it.
• BlueSage refreshes its own recycled-row button listeners, keeps report/ban stays clickable, and avoids covering Pomodoro/PomoSync row space.

MiniMap ID Click

• MiniMap dot-to-ID help is on by default in 0.0.7 because it proved useful.
• Click a minimap player dot to open an ID card when the dot can be safely matched.
• Name labels are guarded: crowded lobbies hide labels unless the map is zoomed enough, so the map does not become name soup.
• Toggle with /minimaplabels or /mml.

Reconnect Guard

• On for players by default.
• Tries up to 20 times about every 15 seconds.
• Then returns toward the normal menu/error flow instead of leaving players stuck in ghost lobbies forever.
• Hosts can turn it off with /rg off.

Asset Sweep

• Runs every 60 minutes by default.
• Helps long sessions reclaim unused Unity assets.
• If AndrewLin Sweep is loaded, BlueSage auto sweep backs off automatically.
• Interval safe range: 30-180 min.
• Manual /as now still respects safety guards.

Leave Notices and Focus Anywhere

• Leave notices are on by default.
• Focus Anywhere is on by default.
• Timestamps are off by default to keep chat cleaner.

Friendly Menus

/styleui

Use this if you want colored names, status text, gradients, or copyable styled text.

What it includes:

• Style, Status, and Templates tabs.
• Built-in color library with cozy colors plus classic web-color style choices.
• Color A/B/C buttons so players do not need to hunt hex codes elsewhere.
• Bold, italic, solid color, 2-color gradient, and 3-color gradient options.
• Reset Current to recover your current in-game name/status if experimenting gets messy.
• Apply Name for direct display-name updates.
• Copy Text for chat, ID cards, room names, or other text fields.
• Uses safe in-game player data updates and never writes profile files directly.
• Header Discord button.
• Resizable window, screen clamping, and vertical scrolling.

QoL Menu: Home, /qolmenu, or /qm

Use this if you do not want to memorize commands.

Tabs:

• Main: quick Sweep, Host Health, and Style UI buttons.
• Toggles: on/off controls for the major features.
• Customize: ping colors, ping sound, status fields, sweep interval, and text limits.
• Credits / Other: credits, safe asset purge, and tiny mostly local-only easter eggs. One suspicious DO NOT PRESS egg sends a tiny @Blue lobby joke once, then only shows local messages.

The easter eggs are local-only. They use PlayerPrefs for a found count and never send chat, network messages, or profile edits. Players can screenshot/share finds in Blue's Discord for fun.

Common Commands

• /qol status or /bsqol status: show current BlueSage states.
• Home, /qolmenu, or /qm: open the QoL menu.
• /styleui or /sui: open the Style Helper.
• /style or /sty: build styled text from chat commands.
• /style color FF66CC hello: copy styled text.
• /setname, /status, /clearstatus, /statuscolor: set your display name/status through safe in-game player data without editing save files directly.
• /setname Blue: set your display name through safe in-game player data.
• /status Reading: add a small status to your name.
• /clearstatus: remove status text.
• /statuscolor FFD45D: set status color.
• /assetsweep or /as on/off/status/now: asset sweep controls.
• /hosthealth or /hh on/off/status/run: host-health controls.
• /leavenotices or /ln on/off/status: leave notice toggle.
• /timestamps or /tt on/off/status: chat and notice timestamps.
• Timestamps apply to chat plus join/leave/system notices when enabled.
• /reconnectguard or /rg on/off/status: reconnect guard toggle.
• /reconnectmessage or /rm on/off/status: reconnect success message toggle.
• /focusanywhere or /fa on/off/status: focus-anywhere toggle.
• /minimaplabels or /mml on/off/status: minimap ID/label helper.

Using a toggle command without on or off flips the current setting.

Settings file

After launching once, settings live here:

BepInEx/config/com.bluesage.ontogether.qoltweaks.beta.cfg

Most players should use Home or /qolmenu instead of editing the file directly.

Important defaults:

• EnableAutoSweep: true
• SweepIntervalMinutes: 60
• EnableHostHealthMonitor: false
• EnableLeaveNotifications: true
• EnableChatTimestamps: false
• EnableReconnectGuard: true
• EnableReconnectAnnouncement: true
• EnableFocusAnywhere: true
• EnableEnhancedPlayerPanel: true
• EnablePingMentions: true
• EnablePingSound: true
• PingSoundMode: click
• PingHighlightColor: 9B59B6
• PingMentionColor: FFD700
• EnableNotificationTimestamps: false
• EnableStyleUi: true
• EnableMiniMapPlayerLabels: true
• MaxChatCharacters: 1500
• MaxProfileCharacters: 1500
• MaxSessionNameCharacters: 1500

Old beta config files may still contain removed settings. BlueSage ignores risky removed settings now. If something acts odd after updating, delete the config and launch once to regenerate it.

Compatibility

• BlueSage only checks mods BepInEx actually loaded.
• Disabled .old, .bak, .disabled, or .dll.disabled files are ignored.
• BlueSage does not delete, rename, edit, or disable another creator's mod files.
• If AndrewLin Sweep is loaded, BlueSage auto sweep backs off.
• If Simple_QOL or ChatTweaks-style mods are loaded, BlueSage avoids duplicate timestamp/leave-notice formatting.
• If AndrewLin Reconnect is loaded too, BlueSage slows/guards reconnect pressure instead of rapid-firing reconnects.
• If BlueSage PlayerLimitLift is loaded, Host Health can include cap/default/chat-relay state.

If Something Feels Weird

• Run /qol status first.
• Open /qolmenu and turn off only the feature that feels weird.
• Reopen the player list if buttons look stale after scrolling a huge lobby.
• Use /mml off if minimap labels feel cluttered.
• Use Reset Current in /styleui if your name/status experiment goes sideways.
• If hidden diagnostics are enabled for testing, check BepInEx logs for [BlueSageDiag] lines.

Credits

Made by BlueSage for the On-Together community.

Inspired by helpful community mods and projects including:

• AndrewLin Sweep
• AndrewLin Reconnect
• Tiny_Plume Simple_QOL
• jaide EnhancedPlayerPanel
• jaide PingSystem
• WhozScott ServerFavorites and Heartbeat
• YenRex ShaderPlayground
• OnToWelcomeCommittee FocusAnywhere
• officerballs PlayerLimitLift and StatusManager
• On-Together Name Customiser
• OnTogetherModTemplate

Source/reference links are kept in the project repo so the Thunderstore page stays readable.

Changelog

[0.1.7 Early Access] - 2026-07-06

Hotfix

• Fixed Chat Backdrop breaking mouse-wheel chat scrolling. The backdrop now only adjusts/restores vanilla chat image color and alpha; it no longer disables the raycast targets Unity uses to route scroll input.
• Kept the 0.1.6 scroll-ownership cleanup: BlueSage still avoids rewriting vanilla ScrollRect movement/sensitivity while preserving chat height, font size, whole-panel scale, outlines, retained rows, and /chatvanilla.

[0.1.6 Early Access] - 2026-07-06

Hotfix

• Fixed chat scrolling compatibility after the 0.1.3 chat layout work. BlueSage no longer rewrites vanilla ScrollRect movement, scroll sensitivity, scrollbar visibility, or viewport mask settings during chat refresh.
• Chat height, chat font size, whole-panel chat scale, outlines, backdrop, and retained rows still work, but native chat scrolling and scroll-speed mods keep ownership of actual scroll input.
• Kept /chatvanilla and the Customize reset button as the safe reset path for chat scale/font/height back to vanilla values.

[0.1.5 Early Access] - 2026-07-06

Emergency Hotfix

• Fixed a 0.1.4 reconnect loop where players who had already entered a healthy lobby could be misread as stuck and forced back through join again.
• Reconnect Guard now treats visible lobby entry as success and stops interfering while the game finishes settling local player/chat runtime objects.
• Native join-by-code watchdog is now observational: it records debug breadcrumbs but does not force a saved-lobby retry or menu fallback after lobby entry succeeds.
• /bluedevdebug breadcrumbs are on by default so community logs include clearer reconnect and UI diagnostics. Use /bluedevdebug off for quieter logs.

[0.1.4 Early Access] - 2026-07-06

Hotfix

• Reconnect Guard now requires the local player/chat runtime to finish loading before it declares reconnect success, instead of trusting transport/lobby signals alone.
• Added a guarded join-by-code loading watchdog: if a lobby join enters a stuck loading state, BlueSage retries that saved lobby once and then returns toward the menu instead of leaving the player trapped until relaunch.
• Reconnect fallback now clears the unhealthy multiplayer session before calling the game's normal menu return path, without re-triggering another guarded reconnect loop during that fallback.

[0.1.3 Early Access] - 2026-07-05

Chat Layout Upgrade

• Added ChatWindowHeightPercent for players who want taller chat space without scaling text or UI. Default stays vanilla 100; supported range is 100-200.
• Added /chatheight, /chatstretch, and /chath plus on/off/toggle, Customize -> Chat window height, Save/Undo, typeahead suggestions, and /qol status reporting as ChatWindowHeight.
• Added ChatFontSizePercent for players who want larger chat message text without scaling the whole chat UI. Default stays vanilla 100; supported range is 75-200, with /chatfont, /chatfontsize, and /cf.
• Added /chatvanilla, /chatreset, Customize -> Reset Chat UI to Vanilla, and unload/reset restoration for whole chat UI scale, chat font size, and chat window height.
• Retained chat logs are now automatically raised to 250 rows for both Global and Local, so players can scroll back through longer sessions even if they leave chat height at vanilla size.
• The larger chat window uses the same verified chat panel roots as the existing scaler, with stable vertical expansion that avoids the older width-expansion path until native wrap-width behavior is proven reliable.
• Retained rows use the current GameSettings.GlobalMessageLimitCount and GameSettings.LocalMessageLimitCount getter path, raising the game limits without touching chat networking or message text.
• Height reset restores vanilla layout, while active height changes keep the current bottom edge stable so players can still use the native chat drag handle for final positioning.
• Refreshed in-game wording, README, and UAT notes to make the difference clear: /chatfont is for bigger message text only, /chatscale is for scaling the whole chat UI, /chatheight is for more vertical visible space, and deeper retained rows are automatic.
• Documented that native Global/Local chat tabs remain game-owned in this release while BlueSage improves readability, retained rows, font size, whole-panel scale, and vertical height around them.
• Reconnect Guard now waits about 5 seconds before its first managed reconnect attempt, limits itself to 3 short attempts, validates that the visible lobby/player UI becomes usable before calling reconnect successful, then tries the saved last lobby once through the game's native join-by-code flow before falling back toward the normal menu flow if the stuck void-lobby state remains.
• If AndrewLin Reconnect is installed, BlueSage now defers to that mod's reconnect loop instead of stacking competing reconnect behavior.
• Added Clone Shield as a defensive local warning when another visible roster row appears to reuse your current avatar/outfit. It ignores shared name colors, font styling, and status text to avoid false positives, warns locally only, and does not perform moderation actions.
• Added optional Player Render Saver for very large lobbies. It is off by default, local-only, hides far/overflow remote player renderers on your PC only, keeps chat/player-list rows visible, and restores renderers when turned off.
• Tuned QoL Menu and Style Helper max-safe opening size down slightly so they still auto-fit but leave more game/chat area visible on launch.

[0.1.2 Early Access] - 2026-07-04

Feedback Polish

• Tuned final feedback defaults: Spoons remains opt-in/off by default, Ping Sound stays on the ticket sound, and default chat outline intensity is now 75.
• Older enabled Spoons configs are reset to hidden once on update so the compact tag is truly opt-in again; players can turn it back on with /spoons on, /spoons 0-5, or Style Helper.
• Existing users with untouched 50 or short-lived 60 chat outline defaults migrate to the current 75 default on update while custom outline values are preserved.
• Name Styler and Status Styler now draw from the same responsive color library layout so their swatch choices match cleanly.
• QoL Menu and Style Helper now open at their largest safe on-screen size, keep a small game/chat lane visible where possible, and still let players shrink them with the bottom-right resize handle.
• Menu helper text and footer guidance are more noticeable so players can hover a control and see the exact answer without hunting through docs.
• Home toggles the QoL Menu, Insert toggles Style Helper, lobby welcome tips call out the main keys/commands, and /back restores the status that was active before /brb or /afk when possible.

[0.1.1 Early Access] - 2026-07-03

Hotfix

• Restored chat readability outline behavior after the 0.1.0 release: exact true-black rich-text names/messages now trigger the configured black-text outline color again, including <#000000>, <color=#000000>, and <color=black> tags.
• Kept black detection precise so dark-but-not-black colors like #000080, #000001, and #101010 still use the normal outline color instead of being forced onto the black-text outline path.
• Made the local UI outline/shadow apply its configured alpha directly so normal and black outline colors render more consistently over bright or busy backgrounds.

[0.1.0 Early Access] - 2026-07-03

Highlights Since 0.0.10

• Full Early Access QoL menu flow: Home or /qolmenu opens settings, /styleui opens Name Styler, Status Styler, templates, colors, and optional Spoons, and Run QoL Status gives a quick local feature check.
• Chat readability/accessibility is now a first-class feature: local outline/shadow, restored TMP material outline, /chatoutline 25-100, /chatscale and /chatresize 75-200, Customize -> whole chat UI scale, back on-screen nudging for scaled panels, /chatoutlinecolor, and /blackoutlinecolor.
• BlackNamesOutline=on/off defaults on so true-black styled chat/name rows can use the lighter black-text outline color instead of disappearing into dark chat backdrops.
• Longer text defaults are now 3000 for chat, Name/ID fields, ID-card details like About Me/FavoriteQuote, and room names, with cautious local tuning up to 4000.
• Chat links are easier to read and safer to use: links get hyperlink color, plain click copies, and Shift-click warns before opening.

Polish And Defaults

• Existing users get a one-time safe config migration: old untouched text limits move to 3000, old 60-minute sweep defaults move to 30, untouched outline intensity moves to the current default, and Spoons moved toward opt-in instead of being assumed visible for everyone.
• Ping Mentions now default to the ticket sound, including migration from the old untouched click default.
• QoL Menu and Style Helper are cleaner: toggles use normal On/Off buttons, Customize keeps safe editable rows with Save/Undo, identity edits live in Style Helper, and Midnight Dock is the default theme.
• Status Styler and Spoons are tidier: Spoons stays compact as [1/5sp], remains opt-in, and has Save/Show/Hide/Undo controls beside status edits.
• Templates apply immediately when loaded, with Undo available if the wrong slot was picked.

Fixes

• Welcome tips retry until the local notification system accepts them, so the welcome no longer vanishes during early lobby/chat setup.
• Detect Current now prefers live in-game values, keeps the current live name style in preview/copy/apply, and only strips BlueSage status/Spoons suffixes before filling an editable draft.
• Menu/footer tooltip and status text areas are consistent across QoL Menu and Style Helper tabs, with no cross-window tooltip bleed.
• Typeahead command popups are scrollable and more readable over busy chat.
• ID-card details now follow the Name/ID text limit for all player data fields, including the bottom About Me/FavoriteQuote section, instead of the vanilla 1000-character publish cap.
• Ping Mentions now match by base name but render the full current display label once, so @Rowan can highlight Rowan [Tired] [4/5sp] and @Blue can highlight Blue (Homelab) [3/5sp] without duplicating suffixes; status/Spoons text does not duplicate inside ping messages.

[0.0.10] - 2026-07-02

New

• Midnight Dock became the default menu theme, and the broken High Contrast theme was removed.
• Added a per-lobby welcome message so players see Home, /qolmenu, /styleui, /qol status, and typeahead tips when they join a lobby.
• Chat links now show as hyperlink-style text. Plain click still copies; Shift-click first copies and warns, then a second Shift-click opens the same link.

Improved

• Moved Purge Unused Assets to the Main tab beside the other quick actions.
• Toggles use two columns so the menu space is easier to scan.
• Fresh configs moved the visible beta features on for testing, while existing configs kept saved player choices.
• Spoons stays compact as [1/5sp]; the old mood command and mood config fields were removed so names do not flood chat.

[0.0.9] - 2026-07-02

New

• Added menu themes: OG, Vanilla Cream OT, and Midnight Dock.
• Theme choice applies to the QoL Menu, Style Helper, and autocomplete/typeahead popups.
• Added click-to-copy chat with /copychat and /ccopy.
• Added safe chat-link opening: plain click copies text, and Shift-click opens the first safe web link.
• Added chat readability with /chatreadability and /chatread.
• Added BetterMove: Shift runs and Ctrl slow-walks.
• Added /brb and /afk quick status shortcuts.

Improved

• Fixed gradient/color output so color tags close cleanly and do not bleed into later text.
• Style is now for names, while Status is for activity tags like (Reading).
• Style Helper templates now save name styling only, so status does not change by accident.
• Added the color library to Status so players can pick status colors without hex-code homework.
• Spoons is now off by default for new installs, uses a compact [1/5sp] tag when enabled, and has /spoons off plus a QoL Menu hide button for shorter names.
• QoL Menu customization rows now include Save plus a back-out button so players can discard unsaved edits.
• Slash-command typeahead is scrollable when browsing commands with /.
• Chat readability now tries a stronger local text outline, and Chat Backdrop can restore saved backdrop colors when turned off.
• MiniMap dot-to-ID is the supported minimap helper for this release.
• Floating minimap name labels stay removed because large lobbies reported FPS/CPU lag; clicking dots for ID cards keeps the useful part without name clutter.
• Chat readability improves local text contrast without changing what other players see.
• BetterMove only affects your own character locally.
• README now keeps the Thunderstore-facing notes shorter and more player-friendly.

[0.0.8] - 2026-06-29

• Added the visible @name suggestion popup for Ping Mentions.
• Made Style Helper and QoL Menu open larger by default with easier resize handles.
• Expanded the Style Helper color library.
• Retired the broken tiny Easter egg buttons and kept one compact mostly local-only DO NOT PRESS gag.
• Player-list helper buttons now protect native report/ignore/kick/ban controls first.
• Enhanced Player Panel helper logs now stay separate from host-health logs.
• README now lists both the official On-Together Discord and Blue's Discord Community.

[0.0.7] - 2026-06-28

• Fixed Ping Mentions so typing @name and pressing Tab works naturally.
• Kept [PING], @lobby, and selectable sound modes.
• Reconnect Guard now tries 20 times about every 15 seconds, then returns toward the normal menu/error flow.
• MiniMap dot-to-ID remains on by default.
• Floating minimap labels are removed after large-lobby FPS/CPU lag reports.
• Style Helper and QoL Menu now have resize grips, screen clamping, vertical scrolling, and clearer tips.
• Home now opens/closes /qolmenu.
• Player-list helper buttons sit left of the native/Pomodoro/PomoSync action area so report/ban buttons remain reachable.

[0.0.6] - 2026-06-28

• Fixed the v0.0.5 player-list button layout regression.
• Style Helper and QoL Menu became easier to read and scroll.
• Added Discord buttons to the Style Helper and QoL Menu headers.
• Moved beta controls into Toggles and changed the old Beta tab into Credits / Other.
• Added Reset Current to the Style Helper.
• Ping Mentions got yellow completed mentions, visible [PING] marking, @lobby, and selectable sound modes.
• MiniMap click-to-ID-card stayed as the useful behavior while floating labels were removed.
• Credits / Other invites players to screenshot/share finds in Blue's Discord.

[0.0.5] - 2026-06-28

• Chat, ID/profile fields, room names, and style-generated text now default to 1500 characters.
• Text limits are user-expandable up to 4000 through config or /qolmenu.
• Host Health now defaults off and is available through manual /hh run.
• Added safer player-list row refresh for larger lobbies and recycled player-list rows.
• Added Pomodoro/PomoSync spacing protection for player-list helper buttons.
• Added MiniMap dot-to-ID support.
• Added /styleui and /qolmenu.
• Added PlayerLimitLift companion awareness for Host Health.
• Fixed timestamps so they can apply to chat plus join/leave/system notices.

[0.0.3] - 2026-06-18

• Early beta cleanup.
• Added /style / /sty.
• Added Focus Anywhere.
• Added Enhanced Player Panel helpers.
• Added optional PlayerLimitLift companion awareness.
• Reduced Host Health false-positive noise.

[0.0.2] - 2026-06-18

• Rebuilt as 0.0.2 so Thunderstore could accept the package after the deprecated 0.0.1 upload.

[0.0.1] - 2026-06-18

• First Early Access release of BlueSage QoL Tweaks - Beta.
• Added Asset Sweep, Host Health, longer chat/name/room text, leave notices, optional timestamps, Reconnect Guard, and internal /as, /hh, /ln, /tt, /rg, /rm, /bsqol, and /qol commands.