NullPlugin

NullPlugin 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

• 🎯 Automatic spawn – random spawn near a player (configurable chance).
• 👀 Stalking – faces the player, teleports behind them, disappears and reappears elsewhere.
• 🧱 World interaction – places eerie signs (LEAVE, I SEE YOU, ...), breaks blocks, extinguishes torches.
• 🔊 Atmospheric effects – ambient sounds, footsteps, heartbeat, portal, smoke and soul particles.
• 💾 State saving – after server restart, Null returns to the same location.
• ⚙️ Flexible configuration – 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

• Required: 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

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

Особенности

• 🎯 Автоматическое появление – случайный спавн рядом с игроком (настраиваемый шанс).
• 👀 Преследование – смотрит на игрока, телепортируется за спину, исчезает и появляется в другом месте.
• 🧱 Взаимодействие с миром – ставит жуткие таблички (LEAVE, I SEE YOU, ...), разрушает блоки, гасит факелы.
• 🔊 Атмосферные эффекты – эмбиент, шаги, сердцебиение, частицы порталов, дыма и душ.
• 💾 Сохранение состояния – после перезагрузки сервера Null возвращается на то же место.
• ⚙️ Гибкие настройки – каждый параметр (дистанции, шансы, звуки, частицы) конфигурируется через 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 (для проверки прав разрушения блоков)

# ============================================================
# 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