Skip to content

Trigger Profiles

Jump to bottom
Rudra edited this page Jan 8, 2026 · 2 revisions

Trigger Profiles (trigger_profiles.yml)

Trigger profiles define how items gain XP. Each profile specifies what action triggers XP gain, how much XP is given, and what blocks/entities are filtered.

File Location

plugins/LevelTools/trigger_profiles.yml

Structure

profiles:
  profile_id:
    type: BLOCK_BREAK  # Trigger type
    xp_modifier:       # XP amounts
      default:
        min: 1.0
        max: 2.0
      custom:
        DIAMOND_ORE:
          min: 5.0
          max: 10.0
    filter:            # Whitelist/blacklist
      type: BLACKLIST
      list:
        - "STONE"

Trigger Types

Type Description Filter Applies To
BLOCK_BREAK XP when breaking blocks Block material
ENTITY_KILL XP when killing entities Entity type
FISHING XP when catching items Caught item material
RIGHT_CLICK XP on right click N/A
LEFT_CLICK XP on left click N/A
CONSUME XP when consuming item N/A
FARMING XP when tilling soil and breaking plants Block material

XP Modifier

Defines the random XP range given per action.

xp_modifier:
  default:
    min: 0.5   # Minimum XP
    max: 1.5   # Maximum XP
  custom:
    DIAMOND_ORE:
      min: 5.0
      max: 10.0
  • default: Base XP range for all blocks/entities
  • custom: Override XP for specific blocks/entities

The actual XP given is randomly selected between min and max.

Filter

Controls which blocks/entities give XP.

filter:
  type: BLACKLIST  # or WHITELIST
  list:
    - "STONE"
    - "DIRT"
Type Behavior
BLACKLIST Everything gives XP except items in the list
WHITELIST Only items in the list give XP

Click Mode (RIGHT_CLICK / LEFT_CLICK only)

click_mode: ANY  # ANY, ON_BLOCK, ON_ENTITY, ON_AIR
Mode Description
ANY Any click triggers XP
ON_BLOCK Only clicking on blocks
ON_ENTITY Only clicking on entities
ON_AIR Only clicking in air

Default Profiles

block_mining

Used by pickaxes, axes, and shovels. Gains XP from breaking blocks.

block_mining:
  type: BLOCK_BREAK
  xp_modifier:
    default:
      min: 0.5
      max: 1.5
    custom:
      DIAMOND_ORE:
        min: 5.0
        max: 10.0
  filter:
    type: BLACKLIST
    list:
      - "FIRE"
      - "TORCH"
      - "GRASS"
      # ... (filters out decorative blocks)

combat

Used by swords, bows, and crossbows. Gains XP from killing entities.

combat:
  type: ENTITY_KILL
  xp_modifier:
    default:
      min: 1.0
      max: 2.5
    custom:
      BLAZE:
        min: 5.0
        max: 7.5
  filter:
    type: BLACKLIST
    list:
      - "PLAYER"  # Prevent PvP XP farming

fishing

Used by fishing rods. Gains XP from catching items.

fishing:
  type: FISHING
  xp_modifier:
    default:
      min: 1.0
      max: 5.0
    custom:
      COD:
        min: 1.0
        max: 2.0
  filter:
    type: BLACKLIST
    list: []

Creating Custom Profiles

Example: Hoe trigger for farming (THIS IS NOW OUTDATED, BUT EXAMPLE IS STILL USEFUL. FARMING TRIGGER TYPE IS MORE USEFUL.)

profiles:
  farming:
    type: BLOCK_BREAK
    xp_modifier:
      default:
        min: 1.0
        max: 2.0
      custom:
        WHEAT:
          min: 2.0
          max: 4.0
        POTATOES:
          min: 2.0
          max: 4.0
        CARROTS:
          min: 2.0
          max: 4.0
    filter:
      type: WHITELIST
      list:
        - "WHEAT"
        - "POTATOES"
        - "CARROTS"
        - "BEETROOTS"
        - "NETHER_WART"

Reference Links

Clone this wiki locally