# Custom Loot 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. ```yaml custom-loot: enabled: true chance: 100 rewards: #Must have atleast one reward with level-requirement:0 '1': imperial: true chance: 100 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOWZiZTFiZTE5ZTRmZmFiYTk3ZDYxYmVlZjdjYTMwMTBiNjI5OTZjNjQxZTU3MDg0ZmMzNjRhNmYzZWIxNDEzOCJ9fX0= name: 'B9F94&lsᴀʀᴅɪɴᴀ' lore: - '&8ᴄᴏᴍᴍᴏɴ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 15-30 '2': chance: 70 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNzg5MmQ3ZGQ2YWFkZjM1Zjg2ZGEyN2ZiNjNkYTRlZGRhMjExZGY5NmQyODI5ZjY5MTQ2MmE0ZmIxY2FiMCJ9fX0= name: '&#C2AE92&lᴄᴏᴅ' lore: - '&8ʀᴀʀᴇ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 40-85 '3': chance: 60 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNzViYTM5M2I5MjZlZTY5YTE0ZDRkODUzYjI1ZDI4NWE4NjhiMTZjNTZjOTE5ZDJiODI0NDEzZTY1NjZkNGU1NSJ9fX0= name: '&#FC5D94&lᴛʀᴏᴘɪᴄᴀʟ ꜰɪѕʜ' lore: - '&8ʀᴀʀᴇ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 35-40 '4': chance: 50 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDZkZDVlNmFkZGI1NmFjYmM2OTRlYTRiYTU5MjNiMWIyNTY4ODE3OGZlZmZhNzIyOTAyOTllMjUwNWM5NzI4MSJ9fX0= name: '&#EE6426&lᴄʟᴏᴡɴꜰɪѕʜ' lore: - '&8ᴄᴏᴍᴍᴏɴ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 8-17 '5': chance: 40 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTNlNjY4ODZhMzRlZWJiNTIwMzBmMGYzM2ZiZTYwYjcwYzY3ZGRjOTE4ZmFlZTQ1YTQyN2QzZjY4NzMwM2E4In19fQ== name: '&#E1C52E&lɢᴏʟᴅꜰɪѕʜ' lore: - '&8ʀᴀʀᴇ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 12-41 '6': chance: 30 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNDVhZjQ2OWU4MWUwZThmMjgwNzkyZTA2Mzk5NTg2MDFkMTIwMWRkNDIxNmI1M2FiNGE2NjU4MTBkYzMwNWU0MyJ9fX0= name: '&#FFFB00&lᴇʟᴇᴄᴛʀɪᴄ ᴍᴇᴅᴜsᴀ ' lore: - '&8ᴇхᴏᴛɪᴄ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 120-200 '7': chance: 20 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmI2NTZiYWM2NGFkYTY0ZmEyMjFlOWY0OGZiZjhhYjkzMzRiNzkzNGVmYjk3OWQ3NThkZjRkMGMxYmQxNzY5NSJ9fX0= name: ' B60FD&lᴍᴇᴅᴜsᴀ' lore: - '&8ᴇхᴏᴛɪᴄ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 120-200 '8': chance: 10 level-requirement: 0 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGZiYmQxYjExZGM3YTA3MTZlZDMxNWEzZTFiMjhmODllMDUwZjUyNDQ4MTAyZTI0ZTE4NzA2MjZjOWE4MTcyMyJ9fX0= name: '&#A3BEE8&lѕʜᴀʀᴋ' lore: - '&8ᴇхᴏᴛɪᴄ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 100-210 '9': chance: 5 item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvM2FmNzIyMTc5ODU0NmY4ZjllNzZhNmEzZWUzYjE3NjczNGU5ZDVmMTdkYmNiMDg1OTgxOTQxNzU4Njk4NjQzNiJ9fX0= name: '୍FF&lᴡʜᴀʟᴇ' lore: - '&8ᴇхᴏᴛɪᴄ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 2500-3000 '10': chance: 5 lava-drop: true item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTE0MGM0MmZjM2ExYmEyZmU3N2M0NWI5NzVmYTg3ZThmNTRhMWIxODMzYmM3NmU2MzM5YjRjMjYyMzA0MDExZCJ9fX0= name: '&#B0952A&lꜰʟʏꜰɪѕʜ' lore: - '&8ᴄᴏᴍᴍᴏɴ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 17-30 '11': chance: 5 lava-drop: true item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjU2YjU5NTViMjk1NTIyYzk2ODk0ODE5NjBjMDFhOTkyY2ExYzc3NTRjZjRlZTMxM2M4ZGQwYzM1NmQzMzVmIn19fQ== name: '&#FF6600&lᴍᴀɢᴍᴀꜰɪѕʜ' lore: - '&8ʀᴀʀᴇ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 200-500 '12': chance: 5 lava-drop: true item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTIzZTBhMjUwNDhiNjBhMmNjMDkyZjcyOTQzMTU5ZWMxNzAwNjNiYjIzNWFhNzk2OTBlZjM0YWIxODFkNjkxIn19fQ== name: 'E9091&lѕᴋᴇʟᴇᴛᴏɴ ꜰɪѕʜ' lore: - '&8ʀᴀʀᴇ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 200-500 '13': chance: 5 lava-drop: true item: material: RAW_FISH base64: enabled: true value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDlhNTI2NzNjNzdhYzA3OWVkMzQ3MmI2OWZlNGU5MWJkMjgwMTlmMjhmM2U5ZDg1YmY5NGRmYWQ2ZTM5OGM0ZiJ9fX0= name: 'E9091&lᴘɪɴᴇᴀᴘᴘʟᴇ ꜰɪѕʜ' lore: - '&8ᴇхᴏᴛɪᴄ ᴛɪᴇʀ' - '&7' - '୍FF▶ {length}' amount: 1 size: 2000-5000 ``` Possible Loot 
   custom-loot:
    enabled: true
    chance: 100
    rewards:
      #Must have atleast one reward with level-requirement:0
      '1':
        size: 2000-5000 
        lava-drop: true
        ############################## 
        level-requirement: 5
        chance: 3
        commands:
         - '[sound]ENTITY_LEVEL_UP;1.0;1.0'
         - '[message]&7Example Message %player%'
         - '[broadcast]&7Example Message %player%'
         - '[json]{"text":"Message"}'
        permission: 'needed-permission'
        exp: 10-20 #Minecraft EXP
        xp: 10-20 #Tool XP
        use-price: false # Set to true if using sell-price: instead of length
        sell-price: 100-200
        amount: 1-3
        regions:
          - 'worldguardregions'
        prestige-requirement: 2
        level-requirement: 3
        exact-level: 2
        essence: 200
        item:
         name: ''
       ############################## 
         material: RAW_FISH
       ############################## 
         base64:
            enabled: true
            value: '' #https://minecraft-heads.com/custom-heads
       ############################## 
         skull:
            enabled: true
            name: Steve
       ############################## 
         lore: 
          - '&7Lore'
          - '&7Lore'
       ############################## 
         glow: true
       ############################## 
         enchants: # Enchants https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
          - 'DURABILITY:10'
       ############################## 
         flags:  # ItemFlags https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html
          - 'HIDE_ENCHANTS' 
       ##############################
         nbt: 
          integer:
            key: 'nbtitem'
            value: '1'
       ##############################  
         nbt: 
          string:
            key: 'nbtitem'
            value: 'Item'
       ############################## 
         nbt: 
          boolean:
            key: 'nbtitem'
            value: true
        ############################## 
        customdata: 1 # For Custom Textures 1.16+
        customModelData: 1 # For Custom Textures 1.16+
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.rivaldev.xyz/rival-tools/rival-fishing-rods/custom-loot.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.