BoneFish Documentation

🐟 Introduction

BoneFish is a powerful, open-source enhancement suite for Roblox, forked from Bloxstrap. It provides a wide range of features designed to improve your Roblox experience — from FPS unlocking and multi-instance launching to deep customization through mods and FastFlags.

Key Highlights

• FPS Unlocker — Break the 60 FPS cap for smoother gameplay
• Multi-Instance — Run multiple Roblox accounts at once
• FastFlags Editor — Easy graphical FastFlag management
• Mod Support — Import community mods for cursors, fonts, sounds, themes
• Theme Engine — Fully customizable bootstrapper appearance
• Account Switcher — Cookie-based quick account switching
• Auto-Reconnect — Smart reconnection when disconnected
• Cache Cleaner — One-click Roblox cache cleanup
• Crosshair Overlay — Custom crosshair for any game

📥 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 (FPS unlock, etc.)
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 Unlocker

Unlock Roblox's FPS cap for smoother gameplay. The unlocker is built into BoneFish's FastFlags system.

• Enable via Settings → FastFlags → FPS Unlocker
• Set your target FPS (default: 144, max: 999)
• Real-time FPS counter available (Ctrl+F toggles)

🔄 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

🔑 Account Switcher

Quickly switch between Roblox accounts using cookie-based management.

• Add cookies via Settings → Account Switcher
• Switch accounts from system tray menu
• Per-account settings preservation

🎯 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 community-created mods to customize your Roblox experience. Mods can include custom cursors, fonts, sounds, UI themes, and more.

Installing Mods

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

Official Mod Collections

• Community Mod Database — Browse all community mods
• Old Avatar Background — Restores the classic avatar background
• Twemoji Font Pack — HD emoji replacement pack
• Fluent Cursor Pack — Modern Fluent Design cursors
• Crosshair Pack — 100+ crosshair overlays

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

• FPSUnlocker — Disables FPS cap
• DisableTextureQualityDrop — Keeps textures at max quality
• FFlagDebugDisableTeleportation — Debug teleport features
• DFIntTaskSchedulerTargetFps — Target FPS value

Access FastFlags via Settings → FastFlags. You can search, edit, add, and remove flags through the built-in editor.

🧹 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 unlocker not working

• Verify FastFlags are applied (check in FastFlags editor)
• Try restarting Roblox after enabling
• Check if V-Sync is enabled in your GPU driver

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 (check our GitHub). It doesn't modify Roblox memory or inject code. It only modifies configuration files and bootstrapper behavior, which is against Roblox ToS? No, BoneFish works with Roblox's official bootstrapper.

Will I get banned?

BoneFish does not modify Roblox binaries or memory. It's considered a "tool assisted" enhancement. However, use at your own risk for features like FPS unlocking 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.