Oceastra's Broom

Add a rideable magic broom to Minecraft — soar through the skies, drift, boost, and zip around.

添加了一把可骑乘的魔法扫帚——飞行、加速、漂移。

---

Features / 功能

🧹 Magic Broom / 魔法扫帚

Place a broom from your inventory and hop on. Fly with intuitive controls — ascend, descend, sprint, drift. While sprinting, it feels like steering a boat on ice.

• While sprinting, drifting builds up boost energy. Press the sprint key again to release a speed burst.
• 3 sitting positions to choose from (adjustable via GUI).
• When not ridden, the broom serves as a floating platform.

从背包中放下扫帚即可骑乘。直观的操作——上升、下降、冲刺、漂移。冲刺状态下的手感类似于冰面上划船。

• 冲刺状态下漂移可积攒加速能量，再次按下冲刺键释放加速。
• 3 种坐姿可选（通过 GUI 调整）。
• 扫帚上无人骑乘时可作为浮空平台。

🔔 Broom Bell / 扫帚铃铛

Craft a Broom Bell to bind with your Broom. From then on, right-click the bell or press R to recall your broom from anywhere — or deploy it from your inventory instantly.

• Right-click on a broom with a bell to bind.
• Right-click with a bound bell to Summon / Recall.
• Alternatively, use the Summon / Recall key (R by default) while holding the bell in your inventory.

制作扫帚铃铛并与你的扫帚绑定。之后右键铃铛或按 R 键即可从任意位置召回扫帚——或从背包中瞬间放出。

• 手持铃铛右键扫帚进行绑定。
• 绑定后右键铃铛召唤 / 召回。
• 也可以将铃铛放在背包里，使用召唤 / 召回键（默认为 R）。

🎮 Customizable Controls / 可自定义按键

• Space — Ascend

• Shift — Descend

• R — Summon / Recall broom

• V — Open broom settings menu

• C — Dismount

• Space — 上升

• Shift — 下降

• R — 召唤 / 召回扫帚

• V — 打开扫帚菜单

• C — 脱离

---

A Few Words / 一些碎碎念

This is my very first mod. I hope you'll enjoy it!

If it feels familiar — yeah, you've probably seen quite a few broom mods out there. They're all great in their own ways, but none of them quite matched what I had in my head. So I decided to make my own.

The mod is still in early alpha and I have so many ideas to implement. There will probably be bugs — please don't hesitate to report them via GitHub Issues (link on the right side of this page), and I'll do my best to fix them.

Updates: I'm pretty busy these days, so expect maybe 1–2 updates per week.

Open Source: Right now the codebase is still evolving rapidly and honestly a bit messy. Once things stabilize, I'll open it up.

About AI: Since this was my first mod, I started off writing everything by hand. Once I got the hang of it, I started using AI for occasional assistance — maybe around 20% of the codebase at this point.

Feedback is always welcome. Thanks for checking it out!

这是我做的第一个模组，希望大家能喜欢！

如果你看着眼熟——没错，市面上已经有不少扫帚模组了。它们各有各的优秀之处，但始终没能完全满足我的想象，于是就有了这个模组。

目前模组还处于早期测试阶段，还有很多想法没有实现，可能会有不少 Bug，欢迎通过右侧的 GitHub Issues 链接提交问题反馈，我会尽力修复。

关于更新： 最近比较忙，大概每周能更新一两次。

关于开源： 目前还在快速开发迭代阶段，代码还很乱，以后稳定了就会开源。

关于 AI： 因为这是我的第一个模组，一开始是纯古法手写编程。逐渐熟悉以后才开始用 AI 辅助，目前 AI 含量估计 20% 左右吧。

欢迎一切反馈，感谢你的关注！