FoxSnow - FoxSnow

简介

FoxSnow 是一款简单实用的插件，它能在你的 Minecraft 服务器中创建逼真的人工降雪效果！❄️❄️❄️ 你可以自定义粒子数量、生效世界，并通过权限控制效果的开关，为你的世界增添冬日氛围。

💡支持版本

• 1.17, 1.18, 1.19, 1.20, 1.21
• 对于 1.13 至 1.16 版本，请访问我们的 Discord 服务器下载。

🎮主要特性

• 可配置粒子数量与类型。
• 可指定允许显示降雪效果的世界。
• 可通过权限控制玩家是否能看到效果。
• 支持通过命令开关效果。
• 可配置生物群系过滤器。
• 提供“雪人效果”，可在玩家周围地面生成积雪。
• 支持 WorldGuard 区域标志集成。
• 包含高级性能调整选项。

🔧命令

• /foxsnow reload - 重载插件配置。
• /foxsnow why - 调试命令，显示你为何看不到降雪效果。
• /foxsnow toggle - 允许玩家开关自己看到的降雪效果。

🔧权限

• foxsnow.show - 允许玩家看到降雪粒子。
• foxsnow.admin - 授予使用 /foxsnow reload 和 /foxsnow why 命令的权限。
• foxsnow.toggle - 授予使用 /foxsnow toggle 命令的权限。

🔧占位符

• %foxsnow_enabled%

✨安装步骤

• 将插件 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件配置文件将在插件文件夹内自动生成，按需编辑 config.yml 和 messages.yml 即可！

✨配置指南

config.yml 概览

以下是核心配置选项的说明

基础设置

• plugin-prefix: 插件消息前缀，设为 "" 可禁用。
• enabled-worlds: 允许降雪的世界列表（区分大小写）。
• require-permission: 设为 false 时，将不需要 foxsnow.show 和 foxsnow.toggle 权限。
• snow-under-blocks: 设为 false 时，降雪只会在头顶无方块遮挡处出现。
• rain-disable-snow: 设为 true 时，若世界自然下雨/下雪，则停止插件降雪效果。

粒子效果

• particle-count: 每次迭代生成的粒子数量。
• max-particle-distance: 粒子可生成位置距离玩家的最远距离。
• particles: 使用的粒子类型列表，例如 WAX_OFF, SNOWFLAKE, END_ROD。
• snowtime: 控制降雪在游戏日内发生的时间段（以刻为单位）。

生物群系过滤

• biome-filter: 可按黑名单或白名单模式，限制效果仅在特定生物群系出现。

雪人效果

• range: 效果范围，设为 -1 则禁用此功能。
• duration: 积雪在地面停留的时间（刻），-1 为永久。
• destroyable: 玩家是否可以破坏积雪并获得雪球。

性能与钩子

• hooks: 可启用或禁用与其他插件（如 WorldGuard）的集成。
• dynamic-performance-adjustment: 根据服务器 TPS 自动调整效果性能。
• roof-cache: 当 snow-under-blocks 为 false 时，启用屋顶缓存以提升性能。

messages.yml 概览

此文件用于自定义插件发送的各种提示信息，例如权限不足、效果开关状态以及 /foxsnow why 命令的调试信息。

✨粒子与生物群系列表

插件支持丰富的粒子效果和生物群系。完整列表请查阅插件主页或配置文件内的详细说明。

✨插件集成（钩子）

WorldGuard

如果启用，插件将注册两个新的区域标志。这些标志的优先级高于所有常规配置选项。这意味着你可以利用 WorldGuard 标志，仅在特定区域（如游戏世界的出生点）启用或禁用降雪效果，实现更精细的控制。

❓支持与帮助

如果你需要任何帮助或遇到了问题

• 请通过讨论区联系我们。
• 或加入我们的 Discord 服务器：http://discord.fox-code.eu
• 开发者个人 Discord：Kesims#0001

> 注：目前插件主要进行维护以兼容新版 Minecraft，暂无重大功能更新。欢迎在 Github 上提交 Pull Request 贡献代码！

如果你喜欢这个插件，可以考虑支持开发者

• 捐赠链接：http://donate.fox-code.eu