Fancy Physics - 花式物理

Fancy Physics 是一款为你的 SMP 服务器增添真实物理效果的完美插件，它完全基于原版机制，无需任何模组或资源包即可实现丰富的视觉效果与互动。

💡基本信息

• 作者: Maxim.jsx
• 源代码: https://github.com/maximjsx/FancyPhysics
• 支持与讨论: https://discord.gg/4pA7VUeQs4
• 荣誉: 本插件已入选 awesome-plugins 列表！

支持的版本

• 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21

重要须知

• 本插件仅支持 1.19.4 及以上版本，其他 1.19.x 版本无法运行。
• 如果你使用 Geyser，基岩版玩家将无法看到效果，因为插件使用的显示实体在基岩版中不存在。
• 暂不支持 WorldGuard。

✨核心功能

• 方块粒子效果: 破坏方块时产生逼真的碎片飞溅。
• 树木倒塌动画: 砍树时，树木会依重力缓缓倒下。
• 真实爆炸效果: 爆炸会产生物理冲击和碎片。
• 爆炸与树木再生: 可配置被爆炸破坏的方块或倒塌的树木在一段时间后自动恢复。
• 视觉化合成: 在合成台方块上方显示当前使用的物品（单玩家限制）。
• 实体死亡粒子: 生物死亡时产生粒子效果。
• 伤害粒子: 实体受到伤害时显示粒子。
• 活板门动画 (实验性): 为活板门添加微小的开合动画。
• 冲刺破坏: 冲刺时撞向门或玻璃可将其破坏。
• API: 提供开发者接口。

🔧安装与使用

• 下载插件。
• 将插件文件复制到服务器的 plugins 文件夹。
• 重启你的服务器。

🎮命令与权限

命令

• /fancyphysics reload - 重载插件配置。
• /fancyphysics clear-particles - 清除服务器上所有现存粒子。

权限

• fancyphysics.admin - 授予使用所有命令的权限。
• fancyphysics.commands - 授予使用命令的权限。

⭐配置详解 (`config.yml`)

以下为配置文件的主要选项说明

声音与保护

• Sounds: 是否启用方块破裂音效。
• SpawnPhysicsProtection: 在世界出生点周围禁用物理效果。

- `Enabled`: 是否启用。

- `RadiusInBlocks`: 保护半径（方块数）。

- `Location`: 保护中心坐标。

爆炸设置

• Explosion:

- `Physics`: 是否启用爆炸物理效果。

- `NaturalDrops`: 爆炸是否产生自然掉落物。

- `Drops`: 爆炸是否产生任何掉落物。

- `EntityDeathParticles`: 爆炸致死的实体是否产生死亡粒子。

粒子效果

• Particle:

- `Enabled`: 总开关。

- `Animation`:

- `Rotation`: 粒子是否旋转。

- `FlyUp`: 方块被破坏时是否向上飞起并缩小（否则为碎裂效果）。

- `SpeedInTicks`: 动画持续时间（刻）。

- `EndSizeMultiplier`: 粒子结束时的尺寸倍数。

- `MaxAmount`: 全服务器允许同时存在的最大粒子数。

• DamageParticles: 是否启用伤害粒子。
• PerformanceMode: 是否启用性能模式（可能降低效果质量以提升性能）。

树木物理

• Tree:

- `Physics`: 是否启用树木倒塌。

- `DropSaplings`: 树木倒塌时是否掉落树苗。

- `ChopDelay`: 是否启用砍伐延迟（使砍树过程分阶段进行，耗时更长）。

- `GravityIfInAir`: 如果树木下方方块被破坏，整棵树是否会因重力倒下。

- `AffectedBlocksInPlayerBreakBlocksStatistic`: 倒塌树木的所有方块是否计入玩家的“破坏方块”统计。

- `AdvancedStemScan`: 是否启用高级树干扫描（可能更准确但更耗资源）。

- `ScanMaxStemSize`, `ScanMaxLeavesSize`, `MaxInvalidScans`, `MaxInvalidBlockDistance`: 高级扫描相关参数。

其他物理效果

• VisualCrafting: 是否启用视觉化合成。
• FallingBlockPhysics: 下落的方块（如沙、砂砾）是否会在无支撑时继续下落并破坏。
• BlockCrackOnFall: 下落的方块是否显示破裂粒子动画。
• TrapdoorPhysics: 是否启用活板门动画（建议仅在测试服使用）。
• SprintBreak: 冲刺破坏设置。

- `Door`: 是否可冲刺破坏门。

- `Glass`: 是否可冲刺破坏玻璃。

再生系统

• Regeneration:

- `TreeRegeneration`: 树木再生。

- `Enabled`: 是否启用。

- `Delay`: 再生延迟（秒）。

- `ExplosionRegeneration`: 爆炸破坏再生。

- `Enabled`: 是否启用。

- `Delay`: 再生延迟（秒）。

黑名单与禁用世界

• BlockParticleBlackList: 破坏时不显示粒子效果的方块列表（如蜡烛、花、火把等）。
• DisabledWorldsList: 完全禁用所有物理效果的世界名称列表。

方块物理（悬空破坏）

• BlockPhysics:

- `Enabled`: 是否启用。启用后，悬空搭建的方块在达到一定长度后会因无支撑而掉落。

- `Blocks`: 为不同方块设置不同的悬空长度限制。

- `DEFAULT`: 默认限制（方块数）。

- `STONE`: 石类方块的限制。

自定义方块粒子

• BlockParticleSettings:

- `Blocks`: 可为特定方块自定义破裂时显示的粒子材质。

- 示例：`DIAMOND_ORE`（钻石矿）破裂时可显示 `DIAMOND_BLOCK`（钻石块）的材质。

❓常见问题与支持

• 遇到问题？ 在给出差评前，请先通过 Discord 服务器寻求支持或在 GitHub 上提交问题。
• 请勿在下方评论区提交建议、功能请求或寻求技术支持，请使用上述官方渠道。
• 作者的其他插件：

- Better Chat Bubbles (基于数据包的气泡聊天)

- Custom score numbers (移除侧边栏红色分数显示)

- Hologram / Leaderboard API (基于数据包的文本显示全息图 API)

💡关于 Fancy Physics

Fancy Physics 是一款为 Minecraft 服务器添加真实物理效果的插件，它能实现诸如树木倒塌、逼真的爆炸和伤害粒子等特性，且完全无需客户端模组。

❓常见问题

安装与使用

• 如何在我的服务器上安装 Fancy Physics？

下载插件的 .jar 文件，将其放入服务器的 plugins 文件夹，然后重启服务器即可启用。

• Fancy Physics 需要客户端模组吗？

不需要。Fancy Physics 无需任何客户端模组或资源包即可工作。

定制与支持

• 我可以自定义物理效果吗？

可以。Fancy Physics 提供了配置文件供您调整各项效果。

• Fancy Physics 是免费的吗？

是的。Fancy Physics 完全免费。

开发者信息

• Fancy Physics 是谁制作的？

本插件由 Maxim.jsx 开发。