User Guide

Configuration & Reference

Settings, filters, macro modes, chat commands and troubleshooting. ~8 min read. New here? Start with the Installation Guide.

01 Algorithm & Filters

BFM runs a dedicated algorithm for each mode (Bazaar, Ebook, Craft Flip and more). The active algorithm is shown on the Flip UI, which you can resize or reposition from the Configure Element Screen after pressing Right Shift.

Profit Range

Sets the range of flips displayed. For most users, keep this at 0 to 10B to show everything. Only lower the cap if you specifically want to filter out high-value flips.

Budget

Per-flip spending cap. Recommended starting values based on your purse:

  • Under 5M purse: set budget to 5M. Don't use Auto, or profit will be inconsistent.
  • 10-20M purse: use a 10M budget.
  • 25-35M purse: use a 15M budget.
  • 60M+ purse: use a 20M budget.

Auto budget reads your purse balance and adjusts. Only use it if your purse is below 5M and you can't commit a fixed amount.

Success Rate

Calculated from how quickly an order is likely to fill. The lower this setting, the higher the potential profit but the longer each flip takes. Adjust it to how patient you are.

Category Filter

Restricts which item categories BFM scans: ALL, Farming, Foraging, Mining, Combat, Dungeons and Misc. Keep it on ALL by default. It exists for variety if you want to focus on a specific category.

Buy Mode

Some macro modes support two buy modes:

  • Order: places limit orders. More profit, slower execution.
  • Instant: buys and sells at market price. Fastest, lower margins.

Use the default per-mode setting unless you have a reason to change it.

Refresh Mode

  • Automatic (5-60s): configurable timer. Keep it at 5s for best results.
  • Manual (keybind): refreshes only when you press the key. Rarely used.

Preferred Flips

This is how you push past the 10-15M/hr mark, adding your own custom flips can earn significantly more.

  • Whitelist: only execute these specific flips.
  • Prefer: shows your preferred items on top and executes them first, then continues with algorithm-chosen flips.
  • Blacklist: excludes specific items from ever being flipped.

02 HUD & Layout

Press Right Shift to open the BFM HUD.

Click the B F M initials and a small dialogue appears. From here you can see quick settings and the Configure Screen Elements chip, which lets you move your on-screen elements around or resize them. You can also save presets by hovering over the PLUS in the taskbar.

Config Screen

Press K to open the config screen. It exposes detailed information and configuration for the macro: custom delays, break-time intervals, and more.

Tip

Set up your layout and a preset once, then save it. The next launch restores your HUD exactly where you left it.

03 Macro Modes

The macro is what BFM is at its core: multiple modes and quality-of-life features built around automated flipping.

Bazaar Macro

Creates buy orders, claims them, sells. Occasionally cancels under/overcut orders.

Ebook Macro

Instabuys books from the Bazaar, combines them in an anvil, instasells for moderate profit.

Craft Flip Macro

Instabuys materials from the Bazaar, crafts an item, lists it on the Auction House.

PF-AH Macro

Like Craft Flip but upgrades items via Hex (requires Hex) to stay competitive at a lower price while still profiting.

AF-AH Macro

Buys from AH to craft RNG-based items (Terminator, Wither armor, etc.) that can't be bought or crafted from Bazaar materials alone.

BZ-NPC Macro

Buys from the Bazaar then instantly sells to an NPC. Profitable when a gap exists between BZ price and NPC sell price.

Keepalive

Use .keepalive buy/sell {item} to keep an order alive by automatically relisting it whenever it gets undercut or overpriced.

Controls

  • Press O to activate or deactivate the macro. This is rebindable in Minecraft's keybind settings.
  • Change macro modes from the BFM HUD (same activation key).
  • To stop the macro, move around or press Esc.

Be aware

Running any macro for extended periods can attract staff attention. Generally BFM can be left unattended for long stretches, but use sensible breaks and exposure limits.

04 Chat Commands

Type these in Minecraft chat:

.bfmversion

Shows the BFM version you're currently running.

.bfmversions

Shows the previous 3 versions plus the current one.

.rollto {1-3}

Rolls to a specific version from the list shown by .bfmversions.

.bfmretry

Retries authentication.

.bfmdebug

Shows macro debug information.

.keepalive buy/sell {item}

Keeps an order alive by relisting when under or overpriced.

05 Troubleshooting

BFM doesn't load

  • Confirm you're using Fabric Loader with Minecraft 1.21.1.
  • Verify Fabric API is installed in your mods folder.
  • Make sure you're running Java 21 or newer.
  • Remove conflicting mods one at a time to isolate the issue.
  • Check %appdata%/.minecraft/bfm/logs for error messages.

Verification popup not appearing

  • Ensure you have an active license on your account.
  • Check your internet connection, BFM contacts the license server on startup.
  • Restart your game and try again.
  • Make sure you're not using the Modrinth launcher.
  • BFM only supports Windows, macOS and Linux are not supported.

Still stuck?

Open a support ticket in the Discord server. If it's verification related, attach your bootstrapper logs from C:\Users\{User}\AppData\Roaming\.minecraft\bfm\logs plus your latest instance log.

Need to install first?

The Installation Guide covers system requirements, setup, account & licensing, and your first launch.

Installation Guide Open dashboard