? NPresents Fork — Easter Edition v2.0
扩展版季节性活动插件,适用于 Minecraft 服务器。
由 n1zamu 开发的 NPresents 的分支版本 —— 包含 19 种动画、新命令、本地化支持及错误修复。
? 描述
NPresents Fork 是一款用于在服务器上组织季节性收集活动的插件。管理员会在地图各处隐藏自定义的玩家头颅(鸡蛋、南瓜、礼物——纹理可配置),玩家负责寻找它们。破坏头颅会触发奖励指令、播放炫酷动画并记录进度。收集所有头颅即可赢得最终奖品。
适用于任何节日——复活节、万圣节、新年、服务器周年庆等——只需在配置文件中更改头颅纹理和动画类型即可。
? 19 种收集动画
本分支的主要功能。每种动画都是粒子效果、音效和盔甲架移动的独特组合,在玩家收集礼物时播放。只需在配置中设置一行代码即可:
animationType: "EGG_CRACK"
| 主题 |
动画 |
| 通用 (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 |
在游戏中预览任意动画:/nPresent test BUNNY_HOP
? 5 个新命令
除了原有的 give、edit、clear、reload 之外,新增以下命令:
| 命令 |
描述 |
/nPresent setcoords <cmd> |
输入奖励指令,然后右键点击任意方块以在该处放置礼物 |
/nPresent search [radius] [minY] [maxY] |
异步搜索半径内所有已放置的礼物 |
/nPresent test [type/list/off] |
管理员测试模式——破坏礼物以预览动画,不发放奖励 |
/nPresent list |
显示所有已放置礼物的坐标 |
/nPresent basehead |
显示手持头颅的纹理并与配置文件中的进行比较 |
? 本地化
所有消息均存储在独立的语言文件中。默认包含俄语和英语。只需修改一行即可切换:
language: "en" # 或 "ru"
文件位于 plugins/NPresents/lang/ 目录下——您可以编辑它们或添加自己的语言包。
?️ 修复与改进
- 修复 SQL 注入漏洞 —— 所有查询现在均使用 PreparedStatement(原版为字符串拼接)
- 空值安全 —— 如果世界未加载或纹理缺失,插件不会崩溃
- ConcurrentHashMap 处理动画 —— 避免并发修改错误
- Marker ArmorStand —— 零碰撞箱,不会干扰玩家
- 放置反馈 —— 放置礼物时会在聊天栏显示坐标
- 管理员右键信息 —— 拥有管理员权限的玩家右键点击任意头颅即可查看其纹理和绑定的指令
- 命令别名 ——
/npresent, /np, /egg
- api-version 更新至 1.16(原为 1.13)
? 命令与权限
| 命令 |
权限节点 |
/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 权限可获得所有命令的使用权。
⚙️ 要求
- Minecraft 1.16+
- Spigot / Paper
- Java 8+
- SQLite(默认)或 YAML 数据库
? 安装方法
- 从文件区域下载
.jar 文件
- 将其放入服务器的
plugins 文件夹
- 重启服务器
- 配置
config.yml —— 选择动画类型、语言和头颅纹理
- 使用
give 或 setcoords 放置礼物
基于 NPresents by n1zamu · MIT 许可证
?? Описание на русском
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
? 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
?? Описание на русском
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧