OpenFlares - 信号枪！

OpenFlares 为 Minecraft 添加了一个可配置、支持多人游戏的信号枪系统。你可以装填彩色信号弹，发射由服务器权威模拟的信号弹抛射物，并留下浓密的烟雾轨迹；当服务器允许时，这些烟雾即使在原版区块渲染距离之外也能保持可见。

发射装填了黄色、绿色、红色、黑色、紫色或蓝色信号弹的信号枪。服务器模拟信号弹抛射物，向客户端发布烟雾云，并控制影响游戏玩法的限制。客户端使用可配置的视觉样式渲染烟雾，可选的长距离烟雾，以及为需要更清晰颜色识别的玩家提供的无障碍设置。

功能亮点

• 信号枪物品，带有空的和彩色的信号弹。
• 黄、绿、红、黑、紫、蓝六种信号弹颜色。
• 装填、退弹、发射和重新装填偏好控制。
• 信号枪、空信号弹和彩色信号弹的合成配方。
• 服务器权威的信号弹抛射物飞行、限制、碰撞行为和烟雾发布。
• 可配置的抛射物速度、重力、阻力、最大距离、飞行超时、命中伤害、烟雾持续时间、烟雾不透明度和烟雾大小。
• 长距离 3D 信号烟雾，当客户端启用且服务器允许时，可以渲染超出原版区块渲染距离。
• 服务器端的远距离烟雾视线遮挡，因此即使遮挡物位于玩家的区块渲染距离之外，不透明地形也能隐藏远处的烟雾，同时玻璃等透明方块始终保持透明。
• 自适应远距离烟雾遮挡预算，用于射线检查和可选的缺失区块加载。
• 客户端侧稳定的烟雾颜色（默认启用），以减少光照、视角和背景颜色变化的影响。
• 可选色盲无障碍标签，可显示玩家正在注视的信号烟雾颜色名称。
• 无障碍标签后面可选背景，以提高可读性。
• Fabric Mod Menu 和 NeoForge 模组列表配置界面。
• 独立的客户端侧和服务器侧配置界面。
• /openflares reload server 命令，用于管理员级别的配置重载。

烟雾渲染器选项

服务器选择烟雾渲染器，并将该选择同步给客户端。

渲染器	描述
Friday's Vanilla+ Textures	默认渲染器。使用 FridayNextWeek 的颜色特定纹理集，每种信号弹颜色都有专属外观。
Friday's Vanilla+ Textures #2	使用 FridayNextWeek 的通用 Vanilla+ 烟雾帧，呈现更柔和的原版风格序列。
Minecraft Smoke Textures	使用原版 Minecraft 烟雾粒子帧，同时保留 OpenFlares 的距离、遮挡和远距离渲染行为。
OpenFlares Particles (Spherical)	密集、洁净的 OpenFlares 球形粒子烟雾。
OpenFlares Particles (Spherical-Bumpy)	使用 Arrowstorm_1000 的 CC-BY-SA-4.0 凹凸烟雾纹理，生成更粗糙的球形 OpenFlares 烟雾。
OpenFlares Billboards	风格化的分层广告牌烟雾，具有宽阔的轮廓。

无障碍功能

OpenFlares 包含烟雾可读性选项，旨在帮助玩家在困难光照下或玩家之间颜色感知存在差异时识别信号弹颜色。

• 稳定的烟雾颜色默认启用。
• 黑色信号烟雾渲染为纯黑色。
• 可选的烟雾颜色标签可以关闭、显示为弹出标签或持续标签。
• 当准星下有多种信号弹颜色时，标签可以显示最近的颜色，或按从近到远的顺序列出所有可见颜色。
• 标签位置和文本缩放独立于信号枪重新装填偏好覆盖层进行配置。

配置

OpenFlares 会写入两个 TOML 配置文件：

文件	侧	用途
open_flares-client.toml	客户端	本地烟雾渲染、覆盖层和无障碍设置。
open_flares-server.toml	服务器	信号枪行为、抛射物模拟、烟雾行为、网络限制和远距离烟雾遮挡。

在单人游戏和本地托管的多人世界中，服务器侧配置界面会编辑该 Minecraft 安装所托管世界的服务器设置。在专用服务器上，请在服务器主机上编辑 open_flares-server.toml，然后以管理员身份运行 /openflares reload server 以重载并同步设置。

支持的目标版本

Minecraft	Fabric	NeoForge
1.21.1	支持	支持
1.21.11	支持	支持
26.1.2	支持	支持
26.2	支持	支持

运行时依赖

请安装与你的 Minecraft 版本和加载器都匹配的 OpenFlares jar 文件。

加载器	依赖项
Fabric	Fabric Loader、Fabric API 和 Fabric Language Kotlin。
NeoForge	NeoForge 和 Kotlin for Forge。

对于多人游戏，请在服务器和每个想要使用或查看 OpenFlares 内容的客户端上安装 OpenFlares。

许可与致谢

OpenFlares 的代码、文档、构建逻辑、翻译、数据文件和 UI 定义均根据 AGPL-3.0-or-later 许可。

除非另有说明，大多数 OpenFlares 原创美术、音频和纹理资产均根据 CC-BY-SA-4.0 许可。新的 OpenFlares 原创资产默认使用 CC-BY-SA-4.0，除非其文件级元数据记录了不同的许可证。

某些视觉和声音资产使用其自己的许可证。有关权威的资产致谢和许可证元数据，请参阅源代码仓库中的 CREDITS.md、COPYRIGHT.md 和 REUSE.toml。

贡献者提交的资产：

作者	资产	许可证
Arrowstorm_1000	flare_smoke_spherical_bumpy.png	CC-BY-SA-4.0

记录在 REUSE.toml 中的外部资产致谢：

作者	资产	许可证
FridayNextWeek	textures/particle/fridays_vanilla_plus/ 中的 Friday's Vanilla+ 烟雾纹理帧	ARR
SpringySpringo	flare_gun_reloading_2.ogg，来源： https://opengameart.org/content/gun-reload-sounds	CC0-1.0
MidFag	flare_gun_fire.ogg，来源： https://opengameart.org/content/steampiston	CC-BY-3.0