:【Kix's Gift Hunt】: Configurable hidden block search for events! icon

:【Kix's Gift Hunt】: Configurable hidden block search for events! -----

Hide collectable gifts with any block for a hunt event! Perfect for holiday presents & any occasion!



Kix's Gift Hunt
A lightweight plugin to allow you to effortlessly create exciting per-player gift hunt events! Simply toggle on the gift placer and any placed blocks turn into collectable gifts. Reward players as they make progress and collect them all! Use any block or custom textured heads to match your theme, whether it's presents for the holidays, eggs for Easter, treasures, and more.

Click to play the gif
[​IMG]

Hello, world!
This plugin originally was developed for private use in 2021 for MC 1.17. I am choosing to make it public now and open source it soon after I refine and improve the original project. This first 1.1.0 release starts this process by adding numerous configuration options that were previously hard-coded to allow for easy customization. The Spigot API version has also been updated to 1.21.1.


Features
  • Customizable; change particles, messages, rewards, and other aspects of the plugin via the config.

  • Bossbar display; shows each player their collection progress in enabled worlds.

  • Smooth setup; simply enable the gift editor and place or remove your desired gifts anywhere to make the hunt.

  • Realtime updates; you can add or remove gifts from the hunt anytime. Player data will clean itself & displays will update accordingly.

  • Easy in-game control; reset players progress, list gifts and teleport to them, and more all in-game.


Commands & Permissions
All commands require the gifthunt.admin permission to use
  • /gifthunt editor
    Highlights all gifts with particle beams and toggles gift placing/removing

  • /gifthunt reload
    Reloads the plugin and files

  • /gifthunt resetplayer <player>
    Reset a target players progress. Must be online.

  • /gifthunt list
    List all placed gifts. You can click each entry in chat to teleport to that gift.

  • /gifthunt cheat [player]
    Toggle gift highlighting with particle beams.
Config
Code (YAML):
# . . . . . . .

# Kix's Gift Hunt
# . . . . . . .
# Placeholders:
# {player}
# {firework-atgift-instant}
# {firework-atgift-regular}
# {firework-atplayer-instant}
# {firework-atplayer-regular}
# Bossbar colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW

unopened-gift-particle
: HAPPY_VILLAGER
get-commands
:
 - ' {firework-atgift-instant }'
  - minecraft:xp add {player } 5
found-all-commands
:
 - minecraft:execute positioned as {player } run playsound minecraft:ui.toast.challenge_complete
    ambient {player } ~ ~ ~ 2 1
get-messages
:
 - '&f'
  - '&b&lGIFT FOUND!&fヾ (≧▽≦* )'
  - '&7There (are|is ) &f&l {REMAINING_GIFTS } &7gift (s ) left to find'
  - '&f'
found-all-messages
:
 - '&f'
  - '&d&lGIFT HUNT &d&lCOMPLETED!'
  - '&f'
  - '&fNice work, you found all the gifts! :D'
  - '&f'
found-all-broadcast
:
 - '&7'
  - '&8 [&a☆&8 ] &7 {PLAYER } &bcompleted the gift hunt!'
  - '&7'
already-found
: '&8 [&a☆&8 ] &7You already found that gift ^-~'
cannot-break
: '&8 [&a☆&8 ] &7You can''t break the gifts! D:'
notify-admins
: true
player-found-admin-message
: '&8 [&a☆&8 ] &7 {player } &7found a gift (&f {FOUND }&8/&f {TOTAL }&7 )'
bossbar-enabled-worlds
:
 - world
bossbar-format
: '&c&lGIFT &b&lHUNT &8&l| &e&l {FOUND } &8&l/ &e&l {TOTAL } &fgifts found'
bossbar-color
: GREEN
 

Support

If you have any questions, suggestions, or just want to say hi you can join my Discord server here: https://discord.com/invite/HKnDTRj
Resource Information
Author:
----------
Total Downloads: 148
First Release: Dec 24, 2024
Last Update: Dec 24, 2024
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings