This configuration section allows for setting up custom loot drops with various settings, including item specifics, drop chance, requirements based on player levels, and more.
imperial: true
You can add imperial: true to the drop configuration if you want the {length} placeholder to display values in the Imperial measurement system (inches, feet) instead of the default Metric system (centimeters, meters).
Top-Level Configuration Options
Key
Type
Description
custom-loot
Section
Main configuration section for custom loot drops.
enabled
Boolean
Enables or disables the custom loot system.
chance
Integer
Chance (in %) for custom loot to drop when conditions are met.
rewards
Section
Defines specific loot items and their requirements.
Rewards Section
Each entry under rewards defines an individual loot item and its requirements. Entries are identified by unique string keys (e.g., '1'), which should be incremented for each new reward.
Key
Type
Description
chance
Integer
Chance (in %) for this specific reward to drop, independent of custom-loot chance.
level-requirement
Integer
Minimum player level required for this reward to be available.
item
Section
Item configuration section (see below for details).
amount
Integer
Quantity of the item to drop.
size
Range
Specifies a range (e.g., 15-30) for the item's stack size.
Item Configuration Section
Each reward includes an item section that specifies the properties and appearance of the item to be dropped.
Key
Type
Description
material
String
The base material of the item (e.g., RAW_FISH).
base64
Section
Custom texture configuration for the item.
name
String
Display name of the item. Supports color codes (& format).
lore
List
List of strings defining the lore of the item, supporting color codes and placeholders like {length}.
Note: Color codes use &# syntax to specify hex colors (e.g., B9F94), which can create more customized color effects.
Base64 Section
The base64 section is used to apply a custom texture to the item. This requires two fields:
Key
Type
Description
enabled
Boolean
Enables or disables custom texture for the item.
value
String
Base64-encoded texture value for the item. Example values can be obtained through external skin databases.
Example Breakdown
Material: Specifies the item as a RAW_FISH.
Custom Texture: Enabled with a Base64-encoded texture, applied only if base64.enabled is set to true.
Item Name: Displayed as &lsᴀʀᴅɪɴᴀ in teal color.
Lore: Provides extra text with {length}, which can be set to show in Imperial or Metric values.
Amount: 1 item will drop per successful reward.
Size: Specifies a range for the item stack, generating between 15 and 30 weight.
