PhantomCreeper
English · 简体中文
PhantomCreeper 是一种混合了幻翼和苦力怕的实体。它像幻翼一样飞行,靠近玩家后像苦力怕一样引信爆炸。该插件支持 Paper 和 Folia,并可使用 BetterModel 或 ModelEngine 4.x 渲染模型。
兼容性
- 服务端:Paper 或 Folia 26.1.x–26.3。
(已在 Paper 26.3 和 Folia 26.3 上测试;其他版本未经测试。)
- Java:需要 Java 25。该插件不兼容 Java 21。
- 模型引擎(二选一):
- BetterModel 3.6.0 或更高版本(本项目的参考版本为 3.7.0)。
- ModelEngine 4.1.1 或更高版本(免费版和专业版均支持)。
- 资源包托管:CraftEngine、ItemsAdder 或其他能够合并模型引擎资源的插件。
已知问题:在 ModelEngine 下,模型飞行目前存在轻微卡顿。在 BetterModel 下飞行流畅。此问题尚未修复。
命令
| 命令 |
描述 |
/phantomcreeper stats |
查看你自己的击杀和死亡统计 |
/phantomcreeper spawn [player] |
在玩家前方 12 格、上方 6 格处生成一只 |
/phantomcreeper removeall |
移除该插件管理的所有实体 |
/phantomcreeper reload |
重载配置文件和语言文件 |
/phantomcreeper info |
查看存活数量和模型状态 |
/phantomcreeper engine <bettermodel|modelengine> |
在运行时切换已安装的模型引擎并重新绑定现有实体 |
别名:/pcreeper
权限:
phantomcreeper.stats:允许使用 /phantomcreeper stats;默认所有玩家可用。
phantomcreeper.admin:允许使用 spawn、removeall、reload、info 和 engine;默认仅 OP 可用。
engine 子命令是管理员调试命令,仅在安装了所选模型引擎插件时可用。切换操作不会修改 config.yml;服务器重启后,将再次使用配置的后端。
PlaceholderAPI 变量
| 变量 |
描述 |
%phantomcreeper_kills% |
在当前 PlaceholderAPI 玩家上下文中的玩家对 PhantomCreeper 的击杀数 |
%phantomcreeper_deaths% |
玩家被 PhantomCreeper 爆炸击杀的次数 |
这两个变量都是针对特定玩家的,当没有玩家上下文时返回 0。
完整配置
内置语言包括英语、简体中文、日语、韩语、繁体中文、德语、法语、西班牙语和俄语。完整的 config.yml 如下所示:
# 更改模型设置后请重启服务器;其他设置可使用 /phantomcreeper reload 重载。
# 插件语言:auto,或 lang/ 下的文件名,例如 zh_cn.yml。
# auto 跟随服务器 Locale,当无法识别时回退到 en_us.yml。
language: auto
model:
# 渲染后端:auto、bettermodel 或 modelengine。
# auto 优先使用 BetterModel,并在缺少 BetterModel 时自动使用 ModelEngine。
engine: auto
# 两种模型引擎共用的模型名称;通常无需更改。
name: phantom_creeper
# 整体模型缩放倍数。
scale: 1.25
# 飞行时使用的循环翅膀拍打动画名称。
flap-animation: flap
# 使用 ModelEngine 时,自动安装内置兼容蓝图至
# plugins/ModelEngine/blueprints/phantom_creeper.bbmodel。
modelengine-auto-install-blueprint: true
# 当模型不可用时,保留原版苦力怕载体作为后备显示。
keep-base-phantom-visible-if-model-fails: true
targeting:
# 实体开始追踪玩家的最大距离。
acquire-range: 48.0
# 目标超出此距离后放弃追踪。
lose-range: 64.0
# 是否忽略创造模式下的玩家。
ignore-creative: true
# 是否忽略旁观者模式下的玩家。
ignore-spectator: true
# 是否需要无障碍视线;启用此项会增加可见性检查的成本。
require-line-of-sight: false
movement:
长距离巡航速度,单位为每刻方块数;0.32 约为每秒 6.4 个方块。
cruise-speed: 0.32
近距离追击速度,单位为每刻方块数。
chase-speed: 0.48
所有飞行速度的硬性上限。
max-speed: 0.68
速度平滑因子,范围从 0.0 到 1.0;数值越大,转向越快。
acceleration: 0.20
长距离移动时,高于目标的巡航高度。
cruise-height: 6.0
近距离俯冲时,高于目标脚部的攻击高度。
strike-height: 1.2
进入近距离攻击模式及追击速度所需的水平距离。
close-range: 8.0
在没有目标时,围绕巡逻点旋转的半径。
waypoint-radius: 3.5
飞行或返回家园时,距初始生成点的最大距离。
max-distance-from-home: 72.0
生物之间的首选间隔距离;允许在同一位置生成。
minimum-separation: 6.0
combat:
PhantomCreeper 的最大生命值。
max-health: 24.0
触发爆炸引信所需的玩家距离。
trigger-radius: 2.8
引信持续时间,单位为刻;20 刻等于一秒。
fuse-ticks: 30
当玩家离开此半径时取消引信并恢复追击。
fuse-cancel-radius: 7.0
explosion:
# 爆炸半径,单位为方块;内部会转换为 Minecraft 的爆炸威力。
radius: 6.0
# 在应用护甲、附魔和伤害免疫之前的原始中心伤害值。
damage: 40.0
# 伤害是否随距离衰减;禁用后,范围内造成全额伤害。
damage-falloff: true
# 爆炸是否会破坏方块;默认禁用。
break-blocks: false
# 爆炸是否会引发火焰。
set-fire: false
# 爆炸是否会伤害 PhantomCreeper 自身。
damage-self: false
被玩家击杀时掉落的幻翼膜数量。
drop-phantom-membrane: 2
被玩家击杀时掉落的火药数量。
drop-gunpowder: 2
被击杀时掉落的最小经验值。
dropped-experience: 20
natural-spawn:
是否启用自然生成。
enabled: true
生成条件检查的间隔时间,单位为刻;20 刻等于一秒。
check-interval-ticks: 200
Minecraft 夜晚开始的时间。
night-start-time: 13000
Minecraft 夜晚结束的时间。
night-end-time: 23000
自然生成是否仅限于主世界。
only-overworld: true
处于活动状态的自然生成生物的最大数量;管理员生成的生物不计入此限制。
max-active: 10
所有活体生物的全球硬性上限,包括管理员生成的生物。
max-tracked: 20
spawn-area:
# 选择生成点时,距玩家的最小水平距离。
min-distance: 18.0
# 选择生成点时,距玩家的最大水平距离。
max-distance: 32.0
# 选择生成点时,高于玩家的最小高度偏移量。
min-height-offset: 6.0
# 选择生成点时,高于玩家的最大高度偏移量。
max-height-offset: 12.0
机制 A:每晚每个玩家根据当前世界难度掷骰子一次。
nightly-difficulty-spawn:
# 是否启用机制 A。
enabled: true
# 掷骰成功后生成的数量。
spawn-count: 1
chances:
# 简单难度概率;0.05 表示 5%。
easy: 0.05
# 普通难度概率;0.10 表示 10%。
normal: 0.10
# 困难难度概率;0.20 表示 20%。
hard: 0.20
机制 B:当附近的原版幻翼数量达到阈值时,每晚每个玩家掷骰子一次。
phantom-threshold-spawn:
# 是否启用机制 B。
enabled: true
# 用于统计附近原版幻翼数量的球体半径。
scan-radius: 32.0
triggers:
# 当附近有 3 只原版幻翼时,生成 1 只 PhantomCreeper。
- phantom-count: 3
spawn-count: 1
# 当附近有 6 只原版幻翼时,生成 2 只 PhantomCreeper。
- phantom-count: 6
spawn-count: 2
允许自然生成的世界列表。为空表示所有世界,但仍受 only-overworld 限制。
worlds:
- world
safety:
当其所在区块卸载时,是否立即移除受管理的生物。
remove-on-chunk-unload: true
在此刻数后移除;12000 刻等于 10 分钟,0 表示禁用自动移除。
despawn-after-ticks: 12000
## 赞助与支持
如果本项目对您有用,您可以通过 Ko-fi 或爱发电支持开发。
<p align="center">
<a href='https://ko-fi.com/J5C529ZWWL' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
<a href='https://afdian.com/a/sss000' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://img.shields.io/badge/Afdian-Support-946CE6?style=for-the-badge&logo=afdian&logoColor=white' border='0' alt='Support on Afdian' /></a>
</p>
<br><br><br>
<p align="center">
<img src="https://raw.githubusercontent.com/che11111/PhantomCreeper/main/img/logo.png" alt="PhantomCreeper logo" height="128">
</p>
PhantomCreeper
English · 简体中文
PhantomCreeper is a hybrid Phantom and Creeper mob. It flies like a Phantom, approaches players, and then primes and explodes like a Creeper. The plugin supports Paper and Folia and can render the model with BetterModel or ModelEngine 4.x.
Compatibility
- Server: Paper or Folia 26.1.x–26.3.
(Tested on Paper 26.3 and Folia 26.3; other versions have not been tested.)
- Java: 25 required. The plugin is not compatible with Java 21.
- Model engine (choose one):
- BetterModel 3.6.0 or newer (the reference version for this project is 3.7.0).
- ModelEngine 4.1.1 or newer (Free and Premium are both supported).
- Resource-pack hosting: CraftEngine, ItemsAdder, or another plugin capable of merging model-engine resources.
Known issue: Model flight currently has slight stuttering under ModelEngine. Flight is smooth under BetterModel. This issue has not yet been fixed.
Commands
| Command |
Description |
/phantomcreeper stats |
View your own kill and death statistics |
/phantomcreeper spawn [player] |
Spawn 12 blocks ahead of and 6 blocks above a player |
/phantomcreeper removeall |
Remove every mob managed by this plugin |
/phantomcreeper reload |
Reload the configuration and language files |
/phantomcreeper info |
View the living count and model status |
/phantomcreeper engine <bettermodel|modelengine> |
Switch the installed model engine at runtime and rebind existing mobs |
Alias: /pcreeper
Permissions:
phantomcreeper.stats: Allows /phantomcreeper stats; available to all players by default.
phantomcreeper.admin: Allows spawn, removeall, reload, info, and engine; OP only by default.
The engine subcommand is an administrator debugging command and is available only when the selected model-engine plugin is installed. Switching does not modify config.yml; after a server restart, the configured backend is used again.
PlaceholderAPI Variables
| Variable |
Description |
%phantomcreeper_kills% |
The player's PhantomCreeper kills in the current PlaceholderAPI player context |
%phantomcreeper_deaths% |
The number of times the player has been killed by a PhantomCreeper explosion |
Both variables are player-specific and return 0 when no player context is available.
Full Configuration
Bundled languages are English, Simplified Chinese, Japanese, Korean, Traditional Chinese, German, French, Spanish, and Russian. The complete config.yml is shown below:
# Restart the server after changing model settings; other settings can use /phantomcreeper reload.
# Plugin language: auto, or a file name under lang/ such as zh_cn.yml.
# auto follows the server Locale and falls back to en_us.yml when unrecognized.
language: auto
model:
# Renderer backend: auto, bettermodel, or modelengine.
# auto prefers BetterModel and automatically uses ModelEngine when BetterModel is absent.
engine: auto
# Shared model name for both model engines; normally no change is needed.
name: phantom_creeper
# Overall model scale multiplier.
scale: 1.25
# Looping wing-flap animation name used while flying.
flap-animation: flap
# With ModelEngine, install the bundled compatible blueprint to
# plugins/ModelEngine/blueprints/phantom_creeper.bbmodel automatically.
modelengine-auto-install-blueprint: true
# Keep the vanilla Creeper carrier visible as a fallback when the model is unavailable.
keep-base-phantom-visible-if-model-fails: true
targeting:
# Maximum distance at which the creature starts tracking a player.
acquire-range: 48.0
# Drop the current target after it moves beyond this distance.
lose-range: 64.0
# Whether to ignore players in Creative mode.
ignore-creative: true
# Whether to ignore players in Spectator mode.
ignore-spectator: true
# Require an unobstructed line of sight; enabling this increases visibility-check cost.
require-line-of-sight: false
movement:
# Long-range cruise speed in blocks per tick; 0.32 is about 6.4 blocks per second.
cruise-speed: 0.32
# Close-range chase speed in blocks per tick.
chase-speed: 0.48
# Hard upper limit for all flight speeds.
max-speed: 0.68
# Velocity smoothing factor from 0.0 to 1.0; larger values turn faster.
acceleration: 0.20
# Cruise height above the target during long-range movement.
cruise-height: 6.0
# Strike height above the target's feet during a close-range dive.
strike-height: 1.2
# Horizontal distance for entering close attack mode and chase speed.
close-range: 8.0
# Orbit radius around the patrol point when no target is available.
waypoint-radius: 3.5
# Maximum distance from the initial spawn point while flying or returning home.
max-distance-from-home: 72.0
# Preferred separation distance between creatures; spawning at the same position is still allowed.
minimum-separation: 6.0
combat:
# Maximum health of PhantomCreeper.
max-health: 24.0
# Player distance required to start the explosion fuse.
trigger-radius: 2.8
# Fuse duration in ticks; 20 ticks equals one second.
fuse-ticks: 30
# Cancel the fuse and resume chasing when the player leaves this radius.
fuse-cancel-radius: 7.0
explosion:
# Explosion radius in blocks; internally converted to Minecraft explosion power.
radius: 6.0
# Raw center damage before armor, enchantments, and damage immunity are applied.
damage: 40.0
# Whether damage falls off with distance; when disabled, full damage applies in range.
damage-falloff: true
# Whether the explosion may break blocks; disabled by default.
break-blocks: false
# Whether the explosion creates fire.
set-fire: false
# Whether the explosion may damage PhantomCreeper itself.
damage-self: false
# Number of Phantom Membranes dropped when killed by a player.
drop-phantom-membrane: 2
# Amount of gunpowder dropped when killed by a player.
drop-gunpowder: 2
# Minimum experience dropped when killed.
dropped-experience: 20
natural-spawn:
# Whether natural spawning is enabled.
enabled: true
# Interval between spawn-condition checks; 20 ticks equals one second.
check-interval-ticks: 200
# Minecraft night start time.
night-start-time: 13000
# Minecraft night end time.
night-end-time: 23000
# Whether natural spawning is limited to the Overworld.
only-overworld: true
# Maximum living naturally spawned creatures; admin spawning does not count toward this limit.
max-active: 10
# Global hard limit for all living creatures, including admin-spawned creatures.
max-tracked: 20
spawn-area:
# Minimum horizontal distance from the player when choosing a spawn point.
min-distance: 18.0
# Maximum horizontal distance from the player when choosing a spawn point.
max-distance: 32.0
# Minimum height offset above the player when choosing a spawn point.
min-height-offset: 6.0
# Maximum height offset above the player when choosing a spawn point.
max-height-offset: 12.0
# Mechanism A: roll once per player per night based on the current world difficulty.
nightly-difficulty-spawn:
# Whether mechanism A is enabled.
enabled: true
# Number spawned after a successful roll.
spawn-count: 1
chances:
# Easy-difficulty chance; 0.05 means 5%.
easy: 0.05
# Normal-difficulty chance; 0.10 means 10%.
normal: 0.10
# Hard-difficulty chance; 0.20 means 20%.
hard: 0.20
# Mechanism B: roll once per player per night when nearby vanilla Phantom counts reach a threshold.
phantom-threshold-spawn:
# Whether mechanism B is enabled.
enabled: true
# Sphere radius used to count nearby vanilla Phantoms.
scan-radius: 32.0
triggers:
# Spawn one PhantomCreeper when three vanilla Phantoms are nearby.
- phantom-count: 3
spawn-count: 1
# Spawn two PhantomCreepers when six vanilla Phantoms are nearby.
- phantom-count: 6
spawn-count: 2
# Worlds allowed for natural spawning. Empty means all worlds, still subject to only-overworld.
worlds:
- world
safety:
# Whether to remove managed creatures immediately when their chunk unloads.
remove-on-chunk-unload: true
# Remove after this many ticks; 12000 ticks equals 10 minutes, and 0 disables auto-removal.
despawn-after-ticks: 12000
Sponsorship and Support
If this project is useful to you, you can support development through Ko-fi or Afdian.
评论 0
登录后参与评分
还没有评论,来抢沙发吧