docs
everything you need to use ruby. if something here is wrong or missing, tell me on discord.
getting started
- download the installer and run it. tick the desktop shortcut box if you want one.
- if windows shows "windows protected your pc", click more info, then run anyway. ruby isn't code-signed yet, so windows doesn't recognise it.
- sign in. sign in to roblox opens roblox's real login page. use account from roblox app picks up the account you're already signed into in the roblox app, so you don't have to log in again.
- pick a game and press play. if roblox isn't installed yet, ruby installs it first.
ruby also takes over the play button on roblox.com, so games you start from the website open through ruby with your mods. you can turn that off in settings.
mods
open mods in the sidebar. pick what you want, then press apply at the bottom. nothing changes until you apply, and discard throws your changes away.
| section | what's in it |
|---|---|
| graphics | quality, texture quality, anti-aliasing and graphics api (direct3d 11, vulkan or opengl). |
| interface | ui tint, cursors, fonts (bundled ones or your own .ttf/.otf) and the ruby logo. |
| world | surfaces, force field, skybox and the death sound. |
| emotes & voice | emote wheel style and microphone icons. |
| imported packs | packs you added yourself, or brought over from another launcher. |
how it works
mods replace files in roblox's own folder (textures, sounds, fonts). before changing a file, ruby saves the original. turn a mod off and the original goes back.
roblox updates itself all the time. ruby puts your mods back on the new version right before you launch, so you don't have to redo anything.
adding your own
- packs: use import pack at the top of the mods page. it takes .zip, .png, .tex, .ttf and .otf files. big zips can go straight in the packs folder (packs folder button) and ruby picks them up.
- death sound: under world, pick a sound takes any .ogg file. roblox only plays ogg here, so convert mp3s first.
- microphone icons: three pictures named muted, quiet and talking.
overlay
press F6 while you're in a game. it only opens over roblox, and pressing F6 again closes it.
| actions | rejoin the same server, best ping server to hop somewhere closer, copy invite for friends, or jump back to ruby. |
| servers | other servers of the same game that have room. |
| friends | friends who are in the same game right now. |
the top of the overlay shows your ping, the server's region and how full it is.
accounts
open the menu (the ☰ button, top left) and pick switch accounts. add another account and ruby remembers it, so switching later is one click.
manage accounts lets you remove one. that only makes ruby forget it; the account stays signed in everywhere else.
importing mods from another launcher
if you used bloxstrap, fishstrap, voidstrap, froststrap, lunastrap or plexity, ruby finds their mods folder on its own. go to mods, then imported packs, and click import from … for the launcher you used.
fastflag settings from those launchers aren't imported. only the mod files are.
useful settings
| open roblox.com games with ruby | turn off if you want the website's play button to go straight to roblox. |
| close roblox when leaving a game | stops the roblox app from opening its own home screen after you leave. |
| minimize to tray when closed | closing the window keeps ruby in the system tray instead of quitting. |
| show my activity on discord | shows the game you're playing on your discord profile. off hides ruby from discord. |
| mode, accent color, font, layout | light, dark, matte black or match windows, eight accent colors or any color you pick, and a compact layout for small windows. all in settings → device preferences. |
| background | pick one of the built-in pictures or add your own image, gif or video (up to 40 MB). dim and blur keep text readable, and animated ones pause while ruby is minimized. |
| reduce motion, text size | turns animations down (animated backgrounds too) and makes text bigger. |
fixing problems
my antivirus flagged the installer
new, unsigned programs that change roblox files get flagged a lot. compare the installer's sha-256 with the one on the download page. if it matches, it's the file i published. you can also read the code that handles your account.
a mod isn't showing in game
make sure you pressed apply, then rejoin. some games replace things themselves: a game with its own sky ignores your skybox, and some games use their own death sound.
roblox looks wrong or crashes after a mod
turn the mod off and apply. ruby puts the original files back. if it's still broken, reinstall roblox from the roblox website; ruby will add your mods again on the next launch.
sign-in keeps failing
try use account from roblox app: sign in to the roblox app once, then pick that option in ruby. if roblox asks for a captcha or 2-step code, finish it in the sign-in window.
ruby opened to a blank window
close it from the tray icon and open it again. if it keeps happening, send me the launcher log (settings, then launcher log).
uninstalling
uninstall ruby from windows settings (apps), like any other program. it removes ruby, its shortcuts, and gives the play button on roblox.com back to roblox.
your settings and saved accounts live in %APPDATA%\com.rubylauncher.tauri. the uninstaller can remove them too, or you can delete that folder yourself.
questions
can i get banned for using ruby?
ruby doesn't touch the game while it runs. it doesn't inject code, read game memory or run scripts. it only swaps files roblox loads from its own folder, like a texture pack. i can't speak for roblox, but that's the same thing bloxstrap and similar launchers have done for years.
does ruby see my password?
no. you type it into roblox's own login page. ruby only keeps the session roblox gives you afterwards, encrypted on your pc, and only ever sends it to roblox.com. here's the code that enforces that.
is ruby free?
yes.
is it open source?
partly. the code that deals with your account, the internet and the installer is readable here so you can check it. the rest stays private so nobody can rebuild ruby and sell it.
mac or linux?
windows only for now.