BlueSage QoL Tweaks
Early Access QoL toolkit for On-Together: Virtual Co-Working.
Current package: v0.1.3 Early Access
This is for players and hosts who want friendly quality-of-life helpers in one mod. It is not the big-lobby mod. For 64-player rooms, the host still needs BlueSagePatched PlayerLimitLift.
Early Access note: this mod is still moving quickly while players test it, but it is meant to be friendly to normal players. If something feels noisy, open /qolmenu, turn off that one feature, and let Blue know what happened.
Community links:
Support Blue's community modding work:
0.1.x Early Access Highlights
- Mod Menu: press
Home or type /qolmenu for toggles, safe Customize fields, quick actions, themes, local status checks, and max-safe on-screen fitting.
- In-game Styler: press
Insert or type /styleui to manage name colors, status tags, templates, Spoons, Detect Current, copyable style text, and undo.
- Chat readability: local text outlines, outline intensity
25-100, normal/black outline colors, and BlackNamesOutline for true-black styled names/messages.
- Chat layout controls:
/chatscale scales the whole chat UI for accessibility, /chatfont enlarges chat text only, /chatheight adds taller visible chat space, and BlueSage keeps deeper scrollback available automatically.
- Longer text defaults: chat, Name/ID fields, ID-card details, and room names default to
3000 characters.
- Comfort helpers: ping mentions, ticket ping sound, click-to-copy chat, safer chat links, minimap dot-to-ID, Clone Shield, opt-in Player Render Saver, BetterMove, asset sweep, host health, and reconnect guard.
Quick Start
Install it, launch the game, then try these:
- Press
Home or type /qolmenu to open the friendly settings menu.
- Press
Insert or type /styleui for Name Styler, Status Styler, Spoons, themes, and copyable styled text.
- The lobby welcome message appears once each time you join a lobby with quick reminders for
Home, Insert, /qol status, /brb, /afk, /back, and slash-command typeahead.
- Type
@name in chat to get mention suggestions, then press Tab or click a suggestion.
- Click a chat message to copy only the message text. Links are recolored;
Shift-click once to copy/warn, then Shift-click again to open.
- Click minimap dots to open ID cards when BlueSage can safely match the player.
- Hold
Shift to run or Ctrl to slow-walk with BetterMove.
- Use
/as now if a long session feels heavy.
- Use
/qol status or the menu's Run QoL Status button to see what is enabled. Hosts can still use /hh run for a quiet lobby-health check.
What It Adds
Chat, Names, And Rooms
- Chat send cap is raised from vanilla
250 to 3000 characters.
- Name, ID-card, and room-name fields default to
3000 characters. ID-card details include the bottom About Me/FavoriteQuote section.
- Power users can raise those up to
4000 in /qolmenu, but very long text can still wrap or look odd in some game UI.
Chat Readability And Layout
- Text outlines and shadows make local chat easier to read on bright or busy backgrounds.
- Outline intensity defaults to
75 and can be tuned from 25 to 100.
- Whole chat UI scale defaults to vanilla
100, can be tuned from 75 to 200, and scales the chat panel, input box, backdrop, text, and outlines together.
- Chat font size defaults to vanilla
100, can be tuned from 75 to 200, and enlarges local chat message text without scaling the whole chat shell.
- Chat window height defaults to vanilla
100, can be tuned from 100 to 200, and adds vertical room for chat without changing text size.
- BlueSage automatically raises both Global and Local retained chat logs to
250 rows so long-running sessions keep more scrollback even when chat height stays vanilla.
- Native Global/Local tabs remain the game's own tabs for now; BlueSage improves retained rows, readability, font sizing, whole-panel scale, and vertical space around them.
- The Customize tab includes Reset Chat UI to Vanilla, and
/chatvanilla does the same reset for whole chat UI scale, chat font size, and chat window height.
- Normal outline color and black-text outline color can be customized separately.
Ping Mentions
-
Type @partialname to show a small suggestion popup.
-
Pinged messages get a visible [PING] marker.
-
@lobby can ping everyone running a compatible mention mod like this one.
-
Sound is on by default and uses ticket by default. Sound modes: click, change, error, task, ticket.
-
Mention suggestions and highlights resolve the player's current display name, including status and Spoons tags, then highlight that full mention once so suffixes do not duplicate inside pinged messages.
Helpful commands:
/setpingcolor FF66CC/pingsound ticket/pingsound off
Style Helper
/styleui opens a friendly window for:
- name styling, status tags like
(Reading), and reusable name templates;
- color buttons so players do not need to hunt hex codes;
Detect Current, Apply Name Styler, Copy Name Style Text, and local-only Clear Draft;- templates that apply immediately when loaded, with Undo available if you picked the wrong slot;
Undo to back out of the last apply, clear, template save/load, or local style edit;- Spoons controls to save
0-5, show the compact [1/5sp] tag, hide it, or undo the last Spoons edit;
- Status Styler keeps live status changes separate from local draft clearing.
Clear Status removes the live status; Clear Draft only clears the editor box.
- themes that also apply to the QoL Menu and autocomplete popup.
It uses safe in-game player data updates and never writes profile files directly.
QoL Menu
Open it with Home, /qolmenu, or /qm.
The QoL Menu and Style Helper open at the largest safe size that fits your current game resolution while leaving a small slice of the game/chat area visible. If you want a smaller window, drag the bottom-right ā handle; BlueSage will keep the resized window inside the screen.
Tabs:
- Main: Purge Unused Assets, Run QoL Status, Style UI, and built-in how-to examples.
- Toggles: simple on/off controls for the major features.
- Customize: ping colors, ping sound, sweep interval, chat outline strength, whole chat UI scale, chat font size, chat window height, outline colors, and text limits. Editable rows have Save and Undo. Use Style Helper for name, status, and Spoons identity edits.
- Credits / Other: optional Host Health, themes with Cycle Theme plus Reset to Midnight Dock, credits, and one compact mostly local-only DO NOT PRESS gag. Older extra joke buttons were retired in
0.0.8.
The remaining gag never edits files or profiles. After one tiny lobby joke, it only shows local messages. Players can screenshot/share finds in Blue's Discord for fun.
Feature Notes
Enhanced Player Panel
- Adds local
@ and ID helper buttons to player rows.
- Buttons stay left of the native/Pomodoro/PomoSync action area so report, ignore, kick, and ban controls stay reachable.
- ID-card lookup handles larger lobbies better than the old vanilla 16-player assumptions.
- If another EnhancedPlayerPanel-style mod is already loaded, BlueSage skips safely.
- 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.
- Click a minimap player dot to open an ID card when the dot can be safely matched.
- Floating minimap name labels are removed. Community testing showed they could cause FPS/CPU lag in large lobbies.
- Toggle dot-to-ID clicks with
/minimaplabels or /mml.
Click-To-Copy Chat
- Click a chat message to copy only the message text.
- It does not copy the sender name, timestamp, or styled status.
- Safe
http, https, and www. links are shown in hyperlink color.
- Hold
Shift while clicking a link once to copy it and show a caution note. Shift-click the same link again within a few seconds to open it.
- Plain click always stays copy-only so players can verify a link before opening it.
- Toggle with
/copychat or /ccopy.
- Toggle link-opening with
/chatlinks or /clinks.
- If the old CopyChat mod is loaded, BlueSage backs off to avoid duplicate click handlers.
Chat Readability
- Adds local outline and shadow to chat text so messages stay readable on bright backgrounds.
- Toggle with
/chatreadability or /chatread.
- Adjust outline strength with
/chatoutline 25-100 or Customize -> Chat outline intensity. Default 75 keeps chat readable without jumping straight to the thickest outline; 100 is the crispest outline.
- Scale the whole local chat UI with
/chatscale 75-200, /chatresize 1.25, or Customize -> Whole chat UI scale. This scales the vanilla chat surface, input, backdrop, text, and outlines together for accessibility on small displays.
- Enlarge only chat message text with
/chatfont on/off/toggle, /chatfont 75-200, /chatfont reset, or Customize -> Chat font size. Use this when you want bigger letters without growing the panel/input/backdrop.
- Expand the chat window vertically with
/chatheight on/off/toggle, /chatheight 100-200, /chatstretch 1.6, or Customize -> Chat window height. This adds taller visible chat space without scaling text.
- BlueSage automatically raises both Global and Local retained chat logs to
250 rows. That means vanilla-height chat still gets deeper scrollback after AFK, while taller chat has enough retained conversation to fill the extra space.
- Native Global/Local tab buttons and the minimize arrow stay controlled by the game UI. BlueSage does not claim a replacement tab/button layer in this release.
- Use
/chatvanilla, /chatreset, or Customize -> Reset Chat UI to Vanilla if scaling, font size, or window height leaves chat in a weird place. It restores saved vanilla transforms and sets whole UI scale/font/window values back to 100.
- BlueSage nudges scaled chat panels back on-screen when possible. If your saved vanilla chat position still feels off after scaling, use the
::: drag handle on the chat box to realign it.
- Tune outline colors with
/chatoutlinecolor #000000 for the normal outline path and /blackoutlinecolor #FFFFFF for true-black chat/name rows. The same fields are in Customize as Normal outline color and Black text outline color.
- Chat Readability uses a TMP material outline plus a soft UI shadow/outline assist so the visible outline stays close to the beloved beta behavior. BlueSage does not rewrite message text or change what other players see.
BlackNamesOutline is on by default so true-black styled names/messages get the light black-text outline color instead of disappearing into black-on-black. Turn it off if you want every row to use the normal outline color.- This does not rewrite chat messages and does not change what other players see.
Clone Shield
- Clone Shield is a defensive local notice for the player panel.
- If another visible roster row appears to reuse your current avatar/outfit, BlueSage warns you locally and suggests checking the player panel ID.
- It ignores shared name colors, font styling, and status text so similar aesthetics do not become noisy false positives.
- It does not report, kick, ban, or moderate anyone. It is only a heads-up so players can spot confusing clones.
- Toggle with
/cloneshield, /cloneguard, or the Toggles tab.
Player Render Saver
- Off by default and opt-in from the Toggles tab.
- Local-only optimization for very large lobbies: hides far/overflow remote player renderers on your PC only.
- Chat, player-list rows, IDs, reports, ignores, kicks, bans, and other players' views stay untouched.
- Defaults keep remote players within
45m visible and also keep the closest 32 remote players visible.
- Tune with Customize -> Render saver radius / max visible, or use
/playersaver radius 45, /playersaver max 32, /playersaver status, and /playersaver off.
- Turning it off restores all hidden renderers without needing a game restart.
BetterMove
- On by default.
- Hold
Shift to run.
- Hold
Ctrl to slow-walk with a cozy popsicle-style animation.
- Local-player only; it does not add custom network packets or require other players to install anything.
- Toggle with
/bettermove or /bm.
Reconnect Guard
- On for players by default.
- Waits about
5 seconds before the first guarded reconnect attempt so the lobby can settle.
- Tries up to
3 short guarded attempts, checks that the visible lobby/player UI becomes usable, then tries the saved last lobby once through the game's native join-by-code flow before returning toward the normal menu/error flow if reconnect would leave you stuck in a broken lobby.
- If AndrewLin Reconnect is loaded too, BlueSage lets that mod own reconnect behavior instead of fighting it.
- Hosts can turn it off with
/rg off.
Asset Sweep
- Runs every
30 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 on by default for this beta pass and can be turned off in
/qolmenu.
Common Commands
/qol status or /bsqol status: show current BlueSage states.Home, /qolmenu, or /qm: open the QoL menu.Insert, /styleui, or /sui: open the Style Helper./style or /sty: build styled text from chat commands./setname, /status, /clearstatus, /statuscolor: set your display name/status without editing save files directly./brb or /afk: quick status shortcuts. /back restores the status you had before BRB/AFK, or clears it if there was nothing to restore./spoons on/off/status or /spoons 0-5: show, hide, or set the optional compact display-name tag, like [1/5sp]. Use /spoons off if your name feels too long./assetsweep or /as on/off/status/now: asset sweep controls./hosthealth or /hh on/off/status/run: host-health controls.
Hosts can use /hh run for a quiet lobby-health check./leavenotices or /ln on/off/status: leave notice toggle./timestamps or /tt on/off/status: chat and notice timestamps./chatreadability or /chatread on/off/status: local chat text outline/shadow./chatoutline or /outline 25-100/status: adjust local chat outline strength./chatscale or /chatresize 75-200/reset/status: scale the local chat UI for readability./chatfont or /chatfontsize 75-200/reset/status: enlarge chat message text without scaling the whole chat UI. It also accepts on, off, and toggle./chatheight or /chatstretch 100-200/reset/status: expand the chat window vertically without scaling text. It also accepts on, off, and toggle./chatvanilla, /chatreset, or /chatdefault: restore whole chat UI scale, chat font size, and chat window height to vanilla 100./chatoutlinecolor or /outlinecolor #000000/status: normal chat outline color./blackoutlinecolor or /blackoutline #FFFFFF/status: true-black chat/name outline color./bettermove or /bm on/off/status: Shift run and Ctrl slow-walk./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 dot-to-ID-card helper. No floating labels./playersaver, /rendercull, or /playercull on/off/status: opt-in local remote-player render saver for large lobbies. Use radius 45, max 32, or reset to tune it./copychat or /ccopy on/off/status: click-to-copy chat messages./chatlinks or /clinks on/off/status: safe click-to-open chat links.
Using a toggle command without on or off flips the current setting. Timestamps apply to chat plus join/leave/system notices when enabled.
Settings
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.
Useful defaults:
EnableAutoSweep: trueSweepIntervalMinutes: 30EnableHostHealthMonitor: trueEnableLeaveNotifications: trueEnableWelcomeMessage: trueEnableChatTimestamps: trueEnableNotificationTimestamps: trueEnableChatReadability: trueChatOutlineIntensity: 75ChatUiScalePercent: 100ChatFontSizePercent: 100ChatWindowHeightPercent: 100ChatOutlineColor: 000000BlackChatOutlineColor: FFFFFFBlackNamesOutline: trueEnableBetterMove: trueEnableReconnectGuard: trueEnableReconnectAnnouncement: trueEnableFocusAnywhere: trueEnableEnhancedPlayerPanel: trueEnablePingMentions: trueEnablePingSound: trueEnableSpoons: false- On update to this release, older enabled Spoons defaults are reset to hidden once. Use
/spoons on, /spoons 0-5, or Style Helper > Show Tag if you want the compact tag back.
EnableStyleUi: trueEnableMiniMapPlayerLabels: true (legacy config name; now controls MiniMap ID Click only)EnableChatCopy: trueEnableChatUrlLinks: trueUiThemePreset: Midnight DockMaxChatCharacters: 3000MaxProfileCharacters: 3000MaxSessionNameCharacters: 3000
Old beta config files may still contain removed settings. BlueSage ignores old 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 defers reconnect behavior to AndrewLin Reconnect instead of stacking two reconnect loops.
- 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.
- Use
/chatvanilla or Customize -> Reset Chat UI to Vanilla if whole UI scale, message font size, or taller chat leaves the panel displaced.
- Use
/spoons off if the optional Spoons tag makes names too long.
- Spoons is opt-in by default and older enabled Spoons configs reset to hidden once on update; Save Spoons, Show Tag, or
/spoons on turns it back on.
- Reopen the player list if buttons look stale after scrolling a huge lobby.
- Use
/mml off if minimap dot clicks feel weird on your setup.
- Use
Detect Current in /styleui to re-read your current in-game name/status before applying a new experiment. It prefers the live display name, strips old style tags plus BlueSage status/Spoons suffixes like [Tired], [4/5sp], and (Homelab) before filling the editor, and falls back to saved config only when live player data is unavailable. Clear Draft only clears the editor box; /clearstatus removes a live status.
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 CopyChat
- 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.
