NPresents-Fork

🐣 NPresents Fork — Easter Edition v2.0

Extended seasonal event plugin for Minecraft servers. Fork of Extended seasonal event plugin for Minecraft servers. 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 [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:

```yaml language: "en" # or "ru" ```

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

---

🛡️ Fixes & Improvements

- api-version — all queries now use PreparedStatement (original concatenated strings) - api-version — plugin won't crash if world is unloaded or texture is missing - api-version for animations — no concurrent modification errors - api-version — zero hitbox, doesn't interfere with players - api-version — coordinates shown in chat when a present is placed - api-version — right-click any head with admin permission to see its texture & bound command - api-version — `/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

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 NPresents by n1zamu · MIT License*

---

---

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

NPresents Fork — Easter Edition v2.0

Расширенный плагин для сезонных ивентов по сбору подарков. Форк NPresents от n1zamu.

Админ прячет на карте специальные головы (подарки, яйца, тыквы — текстура настраивается), игроки ищут и ломают их, получая награды. Кто соберёт все — получит финальный приз.

Что нового в форке

19 анимаций при сборе (в оригинале была 1) — тематики: Хэллоуин, Новый Год, Пасха, универсальные. Каждая анимация — уникальные партиклы, звуки, движения. Настраивается одной строкой: `animationType: "EGG_CRACK"`

5 новых команд: - `/nPresent setcoords <cmd>` — ввёл команду → ПКМ по блоку → подарок установлен - `/nPresent search [радиус] [minY] [maxY]` — асинхронный поиск подарков в радиусе - `/nPresent test [тип/list/off]` — тест анимаций без выдачи наград - `/nPresent list` — список всех подарков с координатами - `/nPresent basehead` — текстура головы в руке + сравнение с конфигом

Локализация — русский и английский в комплекте. Переключение: `language: "ru"`

Исправления: - SQL-инъекция исправлена (PreparedStatement вместо конкатенации строк) - Null-safety, ConcurrentHashMap для анимаций - Marker ArmorStand (нулевой хитбокс) - Админ-инфо по ПКМ, уведомления при установке - Алиасы: `/npresent`, `/np`, `/egg`

Типы анимаций

| Тема | Анимации | |------|----------| | Универсальные (4) | `RISE_AND_EXPLODE`, `SPIRAL_UP`, `FIREWORK_BURST`, `BOUNCE_FADE` | | Хэллоуин (5) | `GHOST_FLOAT`, `SOUL_DRAIN`, `BAT_SWARM`, `WITCH_CAULDRON`, `PUMPKIN_SMASH` | | Новый Год (5) | `CONFETTI_POP`, `SNOWFLAKE_RISE`, `CHAMPAGNE_BURST`, `CLOCK_COUNTDOWN`, `STAR_TRAIL` | | Пасха (5) | `EGG_CRACK`, `RAINBOW_ARC`, `BUNNY_HOP`, `FLOWER_BLOOM`, `SPRING_BREEZE` |

Совместимость

- Minecraft 1.16+ - Spigot / Paper - Java 8+ - SQLite или YAML

---

*Основано на NPresents от n1zamu · Лицензия MIT*