🐣 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
.jarfrom the files section - Place it in your server's
pluginsfolder - Restart the server
- Configure
config.yml— choose animation type, language, head texture - Place presents using
giveorsetcoords
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
