封面參考（原作）： Minecraft: Java Edition · 原作宣傳圖，由 IGDB 提供。圖片版權屬原權利人，供辨識原作使用，不代表此重寫／模組專案的實際畫面。

來源維護者： Svahnen · 版本： 1b7c076dbae5 · 整理日期： 2026-10-12

文件授權： MIT · LICENSE · 本文形式： README 翻譯

下文為來源 README 的繁中翻譯，由 Kirikirin 使用 AI 輔助整理；功能、完成度與測試結果均為原作者描述，本站未逐項實機驗證。圖片改為來源連結，指令與技術識別保留原文。

FPVcraft

在 Minecraft 中駕駛手感真實的 FPV 競速無人機——使用你自己的 RC 遙控器。

FPVcraft 是一款適用於 Minecraft 1.21.1 的 Fabric 模組，新增了一架由完整物理飛行模型驅動的 FPV 四軸飛行器，
而非只是飛行攝影機。推力來自馬達與螺旋槳，電池會隨負載壓降，阻力取決於無人機的姿態，
而 acro 模式的行為就像真正的飛控。接上你的 EdgeTX/OpenTX 遙控器，就能像飛真實四軸機一樣
飛翔你的 Minecraft 世界。

功能

真實 acro 物理：剛體四軸飛行器模型，具備馬達/螺旋槳推力、電池電壓壓降、各方向
空氣動力阻力、地面效應、螺旋槳氣流與墜毀物理。支援 Acro、Angle 與 3D 模式。
你的遙控器，你的速率：任何 USB 搖桿遙控器（EdgeTX/OpenTX）或遊戲手把。具備校正精靈，
支援搖桿模式 1-4、AETR/TAER 預設、雙搖桿即時預覽。支援 Betaflight、Actual、KISS、Raceflight 與 Quickrate 速率，以及油門 mid/expo。
四種無人機：5 吋競速、5 吋自由飛、3 吋微型與 7 吋長程預設。
附 OSD 的 FPV 視角：攝影機上仰角、油門、速度、電池與搖桿顯示。按 F5 切換追尾與前視攝影機。
隨處飛翔：區塊會圍繞無人機載入，因此你可以想飛多遠就飛多遠。你的身體會安全地待在你起飛的地方。
多人遊戲：所有安裝此模組的人都能看見彼此的無人機，以及留在家中的飛手。
飛手在飛行時絕不會受到傷害。無人機是世界的一部分：生物會追它，爆炸、岩漿與火焰會摧毀它，
水會減慢它的速度，而且它會觸發壓力板與絆線。
無人機音效：分層馬達音效，會跟隨每顆馬達的 RPM，外加風聲、翻滾與墜毀聲。每個音效都是從零
合成而成。
引擎無關核心：飛行模型是一個獨立的 C++ 函式庫，具備純 C API（fpvcore），因此其他遊戲也能使用它。

安裝

安裝 Fabric Loader，適用於 Minecraft 1.21.1，並下載 Fabric API。
從 Releases 頁面下載 fpvcraft-<version>.jar。同一個 jar 可在 Windows 與 Linux（x86_64）上運作。
將兩個 jar 放入你的 mods/ 資料夾（或在 Prism、XMCL 等中將它們加入 Fabric 1.21.1 實例）。
若要在多人遊戲中使用，請在伺服器與每個用戶端上安裝此模組。

飛行

按鍵	動作
`G`	起飛無人機並進入 FPV。再按一次即可降落並返回你的身體
`K`	控制器設定與校正
`F5`	循環切換攝影機：FPV、追尾、前視
`H`	在你面前重置無人機
`,`	下一個無人機預設
鍵盤	`W/S` 油門、`A/D` 偏航、方向鍵俯仰/橫滾、`Z` 解鎖、`X` 飛行模式

將油門完全拉到最低後解鎖，然後提高油門（懸停點就在搖桿置中略下方）。指令：/fpv preset、/fpv rates、
/fpv fov、/fpv uptilt、/fpv battery，以及更多。請參閱 docs/MINECRAFT.md。

遙控器設定： 將你的遙控器 USB 模式設為 Joystick (HID)，在啟動 Minecraft 前插上，按 K 並執行精靈。
如果 Steam 正在執行，請停用遙控器的 Steam Input。否則 Steam 會將搖桿變成滑鼠與鍵盤。

從原始碼建置

需要 C++17 編譯器、CMake、podman（用於可攜式 Linux 函式庫）與 JDK 21。請參閱 docs/BUILDING.md。

cmake -S . -B build && cmake --build build -j8 && ctest --test-dir build    # library + tests
cd adapters/minecraft-fabric && ./scripts/build-native.sh && ./gradlew build # mod jar

文件

docs/MINECRAFT.md：模組架構、控制、多人遊戲設計與測試矩陣
docs/FLIGHT_MODEL.md：物理模型
docs/LIBRARY.md 與 docs/API.md：在你自己的遊戲中使用 fpvcore
docs/AUDIO.md：音效如何合成
docs/LEGAL.md：授權、所有內容的來源、商標

授權

程式碼：MIT。音效：CC0。第三方聲明：NOTICE。詳細資訊：docs/LEGAL.md。

FPVcraft 是一個非官方粉絲專案。它不是官方 Minecraft 產品，也未經 Mojang 或 Microsoft 核准或與其相關。

授權與來源聲明

原始 README 與翻譯沿用 MIT 授權；本次修改為繁中翻譯、連結與排版調整。可修改的 Markdown、原始 README、LICENSE 與 NOTICE 收錄於頂部文件包。原作遊戲內容與商標不因此獲得授權。

LICENSE

MIT License

Copyright (c) 2026 FPVcraft contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

NOTICE

FPVcraft / fpv-core: code is MIT (LICENSE); bundled sounds are CC0 (adapters/minecraft-fabric/src/main/resources/assets/fpvcore/CREDITS.txt).

Third-party components:
  third_party/nlohmann/json.hpp   JSON for Modern C++ 3.11.3, MIT (third_party/nlohmann/LICENSE.MIT)
  third_party/doctest/doctest.h   doctest, MIT (third_party/doctest/LICENSE.txt)
  adapters/minecraft-fabric/gradle/wrapper, gradlew, gradlew.bat   Gradle wrapper, Apache License 2.0

Minecraft is a trademark of Mojang AB. This project is not affiliated with or endorsed by Mojang or Microsoft.