π£ 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
No gallery available for this project.