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

來源維護者： PeytonWDYM · 版本： a4a71bc2fb3c · 整理日期： 2026-10-12

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

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

GarryCraft

在 Garry’s Mod 中運行 Minecraft 遊戲玩法。Minecraft 負責處理移動、方塊、物品欄和生物。Garry’s Mod 提供地圖、道具、NPC 和渲染。

README 圖片：Minecraft 玩家在 Garry’s Mod 海灘上空使用鞘翅

安裝 V1

需要 Windows x64 和 64 位元 Garry’s Mod。僅限單人遊戲。
擁有 Garry’s Mod 和 Minecraft Java Edition。安裝程式會下載 Minecraft Java 26.3、Fabric 和私有的 Java 25 執行階段。
您不需要建置工具、獨立的 Java 安裝或 PowerShell 7。

在 Steam 中，選擇 Garry’s Mod > 內容 > Betas > x86-64。
等待更新完成，然後關閉 Garry’s Mod。
從最新版本下載 GarryCraft-1.0.4-windows-x64.zip。請使用此資產，而非原始碼封存檔。
解壓縮整個 ZIP 並開啟 Install.cmd。
開啟列印出的 Play.cmd 路徑，然後選擇 Sandbox > gm_construct > Single Player。

安裝程式會在您的 Steam 媒體庫中找到 Garry’s Mod 並安裝 GarryCraft。
如果被詢問遊戲資料夾，請使用 Steam 的 內容 > 已安裝檔案 > 瀏覽 並貼上該路徑。

Minecraft 會在 %LOCALAPPDATA%\GarryCraft\player 取得自己的安裝和必要的模組。
您現有的 Minecraft 安裝會保持獨立。您啟用的 GMod 附加元件會照常載入。

如果您的 GMod 引擎組建不受支援，安裝程式會停止。Steam 更新可能需要新的 GarryCraft 版本。
請參閱安裝說明以取得修正、日誌和手動安裝方式。

開啟 Play.cmd 以開始 GarryCraft 工作階段。當您載入單人地圖時，Minecraft 會啟動。
透過 Steam 啟動 GMod 以進行一般遊玩。GarryCraft 的橋接程式碼和原生模組在該工作階段中會保持非作用中。
每個 GarryCraft 地圖會保留獨立的 Minecraft 世界。
使用 生成選單 > 公用程式 > GarryCraft，或 garrycraft_menu，來啟用或停用橋接。

開啟 Uninstall.cmd 以移除 GarryCraft。它預設會保留世界和設定。
使用 Uninstall.cmd -Purge 進行完整重設，包括那些世界和設定。

從原始碼簽出時，Install.cmd 會自動下載並執行相符的已編譯發行版安裝程式。
如果 release 包含相符的 ZIP 和校驗碼，安裝程式會驗證並使用該本機套件。

目前限制

V1 的目標是本機 Windows x64 Sandbox 遊玩。其他地圖、遊戲模式和附加元件需要個別的相容性測試。
物理和渲染有已知限制。Source 光照不會重現 Minecraft 光照。
在回報相容性或完整物理一致性之前，請閱讀功能涵蓋範圍和架構。

開發

請閱讀 AGENTS.md 以取得貢獻者和編碼代理的指示。
開發需要 JDK 25、PowerShell 7、Visual Studio 2022 C++ 工具和 CMake。
使用帶有 .garrycraft-lab 標記的獨立 GMod 安裝。

.\tools\Build.ps1
.\tools\Setup-Lab.ps1 -LabPath "$env:LOCALAPPDATA\GarryCraft\gmod-lab"

將產生的遊戲檔案、帳號資料、日誌和測試世界保留在受追蹤原始碼之外。
請參閱發行封裝和安裝程式情境。

橋接建構於 SkyCraft。
協定 · 變更記錄 · 第三方聲明

授權與來源聲明

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

LICENSE

MIT License

Copyright (c) 2026 Peyton

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.

THIRD_PARTY_NOTICES

# Third-party notices

## SkyCraft

The collision, input, camera, water, combat, and renderer capture ports derive from chasmlol/SkyCraft.
https://github.com/chasmlol/SkyCraft

MIT License

Copyright (c) 2026 chasmlol

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.


## garrysmod_common

The native build uses danielga/garrysmod_common headers.
https://github.com/danielga/garrysmod_common

garrysmod_common
A repository of common bits for compilation projects based on Garry's
Mod.
-----------------------------------------------------------------------
Copyright (c) 2015-2023, Daniel Almeida
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


## Gradle wrapper

The Gradle wrapper uses the Apache License, Version 2.0.
https://github.com/gradle/gradle/blob/master/LICENSE

## Game assets

The physics gun uses model, material, and animation files from the user's installed Garry's Mod at runtime.
This repository does not distribute Valve game assets. Minecraft textures and player skins also remain local runtime data.
The Physics Gun inventory icon is an original project asset.

THIRD_PARTY_NOTICES.md

# Third-party notices

## SkyCraft

The collision, input, camera, water, combat, and renderer capture ports derive from chasmlol/SkyCraft.
https://github.com/chasmlol/SkyCraft

MIT License

Copyright (c) 2026 chasmlol

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.


## garrysmod_common

The native build uses danielga/garrysmod_common headers.
https://github.com/danielga/garrysmod_common

garrysmod_common
A repository of common bits for compilation projects based on Garry's
Mod.
-----------------------------------------------------------------------
Copyright (c) 2015-2023, Daniel Almeida
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


## Gradle wrapper

The Gradle wrapper uses the Apache License, Version 2.0.
https://github.com/gradle/gradle/blob/master/LICENSE

## Game assets

The physics gun uses model, material, and animation files from the user's installed Garry's Mod at runtime.
This repository does not distribute Valve game assets. Minecraft textures and player skins also remain local runtime data.
The Physics Gun inventory icon is an original project asset.