BoneFish Documentation

🐟 Introduction

BoneFish is an open-source enhancement suite for Roblox on Windows, forked from Bloxstrap. It provides bootstrapper customization, mod support, FastFlags management, and optional overlays — from multi-instance launching to deep customization through mods and FastFlags.

Key Highlights

• Multi-Instance — Run multiple Roblox instances at once
• FastFlags Editor — Graphical FastFlag management
• Mod Support — Import mods for cursors, fonts, sounds, and more
• Theme Engine — Customizable bootstrapper appearance
• FPS Monitor — Real-time FPS counter overlay (Ctrl+Shift+F)
• Crosshair Overlay — Custom crosshair for any game (Ctrl+Shift+C)
• Game Session Manager — Restores Roblox after unexpected crashes
• Auto Cache Cleanup — Automatic cleanup of old Roblox cache

📥 Installation

System Requirements

• Windows 10 or later (64-bit)
• .NET 9.0 Runtime (download here)
• Roblox installed

Quick Install

1. Download the latest BoneFish.exe from the Releases page
2. Run BoneFish.exe — it will automatically install and configure itself
3. Launch Roblox through BoneFish to enable all features

Portable Mode

Place BoneFish.exe in any folder and run it. All settings and data are stored in a BoneFish folder next to the executable.

Updating

BoneFish automatically checks for updates on launch. You can also manually download the latest version from the Releases page.

🚀 First Launch

When you first run BoneFish, you'll see the setup wizard. Here's what to expect:

1. Install Location — Choose where BoneFish stores its data
2. Bootstrapper Style — Pick a theme for the Roblox bootstrapper
3. FastFlags — Choose performance presets and FPS cap
4. Integrations — Configure Discord Rich Presence, activity watcher

After setup, right-click the BoneFish icon in your system tray to access all features.

⚙️ Features Guide

🎮 Multi-Instance Launcher

BoneFish allows you to run multiple Roblox accounts simultaneously. Each instance runs independently with its own settings.

• Enable in Settings → Integrations → Activity Watcher
• Each instance can have different FastFlags profiles
• Smart window management prevents focus stealing

⚡ FPS Monitor

On-screen FPS counter overlay that works while Roblox is running.

• Enable via Settings → Experimental → FPS Monitor, or press Ctrl+Shift+F
• Draggable counter with saved position
• Runs as a separate overlay — no game-side modification

🔄 Auto-Reconnect

Never lose progress again! BoneFish automatically detects disconnections and reconnects you to the server.

• Works with all Roblox games
• Configurable retry count and delay
• Only reconnects if within timeout window

🎮 Game Session Manager

Tracks Roblox sessions and automatically restores them after unexpected crashes or reboots.

• Found in Settings → Game Session Manager
• Scans for recently suspended apps and resumes them on the next launch
• Keeps a session history with restore results

🎯 Crosshair Overlay

Customizable crosshair overlay for any Roblox game — especially useful for FPS games.

• Multiple crosshair styles (dot, cross, circle, custom)
• Adjustable color, size, opacity
• Toggle with hotkey (default: Ctrl+Shift+C)

📦 Mods & Customization

BoneFish supports mods to customize your Roblox experience — cursors, fonts, sounds, and more.

Installing Mods

1. Download a mod .zip from the Mods or community
2. Open BoneFish Settings → Mods → Import Mod
3. Select the .zip file
4. Review the files that will be added/overwritten
5. Confirm to install

Official Mod Collections

• Source-backed mod list — Verified mods with real sources
• Old Avatar Background — Restores the classic avatar editor background (bundled)
• Old Character Sounds — Classic walk, jump, and get-up sounds (bundled)
• 2006/2013 Cursors — Classic Roblox cursor sets (bundled)
• Emoji Fonts — Catmoji and Segoe UI Emoji variants (bundled)

Creating Mods

To create your own mod:

1. Create the folder structure: content/textures/, content/sounds/, content/fonts/, or ClientSettings/
2. Place your custom files in the appropriate folders
3. Zip everything and share with the community!

⚙️ FastFlags Manager

FastFlags control Roblox's internal settings. BoneFish provides a graphical editor to safely modify them.

Common FastFlags

• DFIntTaskSchedulerTargetFps — Sets the FPS cap used by the performance presets

Access FastFlags via Settings → FastFlags. Flags in the built-in library ship with descriptions, and experimental flags are clearly marked.

🧹 Cleanup Tools

BoneFish includes independent cleanup tools for Roblox Player and Studio installations.

Clean Roblox Player

Removes Roblox Player data including:

• Player binaries and version directories
• Registry keys (roblox, roblox-player)
• Shared log and cache files

Clean Roblox Studio

Removes Roblox Studio data including:

• Studio binaries and version directories
• Registry keys (roblox-studio, roblox-studio-auth, Roblox.Place)
• File associations (.rbxl, .rbxlx)
• Shared log and cache files

🔧 Troubleshooting

BoneFish won't start

• Ensure .NET 9.0 Runtime is installed
• Check Windows Defender/antivirus isn't blocking it
• Run as Administrator
• Delete the BoneFish settings folder and reinstall

FPS Monitor not showing up

• Confirm FPS Monitor is enabled in Settings → Experimental
• Press Ctrl+Shift+F to toggle it at any time
• Restart BoneFish after enabling

Mod not showing up

• Ensure the ZIP has proper structure (content/, ExtraContent/, or ClientSettings/)
• Try re-importing the mod
• Check the Mods page in settings to see active mods

Multi-instance not working

• Enable Activity Watcher in Settings → Integrations
• Launch each instance separately from the system tray
• Some anti-cheat systems may block multiple instances

❓ FAQ

Is BoneFish safe?

Yes! BoneFish is completely open source — review the code on GitHub. It doesn't modify Roblox memory or inject code; it works with Roblox's official bootstrapper and configuration files.

Will I get banned?

BoneFish does not modify Roblox binaries or memory. As with any external launcher or bootstrapper customization, use at your own risk — especially in competitive games.

Is BoneFish free?

Yes, completely free and open source. If you'd like to support development, consider donating.

Can I use BoneFish with other mods/launchers?

BoneFish is compatible with most Roblox mods. However, using multiple enhancers simultaneously may cause conflicts. We recommend using BoneFish as your primary enhancement tool.

How do I report a bug?

Open an issue on our GitHub Issues page or ask in our Discord server.

Can I contribute?

Absolutely! Check our Contributing Guide on GitHub. We welcome PRs, bug reports, and feature suggestions.