ludovic111/horizon

选用指南

AI 根据 README 整理 · 2026/10/25 05:36:06

适用场景

适合在 Linux、macOS 或 Windows 上玩 Minecraft 单人或多人游戏，支持原版世界生成、生物、红石、命令等，并可用资源包和数据包；提供服务器托管和 Mod 支持。

查看 README 依据

<td width="50%"><img src="docs/media/launcher-patch-notes.webp" alt="The launcher's Patch notes page"></td> </tr> </table> ## What works today The [documentation](https://playhorizon.dev/docs/) covers each of these. - **The game:** singleplayer with vanilla's world generation, mobs, villagers, raids, redstone, every command, the HUD and the recipe book, on saves in vanilla's format. Worlds from 1.8 to 26.2 are upgraded as vanilla does. [Status table](#project-status).

- **Playing with others:** invite friends from the pause menu's Friends button with a code, Open to LAN, and joining offline-mode servers. Horizon cannot sign in to a Microsoft account yet, so it cannot join servers that check accounts. See [Multiplayer](https://playhorizon.dev/docs/multiplayer). - **Mods:** Horizon has its own mod system (Rust compiled to WebAssembly). Java mod jars do not run. See [Mods and data packs](https://playhorizon.dev/docs/mods). Screenshots, captured in the Rust client itself with vanilla assets and no mods or shaders: <table> <tr>

The launcher's **Servers** page creates, starts, backs up and updates a Horizon server with buttons, and invites friends over Tailscale. On a VPS, `horizon-server` installs with one command and runs without Java. Guide: [Host a server](https://playhorizon.dev/docs/hosting) ([reference](docs/hosting.md)). ## Modpacks

使用方式

通过 Horizon 启动器安装和更新游戏，准备来自自有 Minecraft 副本的文件；另有 horizon-ctl 命令行工具可让 AI 代理或脚本操控游戏，并支持 MCP 服务。

查看 README 依据

Horizon is installed through **the Horizon launcher**. Get it from [playhorizon.dev](https://playhorizon.dev) (the Download button picks your system) or from [the launcher releases](https://github.com/ludovic111/horizon/releases?q=launcher-v&expanded=true), for Linux x86-64, macOS on Apple Silicon or Windows x64. The launcher installs and updates the game, prepares its files from your own copy of Minecraft, and updates itself.

AI agents and scripts can play Horizon. `horizon-ctl`, shipped beside the game in every release folder, is a command line that reads the game as JSON and acts like a player; `horizon-ctl mcp` serves the same commands as an MCP server (one tool per command, screenshots returned as images). ```sh horizon-ctl launch --world Survival --seed 5 --wait # finds the version the launcher installed horizon-ctl state # position, health, food, target, screen... horizon-ctl find-block birch_log # the nearest logs

部署要求

需要 Minecraft: Java Edition 26.3（已玩过一次）、Java 25 JDK 用于一次性准备，以及支持 Vulkan 的 GPU（Linux/Windows）或任意 Apple Silicon Mac；构建源码需 Rust 1.90+、Python 3.10+ 和 JDK 25。

查看 README 依据

**You need** Minecraft: Java Edition 26.3, played once (the official launcher, Prism, MultiMC and other launchers all work); a Java 25 JDK, for the one-time preparation; and a GPU with Vulkan on Linux and Windows, or any Apple Silicon Mac. Step by step, with macOS's first-open prompt and the first launch: [Install and first launch](https://playhorizon.dev/docs/install). <table> <tr> <td width="50%"><img src="docs/media/launcher-play.webp" alt="The launcher's Play page: a version ready to play, its summary, Client and Server, the version picker and Play"></td>

For developers. Requirements: Rust 1.90 or newer, Python 3.10 or newer, JDK 25, and on Linux the ALSA and udev development headers (`libasound2-dev libudev-dev` on Debian and Ubuntu). Development and the vanilla harnesses run on Linux. Horizon contains no game files and never downloads them. It builds its resources from **your own copy** of Minecraft: Java Edition 26.3, verified against the checksums in `research-lock.json`:

已知限制

尚不能登录微软账户，因此无法加入正版验证的服务器；皮肤若通过 https 提供且未缓存则显示默认皮肤；资源包图标在游戏中显示未知纹理；创造模式快捷键（C/X）和物品提示属性行缺失；Java 版 Mod 无法运行，仅支持自身 Mod 系统。

查看 README 依据

- **Playing with others:** invite friends from the pause menu's Friends button with a code, Open to LAN, and joining offline-mode servers. Horizon cannot sign in to a Microsoft account yet, so it cannot join servers that check accounts. See [Multiplayer](https://playhorizon.dev/docs/multiplayer). - **Mods:** Horizon has its own mod system (Rust compiled to WebAssembly). Java mod jars do not run. See [Mods and data packs](https://playhorizon.dev/docs/mods). Screenshots, captured in the Rust client itself with vanilla assets and no mods or shaders: <table> <tr>

Horizon can't sign in to a Microsoft account yet, so it can't join online-mode servers (it joins offline-mode ones); skins served over https show the default skin unless already cached; pack icons show the unknown-pack texture in game; the creative hotbar keys (C/X) aren't wired to the hotbar loader; item tooltips lack attribute lines. ## Licence