PhantomSpawnControl [FREE] - PhantomSpawnControl 幻翼生成控制

PhantomSpawnControl 可让你精细控制玩家周围幻翼的生成时机，并为幻翼设置自定义属性。你还可以配置多种不同类型的幻翼及其生成概率；当玩家切换到指定游戏模式时（默认 survival 和 adventure），幻翼生成计时器也会被重置。

💡重要说明

• 免费版的 PhantomSpawnControl 将不再继续更新。
• 作者仍会像以前一样持续更新其高级版（premium）。
• 如需获取 PhantomSpawnControl 的新功能与后续更新，请查看高级版：
• https://www.spigotmc.org/resources/...-1-14-x-50-off-for-the-first-10-buyers.71538/

⭐功能特点

• 可自定义大量生成条件（详见下方配置说明）
• 可自定义玩家在多久未睡觉后才会生成幻翼
• 可自定义哪些游戏模式切换时会重置该计时器
• 可通过权限节点为特定玩家禁用计时器重置
• 可禁止特定游戏模式的玩家生成幻翼（默认：creative、spectator）
• Giant_Phantoms：根据“未休息时间”生成不同类型的幻翼
• 可自定义 giant_phantoms（生成概率、幻翼属性等）
• 可添加任意数量的幻翼类型
• 提供切换命令，允许玩家单独开启或关闭自己的幻翼生成
• 提供 DebugMode，便于更快获得插件支持

🎮重要信息

• 关于新增机制的说明可在配置文件中找到。
• 插件首次启用时会在你的 scoreboard 中创建一个新的 objective。请不要删除它（名称会显示在控制台中）。
• 如果 phantom_spawn 未被禁用，插件将完全接管幻翼生成，从而允许你在配置中自定义大量生成条件。spawn_chance_multiplier 会基于 wiki 中说明的默认 Minecraft 公式结果进行倍率计算。
• 虽然支持重载，但依然不建议你对服务器执行 reload。
• 如需启用 debugMode，请在配置文件中添加 debug: true。
• 本插件使用 bstats。

✨安装方法

• 将 jar 文件放入服务器的 plugins 文件夹中。
• 重启服务器后即可在配置文件中进行调整。
• 修改完成后不要忘记再次重启或重载。

🔧命令

• 别名：/psc [subcommand]
• /phantomspawncontrol: credits
• /phantomspawncontrol help: 显示该玩家当前可用的所有命令。
• /phantomspawncontrol toggle: 切换执行该命令玩家的幻翼生成开关状态。

（如果配置中启用了 save_playerdata，则该开关状态会在玩家退出时保存）

🔧权限

• phantomspawncontrol.stopreset: 阻止在切换游戏模式时重置幻翼计时器（默认无）
• phantomspawncontrol.stopspawn: 为特定玩家禁用幻翼生成
• phantomspawncontrol.toggle: 允许使用 toggle 命令

🎮配置文件说明

基础设置

• max_ticks: 幻翼不会生成的时间长度。
• 当玩家进入床中，或切换到已启用重置的游戏模式时，该计时器会被重置。

`gamemode_reset`

• 如果设为 true，玩家切换到对应游戏模式时，“phantom timer” 会被重置。
• 默认配置示例中：
• adventure: true
• creative: false
• spectator: false
• survival: true

`gamemode_disable`

• 如果设为 true，处于对应游戏模式的玩家将无法生成幻翼。
• 默认配置示例中：
• adventure: false
• creative: true
• spectator: true
• survival: false

`phantom_spawn`

• 这是手动幻翼生成算法。
• 启用后，将禁用游戏原版的自然幻翼生成机制。

`general_restrictions`

• player_above_sea_level: 玩家必须位于海平面以上
• max_light_level: 最大允许光照等级
• max_group_size: 最大生成群体数量
• spawn_chance_multiplier: 生成概率倍率

`world_restrictions`

• disable_day_worlds: 是否禁用白天世界中的生成
• enabled_environments:
• normal
• nether
• the_end
• disabled_worlds:
• 可在此列出禁用世界

`spawn_blocks`

• 该部分用于定义：当玩家上方存在哪些方块时，幻翼不会生成。
• ignore_solid_blocks 用于设置“虽然是实体方块，但不应阻止生成”的方块。
• add_blocks 用于设置在所有启用世界中都会阻止生成的方块。
• 可用材质列表请见：
• https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
• 不要使用非方块类材质。

相关选项

• no_solid_block_above_player: 是否要求玩家上方没有实体方块
• enabled_environments:
• normal
• nether
• the_end
• disabled_worlds:
• 可在此列出禁用世界
• ignored_solid_blocks:
• 可在此列出要忽略的实体方块
• add_blocks:
• 可在此列出额外阻止生成的方块

`spawn_attempts`

• min_delay: 最小生成尝试间隔
• max_delay: 最大生成尝试间隔

`spawn_area`

• min_height: 最小高度
• max_height: 最大高度
• xz_plane_diameter: XZ 平面的直径

`bed_protection`

• bed_spawn_not_near: 是否启用床附近保护
• bed_spawn_protection_radius: 床周围保护半径

`advanced`

• use_legacy: 是否启用 legacy 模式
• giant_phantoms: 是否启用 giant_phantoms
• save_playerdata: 是否保存玩家数据

❓Legacy 模式说明

• 重要：如果你使用手动幻翼生成，则无需关心这一部分。
• 因为插件会自行生成幻翼，没有必要同时使用两套方案。
• 简而言之：非 legacy 模式更精确，但移除幻翼时需要更多时间。
• 作者不推荐使用 legacy 模式，尤其是在你为大量玩家禁用幻翼生成时。

普通模式行为

• 插件通常会等待幻翼选定第一个目标。
• 然后决定是移除该幻翼，还是在启用 giant_phantoms 时为其应用不同属性。

Legacy 模式行为

• 插件会检测幻翼生成位置附近的所有玩家。
• 如果其中有任意一名玩家不应生成幻翼，那么该位置附近的幻翼生成就会被阻止。
• 也就是说，只需一名玩家，就足以阻止其附近区域生成幻翼。
• 但如果该生成位置附近的所有玩家分数都大于 max_ticks，则插件会选择其中最低分数来生成“最弱”的幻翼。
• 这一点仅在启用 giant_phantoms 时相关。

⭐`giant_phantoms` 说明

• 如果启用了 giant_phantoms，插件会自动创建一个额外配置文件，用于配置该机制。
• 打开该文件后，你会看到作者提供的一些示例建议。
• 第一段名为 0: 的配置，对应 wiki 中描述的默认幻翼。

配置规则

• 每个分段名称表示：在本文件顶部 max_ticks 的基础上，额外需要多少“未休息 ticks”。
• 如果玩家的未休息 ticks 大于或等于 max_ticks + 分段名，那么他/她就有可能生成该类型幻翼。

重要格式要求

• 除 size 外，所有值都必须是 double。
• size 必须是 integer。
• 否则控制台会收到警告信息。

生成概率机制

• 作者没有采用线性概率，而是使用了另一套系统。
• 其逻辑如下：

• 1. 玩家的未休息 ticks 必须高于 max_ticks + 分段名
• 2. 每多出 1 tick，该幻翼类型就额外获得 1 次生成机会，直到达到下一个更高阶幻翼类型的门槛
• 3. 最终会综合所有“chance-points”后，随机选出一种幻翼类型

附加致谢

• 该功能的灵感来自 Xisumavoid 的 vanilla tweak data pack。

✨Bug 反馈与建议

• 请在 discussion section 报告 bug。
• 欢迎提出对未来更新的建议。