Mod settings reference

Mod Settings Reference

This guide documents every available setting in the SkyCofl mod. Settings are organized by category and include detailed explanations of what each option does, acceptable values, and usage tips.

Access settings with /cofl set or /cl s to see interactive options, or use /cofl set <setting> <value> to change a specific setting directly.


General Settings

These settings control the core flip-finding behavior and filtering rules.

filters

  • Type: Dictionary (key-value pairs)
  • Default: Empty
  • Description: Advanced filter dictionary for custom flip matching rules. Most users should use blacklist/whitelist commands instead.
  • Usage: Configured automatically through /cofl bl and /cofl wl commands.

lbin (BasedOnLBin)

  • Type: Boolean
  • Default: false
  • Description: Calculate profit based on Lowest BIN instead of median price. Highly recommended to enable only the sniper finder when using this setting.
  • Effects:
    • Changes profit calculation from median-based to lbin-based
    • May show negative profits if whitelist items don't have lbin data
    • Works best with /cofl set finders sniper
  • Warning: Using lbin mode with other finders (FLIPPER, MEDIAN_SNIPER) can cause inaccurate profit estimates.

finders (AllowedFinders)

  • Type: FinderType flags
  • Default: FLIPPER_AND_SNIPERS (119)
  • Description: Controls which flip-finding algorithms are enabled.
  • Options:
    • SNIPER – Lowest BIN-based flips (fast, accurate for instant sales)
    • FLIPPER / FLIPPER_AND_SNIPERS – Median-based flips (balanced, higher volume)
    • SNIPER_MEDIAN – Median sniper (alternative median algorithm)
    • STONKS – Risky/experimental flips (high competition, low success rate)
    • USER – Whitelist-only flips (custom tracked items)
    • AI – AI-predicted flips
    • CraftCost – Craft-cost flips
  • Tip: Use sniper alone for maximum speed; use FLIPPER_AND_SNIPERS for broader coverage.

onlyBin (OnlyBin)

  • Type: Boolean
  • Default: true
  • Description: Hide all regular auctions and only show BIN (Buy It Now) auctions.
  • Reason: Non-BIN auctions require bidding and waiting, making them impractical for fast flipping.

whitelistAftermain (WhitelistAfterMain)

  • Type: Boolean
  • Default: false
  • Description: Whitelisted items must also pass main filters (minProfit, minVolume, etc.).
  • When false: Whitelist bypasses all other filters (recommended for specific targets).
  • When true: Whitelist acts as a "priority" filter that still respects profit/volume thresholds.

DisableFlips

  • Type: Boolean
  • Default: false
  • Description: Stop receiving flip notifications entirely (keeps mod features like /cofl bazaar active).
  • Also stops: The countdown timer display.
  • Use case: Temporarily pause flipping without logging out.

DebugMode

  • Type: Boolean
  • Default: false
  • Description: Enable verbose logging to help diagnose issues.
  • Output: Extra information in chat and logs for troubleshooting filter/flip behavior.

blockHighCompetition (BlockHighCompetitionFlips)

  • Type: Boolean
  • Default: true
  • Description: Hide flips that are likely already purchased by the time you click them (based on grace period expiry and competition metrics).
  • Recommended: Keep enabled to avoid wasted clicks on impossible-to-buy flips.

minProfit (MinProfit)

  • Type: Long (coins)
  • Default: 2,500,000 (2.5m)
  • Description: Minimum absolute profit (after taxes) a flip must have to be displayed.
  • Format: Accepts shorthand like 2.5m, 500k, 1b.
  • Example: /cofl set minProfit 5m to only see flips with at least 5 million profit.

minProfitPercent (MinProfitPercent)

  • Type: Integer (percent)
  • Default: 20
  • Description: Minimum profit percentage ((sell - cost) / cost × 100) required.
  • Note: Flips must pass both minProfit and minProfitPercent checks.
  • Auto-flip clients: Percentage is increased to at least 9% when AH slots are nearly full (< 2 open).

minVolume (MinVolume)

  • Type: Double (sales per day)
  • Default: 0.1
  • Description: Minimum average daily sales volume (how many times the item sells per 24 hours).
  • Low volume risk: Items with <1 sale/day may take longer to resell.
  • Decimal values: 0.1 means roughly 1 sale every 10 days.

maxCost (MaxCost)

  • Type: Long (coins)
  • Default: 1,000,000,000 (1 billion)
  • Description: Maximum purchase price you're willing to spend on a single flip.
  • Interaction: Also respects modmaxPercentOfPurse (see Mod Settings).
  • Example: /cofl set maxCost 50m to cap flips at 50 million coins.

Mod Settings

These settings control the in-game mod behavior, including UI, sounds, notifications, and automation.

modjustProfit (DisplayJustProfit)

  • Type: Boolean
  • Default: true
  • Description: Show only profit in flip messages instead of full price breakdown.
  • When false: Displays cost → sell price → profit.

modsoundOnFlip (PlaySoundOnFlip)

  • Type: Boolean
  • Default: true
  • Description: Play a notification sound when a new flip arrives.
  • Disabled in: Streamer mode (modstreamerMode).

modsoundOnOutbid (PlaySoundOnOutbid)

  • Type: Boolean
  • Default: false
  • Description: Play a sound when your bazaar order is outbid.
  • Use case: Helpful for active bazaar flipping.

modshortNumbers (ShortNumbers)

  • Type: Boolean
  • Default: true
  • Description: Use k and M abbreviations (e.g., 2.5M instead of 2,500,000).
  • When false: Shows full numbers.

modshortNames (ShortNames)

  • Type: Boolean
  • Default: false
  • Description: Remove reforges and modifiers from item names in flip messages.
  • Example: Renowned Shadow FuryShadow Fury.

modblockTenSecMsg (BlockTenSecondsMsg)

  • Type: Boolean
  • Default: false
  • Description: Hide the "Flips in 10 seconds..." countdown message.

modformat (Format)

  • Type: String (format template)
  • Default: (FLIP) {0}: {1}{2} {3}{4} -> {5} Volume: {10}
  • Description: Custom flip message format using placeholders:
    • {0} – Finder type (FLIP, SNIPE, USER, etc.)
    • {1} – Rarity color code
    • {2} – Item name
    • {3} – Profit color
    • {4} – Profit amount
    • {5} – Target price
    • {10} – Volume
  • Advanced: Edit to customize flip notification appearance.

modblockedFormat (BlockedFormat)

  • Type: String (optional)
  • Default: null (uses default format)
  • Description: Separate format template for blocked flips shown via /cofl blocked.

modchat (Chat)

  • Type: Boolean
  • Default: false
  • Description: Enable /fc SkyCofl chat integration.
  • Toggle: /cofl chat or /fc to turn on/off.

modcountdown (DisplayTimer)

  • Type: Boolean
  • Default: true
  • Description: Show the countdown timer until the next Hypixel auction update.
  • Position: Customizable with modtimerX and modtimerY.

modhideNoBestFlip (HideNoBestFlip)

  • Type: Boolean
  • Default: false
  • Description: Hide the "No best flip on page" message when using the flip hotkey in AH.

modtimerX (TimerX)

  • Type: Integer (percent)
  • Default: 0
  • Description: Horizontal position of timer (percentage of screen width, left/right).

modtimerY (TimerY)

  • Type: Integer (percent)
  • Default: 0
  • Description: Vertical position of timer (percentage of screen height, up/down).

modtimerSeconds (TimerSeconds)

  • Type: Integer (seconds)
  • Default: 0
  • Description: Show timer only when X seconds remain before auction update.
  • Example: Set to 30 to display timer only in the last 30 seconds.

modtimerScale (TimerScale)

  • Type: Float (scale multiplier)
  • Default: 0.0 (uses default size)
  • Description: Scale factor for timer size (e.g., 1.5 = 150% size).

modtimerPrefix (TimerPrefix)

  • Type: String (optional)
  • Default: null
  • Description: Custom text displayed before the timer (e.g., "Next update: ").

modtimerPrecision (TimerPrecision)

  • Type: Integer (digits)
  • Default: 0 (auto)
  • Description: Number of decimal places for timer display (e.g., 3 = 12.345s).

modblockedMsg (MinutesBetweenBlocked)

  • Type: Byte (minutes, 0-127)
  • Default: 0 (show every time)
  • Description: Minimum minutes between "X flips blocked" summary messages.
  • Example: Set to 5 to reduce spam when many flips are blocked.

modmaxPercentOfPurse (MaxPercentOfPurse)

  • Type: Short (percent, 0-100)
  • Default: 0 (disabled)
  • Description: Maximum percentage of your purse to spend on a single flip.
  • Example: Set to 50 to never spend more than 50% of your coins on one item.
  • Interaction: Works alongside maxCost (stricter limit wins).

modnoBedDelay (NoBedDelay)

  • Type: Boolean
  • Default: false
  • Description: Send bed flips immediately without fairness delay.
  • Use case: Premium feature for beds (applies bed-specific rules).

modstreamerMode (StreamerMode)

  • Type: Boolean
  • Default: false
  • Description: Hide personal data (usernames, balances) and reduce sound volume for streaming.

modautoStartFlipper (AutoStartFlipper)

  • Type: Boolean
  • Default: false
  • Description: Automatically start receiving flips when joining SkyBlock.
  • Toggle: Use /cofl flip always to enable, /cofl flip never to disable.

modnormalSoldFlips (NormalSoldFlips)

  • Type: Boolean
  • Default: false
  • Description: Don't mark sold flips with [SOLD] prefix—display them normally.

modtempBlacklistSpam (TempBlacklistSpam)

  • Type: Boolean
  • Default: false
  • Description: Auto-blacklist items for 8 hours if they appear >5 times in 2 minutes.
  • Purpose: Prevent spam from manipulated or hyper-competitive items.

moddataOnlyMode (AhDataOnlyMode)

  • Type: Boolean
  • Default: false
  • Description: Disable flip delivery; only add price/lore data to items.
  • Use case: Keep mod features (lore extensions, price info) without receiving flips.

modahListHours (AhListTimeTarget)

  • Type: Integer (hours)
  • Default: 0 (uses recommended time)
  • Description: Target listing duration when posting auctions (in hours).

modquickSell (QuickSell)

  • Type: Boolean
  • Default: false
  • Description: Automatically list flips at lowest possible price to sell ASAP.
  • Warning: Reduces profit for speed.

modmaxItemsInInventory (MaxFlipItemsInInventory)

  • Type: Integer (item count)
  • Default: 0 (when full minus 2 spare slots)
  • Description: Stop receiving flips when X flip items are already in inventory. If set to 101 or higher buying won't be stopped completely but be slowed down a bit.
  • Use case: Prevent inventory clutter; forces you to sell before buying more.

moddisableSpamProtection (DisableSpamProtection)

  • Type: Boolean
  • Default: false
  • Description: Disable the 5-flip limit per update—show ALL matching flips.
  • CAUTION: Can flood chat with dozens of flips; only enable if you have strict filters.

modtempBlacklistThreshold (TempBlacklistThreshold)

  • Type: Integer (percent)
  • Default: 20
  • Description: If you purchase more than X% of flips seen for an item, auto-blacklist it temporarily.
  • Example: Default 20 means buying 4 out of 8 seen flips (50% > 20%) triggers temp blacklist.
  • Purpose: Prevent overspending on a single item type.

Visibility Settings

Control which data fields are shown in flip messages.

showcost (Cost)

  • Type: Boolean
  • Default: true
  • Description: Display the purchase cost of the flip.

showestProfit (EstimatedProfit)

  • Type: Boolean
  • Default: true
  • Description: Show profit after AH tax (estimated sell price - cost - fees).

showlbin (LowestBin)

  • Type: Boolean
  • Default: false
  • Description: Display the current lowest BIN price.
  • Performance: Adds a few milliseconds delay to fetch lbin data.
  • Warning: If you use non-sniper finders, the mod warns that fetching lbin slows flips.

showslbin (SecondLowestBin)

  • Type: Boolean
  • Default: false
  • Description: Show the second-lowest BIN price.
  • Performance: Adds a few milliseconds delay.

showmedPrice (MedianPrice)

  • Type: Boolean
  • Default: false
  • Description: Display the median/target price (equals lbin for sniper flips).

showseller (Seller)

  • Type: Boolean
  • Default: true
  • Description: Show the auction seller's username.
  • Performance: Adds a few milliseconds to look up seller name.
  • Privacy: Disable to reduce data fetching.

showvolume (Volume)

  • Type: Boolean
  • Default: true
  • Description: Display average sales per 24 hours.

showextraFields (ExtraInfoMax)

  • Type: Integer (number of lines)
  • Default: 0
  • Description: How many extra info lines to display below the flip (e.g., enchantments, reforge, modifiers).
  • Example: Set to 3 to show up to 3 detail lines.

showprofitPercent (ProfitPercentage)

  • Type: Boolean
  • Default: true
  • Description: Show profit percentage (%).

showprofit (Profit)

  • Type: Boolean
  • Default: false
  • Description: Show absolute profit amount (in coins).
  • Difference from EstimatedProfit: This is a separate toggle for displaying profit explicitly in the message.

showsellerOpenBtn (SellerOpenButton)

  • Type: Boolean
  • Default: true
  • Description: Display a clickable button to open the seller's active auctions.

showlore (Lore)

  • Type: Boolean
  • Default: true
  • Description: Show full item description in hover tooltip.

showhideSold (HideSoldAuction)

  • Type: Boolean
  • Default: false
  • Description: Prevent sold auctions from appearing in flip messages.
  • Use case: Reduce clutter by hiding auctions that were already purchased by someone else.

showhideManipulated (HideManipulated)

  • Type: Boolean
  • Default: false
  • Description: Hide manipulated bazaar items (price ratio > 2× or > 1.5× above 7.5m).
  • Applies to: /cofl bazaar command and bazaar flip lists.

Privacy Settings

Control what data the mod collects and uploads for tracking/features.

privacyCollectChat (CollectChat)

  • Type: Boolean
  • Default: true
  • Description: Allow collection of limited chat messages to track trades, AH sales, drops, and bazaar events.
  • Required for: /cofl profit, flip tracking, trade history.

privacyCollectInventory (CollectInventory)

  • Type: Boolean
  • Default: true
  • Description: Upload chest and inventory contents (required for trade tracking).
  • Required for: /cofl search, lowball matching, trade profit tracking.

privacyDisableTradeStoring (DisableTradeStoring)

  • Type: Boolean
  • Default: false
  • Description: Stop storing player-to-player trades in your flip history.

privacyDisableKuudraTracking (DisableKuudraTracking)

  • Type: Boolean
  • Default: false
  • Description: Stop tracking Kuudra run profit calculations.

privacyCollectTab (CollectTab)

  • Type: Boolean
  • Default: true
  • Description: Read and upload tab list when joining servers to detect profile type, server, and island.
  • Required for: Auto-profile detection, location-based filters.

privacyCollectScoreboard (CollectScoreboard)

  • Type: Boolean
  • Default: true
  • Description: Read and upload scoreboard periodically to detect purse balance.
  • Required for: Purse-based flip filtering (modmaxPercentOfPurse).

privacyCollectChatClicks (CollectChatClicks)

  • Type: Boolean
  • Default: true
  • Description: Track clicks on chat messages (for analytics and improvement).

privacyExtendDescriptions (ExtendDescriptions)

  • Type: Boolean
  • Default: true
  • Description: Enable lore extensions (extra info lines in item tooltips).
  • Required for: /cofl lore customization.

privacyAutoStart (AutoStart)

  • Type: Boolean
  • Default: true
  • Description: Automatically connect to SkyCofl when joining SkyBlock.
  • When false: Must manually run /cofl start.

Lore Settings

Lore settings control the extra item information, menu panels, highlights, and price suggestions produced by SkyCofl. They do not change the item itself.

Command format and defaults

Every supported field in the backend DescriptionSetting model gets the lore prefix:

/cofl set lore<FieldName> <value>

For example, DisableHighlighting becomes /cofl set loreDisableHighlighting true. Names are case-insensitive. A Boolean value may be omitted to toggle it, but explicit true or false is safer. The defaults below are the fresh server-side defaults; /cofl set shows your saved value.

Some settings also have shorter aliases:

Full keyAlias
loreDisableSuggestionsnosuggest
loreBazaarBookmarksbzBookmarks
loreLowballMedUndercutmedUndercut
loreLowballLbinUndercutlbinUndercut
lorePreferLbinInSuggestionssuggestLbin
loreSuggestQuicksellsuggestQuicksell
loreNoCookienocookie
loreBuyOrderPricesbuyOrderPrices
loreDisableAuctionStartedTimenoStartTime
loreLowballNonExactExtraPctlbNonExactPct
loreLowballWorstCaseExtraPctlbWorstCasePct
loreLowballHideBreakdownlbHideBreakdown
loreLowballHideWorstCaselbHideWorstCase

The fields placed into each tooltip line are a separate layout, edited with /cofl lore. There is no /cofl set loreFields setting.

Extra lore, panels, and highlights

loreDisabled (Disabled)

  • Type: Boolean
  • Default: false
  • What it does: Stops all SkyCofl description extensions for items and menus. Supported menu versions show a small “SkyCofl Lore disabled” entry that can re-enable it.
  • Use when: You want to temporarily remove the entire overlay. For one unwanted menu panel, use loreDisableInfoIn instead.

loreDisableInfoIn (DisableInfoIn)

  • Type: Set of info-display names
  • Default: Empty
  • What it does: Disables selected SkyCofl side panels or menu-specific information without disabling normal item price lore.
  • Recommended method: Click the x attached to a SkyCofl info panel. SkyCofl stores the correct internal display name for you.
  • Manual examples:
    • /cofl set loreDisableInfoIn Crafting
    • /cofl set loreDisableInfoIn bazaar
    • /cofl set loreDisableInfoIn TradeInfoDisplay
    • /cofl set loreDisableInfoIn rm Crafting to re-enable one display
    • /cofl set loreDisableInfoIn clear to re-enable every display
  • Details: Display names are matched case-insensitively. Current named displays include Crafting and bazaar; other panels use their feature name, such as TradeInfoDisplay, ListPriceRecommend, or FishFamilyCalculator.

loreHighlightFilterMatch (HighlightFilterMatch)

  • Type: Boolean
  • Default: false
  • What it does: Highlights items in Auction House and trade-related windows when they match your whitelist, normal filters, blacklist, or force-blacklist. Each match type uses a different green or red shade.
  • Requirement: Filter-match highlighting requires an active Premium account. Other SkyCofl highlights are controlled separately.

loreMinProfitForHighlight (MinProfitForHighlight)

  • Type: Whole number (coins)
  • Default: 0
  • What it does: Sets the minimum exact median profit required before the best flip on an Auction House page receives a green highlight.
  • Example: /cofl set loreMinProfitForHighlight 5m
  • Details: This threshold only controls the “BEST FLIP ON PAGE” highlight. It does not filter flips or set your main minProfit.

loreDisableHighlighting (DisableHighlighting)

  • Type: Boolean
  • Default: false
  • What it does: Removes every SkyCofl slot background or outline after the server has calculated the page. This includes filter matches, best-flip markers, Bazaar order highlights, and other SkyCofl highlights.
  • Does not do: It does not disable ordinary extra lore or necessarily remove text warnings associated with a highlighted item.

Sign and listing-price suggestions

SkyCofl sends a special suggestion instruction with its menu information. On Fabric, the mod displays the proposed value and fills it only when the next Hypixel sign has the expected label, preventing a suggestion from being inserted into an unrelated sign.

loreDisableSuggestions (DisableSuggestions, alias: nosuggest)

  • Type: Boolean
  • Default: false
  • What it does: Prevents automatic sign filling for Auction House list prices, Bazaar order prices, and lowball trade amounts.
  • When enabled: SkyCofl still shows the recommended number as text; you enter it yourself.
  • Example: /cofl set nosuggest true

lorePreferLbinInSuggestions (PreferLbinInSuggestions, alias: suggestLbin)

  • Type: Boolean
  • Default: false
  • What it does: Starts Auction House listing recommendations from the current matching Lowest BIN minus one coin instead of the stable median.
  • Important: A saved recommendation for the exact flip or one of your previous listing prices can still take priority. When this setting is off, SkyCofl may still select a matching LBIN for a high-volume, low-volatility item.

loreSuggestQuicksell (SuggestQuicksell, alias: suggestQuicksell)

  • Type: Boolean
  • Default: false
  • What it does: Caps an Auction House listing recommendation at SkyCofl’s estimated instant-sell price when that is lower than the normal recommendation.
  • Trade-off: This aims to sell faster, but usually gives up some potential profit.

Bazaar helpers and craft-cost pricing

loreBazaarBookmarks (BazaarBookmarks, alias: bzBookmarks)

  • Type: Set of Bazaar item tags
  • Default: Empty
  • What it does: Adds bookmarked products, with current prices and clickable searches, to the main Bazaar menu.
  • Recommended method: Open a Bazaar product and click add bookmark or remove bookmark in the SkyCofl panel.
  • Manual examples:
    • /cofl set bzBookmarks ENCHANTED_DIAMOND
    • /cofl set bzBookmarks rm ENCHANTED_DIAMOND
    • /cofl set bzBookmarks clear

loreNoCookie (NoCookie, alias: nocookie)

  • Type: Boolean
  • Default: false
  • What it does: Changes clickable Bazaar flip and bookmark links from Hypixel’s /bz <item> shortcut to /cofl bazaarsearch <item>. The Fabric mod then opens the Bazaar search control, fills its sign, and submits it.
  • Use when: You cannot use /bz, normally because you do not have an active Booster Cookie.
  • Warning: This performs extra GUI clicks, may conflict with other mods, and is described by the backend as potentially considered macro behavior. Leave it off unless you understand and accept that risk.

loreBuyOrderPrices (BuyOrderPrices, alias: buyOrderPrices)

  • Type: Boolean
  • Default: false
  • What it does: Uses top Bazaar buy-order prices and buy-order recipe costs for affected CRAFT_COST, FullCraftCost, and Bazaar-priced modifier-component calculations. The full craft-cost line is marked {BUY_ORDER}.
  • When off: Those calculations use the normal instant-buy/lowest-sell-offer based recipe and component costs.
  • Does not change: Raw LBIN, MEDIAN, BazaarBuy, or BazaarSell fields.

Lowball trade recommendations

SkyCofl calculates adjusted median and LBIN values for every item you would receive, then uses the lower positive estimate. The base undercuts below receive automatic risk adjustments:

  • Value below 10m: add 2 percentage points.
  • Value above 100m: subtract 2 points; above 1b subtract another 3.
  • Volume at or below 1 sale/day: add 3 points; at or below 0.4 add another 2.
  • An inexact price match can add loreLowballNonExactExtraPct.

These settings change recommendations only; they do not change market data.

loreLowballMedUndercut (LowballMedUndercut, alias: medUndercut)

  • Type: Byte percentage (use 0100)
  • Default: 0
  • What it does: Base percentage subtracted from the median estimate before automatic risk adjustments.
  • Special values: 0 still participates in the calculation but shows a reminder to configure lowballing. 100 disables lowball suggestions entirely.
  • Example: /cofl set medUndercut 10

loreLowballLbinUndercut (LowballLbinUndercut, alias: lbinUndercut)

  • Type: Byte percentage (use 0100)
  • Default: 10
  • What it does: Base percentage subtracted from the matching Lowest BIN estimate before automatic risk adjustments.
  • Example: /cofl set lbinUndercut 10

loreLowballNonExactExtraPct (LowballNonExactExtraPct, alias: lbNonExactPct)

  • Type: Byte percentage
  • Default: 2
  • Recommended range: 010
  • What it does: Adds an extra undercut when the price key does not exactly match the item’s valuable modifiers and the estimate therefore comes from similar items.
  • Disable with: /cofl set lbNonExactPct 0

loreLowballWorstCaseExtraPct (LowballWorstCaseExtraPct, alias: lbWorstCasePct)

  • Type: Byte percentage
  • Default: 5
  • Recommended range: 015
  • What it does: Shows a second, more conservative total by adding this undercut when current volume is above 0.4, simulating a drop into the lowest-volume band.
  • Does not change: The main recommended lowball total.
  • Disable with: /cofl set lbWorstCasePct 0

loreLowballHideBreakdown (LowballHideBreakdown, alias: lbHideBreakdown)

  • Type: Boolean
  • Default: false
  • What it does: Hides the per-item median/LBIN, volume, applied-undercut, exact-match, and AI-value rows in the lowball recommendation hover.
  • Does not change: The recommendation itself.

loreLowballHideWorstCase (LowballHideWorstCase, alias: lbHideWorstCase)

  • Type: Boolean
  • Default: false
  • What it does: Hides the worst-case lowball total and its per-item worst-case values.
  • Does not change: The main recommendation.

Generated-lore colors

These settings replace one Minecraft color code in all SkyCofl-generated modifications. They do not recolor Hypixel’s original item description. Supply the single code character without §; for example, c is red, b is aqua, f is white, and 7 is gray. Run the command without a value to clear a replacement.

SettingDefaultReplacesExample
loreReplaceGrayWithNot setGray (§7)/cofl set loreReplaceGrayWith f
loreReplaceAquaWithNot setAqua (§b)/cofl set loreReplaceAquaWith 6
loreReplaceYellowWithNot setYellow (§e)/cofl set loreReplaceYellowWith a
loreReplaceGoldWithNot setGold (§6)/cofl set loreReplaceGoldWith e
loreReplaceWhiteWithNot setWhite (§f)/cofl set loreReplaceWhiteWith 7

The backend does not validate these strings as color codes, so use one valid Minecraft formatting character.

Auction timing and compatibility

loreDisableAuctionStartedTime (DisableAuctionStartedTime, alias: noStartTime)

  • Type: Boolean
  • Default: false
  • What it does: Stops SkyCofl replacing an Auction House lore line with Started <time> ago when auction-history data is available, normally alongside the PRICE_PAID lore field.
  • Use when: Another mod inserts or rearranges tooltip lines and the replacement lands on the wrong seller, price, or timing line.

loreCustomFormat (CustomFormat)

  • Type: String
  • Default: Not set
  • Status: Hidden compatibility field.
  • Current behavior: It is accepted and stored by the settings backend, but the inspected current SkyApi, coflskycore, and Fabric implementations do not consume it. Changing it has no supported visible effect; use /cofl lore to arrange fields instead.

Tips & Best Practices

Optimizing for Speed

  • Enable only sniper finder with lbin mode for fastest flips.
  • Disable showseller and showlbin to reduce lookup delays.
  • Set blockHighCompetition to true.

Reducing Chat Spam

  • Increase minProfit and minProfitPercent.
  • Enable modblockedMsg 5 to reduce blocked flip summaries.
  • Keep moddisableSpamProtection false (default).

Maximizing Profit

  • Use FLIPPER_AND_SNIPERS finders for broader coverage.
  • Lower minVolume to 0.1 to see rare high-profit items.
  • Enable /cofl set finders flipper,sniper,median for all algorithms.

Safety & Fairness

  • Never disable blockHighCompetition (risks wasted clicks).
  • Keep modtempBlacklistSpam enabled to avoid manipulation traps.
  • Set modmaxPercentOfPurse to avoid overspending (e.g., 30 = max 30% of purse per flip).

Customization

  • Edit modformat to personalize flip messages.
  • Adjust timer position with modtimerX and modtimerY.
  • Use /cofl lore to configure which stats appear in item descriptions.

Quick Reference Table

SettingCategoryTypeDefaultDescription
lbinGeneralBooleanfalseUse lbin for profit calculation
findersGeneralFinderType119Which flip algorithms to use
onlyBinGeneralBooleantrueShow only BIN auctions
minProfitGeneralLong2500000Minimum profit (coins)
minProfitPercentGeneralInteger20Minimum profit (%)
minVolumeGeneralDouble0.1Minimum sales/day
maxCostGeneralLong1000000000Maximum purchase price
blockHighCompetitionGeneralBooleantrueHide impossible flips
modsoundOnFlipModBooleantruePlay flip sound
modcountdownModBooleantrueShow timer
modautoStartFlipperModBooleanfalseAuto-start on join
modstreamerModeModBooleanfalseHide personal data
showcostVisibilityBooleantrueShow cost
showestProfitVisibilityBooleantrueShow profit
showvolumeVisibilityBooleantrueShow volume
showsellerVisibilityBooleantrueShow seller name
privacyCollectChatPrivacyBooleantrueTrack chat for events
privacyCollectInventoryPrivacyBooleantrueUpload inventory
privacyExtendDescriptionsPrivacyBooleantrueEnable lore overlay
loreHighlightFilterMatchLoreBooleanfalseHighlight filter matches
loreDisabledLoreBooleanfalseDisable all lore

  • /cofl set – View all settings with interactive toggles
  • /cofl set <page> – Jump to a specific settings page
  • /cofl set <setting> <value> – Change a setting directly
  • /cofl blocked – See why flips are filtered out
  • /cofl lore – Customize item description overlays
  • /cofl bl / /cofl wl – Manage blacklist/whitelist filters

Troubleshooting

Q: Why aren't I seeing any flips?
A: Check /cofl blocked to see what's being filtered. Common causes:

  • minProfit or minProfitPercent too high
  • Wrong finders enabled
  • DisableFlips turned on accidentally
  • Purse too low + maxCost or modmaxPercentOfPurse blocking expensive flips

Q: Flips are too slow / arrive late
A: Run /cofl delay to check your current delay. Reduce it by:

  • Disabling showseller and showlbin (reduces lookup time)
  • Using only sniper finder with lbin mode
  • Upgrading to Premium/Premium+ (lower base delay)
  • Solving captchas with /cofl captcha

Q: How do I reset settings to default?
A: Use /cofl backup add default to save current settings, then manually change each setting back to documented defaults, or load a fresh config from /cofl configs.


Last Updated: October 2025
For more help, join the Coflnet Discord or check the full command reference.