SWAY API

Sway

为 Minecraft 带来真实的植被互动与形变效果。

“让你的世界焕发生机，从每一根草叶开始。”

SWAY 本身不会产生任何效果；需要搭配其他模组使用。推荐项目：Interactive Foliage

📖 介绍

让 Minecraft 的森林生机盎然！

Sway 是一款高性能模组，当实体穿过植被时，植被会随之互动并发生形变。告别穿过静止、如同幽灵般的草丛——使用 Sway 后，你迈出的每一步、每只移动的生物，都会让周围环境产生真实的反应，让世界更具沉浸感与互动性。

Sway 将性能放在首位，并采用经过优化的形变引擎，确保即使身处最茂密的丛林，FPS 也能保持稳定。

🌟 功能特色

• 动态互动：植被（草、花、蕨类等）会在玩家和生物靠近时弯曲并向外避让。
• 优化引擎：采用高性能的实体与方块交互逻辑，尽可能降低 CPU 和 GPU 开销。
• 双格连续形变：高草和大型蕨类等大型植物会作为一个整体发生形变，避免上下两部分之间出现视觉断层。
• 二次曲线弯曲：呈现自然的弧形形变，根部保持固定，尖端则优雅弯曲。
• 开发者友好：提供简单的 API，方便其他模组开发者让自定义植物兼容 Sway。

⚙️ 兼容性

• Minecraft 版本：

  • 支持版本：1.20.1、1.21.1、1.21.11 和 26+。

• 模组平台：

  • Fabric：✅ 完全支持！

• 模组兼容性：

  • 兼容任何使用 Minecraft 标准植被模型的模组。
  • 可通过 SwayAPI 注册自定义植物。

📦 安装

1. 下载模组：从 Modrinth 或 CurseForge 获取最新版本。
2. 安装 Fabric：确保已为对应的 Minecraft 版本安装 Fabric Loader。
3. 添加模组：将 .jar 文件放入 mods 文件夹。
4. 启动并畅玩：打开 Minecraft，看看世界如何回应你的到来！

🛠️ 开发者 API

Sway 支持扩展。如果你是模组开发者，并希望自己的植物支持 Sway 形变，可以使用 SwayAPI：

// Register your custom block with a 1.2x sway intensity
SwayAPI.register(MyBlocks.CUSTOM_PLANT, 1.2f);

请查看 SwayAPI 了解更多详情。

📝 参与贡献与反馈

欢迎提交贡献和错误报告！

• 发现错误？请在我们的 GitHub 上提交问题。
• 有新点子？欢迎发布建议帖。
• 想要帮忙？请复刻代码仓库并提交拉取请求！

📄 许可证

本模组采用 MIT License 授权。

❤️ 致谢

Sway 旨在为 Minecraft 荒野增添一丝真实感，同时不牺牲性能。感谢你使用本模组并支持社区！