Skip to content

ABF (Mod Abbreviation) Config File Guide

Jump to bottom
LithumC edited this page Jul 28, 2026 · 3 revisions
wiki

⚠️ Disclaimer: This English version has been automatically translated by an AI assistant. While every effort has been made to ensure accuracy, there may be translation errors or ambiguous phrasings. For the most reliable and precise information, please refer to the original Chinese version. If you notice any significant issues, feel free to report them.

Preface

Since the 23.8 update, the mod's configurability has been further enhanced; this guide will fully explain the mod's configuration file.

Although it is essentially a random fishing rod mod, its powerful configurability makes it entirely usable as a modpack tweaking tool.

Configuration GUI

Required Dependencies

A GUI configuration interface significantly lowers the learning curve and is recommended for newcomers.

To modify the mod's configuration via an intuitive GUI, you need to install the following mods:

  • Fabric API (optional dependency since version 23.8)
  • Mod Menu
  • YetAnotherConfigLib (for 1.20 and above)
  • Cloth Config API (for versions below 1.20)

Many people think YACL's compatibility is quite poor, but the author believes YACL's configuration interface has better layout and readability compared to Cloth Config API.

Screenshots

These are screenshots of the configuration interface running on Minecraft 1.20.6 & Fabric 0.19.3.

1784834863_601517_kHyE 1784834875_601517_MiCK
1784834885_601517_uILO 1784834897_601517_gqmJ

Config File Location & Format

Config file path:

.minecraft/config/anythingbutfish.json5

It is automatically generated by the mod on first launch. If the file does not exist or is corrupted, the mod will automatically rebuild it with default settings.

When updating the mod, due to changes in the config file, it is recommended to delete the old config to avoid issues.

Table of Contents

The config file includes the following sections:

  • General – probabilities, stack sizes, experience, casting physics
  • Miscellaneous – master switch, debug mode, infinite durability, wait for bite, modded rod compatibility
  • Item Pool – whitelist/blacklist items with additional rules
  • Entity Pool – whitelist/blacklist entities with additional rules

Feature Toggles

enabled (Master Switch)

Property Value
Type Boolean
Default true

Master switch for the mod. When set to false, fishing reverts completely to vanilla behavior, producing no random loot.

debugMode (Debug Mode)

Property Value
Type Boolean
Default true

When enabled, each reel‑in will output the caught result in chat and the game log.

This feature is designed for troubleshooting mod conflicts and may impact performance; regular players do not need to enable it.

Example output:

[ABF] Item: minecraft:diamond x2
[ABF] Entity: minecraft:creeper
[ABF] XP: 37
[ABF] The one that got away...

infiniteDurability (Infinite Durability)

Property Value
Type Boolean
Default false

When enabled, fishing rods no longer lose durability and can be cast and reeled in infinitely. This applies to vanilla rods and any modded rods that inherit FishingRodItem.

moddedRodCompat (Modded Rod Compatibility)

Property Value
Type Boolean
Default true

In older versions this was indeed a separate design; in the new version (23.8) it has not been removed and serves as an informational flag. Any fishing rod that uses the vanilla bobber entity will automatically trigger the mod's mechanics.

waitForBite (Wait for Bite)

Property Value
Type Boolean
Default true

Controls when random loot is given.

  • If disabled, every reel‑in gives random loot, regardless of whether anything was caught.
  • If enabled, random loot is given only when the hook actually gets a bite, requiring you to wait like in vanilla fishing.

Probability Settings

The sum of the three probability values must not exceed 100. The remainder is the chance of "the one that got away" (i.e., nothing is caught).

chanceItem (Item Drop Chance)

Property Value
Type Integer
Range 0 ~ 100
Default 60

The percentage chance of catching a random item when reeling in. Set to 0 to completely disable this loot type.

chanceEntity (Entity Spawn Chance)

Property Value
Type Integer
Range 0 ~ 100
Default 25

Entities spawned by the fishing rod will be flung toward the player like items. Be careful with lit TNT and creepers that might ruin your party.

chanceXp (Experience Orb Chance)

Property Value
Type Integer
Range 0 ~ 100
Default 10

Probability Calculation Example

"chanceItem": 60,
"chanceEntity": 25,
"chanceXp": 10
  • Item: 0% ~ 59% (60% probability)
  • Entity: 60% ~ 84% (25% probability)
  • Experience: 85% ~ 94% (10% probability)
  • The one that got away: 95% ~ 99% (5% probability, no output)

If the sum of the three exceeds 100, the mod will automatically scale them proportionally to fit within 100.

Pool Modes (Core Mechanism)

The mod supports two pool modes, controlled by itemPoolIsWhitelist (item list) and entityPoolIsWhitelist (entity list).

itemPoolIsWhitelist (Item Pool Mode)

Property Value
Type Boolean
Default true

entityPoolIsWhitelist (Entity Pool Mode)

Property Value
Type Boolean
Default true

Behaviour of the two modes:

  • Whitelist: Only entries in the list can appear. If the list is empty, this loot type is entirely skipped.
  • Blacklist: Entries in the list are excluded from the full registry, all others may appear, subject to registry filters.

Registry Filters

Note: The following filters only take effect when drawing from the full registry in blacklist mode. They have no effect in whitelist mode.

allowModdedItems (Allow Modded Items)

Property Value
Type Boolean
Default true

When disabled, the full registry draw in blacklist mode will exclude all items that are not in the minecraft namespace.

allowModdedEntities (Allow Modded Entities)

Property Value
Type Boolean
Default true

When disabled, the full registry draw in blacklist mode will exclude all entities that are not in the minecraft namespace.

allowAdminItems (Allow Admin Items)

Property Value
Type Boolean
Default true

When disabled, the following items will not appear in the random pool:

  • Command blocks (normal / chain / repeating / command block minecart)
  • Structure blocks, structure voids, jigsaw blocks
  • Barriers, debug sticks
  • Written books, knowledge books
  • Light blocks

allowDangerousMobs (Allow Dangerous Mobs)

Property Value
Type Boolean
Default false

When set to false (default), the following entities will not appear in the random pool:

  • Ender Dragon (minecraft:ender_dragon)
  • Wither (minecraft:wither)

Item Settings

itemCountMin (Minimum Stack Size)

Property Value
Type Integer
Range 1 ~ 64
Default 1

itemCountMax (Maximum Stack Size)

Property Value
Type Integer
Range 1 ~ 64 (must be ≥ itemCountMin)
Default 1

The default stack size range when an item is caught. Whitelist entries can override this global setting via their own minCount / maxCount.

itemPool (Item List)

Property Value
Type Array of objects
Default [] (empty)

Format of each entry:

{
  "id": "minecraft:diamond",
  "minCount": 1,
  "maxCount": 3
}

Whitelist Mode Example

Allow only diamonds, iron ingots, and cod:

"itemPoolIsWhitelist": true,
"itemPool": [
  { "id": "minecraft:diamond" },
  { "id": "minecraft:iron_ingot", "minCount": 1, "maxCount": 5 },
  { "id": "minecraft:cod" }
]

Blacklist Mode Example

Forbid dirt and stone:

"itemPoolIsWhitelist": false,
"itemPool": [
  { "id": "minecraft:dirt" },
  { "id": "minecraft:stone" }
]

Entity Settings

entityPool (Entity List)

Property Value
Type Array of objects
Default [] (empty)

Format of each entry:

{
  "id": "minecraft:creeper"
}

Whitelist Mode Example

Allow only pigs and cows:

"entityPoolIsWhitelist": true,
"entityPool": [
  { "id": "minecraft:pig" },
  { "id": "minecraft:cow" }
]

Blacklist Mode Example

Forbid creepers and endermen:

"entityPoolIsWhitelist": false,
"entityPool": [
  { "id": "minecraft:creeper" },
  { "id": "minecraft:enderman" }
]

Note: The player (minecraft:player) and fishing bobber (minecraft:fishing_bobber) are always excluded and cannot be added via configuration.

Experience Settings

xpMin (Minimum Experience)

Property Value
Type Integer
Range 1 ~ 1000
Default 1

xpMax (Maximum Experience)

Property Value
Type Integer
Range 1 ~ 1000 (must be ≥ xpMin)
Default 50

When an experience result is triggered, the actual reward points are randomly chosen between these two values.

Physics Parameters

Controls how items, entities, and experience orbs are flung toward the player after reeling in.

flingSpeed (Fling Speed)

Property Value
Type Float
Range 0.01 ~ 1.0
Default 0.1

Horizontal speed multiplier. Higher values make loot fly faster horizontally toward the player.

flingArc (Fling Arc)

Property Value
Type Float
Range 0.0 ~ 1.0
Default 0.08

Upward arc multiplier. Higher values make loot fly higher (rising then falling). Set to 0.0 for a straight line toward the player.

Complete Config File Example

A fully commented example configuration file (JSON5 format):

/*
 * AnythingButFish Configuration File
 *
 * Pool modes:
 *   itemPoolIsWhitelist / entityPoolIsWhitelist
 *     true  (WHITELIST) – only items/entities in the list can appear.
 *                         Empty list = skip this loot type entirely.
 *     false (BLACKLIST) – full registry minus items/entities in the list.
 *                         allowModded/allowAdmin/allowDangerous filters apply.
 *
 * Probability: chanceItem + chanceEntity + chanceXp <= 100.
 *   Remainder is the chance of nothing (the one that got away).
 */
{
  "itemPoolIsWhitelist": false,
  "entityPoolIsWhitelist": false,
  "enabled": true,
  "debugMode": false,
  "infiniteDurability": false,
  "moddedRodCompat": true,
  "waitForBite": false,
  "allowModdedItems": true,
  "allowModdedEntities": true,
  "allowAdminItems": false,
  "allowDangerousMobs": false,
  "chanceItem": 60,
  "chanceEntity": 25,
  "chanceXp": 10,
  "itemCountMin": 1,
  "itemCountMax": 1,
  "itemPool": [],
  "entityPool": [],
  "xpMin": 1,
  "xpMax": 50,
  "flingSpeed": 0.1,
  "flingArc": 0.08
}

Clone this wiki locally