AdvancedHunt

- 💬 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"

```