NullPlugin

RU

- Исправлены баги. - Улучшена производительность и потокобезопастность. - Добавлена поддержка Folia. - Добавлена поддержка версий 26.x - Добавлена поддержка BStats.

EN

- Fixed bugs. - Improved performance and thread safety. - Added support for Folia. - Added support for version 26.x - Added support for BStats. --- Нашёл баг или хочешь предложить идею? Пиши в Issue: https://github.com/Rompix666/NullPlugin/issues --- Have you found a bug or have an idea? Write in Issue: https://github.com/Rompix666/NullPlugin/issues --- BStats статистика: https://bstats.org/plugin/bukkit/NullPlugin/32149 --- BStats statistic: https://bstats.org/plugin/bukkit/NullPlugin/32149

RU

<details> <summary>CHANGELOG</summary> - Добавлена окончательная поддержка плагинов на NPC - Улучшены скримеры/резкие появления. - Добавлены уведомления о новых обновлениях.

Добавлены новые строки в конфиг и ru/en.yml файлы. Сохраните свои настройки NullPlugin и замените файлы на эти, после чего копируйте свои настройки в обновлённые файлы:

config.yml

``` yml

============================================================

NullPlugin Configuration File

Version: 1.0.3

============================================================

Language for messages: ru (Russian) or en (English)

language: en

------------------------------------------------------------

UPDATE CHECKER

------------------------------------------------------------

update-checker: # Enable checking for updates on Modrinth enabled: true

============================================================

NULL SETTINGS

============================================================

null: # Enable/disable the Null myth completely enabled: true # Chance (0.0 - 1.0) for Null to spawn randomly: # - on player join (with join-spawn-delay) # - every 6 seconds in a periodic task spawn-chance: 0.01 # Delay after player join before possible Null spawn (ticks, 20 ticks = 1 sec) join-spawn-delay: 200 # Minimum and maximum distance (blocks) from player where Null can spawn spawn-min-distance: 5 spawn-distance: 25 # Maximum number of Null instances allowed at once (usually 1) max-instances: 1 # How long Null lives after spawn (seconds). Set to 0 for infinite lifetime lifetime-seconds: 60 # NPC ID assigned automatically – DO NOT MANUALLY EDIT npc-id: -1 # Should WorldGuard be used to check block break/place permissions? use-worldguard: true # ------------------------------------------------------------ # Null behavior settings # ------------------------------------------------------------ behavior: # Should Null follow the target player? follow-player: true # Should Null teleport randomly from time to time? teleport-randomly: true # Can Null destroy blocks around itself? destroy-blocks: true # Can Null place creepy signs? place-signs: true # Should Null face the player? look-at-player: true # Delay between teleports (seconds) teleport-cooldown: 10 # Delay between placing signs / destroying blocks (seconds) action-cooldown: 15 # Distance at which Null teleports closer to player follow-range-teleport: 50 # Distance at which Null may disappear and reappear elsewhere invisible-distance: 5 # Duration of invisibility after disappearing (ticks, 20 ticks = 1 sec) invisible-duration: 60 # Number of attempts to find a valid location for spawn/teleport max-location-attempts: 10 # Probability of teleport (0.0 - 1.0) teleport-chance: 0.3 # Probability to teleport behind the player instead of nearby teleport-behind-chance: 0.05 # Probability of glancing effect (appear in peripheral vision) glance-chance: 0.02 # Probability to extinguish nearby torches extinguish-torch-chance: 0.1 # Probability to become invisible when close to player invisible-chance: 0.3 # Probability to place a creepy sign sign-chance: 0.2 # Probability to destroy a random block destroy-chance: 0.15 # Probability to play an ambient (scary) sound ambient-sound-chance: 0.1 # Delay after which a placed sign is removed (ticks) sign-remove-delay: 1200 # Delay after which an extinguished torch is restored (ticks) torch-restore-delay: 80 # Duration of glancing effect (ticks) glance-duration: 6 # Radius for block destruction (blocks in each direction) destroy-radius: 3 # How many blocks to destroy per action destroy-iterations: 3 # Radius to search for torches to extinguish (blocks) torch-radius: 6 # Distance for enhanced fear effects (darkness, blindness, nausea) near-effect-distance: 5.0 # Minimum and maximum distances for "near" vanish/respawn near-min: 15 near-max: 30 # Minimum and maximum distances for random teleport teleport-min: 20 teleport-max: 40 # Minimum and maximum distances for sign placement sign-min: 5 sign-max: 15 # ------------------------------------------------------------ # Null appearance # ------------------------------------------------------------ appearance: # Skin name for the Null NPC (must exist on the server) skin-name: "Nulleclipse" # Should Null sometimes become invisible when player approaches? invisible-sometimes: true # Should particles appear when Null spawns? spawn-particles: true # Should particles appear when Null teleports? teleport-particles: true # Should particles appear when Null despawns? despawn-particles: true # Show Null's nameplate? (default: true) show-nameplate: true # ------------------------------------------------------------ # Signs that Null can place # ------------------------------------------------------------ signs: messages: - "null" - "LEAVE" - "I SEE YOU" - "RUN" # ------------------------------------------------------------ # Null sound effects # ------------------------------------------------------------ sounds: # Enable all Null sounds? enabled: true # Enable ambient (background) sounds? ambient-sounds: true # Sound when Null teleports teleport-sound: "ENTITY_ENDERMAN_TELEPORT" # Sound when Null disappears despawn-sound: "ENTITY_ILLUSIONER_MIRROR_MOVE" # Sound when Null appears spawn-sound: "ENTITY_ENDERMAN_AMBIENT" # Sound when Null destroys a block destroy-sound: "ENTITY_GENERIC_EXPLODE" # Sound when Null places a sign place-sign-sound: "BLOCK_WOOD_PLACE" # Sound when a placed sign is removed sign-break-sound: "BLOCK_WOOD_BREAK" # Sound when Null extinguishes a torch extinguish-sound: "BLOCK_FIRE_EXTINGUISH" # Sound for the quick glance effect glance-teleport-sound: "ENTITY_ENDERMAN_TELEPORT" # Additional sound for the glance effect glance-illusioner-sound: "ENTITY_ILLUSIONER_AMBIENT" # Sound of heartbeat when player is too close heartbeat-sound: "ENTITY_WARDEN_HEARTBEAT" # List of scary sounds for ambient effect ambient-scary: - "AMBIENT_CAVE" - "ENTITY_ENDERMAN_STARE" - "ENTITY_GHAST_AMBIENT" - "BLOCK_PORTAL_AMBIENT" - "ENTITY_WITHER_AMBIENT" - "ENTITY_ILLUSIONER_AMBIENT" - "ENTITY_VEX_AMBIENT" - "ENTITY_PLAYER_BREATH" - "BLOCK_SCULK_SHRIEKER_SHRIEK" # List of footstep sounds for ambient effect ambient-step: - "BLOCK_STONE_STEP" - "BLOCK_SAND_STEP" - "BLOCK_GRAVEL_STEP" - "ENTITY_PLAYER_ATTACK_SWEEP" # ------------------------------------------------------------ # Null particle effects # ------------------------------------------------------------ particles: # Particle type on spawn (see Bukkit Particle enum) spawn: "PORTAL" # Particle type on teleport teleport: "PORTAL" # Particle type on despawn despawn: "LARGE_SMOKE" # Particle for the glance effect glance-portal: "PORTAL" # Another particle for the glance effect glance-soul-flame: "SOUL_FIRE_FLAME" # Number of particles to spawn at once count: 20 # Particle speed / spread speed: 0.1 # Offset for spawn particles (X, Y, Z) spawn-offset-x: 0.5 spawn-offset-y: 1.0 spawn-offset-z: 0.5 # ------------------------------------------------------------ # Fear & mystical effects # ------------------------------------------------------------ effects: # Standard nearby effects when player is too close darkness-duration: 100 # Duration of Darkness effect (ticks) blindness-duration: 60

NullPlugin 1.0.2 – что нового?

Поддержка сторонних NPC-плагинов

Null больше не привязан только к Citizens! Теперь плагин работает с: - FancyNPCs (требуется клиентский мод fancynpcs) - NPC Plugin (npccore) При запуске Null автоматически определяет, какой NPC-плагин установлен, и использует его. Вы можете легко переключаться между плагинами без изменения конфигурации.

Автоматическое исчезновение

Добавлен параметр lifetime-seconds в config.yml. Null исчезает с эффектами (тьма, звук, частицы) через указанное время. Это позволяет избежать вечного пребывания NPC на сервере.

Улучшенная система скинов

Скины загружаются стабильнее и не сбрасываются при перезагрузке плагина через /null reload. Скин указывается как обычно: skin-name: "Nulleclipse".

Оптимизация и исправления

- Исправлены проблемы с потоками (рандом, сохранение состояния). - Удалены устаревшие зависимости. - Повышена производительность поиска мест для телепортации. - Полная совместимость с Paper 1.21+ (включая будущие версии до 1.30).

Что изменилось для администраторов?

- Команды остались без изменений. - Файл config.yml теперь содержит новую опцию null.lifetime-seconds (по умолчанию 60). При желании можно установить 0, чтобы отключить автоматическое исчезновение. - При использовании FancyNPCs или NPC Plugin убедитесь, что они установлены и правильно работают.

Миграция с версии 1.0.1

Если вы обновляетесь с версии 1.0.1, просто замените NullPlugin.jar и перезагрузите сервер. Конфигурация останется совместимой. Рекомендуется добавить lifetime-seconds в null: раздел конфига. ---

NullPlugin 1.0.2 – What's New?

Third‑party NPC plugin support

Null is no longer tied only to Citizens! The plugin now works with: - FancyNPCs (requires client‑side mod fancynpcs) - NPC Plugin (npccore) On startup, Null automatically detects which NPC plugin is installed and uses it. You can easily switch between plugins without changing the configuration.

Automatic disappearance

Added lifetime-seconds to config.yml. Null vanishes with effects (darkness, sound, particles) after the specified time. This prevents the NPC from staying on the server forever.

Improved skin system

Skins load more reliably and no longer reset when reloading the plugin via /null reload. Skin is specified as usual: skin-name: "Nulleclipse".

Optimizations and fixes

- Fixed threading issues (randomness, state saving). - Removed outdated dependencies. - Improved performance of teleport location selection. - Full compatibility with Paper 1.21+ (including future versions up to 1.30).

What changed for admins?

- Commands remain unchanged. - config.yml now includes a new option: null.lifetime-seconds (default 60). You can set it to 0 to disable automatic disappearance. - When using FancyNPCs or NPC Plugin, make sure they are installed and working properly.

Migrating from version 1.0.1

If you are upgrading from 1.0.1, simply replace NullPlugin.jar and restart the server. The configuration remains compatible. It is recommended to add lifetime-seconds to the null: section of the config. ---

Null Plugin 1.0.1 — Атмосфера становится ещё глубже!

---

Русский

Что нового в версии 1.0.1?

#### Скримеры и эффекты неожиданности Ваш сервер обрёл настоящий ужас! Теперь Null может появляться внезапно, заставляя игроков вздрагивать: - Пещерный ужас — если игрок задержится в пещере дольше положенного (настраивается), Null возникнет прямо за спиной с жутким сообщением `&4behind you`. - Кошмары от бессонницы — когда игрок не спит три дня подряд, реальность искажается: Null является с таинственным текстом `&4&kfsaasd`. - Каждое такое появление сопровождается леденящим душу звуком (по умолчанию ENTITY_GHAST_SCREAM). Все параметры гибко регулируются в конфиге (раздел scare). #### Полная локализация Все сообщения плагина теперь вынесены в отдельные языковые файлы. Вы можете легко сменить язык или отредактировать любой текст прямо в папке lang/, без перезагрузки сервера. Поддерживаются как классические &-коды цвета, так и современный формат MiniMessage для тонкой настройки. В комплекте уже идёт ru.yml — вы всегда можете создать свой перевод, просто скопировав файл и изменив значение language в config.yml. #### Умные подсказки в командах Теперь при вводе команд работают TabCompleter: - /null target покажет список онлайн-игроков. - /null behavior подскажет доступные действия (follow, teleport, destroy, place, look). - Для переключения предложит варианты on / off. Управлять Null стало удобнее и быстрее! #### Скины без головной боли Мы переработали механизм применения скинов. Больше не нужно вручную вводить /npc select и /npc skin после каждой перезагрузки — плагин сам сохраняет скин и применяет его при старте. Просто укажите имя скина в конфиге (skin-name), и Null всегда будет выглядеть именно так, как вы задумали. #### Эффектный запуск При включении плагина в консоли теперь отображается красный ASCII-арт с логотипом NULL — стильное начало работы вашего цифрового призрака. #### Исправления и улучшения - Исправлена проблема с сохранением ID NPC (скин больше не сбрасывается). - Оптимизирован поиск места для спавна — добавлена настройка spawn-min-distance. - Устранены предупреждения при компиляции. - Множество мелких доработок для стабильности и производительности. ---

English

What's New in Version 1.0.1?

#### Jump Scares & Unexpected Effects Your server gets a real horror twist! Now Null can appear suddenly, making players jump: - Cave Horror — if a player stays in a cave longer than configured, Null will spawn right behind them with the chilling message `&4behind you`. - Insomnia Nightmares — when a player hasn't slept for three days, reality distorts: Null appears with a mysterious `&4&kfsaasd` text. - Each appearance is accompanied by a spine-chilling sound (default ENTITY_GHAST_SCREAM). All parameters are fully adjustable in the config (scare section). #### Full Localization All plugin messages are now stored in separate language files. You can easily switch languages or edit any text directly in the lang/ folder without restarting the server. Both classic & color codes and modern MiniMessage format are supported. The package includes ru.yml – you can create your own translation by copying the file and changing the language value in config.yml. #### Smart Tab Completion Commands now feature TabCompleter: - /null target suggests online players. - /null behavior offers available behaviors (follow, teleport, destroy, place, look). - Toggling suggests on / off. Managing Null has never been easier! #### Hassle‑Free Skins We've reworked the skin application mechanism. No more manually typing /npc select and /npc skin after every restart — the plugin now saves the skin and applies it automatically on startup. Just set the skin name in config.yml (skin-name), and Null will always look exactly as you intended. #### Stylish Startup When the plugin enables, a red ASCII‑art logo of NULL appears in the console – a stylish entrance for your digital ghost. #### Fixes & Improvements - Fixed NPC ID persistence (skin no longer resets). - Improved spawn location search – added spawn-min-distance option. - Removed compilation warnings. - Many minor tweaks for stability and performance. ---

Installation

1. Download the latest NullPlugin.jar from [Modrinth](https://modrinth.com/plugin/nullplugin) or [GitHub Releases](https://github.com/rompix/NullPlugin/releases). 2. Place it in your server's plugins/ folder. 3. Ensure you have Citizens installed (required) and optionally WorldGuard. 4. Restart your server (or use /reload confirm). 5. Configure the plugin in plugins/NullPlugin/config.yml and language files in plugins/NullPlugin/lang/. ---

Statistics

| Statistic | Value | |:---------:|:-----:| | Supported versions | Paper 1.21 – 1.21.11 | | Dependencies | Citizens (required), WorldGuard (optional) | | Languages | English & Russian (customizable) | | Max concurrent Nulls | Configurable (default 1) | ---

Support

- Telegram Bot: [@romixsupport_bot](https://t.me/romixsupport_bot) - Discord: [Join our community](https://discord.com/invite/PNp3S3sanv) - Wiki: [romixerx.ru/null-wiki](https://romixerx.ru/null-wiki) - GitHub Issues: [Report a bug](https://github.com/rompix/NullPlugin/issues) ---

Show Your Support

If you enjoy this plugin, please consider: - Starring the [GitHub repository](https://github.com/rompix/NullPlugin) - Sharing with friends - Creating videos about the plugin - Joining our Discord community --- <div align="center"> Made with ❤️ by Rompix [ Back to top](#) </div>

ru - Подробности в описании. eu - The details are in the description.