🐣 NPresents Fork — Easter Edition v2.0

Extended seasonal event plugin for Minecraft servers.
Fork of NPresents by n1zamu — with 19 animations, new commands, localization and bug fixes.

📝 Description

NPresents Fork is a plugin for organizing seasonal collection events on your server. Admins hide custom player heads (eggs, pumpkins, presents — texture is configurable) around the map, and players search for them. Breaking a head triggers a reward command, a fancy animation, and tracks progress. Collect all of them to earn a final prize.

Works for any holiday — Easter, Halloween, New Year, server anniversary — just change the head texture and animation type in the config.

🎬 19 Collection Animations

The main feature of this fork. Each animation is a unique combination of particles, sounds, and ArmorStand movement that plays when a player collects a present. Set it with one line in config:

animationType: "EGG_CRACK"

Theme	Animations
Universal (4)	`RISE_AND_EXPLODE` · `SPIRAL_UP` · `FIREWORK_BURST` · `BOUNCE_FADE`
Halloween (5)	`GHOST_FLOAT` · `SOUL_DRAIN` · `BAT_SWARM` · `WITCH_CAULDRON` · `PUMPKIN_SMASH`
New Year (5)	`CONFETTI_POP` · `SNOWFLAKE_RISE` · `CHAMPAGNE_BURST` · `CLOCK_COUNTDOWN` · `STAR_TRAIL`
Easter (5)	`EGG_CRACK` · `RAINBOW_ARC` · `BUNNY_HOP` · `FLOWER_BLOOM` · `SPRING_BREEZE`

Preview any animation in-game: /nPresent test BUNNY_HOP

🆕 5 New Commands

In addition to the original give, edit, clear, reload:

Command	Description
`/nPresent setcoords <cmd>`	Enter a reward command, then right-click any block to place a present there
`/nPresent search [radius] [minY] [maxY]`	Async search for all placed presents in a radius
`/nPresent test [type/list/off]`	Admin test mode — break presents to preview animations, no rewards given
`/nPresent list`	Show all placed presents with coordinates
`/nPresent basehead`	Display the texture of the held skull and compare it with config

🌍 Localization

All messages are stored in separate language files. Russian and English included out of the box. Switch with one line:

language: "en"  # or "ru"

Files are in plugins/NPresents/lang/ — edit them or add your own language.

🛡️ Fixes & Improvements

SQL injection fixed — all queries now use PreparedStatement (original concatenated strings)
Null-safety — plugin won't crash if world is unloaded or texture is missing
ConcurrentHashMap for animations — no concurrent modification errors
Marker ArmorStand — zero hitbox, doesn't interfere with players
Placement feedback — coordinates shown in chat when a present is placed
Admin RMB info — right-click any head with admin permission to see its texture & bound command
Command aliases — /npresent, /np, /egg
api-version updated to 1.16 (was 1.13)

📋 Commands & Permissions

Command	Permission
`/nPresent give <player> <command>`	`nPresent.give`
`/nPresent setcoords <command>`	`nPresent.give`
`/nPresent edit`	`nPresent.edit`
`/nPresent clear`	`nPresent.clear`
`/nPresent reload`	`nPresent.reload`
`/nPresent search [r] [minY] [maxY]`	`nPresent.search`
`/nPresent test [type/list/off]`	`nPresent.test`
`/nPresent list`	`nPresent.list`
`/nPresent basehead`	`nPresent.basehead`

nPresent.admin grants access to all commands.

⚙️ Requirements

Minecraft 1.16+
Spigot / Paper
Java 8+
SQLite (default) or YAML database

📦 Installation

Download the .jar from the files section
Place it in your server's plugins folder
Restart the server
Configure config.yml — choose animation type, language, head texture
Place presents using give or setcoords

Based on NPresents by n1zamu · MIT License

🇷🇺 Описание на русском