PlayerPresents

✅ Added particle and sound effects for gift creation and opening with customizable settings.

✅ Implemented separate configuration for creation and opening effects via create-particle-count and open-particle-count.

✅ Fixed bug preventing gifts from being placed into containers (chests, barrels, shulker boxes, etc.).

✅ Gifts can now be stored in containers without restrictions.

✅ Fixed asynchronous gift creation process for more stable and optimized custom name and custom lore functionality.

✅ Prevented players from accidentally clicking existing gifts when selecting gift names and lore.

✅ Config auto-updates on plugin startup with missing keys and values.

---

Effects Configuration Example

# =====================================
# EFFECTS SETTINGS - SOUNDS AND PARTICLES
# =====================================
# Configure sound and particle effects for gift creation and opening
# All players will experience these unified effects for all gifts

effects:
  # Sound played when a gift is created
  # List of available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  # Examples: ENTITY_PLAYER_LEVELUP, BLOCK_NOTE_BLOCK_XYLOPHONE, ENTITY_FIREWORK_ROCKET, BLOCK_AMETHYST_BLOCK_CHIME
  # Set to "NONE" to disable sound
  create-sound: "ENTITY_PLAYER_LEVELUP"

  # Sound played when a gift is opened
  # Examples: ENTITY_ITEM_PICKUP, BLOCK_CHEST_OPEN, UI_TOAST_CHALLENGE_COMPLETE, ENTITY_FIREWORK_LAUNCH
  # Set to "NONE" to disable sound
  open-sound: "BLOCK_CHEST_OPEN"

  # Particle effect displayed when a gift is created
  # List of available particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
  # Examples: FIREWORKS, HAPPY_VILLAGER, EXPLOSION_NORMAL, SPELL_WITCH, CLOUD, DRAGON_BREATH, TOTEM
  # Set to "NONE" to disable particles
  create-particle: "HAPPY_VILLAGER"

  # Particle effect displayed when a gift is opened
  # Examples: FIREWORK, CRIT, EXPLOSION_LARGE, SPELL_INSTANT, CLOUD, TOTEM
  # Set to "NONE" to disable particles
  open-particle: "FIREWORK"

  # Number of particles to spawn for creation effect
  # Recommended: 10-30
  create-particle-count: 25

  # Number of particles to spawn for opening effect
  # Recommended: 20-50
  open-particle-count: 25