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: trueSweepIntervalMinutes: 60EnableHostHealthMonitor: falseEnableLeaveNotifications: trueEnableChatTimestamps: falseEnableReconnectGuard: trueEnableReconnectAnnouncement: trueEnableFocusAnywhere: trueEnableEnhancedPlayerPanel: trueEnablePingMentions: trueEnablePingSound: truePingSoundMode: clickPingHighlightColor: 9B59B6PingMentionColor: FFD700EnableNotificationTimestamps: falseEnableStyleUi: trueEnableMiniMapPlayerLabels: trueMaxChatCharacters: 1500MaxProfileCharacters: 1500MaxSessionNameCharacters: 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.
