NullPlugin

插件

· 作者 Rompix

Null 为你的服务器添加了来自 creepypasta 的神秘实体。

0 本站下载 0 关注 更新于 1 个月前

最新 1.1.1-release · 26.3 · Bukkit / Folia

一键开服(送7天)

NullPlugin

Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null Null

统计信息

NullPlugin 添加了一个神秘实体 Null —— 一个无名的 NPC,它会跟踪玩家,营造恐怖氛围并表现出不可预测的行为。非常适合恐怖和生存服务器。

功能

  • 自动生成 – 在玩家附近随机生成(可配置概率)。
  • 跟踪 – 面向玩家,传送到其身后,消失并在其他地方重新出现。
  • 世界交互 – 放置诡异的告示牌(LEAVE、I SEE YOU 等),破坏方块,熄灭火把。
  • 氛围效果 – 环境音效、脚步声、心跳声、传送门、烟雾和灵魂粒子。
  • 状态保存 – 服务器重启后,Null 会回到原来的位置。
  • 自定义 NPC 皮肤(Mineskin) – 将 PNG 文件放入 plugins/NullPlugin/skins/ 目录,插件会在服务器启动时通过 Mineskin API 自动生成签名的皮肤。结果会缓存到磁盘,因此后续启动无需联网。
  • 灵活配置 – 所有参数(距离、概率、声音、粒子)均可通过 config.yml 进行配置。
  • NPC 插件支持(自 v1.0.2 起)– Citizens、FancyNPCs、NPC Plugin。

管理员命令

  • /null spawn [player] – 在你自己或指定玩家附近召唤 Null。
  • /null remove – 移除当前的 Null。
  • /null reload – 重新加载配置。
  • /null info – 显示 NPC 状态。
  • /null target <player> – 更改目标。
  • /null debug – 调试信息。
  • /null stats – 统计信息(生成次数、告示牌数量、破坏数、传送次数)。

安装

  1. 下载 NullPlugin.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 安装其中一个支持的 NPC 插件(Citizens、FancyNPCs 或 NPC Plugin)。
  4. 重启服务器。
  5. 在 plugins/NullPlugin/ 中配置 config.yml。
  6. (可选)通过 Mineskin 设置自定义 NPC 皮肤——见下文“自定义皮肤”部分。

自定义皮肤(Mineskin)

NullPlugin 可以根据你提供的 PNG 文件为 Null NPC 生成已签名的 Minecraft 皮肤。这是通过 Mineskin API 完成的。

设置(5 分钟)

  1. 获取 Mineskin API 密钥(可选但推荐):

    • 没有密钥插件仍可工作,但 Mineskin 会施加严格的速率限制并降低请求速度。
    • 免费密钥:
    • 复制密钥 —— 格式类似于 msk_XXXXXXXXXXXXXX。
  2. 将密钥粘贴到 plugins/NullPlugin/config.yml 中:

    mineskin:
      api-key: "msk_XXXXXXXXXXXXXX"
    
  3. 将你的皮肤放入 plugins/NullPlugin/skins/nulleclipse.png。

    • 文件必须是 PNG 格式,大小为 64×64,格式需符合标准 Minecraft 皮肤规范。
    • 文件名(不含扩展名)必须与 null.appearance.skin-name 匹配(默认值:Nulleclipse)。
  4. 重启服务器。 控制台将显示:

    [SkinLoader] Нужно сгенерировать 1 текстур через Mineskin API
    [SkinLoader] Текстура сгенерирована и сохранена для 'nulleclipse'.
    

    下次启动时:

    [SkinLoader] Загружено 1 текстур из skin-cache.yml
    
  5. 完成 —— Null 将在首次生成时使用你的皮肤。

稍后更改皮肤

  1. 替换 plugins/NullPlugin/skins/ 中的 PNG 文件。
  2. 删除 plugins/NullPlugin/skin-cache.yml。
  3. 重启服务器 —— 插件将重新生成纹理。

文件存储位置

路径 用途
plugins/NullPlugin/skins/*.png 皮肤源文件(PNG,64×64)
plugins/NullPlugin/skin-cache.yml 从 Mineskin 生成的 value + signature
plugins/NullPlugin/config.yml → mineskin.api-key Mineskin API 密钥

NullPlugin

NullPlugin 向服务器添加了神秘实体 Null —— 一个无名的 NPC,它会追踪玩家,营造恐怖氛围并行为不定。完美适用于恐怖和生存服务器。

特性

  • 自动出现 – 在玩家附近随机生成(可配置的概率)。
  • 追逐行为 – 注视玩家,传送至玩家背后,消失并在另一处重新出现。
  • 与世界交互 – 放置恐怖告示牌(LEAVE、I SEE YOU 等),破坏方块,熄灭火把。
  • 氛围效果 – 环境音、脚步声、心跳声、传送门粒子、烟雾和灵魂沙粒子。
  • 状态保存 – Null 在服务器重启后会回到原来的位置。
  • 通过 Mineskin 使用自定义皮肤 – 将 PNG 文件放入 plugins/NullPlugin/skins/,插件会在服务器启动时通过 Mineskin API 自动生成签名皮肤。结果会缓存到磁盘——后续启动无需联网。
  • 灵活配置 – 每个参数(距离、概率、声音、粒子)均可通过 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. 在 plugins/NullPlugin/ 中配置 config.yml。
  6. (可选)通过 Mineskin 为 NPC 设置自定义皮肤——见下文“自定义皮肤”部分。

自定义皮肤 (Mineskin)

NullPlugin 能够根据您放入的 PNG 文件为 NPC Null 生成签名皮肤。这是通过 Mineskin 服务 API 实现的。

配置(5分钟)

  1. 获取 Mineskin API 密钥(非必需,但推荐):

    • 没有密钥插件也能工作,但 Mineskin 会施加严格的速率限制,且请求速度较慢。
    • 免费密钥:
    • 密钥格式大致如下:msk_XXXXXXXXXXXXXX。
  2. 将密钥插入 plugins/NullPlugin/config.yml:

    mineskin:
      api-key: "msk_XXXXXXXXXXXXXX"
    
  3. 将皮肤文件放入 plugins/NullPlugin/skins/nulleclipse.png。

    • 文件格式必须为 PNG,尺寸为 64×64,符合 Minecraft 标准皮肤规格。
    • 文件名(不含扩展名)必须与 null.appearance.skin-name 匹配(默认为 Nulleclipse)。
  4. 重启服务器。 控制台将显示:

    [SkinLoader] Нужно сгенерировать 1 текстур через Mineskin API
    [SkinLoader] Текстура сгенерирована и сохранена для 'nulleclipse'.
    

    下次启动时:

    [SkinLoader] Загружено 1 текстур из skin-cache.yml
    
  5. 完成——从第一次生成开始,Null 就会使用您的自定义皮肤。

如何稍后更换皮肤

  1. 替换 plugins/NullPlugin/skins/ 中的 PNG 文件。
  2. 删除 plugins/NullPlugin/skin-cache.yml。
  3. 重启服务器——插件将重新生成纹理。

文件存储位置说明

路径 用途
plugins/NullPlugin/skins/*.png 原始皮肤文件(PNG,64×64)
plugins/NullPlugin/skin-cache.yml 由 Mineskin 生成的 value 和 signature
plugins/NullPlugin/config.yml → mineskin.api-key Mineskin API 密钥

依赖项

  • 必需: Citizens(最高至 v1.0.1)/ Citizens、FancyNPCs 或 NPC Plugin(自 v1.0.2 起)
  • 可选: WorldGuard(用于检查方块破坏权限)

? config.yml

# ============================================================
# NullPlugin Configuration File
# Версия / Version: 1.1.0
# ============================================================

# Language for messages: ru (Russian) or en (English)
# Язык сообщений: ru (русский) или en (английский)
language: ru

# ------------------------------------------------------------
# UPDATE CHECKER / ПРОВЕРКА ОБНОВЛЕНИЙ
# ------------------------------------------------------------
update-checker:
  # Enable checking for updates on Modrinth
  # Включить проверку обновлений на Modrinth
  enabled: true

# ============================================================
# MINESKIN API — 为 NPC 生成皮肤
# MINESKIN API — generating skins for NPCs
# ============================================================
#
# ?? Что это и зачем:
#   Minecraft玩家皮肤必须经过Mojang签名。
#   Mineskin是一个服务,它接收PNG文件(64×64)
#   并返回已签名的value和signature。我们将这些数据
#   附加到NPC上,使其获得所需的皮肤。
#
#   插件在服务器启动时自动执行此操作:
#     1. 从 plugins/NullPlugin/skins/nulleclipse.png 读取PNG
#     2. 上传至Mineskin
#     3. 将结果保存到 plugins/NullPlugin/skin-cache.yml
#     4. 后续启动将读取缓存的纹理——
#        无需发起网络请求。
#
#   API密钥:
#     即使没有密钥,插件也能工作,但Mineskin会施加严格的
#     速率限制(且请求速度较慢)。建议
#     获取免费密钥:https://mineskin.org/apikey
#     将其粘贴到下方的 'api-key' 字段中。
#
# ?? What and why:
#   Minecraft player skins must be Mojang-signed. Mineskin accepts
#   a PNG file (64×64) and returns signed value + signature.
#   These are attached to the NPC, giving it the desired skin.
#
#   The plugin does this automatically on server startup:
#     1. Reads plugins/NullPlugin/skins/nulleclipse.png
#     2. Uploads to Mineskin
#     3. Saves result to plugins/NullPlugin/skin-cache.yml
#     4. Subsequent starts read the cached texture —
#        no internet requests.
#
#   API key:
#     Works without a key too, but Mineskin enforces strict
#     rate limits (and slower requests). Get a free key at
#     https://mineskin.org/apikey and paste it below.
# ============================================================
mineskin:
  # Mineskin API key (leave empty "" to run without authorization).
  api-key: ""

# ============================================================
# 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:
    follow-player: true
    teleport-randomly: true
    destroy-blocks: true
    place-signs: true
    look-at-player: true
    teleport-cooldown: 10
    action-cooldown: 15
    follow-range-teleport: 50
    invisible-distance: 5
    invisible-duration: 60
    max-location-attempts: 10
    teleport-chance: 0.3
    teleport-behind-chance: 0.05
    glance-chance: 0.02
    extinguish-torch-chance: 0.1
    invisible-chance: 0.3
    sign-chance: 0.2
    destroy-chance: 0.15
    ambient-sound-chance: 0.1
    sign-remove-delay: 1200
    torch-restore-delay: 80
    glance-duration: 6
    destroy-radius: 3
    destroy-iterations: 3
    torch-radius: 6
    near-effect-distance: 5.0
    near-min: 15
    near-max: 30
    teleport-min: 20
    teleport-max: 40
    sign-min: 5
    sign-max: 15

  # ------------------------------------------------------------
  # Null appearance
  # ------------------------------------------------------------
  appearance:
    # Skin name in skins/ folder (without .png)
    skin-name: "Nulleclipse"
    invisible-sometimes: true
    spawn-particles: true
    teleport-particles: true
    despawn-particles: true
    show-nameplate: true

  # ------------------------------------------------------------
  # Signs that Null can place
  # ------------------------------------------------------------
  signs:
    messages:
      - "null"
      - "LEAVE"
      - "I SEE YOU"
      - "RUN"

  # ------------------------------------------------------------
  # Null sound effects
  # ------------------------------------------------------------
  sounds:
    enabled: true
    ambient-sounds: true
    teleport-sound: "ENTITY_ENDERMAN_TELEPORT"
    despawn-sound: "ENTITY_ILLUSIONER_MIRROR_MOVE"
    spawn-sound: "ENTITY_ENDERMAN_AMBIENT"
    destroy-sound: "ENTITY_GENERIC_EXPLODE"
    place-sign-sound: "BLOCK_WOOD_PLACE"
    sign-break-sound: "BLOCK_WOOD_BREAK"
    extinguish-sound: "BLOCK_FIRE_EXTINGUISH"
    glance-teleport-sound: "ENTITY_ENDERMAN_TELEPORT"
    glance-illusioner-sound: "ENTITY_ILLUSIONER_AMBIENT"
    heartbeat-sound: "ENTITY_WARDEN_HEARTBEAT"
    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"
    ambient-step:
      - "BLOCK_STONE_STEP"
      - "BLOCK_SAND_STEP"
      - "BLOCK_GRAVEL_STEP"
      - "ENTITY_PLAYER_ATTACK_SWEEP"

# ------------------------------------------------------------
  # 无粒子效果
  # ------------------------------------------------------------
  particles:
    spawn: "PORTAL"
    teleport: "PORTAL"
    despawn: "LARGE_SMOKE"
    glance-portal: "PORTAL"
    glance-soul-flame: "SOUL_FIRE_FLAME"
    count: 20
    speed: 0.1
    spawn-offset-x: 0.5
    spawn-offset-y: 1.0
    spawn-offset-z: 0.5

  # ------------------------------------------------------------
  # 恐惧与神秘效果
  # ------------------------------------------------------------
  effects:
    darkness-duration: 100
    blindness-duration: 60
    nausea-duration: 120

    whisper:
      enabled: true
      sound: "ENTITY_ILLUSIONER_AMBIENT"
      chance: 0.08

    flicker:
      enabled: true
      sound: "ENTITY_ELDER_GUARDIAN_CURSE"
      chance: 0.05
      blind-duration: 40

    creepy-particles:
      enabled: true
      particle: "WARPED_SPORE"
      chance: 0.12
      count: 15

    fake-hurt:
      enabled: true
      sound: "ENTITY_PLAYER_HURT"
      chance: 0.04

    distortion:
      enabled: true
      chance: 0.03
      duration: 100
      amplifier: 4

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源