NPresents-Fork

# 🐣 NPresents Fork — Easter Edition v2.0 **Extended seasonal event plugin for Minecraft servers.** Fork of (https://github.com/n1zamu/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: ```yaml 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 ` | Async search for all placed presents in a radius | | `/nPresent test ` | 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: ```yaml 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 ` | `nPresent.search` | | `/nPresent test ` | `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 1. Download the `.jar` from the files section 2. Place it in your server's `plugins` folder 3. Restart the server 4. Configure `config.yml` — choose animation type, language, head texture 5. Place presents using `give` or `setcoords` --- *Based on (https://github.com/n1zamu/NPresents) by n1zamu · MIT License* --- --- # 🇷🇺 Описание на русском ## NPresents Fork — Easter Edition v2.0 Расширенный плагин для сезонных ивентов по сбору подарков. Форк (https://github.com/n1zamu/NPresents) от n1zamu. Админ прячет на карте специальные головы (подарки, яйца, тыквы — текстура настраивается), игроки ищут и ломают их, получая награды. Кто соберёт все — получит финальный приз. ### Что нового в форке **19 анимаций при сборе** (в оригинале была 1) — тематики: Хэллоуин, Новый Год, Пасха, универсальные. Каждая анимация — уникальные партиклы, звуки, движения. Настраивается одной строкой: `animationType: "EGG_CRACK"` **5 новых команд:** - `/nPresent setcoords <cmd>` — ввёл команду → ПКМ по блоку → подарок установлен - `/nPresent search ` — асинхронный поиск подарков в радиусе - `/nPresent test ` — тест анимаций без выдачи наград - `/nPresent list` — список всех подарков с координатами - `/nPresent baseh