Wallbycontact/java-mod-rust-port-tool

选用指南

AI 根据 README 整理 · 2026/11/5 16:17:34

适用场景

适用于将 Fabric 或 NeoForge 的 Java 版 Minecraft 模组转换为 Rust 版 Minecraft（Horizon）模组，转换结果会标记未完成部分。

查看 README 依据

<img src="assets/smelt.gif" alt="A .jar is dragged into Smelt, turns into a Rust mod in a few seconds and is added to Horizon with one click" width="880"> </p> Smelt turns a Fabric or NeoForge mod into a mod for **Minecraft on Rust**: [Horizon](https://github.com/horizon-rust/horizon), the open-source rewrite of Minecraft: Java Edition 26.3. Java mods don't run there. Smelt rewrites them so they do. Drop the `.jar` on the window, wait a few seconds, press **Add to Horizon**. That's the whole app. ## Download | System | File | | |---|---|---|

Every mod gets one of three verdicts: | Verdict | What it means | |---|---| | **Works** | Everything in the mod runs in Minecraft on Rust. | | **Partly** | Most of it runs. Smelt tells you which part doesn't, in one line. | | **Won't run** | The mod does something Minecraft on Rust can't load yet. Nothing gets installed. | What to expect, by kind of mod: | Kind of mod | Usually | |---|---| | Blocks, items, recipes, loot, textures | Works | | HUD overlays, keybinds, zoom, chat tweaks, minimaps | Works | | Settings screens and custom menus | Partly |

使用方式

可通过桌面应用拖拽 .jar 文件或选择文件，也可通过命令行使用，支持转换单个模组或整个文件夹。

查看 README 依据

| Windows 10 and 11 | [`java-mod-rust-port-tool.zip`](https://github.com/Ropesehypnotize/java-mod-rust-port-tool/releases/latest/download/java-mod-rust-port-tool.zip) | One zip. No installer, no admin rights | Unpack the whole folder and start `Main.exe`. No installer, no admin rights. `Main.exe` is code-signed, so Windows starts it without a warning. Keep `Smelt` next to it: they ship together. ## How to use 1. Open Smelt. 2. Drop a mod's `.jar` on the window, or press **Choose a file**. 3. Press **Add to Horizon**.

<img src="assets/cli.gif" alt="smelt converts a mod and checks a whole mods folder in PowerShell" width="820"> </p> ```bash smelt zoom.jar # convert one mod, add it to Horizon smelt check ./mods # verdicts only, nothing written smelt ./mods --out ./converted # convert a folder, don't install smelt zoom.jar --keep-project ./zoom # keep the generated Cargo project ``` | Option | What it does | |---|---| | `--out <dir>` | Write the `.hnmod` and `.hmod` files to a folder instead of Horizon |

部署要求

Windows 10/11 或 Linux，无需安装或管理员权限；从源码构建需要 Rust 1.85 或更高版本及 Tauri 前置条件。

查看 README 依据

<p align="center"> <img src="assets/banner.png" alt="Smelt. Drop a Java mod, get it back in Rust." width="100%"> </p> <p align="center"> <a href="#download"><img src="https://img.shields.io/badge/release-v1.1.21-e8834a?style=flat-square" alt="Release v1.1.21"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-7fd3ae?style=flat-square" alt="MIT license"></a> <img src="https://img.shields.io/badge/Windows%20%C2%B7%20Linux-portable-9fb6cc?style=flat-square" alt="Windows and Linux, portable">

| `--keep-project <dir>` | Keep the generated Cargo project for hand editing | | `--horizon <dir>` | Use a specific Horizon install | | `--plan <file.md>` | Write the port plan as a Markdown checklist | | `--json` | Machine-readable verdicts, for CI | ## Build from source You need Rust 1.85 or newer. The desktop app also needs the [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/) for your system. ```bash git clone https://github.com/Ropesehypnotize/java-mod-rust-port-tool.git cd smelt cargo build --release -p smelt-cli # the smelt command cargo test --workspace

已知限制

仅支持 Fabric 和 NeoForge，不支持旧版 Forge；着色器、渲染引擎和性能模组无法转换；转换后的模组仅适用于 Minecraft on Rust，不适用于 Java 版。

查看 README 依据

| Machines, pipes, new mob behaviour, world generation | Partly or won't run | | Shaders, rendering engines, performance mods | Won't run | Smelt doesn't guess. If a piece of a mod can't be rewritten safely, it's left out and the verdict says so. You never get a mod that loads and then breaks your world. ## How it works <p align="center"> <img src="assets/how-it-works.png" alt="mod.jar is read, rewritten in Rust and packed into a .hnmod for code and a .hmod for blocks and textures" width="100%"> </p>

<details> <summary><b>Will a converted mod work in normal Minecraft?</b></summary> No. It's made for Minecraft on Rust only. Keep the original `.jar` for Java Edition. </details> <details> <summary><b>Is it safe?</b></summary> Smelt works offline and never uploads your mods. Mods with code run unsandboxed in Horizon, so Horizon asks you to trust each one. Only convert mods you would trust on Java Edition too. </details> <details> <summary><b>Can I share a mod I converted?</b></summary> Check the original mod's license first. A converted mod is still its author's work. </details>

<details> <summary><b>My mod says "Won't run". What now?</b></summary> Usually it changes how the game draws or depends on parts of Java Minecraft that Minecraft on Rust doesn't have yet. Try again after Smelt or Horizon updates. If you think the verdict is wrong, open an issue and attach `smelt check <mod>.jar --json`. </details> <details> <summary><b>Does it handle Forge or Quilt mods?</b></summary> NeoForge and Fabric today. Quilt mods that only use the Fabric API usually work. Older Forge mods aren't supported. </details> ## License