NullPlugin

NullPlugin

Null adds a mythical entity Null – a nameless NPC that stalks players, creates a creepy atmosphere and behaves unpredictably. Perfect for horror and survival servers.

Features

- 🎯 NPC plugin support – random spawn near a player (configurable chance). - 👀 NPC plugin support – faces the player, teleports behind them, disappears and reappears elsewhere. - 🧱 NPC plugin support – places eerie signs (`LEAVE`, `I SEE YOU`, ...), breaks blocks, extinguishes torches. - 🔊 NPC plugin support – ambient sounds, footsteps, heartbeat, portal, smoke and soul particles. - 💾 NPC plugin support – after server restart, Null returns to the same location. - ⚙️ NPC plugin support – every parameter (distances, chances, sounds, particles) is configurable via `config.yml`. - 🔌 NPC plugin support (since v1.0.2) – Citizens, FancyNPCs, NPC Plugin.

Admin commands

- `/null spawn [player]` – summon Null near yourself or the specified player. - `/null remove` – remove the current Null. - `/null reload` – reload the configuration. - `/null info` – show NPC status. - `/null target <player>` – change target. - `/null debug` – debug information. - `/null stats` – statistics (spawns, signs, destructions, teleports).

Installation

1. Download `NullPlugin.jar`. 2. Place it in your server's `plugins/` folder. 3. Install one of the supported NPC plugins (Citizens, FancyNPCs or NPC Plugin). 4. Restart the server. 5. Configure `config.yml` in `plugins/NullPlugin/`.

Dependencies

- Optional: Citizens (before v1.0.1) / Citizens, FancyNPCs or NPC Plugin (since v1.0.2) - Optional: WorldGuard (for block build permission checks)

Support

- Telegram: @romixsupport_bot - Discord: https://discord.gg/PNp3S3sanv - Wiki (RU): https://romixerx.ru/null-wiki - GitHub Issues: https://github.com/rompix/NullPlugin/issues

NullPlugin

Null добавляет на сервер мистическую сущность Null – безымянного NPC, который преследует игроков, создаёт жуткую атмосферу и ведёт себя непредсказуемо. Идеально для хоррор‑ и выживани‑серверов.

Особенности

- 🎯 Поддержка NPC-плагинов – случайный спавн рядом с игроком (настраиваемый шанс). - 👀 Поддержка NPC-плагинов – смотрит на игрока, телепортируется за спину, исчезает и появляется в другом месте. - 🧱 Поддержка NPC-плагинов – ставит жуткие таблички (`LEAVE`, `I SEE YOU`, ...), разрушает блоки, гасит факелы. - 🔊 Поддержка NPC-плагинов – эмбиент, шаги, сердцебиение, частицы порталов, дыма и душ. - 💾 Поддержка NPC-плагинов – после перезагрузки сервера Null возвращается на то же место. - ⚙️ Поддержка NPC-плагинов – каждый параметр (дистанции, шансы, звуки, частицы) конфигурируется через `config.yml`. - 🔌 Поддержка NPC-плагинов (с версии 1.0.2) – Citizens, FancyNPCs, NPC Plugin.

Команды администратора

- `/null spawn [игрок]` – призвать Null рядом с собой или указанным игроком. - `/null remove` – удалить текущего Null. - `/null reload` – перезагрузить конфигурацию. - `/null info` – показать статус NPC. - `/null target <игрок>` – сменить цель. - `/null debug` – отладочная информация. - `/null stats` – статистика (появления, таблички, разрушения, телепорты).

Установка

1. Скачайте `NullPlugin.jar`. 2. Поместите в папку `plugins/` сервера. 3. Установите один из поддерживаемых NPC-плагинов (Citizens, FancyNPCs или NPC Plugin). 4. Перезапустите сервер. 5. Настройте `config.yml` в `plugins/NullPlugin/`.

Зависимости

- Опционально: Citizens (до v1.0.1) / Citizens, FancyNPCs или NPC Plugin (начиная с v1.0.2) - Опционально: WorldGuard (для проверки прав разрушения блоков)

``` yaml

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

NullPlugin Configuration File

Version: 1.0.2

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

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

language: ru

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

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-teleport-attempts: 20

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

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

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 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"

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 effects (darkness)

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

scare:

Enable darkness and fear effects?

enabled: true

Duration of darkness effect when Null disappears (ticks)

darkness-duration: 100

```