Hookt

Hookt is a modification that completely reworks the fishing loot system in Minecraft, allowing you to create complex drop conditions and item replacement rules.

The mod requires the Athenaeum library to function.

Main Features

Trigger Conditions

The mod allows configuring conditions for replacing fishing loot based on:

• Caught items (metadata, wildcards, multiple metadata values, ore dictionary) with whitelist and blacklist
• Angler type (player, non-player, any)
• Item held by the angler (metadata, wildcards) with whitelist and blacklist
• Player game stages (requires GameStages mod)
• Player name
• Biome with whitelist and blacklist
• Dimension with whitelist and blacklist
• Vertical range

Replacement Strategies

Various item replacement methods are available:

• Adding to existing loot
• Complete replacement of all dropped items
• Replacement of all items when a specific loot is selected
• Replacement of only matching items from the condition
• Replacement of matching items when a specific loot is selected

Drop System

Selection strategies:

• Repeat (an item can drop multiple times)
• Unique (each item drops only once)

Number of dropped items is determined by:

• Fixed value
• Random number in specified range
• Modified by player's luck

Drop probability depends on:

• Weight modified by luck
• Minimum luck level

Item stack quantity:

• Fixed value
• Random number in specified range
• Modified by luck

Loot Configuration

• Ability to create lists of dropped items
• Use of wildcards for metadata
• Work with ore dictionary
• Configuration of dropped experience (range modified by luck)
• Adding NBT data to items

Commands

/hookt reload — reload configuration during gameplay

/hookt hand — copy the held item's string for quick pasting into .json file; especially useful for lengthy NBT tags

Configuration

Hookt uses configuration files in .json format placed in the [instance]/config/hookt folder. File names don't matter as long as they have the .json extension. You can create any number of configuration files.

Logging

All syntax errors in .json files are output to the Forge log. When reloading configuration in-game, errors are also displayed in the chat.

All errors are additionally written to the log file: [instance]/hookt.log.

For each individual rule, additional debug information can be enabled, which will be output to the log file.