CNPCplus-Fix 3.1.0

A small follow-up update for 3.0.0, containing several fixes, improvements, and a few quality-of-life features.

🇬🇧 English

🎵 Bard BGM Improvements

• Fixed and optimized the Bard BGM distance-based stopping system.
• Bard music should now stop correctly when the player moves outside the configured playback range.

✨ New Dedicated Particle APIs

Added dedicated APIs for three special particle types:

• dust
• Block breaking particles
• Item breaking particles

These particles can now be spawned directly through scripts instead of requiring commands to be executed through scripts.

spawnDustParticle()

spawnDustParticle(red, green, blue, size, x, y, z, spreadX, spreadY, spreadZ, speed, count)

spawnBlockParticle()

spawnBlockParticle(blockID, x, y, z, spreadX, spreadY, spreadZ, speed, count)

spawnItemParticle()

spawnItemParticle(itemID, x, y, z, spreadX, spreadY, spreadZ, speed, count)

This should make these particle effects much easier to use in CNPC scripts.

🏃 NPC Movement Speed

• Reduced the minimum configurable NPC movement speed from 1 → 0.01.
• NPCs can now be configured with much slower movement speeds.

⚔️ Mercenary & Follower Improvements

• NPCs with the Mercenary or Follower profession can now be dismissed.
• This allows players to properly dismiss hired NPC companions when they are no longer needed.

🪽 Flying Navigation Fix

• Fixed an issue where an NPC's collision box would not properly follow the NPC when using Flying Navigation.
• The collision box should now correctly follow the NPC during flight.

🇨🇳 中文

这是一次针对 3.0.0 的小型追加更新，主要包含若干修复、优化以及一些实用功能。

🎵 吟游诗人 BGM 优化

• 修复并优化了吟游诗人 BGM 的距离关闭功能。
• 现在当玩家离开设定的播放范围后，吟游诗人的音乐应该可以正确停止。

✨ 新增专用粒子 API

为以下三种特殊粒子提供了专用的脚本 API：

• dust
• 方块破坏粒子
• 物品破坏粒子

现在不再需要通过脚本执行指令来生成这些特殊粒子，可以直接调用 API。

spawnDustParticle()

spawnDustParticle(红, 绿, 蓝, 大小, x, y, z, 扩散X, 扩散Y, 扩散Z, 速度, 数量)

spawnBlockParticle()

spawnBlockParticle(方块ID, x, y, z, 扩散X, 扩散Y, 扩散Z, 速度, 数量)

spawnItemParticle()

spawnItemParticle(物品ID, x, y, z, 扩散X, 扩散Y, 扩散Z, 速度, 数量)

这使得在 CNPC 脚本中使用这些粒子效果更加方便，也不再需要绕道调用指令。

🏃 NPC 移动速度

• NPC 可设置的最低移动速度从 1 降低至 0.01。
• 现在可以让 NPC 以更低的速度移动。

⚔️ 雇佣兵与随从职业优化

• 现在可以解雇拥有雇佣兵或随从职业的 NPC。
• 当玩家不再需要这些 NPC 时，可以正常将其解雇。

🪽 飞行导航修复

• 修复 NPC 使用飞行模式导航时，碰撞箱无法跟随 NPC 移动的问题。
• 现在 NPC 飞行时，碰撞箱应该可以正确跟随 NPC。