Repo ↗ · 原始 README ↗ · 文件包（Markdown／授權）

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

來源維護者： AvanindraPatil · 版本： 9392d0ffbe40 · 整理日期： 2026-10-12

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

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

Minecraft in Hello Neighbor

我們所喜愛的一切 Minecraft 內容，直接進到 Hello Neighbor 裡。
README 圖片：Screenshot (2855)

真正的 Minecraft 用戶端隱藏在背景執行。Hello Neighbor 顯示它渲染的內容，並告訴它牆壁在哪裡；Minecraft 告訴 Hello Neighbor 玩家在哪裡、以及他們做了什麼。這個想法來自
SkyCraft（Minecraft 在 Skyrim 裡）。

非官方粉絲專案。與 tinyBuild、Dynamic Pixels、Mojang 或 Microsoft 均無關聯。你需要自己的
Hello Neighbor 副本，以及一個擁有 Minecraft 的 Microsoft 帳戶；這裡不包含任何遊戲檔案。

可運作的功能

  • Minecraft 移動 在每一幕皆可運作：走路、疾走、潛行、鞘翅飛行、終界珍珠。
    Hello Neighbor 的牆壁、地板、家具、道具和玻璃對 Minecraft 而言都是實心的。
  • Minecraft 渲染：你的手和手持物品、快捷欄、愛心與飢餓值、第三人稱（F5）搭配 Minecraft
    玩家模型、你放置的方塊、生物、掉落物、粒子——全部繪製在 Hello Neighbor 的 3D 場景中。
  • 建造與破壞：在 Hello Neighbor 的表面上放置與挖掘方塊；水和岩漿在其地板上流動。
  • Hello Neighbor 本身的遊戲內容：門、開關、撿起與投擲它的物件、它的物品欄（以 Minecraft
    物品顯示）、梯子、躲在櫥櫃裡和床底下、被抓住、第三幕的「按空白鍵」逃脫。
  • 戰鬥：用 Minecraft 物品和箭矢攻擊鄰居，會將他擊倒，TNT 也差不多能將他擊倒，還能讓他稍微飛起來，派 Minecraft 生物攻擊他。攻擊
    會打破窗戶並撞飛物件。
  • 死亡：Minecraft 的死亡會保留你的物品欄，並將你放在 Hello Neighbor 該關卡自己的重生點。

需求

  • Windows 10 或 11
  • Steam 上的 Hello Neighbor
  • Minecraft: Java Edition（擁有 Minecraft 的 Microsoft 帳戶）
  • Prism Launcher（免費；它會為你設定好 Java 和 Fabric）

安裝

  1. 安裝 Prism Launcher，開啟它，用你的 Microsoft 帳戶登入，然後關閉它。
  2. 從 Releases 頁面下載 HelloCraft-<version>.zip，並解壓縮到任何位置。
  3. 執行 Install.bat。它會自行找到 Hello Neighbor（透過 Steam）和 Prism，將模組安裝到 Hello
    Neighbor，並為 Minecraft 部分新增一個 Prism 實例。如果 Hello Neighbor 正在執行，請先關閉它。

Windows 可能會警告指令碼來自網際網路：選擇 更多資訊 → 仍要執行。首次啟動會透過 Prism 下載
Minecraft 和 Java，因此需要幾分鐘。

安全性。 此模組沒有網路程式碼，也絕不會碰觸你的 Minecraft 登入資訊（由 Prism 處理）；它的 Minecraft
世界是私人的單人世界。它只會變更 Hello Neighbor 的資料夾（UE4SS、兩個模組、幾個小檔案）
並新增一個 Prism 實例；被取代的檔案會保留為 *.before-hnmc，而 Uninstall.bat 會移除全部。防毒
程式可能會警告，因為它會掛鉤遊戲的圖形，且 UE4SS 會以 dwmapi.dll 載入：原始碼在這裡。

遊玩

執行 Play.bat 並等待。Minecraft 會在背景隱藏啟動，然後 Hello Neighbor 開啟。載入一個關卡並
遊玩。讓 Play.bat 視窗保持開啟；當你關閉 Hello Neighbor 時，Minecraft 也會關閉。Uninstall.bat 會移除
模組。

你在聊天和死亡訊息中的名稱是你的 Minecraft 帳戶名稱；若要使用其他名稱，請在
實例的 config\hnmc.properties 中設定 playerName（請參閱 zip 中的 README.txt）。

控制

按鍵
滑鼠、W A S D、空白鍵、Shift、Ctrl、1-9、E、Q、F5、T、… Minecraft，如常
R（按住） Hello Neighbor：撿起／互動
G Hello Neighbor：使用手持物品
X Hello Neighbor：投擲手持物品
右鍵 開門、切換開關、開電視……（當準星對準時）
空白鍵 跳躍；也可推動能力和跳過過場動畫
F 同時傳送給 Minecraft 和 Hello Neighbor
Esc Hello Neighbor 的選單
F4 Minecraft 移動開／關（關 = 由 Hello Neighbor 移動玩家）
F6 在 Hello Neighbor 中再次顯示 Minecraft 的方塊（重新同步）
F9 記錄你前方格子中的方塊（用於錯誤回報）
/hnreset 移除你的方塊、生物和掉落物，並取回起始裝備

R / G / X 可以在 Minecraft 的控制設定中變更（類別「Hello Neighbor」）。它們會按下 Hello Neighbor
自身設定用於撿起、使用和投擲的按鍵，模組會從遊戲中讀取這些設定，因此兩者不必一致。

已知限制

  • 手持的 Hello Neighbor 物品仍會稍微落後於手，且大小不一。
  • 世界只有你周圍的區域是已知的：幾何會隨著你前進而掃描（大幅傳送後的一秒內，Hello Neighbor
    會固定玩家，同時掃描新區域）。
  • 你可能會直接掉進虛空，我建議按 f4 並從選單重新開始。然後在你落地後再次按 f4，以取回 Minecraft 角色。
  • 第一幕地下室追逐序列無法正常運作，你可能會卡在無限迴圈中。建議直接前往第二幕，並跳過第一幕地下室的
    最終追逐。
  • 終界珍珠有時會掉進虛空。
  • 鞘翅飛行可能會有點小問題
  • 最終幕頭目戰無法以 Minecraft 移動完成，你需要按 F4 讓 Hello Neighbor 移動玩家才能完成。

給開發者

若要從原始碼建置模組、修改它或了解它的運作方式，請參閱 docs/DEVELOPING.md 和
docs/ARCHITECTURE.md。

致謝與授權

  • SkyCraft（MIT）：整體做法；FrameExporter、InputBridge 和
    實體匯出皆改編自它（已在檔案中標註）。
  • MinHook（BSD-2-Clause），位於 native/third_party/minhook。
  • UE4SS、Fabric、fengari（測試）。

本專案自身的程式碼採用 MIT 授權。

授權與來源聲明

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

LICENSE

MIT License

Copyright (c) 2026 Gaming with ACK

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.