• 💬 Custom messages with multi-language support
• ✨ Particle effects for treasures
• 📦 Interactive list inventory
• ⚙️ In-game configuration
• 🎯 Place mode for better item placement
• 🔊 Sound effects for every action
• 💾 Inventory save during place mode
• 🏆 Leaderboard menu
• 📊 Progress tracking menu
• 🌟 Treasure glow effects
• 🎁 Custom reward commands
• 💡 Hint system with cooldowns
• 📚 Multiple independent collections
• 🌍 Multi-language support (EN, DE, FR, VN, BN, ZH)
• 🎨 Hex color support
• MYSQL, SQLite support
• Client-Side hiding when disabled

All placeholders can be viewed on the GitHub Wiki

config-version: 4.0

storage:
  # Options: SQLITE, MYSQL, YAML
  type: SQLITE

  # MySQL Configuration (Only needed if type is MYSQL)
  mysql:
    host: localhost
    port: 3306
    database: advancedhunt
    username: root
    password: password

# Supported languages are en, de, bn, vi
language: en

command:
  # Defines the main command and its aliases for the plugin.
  # The first value is used as the primary command, all following values (separated by "|") are registered as aliases.
  name: advancedhunt|ah|ahunt|treasure|treasures
  
  # Enable Brigadier command integration for enhanced command completion.
  # Brigadier provides native Minecraft command suggestions and validation.
  # Disable this if you experience command-related issues or prefer legacy completion.
  brigadier-integration: false

rewards:
  # Commands matching these regex patterns will be blocked from being added or executed.
  # Use ^ to match the start and $ to match the end of the command.
  # Matches are case-insensitive.
  command-blacklist:
    - "^([^:]+:)?execute\\b"
    - "^([^:]+:)?op\\b"
    - "^([^:]+:)?deop\\b"
    - "^([^:]+:)?kill\\b"
    - "^([^:]+:)?summon\\b"
    - "^([^:]+:)?setblock\\b"
    - "^([^:]+:)?fill\\b"
    - "^([^:]+:)?reload\\b"
    - "^([^:]+:)?rl\\b"
    - "^([^:]+:)?stop\\b"
    - "^([^:]+:)?restart\\b"
    - "^([^:]+:)?kick\\b"
    - "^([^:]+:)?whitelist\\b"
    - "^([^:]+:)?ban\\b"
    - "^([^:]+:)?ban-ip\\b"
    - "^([^:]+:)?pardon\\b"
    - "^([^:]+:)?pardon-ip\\b"
    - "^([^:]+:)?pex\\b"
    - "^([^:]+:)?lp\\b"
    - "^([^:]+:)?luckperms\\b"
    - "^([^:]+:)?perm\\b"
    - "^([^:]+:)?perms\\b"
    - "^([^:]+:)?permission\\b"
    - "^([^:]+:)?permissions\\b"
  # If true, blacklisted commands will also be blocked from executing.
  # If false, they will only be blocked when an admin tries to add them via the GUI.
  block-execution: true

particle-settings:
  enabled: true
  view-distance: 32
  # Particles for treasures not found by the current player
  not-found:
    enabled: true
    particle: CRIT
    count: 3
    speed: 0.01
    offset:
      x: 0.3
      y: 0.3
      z: 0.3
  # Particles for treasures already found by the current player
  found-by-player:
    enabled: true
    particle: HAPPY_VILLAGER
    count: 2
    speed: 0.03
    offset:
      x: 0.3
      y: 0.2
      z: 0.3
  # Particles for treasures found by another player in single-player-find collections
  found-by-others:
    enabled: false # Disabled by default for performance
    particle: WAX_OFF
    count: 2
    speed: 0.3
    offset:
      x: 0.3
      y: 0.2
      z: 0.3

# Shows an action bar when the placer is in range of a treasure
proximity-settings:
  enabled: true
  range: 10

leaderboard:
  # Maximum number of entries to display in the GUI leaderboard (per collection)
  display-limit: 100
  # How often to refresh the leaderboard cache in seconds (default: 300 = 5 minutes)
  cache-refresh-interval: 300

hint:
  # Enable/disable the hint feature
  enabled: true
  # Cooldown in seconds before player can request another hint
  cooldown-seconds: 300
  # Maximum distance in blocks to search for treasures
  proximity-range: 50
  # Apply cooldown if the player fails the minigame?
  apply-cooldown-on-fail: true
  # Apply cooldown to operators
  apply-cooldown-to-operators: false
  # Which coordinate to reveal: X, Z, or RANDOM (only X or Z)
  reveal-coordinate: RANDOM
  
  # Minigame settings for hints
  minigames:
    # Global setting to enable/disable minigames entirely
    enabled: true
    # Which minigame to use for hints (REACTION, MEMORY, or RANDOM)
    type: RANDOM
    
    # Settings for the Reaction minigame
    reaction:
      enabled: true
      # Number of correct clicks required to win
      required-clicks: 15
      # Time in ticks (20 ticks = 1 second) before the target moves and counts as a miss
      update-time: 20
    
    # Settings for the Memory (Simon) minigame
    memory:
      enabled: true
      # Number of rounds to complete to win
      rounds: 5
      # Time in ticks to show each color during the sequence display
      display-time: 20

# Updates the plugin automatically when a new version comes out
updater:
  # Update for AdvancedHunt plugin
  enabled: true

  # Update for dependency plugin
  dependencies:
    PacketEvents: false
    NBT-API: false
    PlaceholderAPI: false

sounds:
  enabled: true
  treasure-found:
    enabled: true
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.5
  collection-completed:
    enabled: true
    sound: UI_TOAST_CHALLENGE_COMPLETE
    volume: 1.0
    pitch: 1.0
  treasure-placed:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 2.0
  treasure-broken:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_SNARE
    volume: 0.6
    pitch: 0.8
  treasure-already-found:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_BASS
    volume: 0.7
    pitch: 0.5
  treasure-claimed-by-other:
    enabled: true
    sound: ENTITY_ENDERMAN_TELEPORT
    volume: 0.6
    pitch: 0.8
  block-protected:
    enabled: true
    sound: ENTITY_VILLAGER_NO
    volume: 0.8
    pitch: 1.0
  place-mode-break-denied:
    enabled: true
    sound: ITEM_SHIELD_BLOCK
    volume: 0.4
    pitch: 0.9
  place-mode-collect-denied:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_BASS
    volume: 1.0
    pitch: 1.0
  collection_unavailable:
    enabled: true
    sound: BLOCK_BEACON_DEACTIVATE
    volume: 1.0
    pitch: 1.0


fireworks:
  # Enable or disable all custom fireworks
  enabled: true
  # Should the firework be silent (no launch/explosion sound)
  silent: false
  power:
    # Minimum flight power (1 = low, 3 = very high)
    min: 1
    # Maximum flight power
    max: 2
  effects:
    # Enable flickering effect
    flicker: true
    # Enable trail behind the firework
    trail: true
    # Possible firework effect types (used if random-type = true)
    # Available: BALL, BALL_LARGE, STAR, BURST, CREEPER
    # Will pick a random one
    types:
      - BALL
      - BALL_LARGE
      - STAR
      - BURST
      - CREEPER

  colors:
    # Main firework colors
    # Available colors:
    # AQUA, BLACK, BLUE, FUCHSIA, GRAY, GREEN, LIME, MAROON,
    # NAVY, OLIVE, ORANGE, PURPLE, RED, SILVER, TEAL, WHITE, YELLOW
    # Will pick a random one
    list:
      - AQUA
      - BLUE
      - PURPLE
      - RED
      - ORANGE
      - YELLOW
      - LIME
      - WHITE

  fade-colors:
    # Enable fade colors after explosion
    enabled: true
    # Colors used for fading
    list:
      - WHITE
      - SILVER
      - GRAY


# Settings for data migration
# These settings are ONLY used when running '/ah migrate mysql'
# They define the TARGET database where data will be moved TO.
migration:
  target:
    host: "localhost"
    port: 3306
    database: "advancedhunt_target"
    username: "root"
    password: "password"