# Universe Journey

## 中文

`UniverseJourney` 是一个以高强度后期成长为核心的 Fabric 模组，围绕 **Supreme** 与 **Universe** 两条内容线展开。

本模组包含自定义装备、维度、Boss 实体与进阶玩法机制，为后期体验提供高阶功能性与战斗能力。

---

## 🎮 玩家指南

### 核心特色
* **Supreme 进阶线**：以功能性为主，包含 `Supreme Mobile`，以及 `Supreme Worktable`、`Reserver` 等专用方块。
* **Universe 进阶线**：力量巅峰路线，包含 `Universe Star`、`Omni Blade` 与完整的 `Universe` 护甲套装。
* **自定义维度**：探索 **Ore Continent** 与 **Harvest Continent**，以及 `Melon Jungle`、`Pumpkin Gorge` 等特色群系。
* **Boss 挑战**：迎战 `Universe Guardian`，或挑战多阶段的 `Skulk Behemoth`。

### 操作与机制
* **装备模式切换**：按 **`U`**（默认）可切换 Supreme Mobile、Universe Swords 与 Console 的模式。
* **Universe 靴子冲刺**：在 **潜行** 状态下，双击移动键（`W/A/S/D`）可进行高速冲刺。
* **远程交互**：
  * 使用 `Universe Console` 进行方块绑定与远程菜单访问。
  * `Supreme Mobile` 可识别兼容方块并远程打开虚拟 GUI。

### 运行需求
* **Minecraft**: `26.1`
* **Fabric Loader**: `>=0.19.1`
* **Fabric API**: `0.145.1+26.1`
* **Java**: `25`

---

## 🛠️ 开发者指南

> **[ !!! 重要 !!! ]**：本项目当前处于**个人活跃开发阶段**。为避免版本分叉与同步问题，除非绝对必要，请**不要 fork** 本项目。

### 技术概览
* **命名空间**：`universejourney`
* **入口点**：
  * Main: `roeyqian.universejourney.UniverseJourney`
  * Client: `roeyqian.universejourney.UniverseJourneyClient`
* **自定义配方类型**：
  * `universejourney:supreme_crafting`
  * `universejourney:universe_crafting`
  * `universejourney:universe_cooking`

### 构建说明
本项目使用 Java 25。构建前请确保本地环境已正确配置。

```powershell
# Build the project
.\gradlew.bat build
```
构建产物位于 `build/libs`。

---

## English

`UniverseJourney` is a Fabric mod focused on high-power progression, built around two content lines: **Supreme** and **Universe**.

The mod includes custom equipment, dimensions, boss entities, and advanced gameplay mechanics, expanding the late-game experience with high-tier utility and combat tools.

---

## 🎮 For Users

### Core Features
* **Supreme Progression**: Focuses on utility with the `Supreme Mobile` and specialized blocks like the `Supreme Worktable` and `Reserver`.
* **Universe Progression**: The pinnacle of power, featuring the `Universe Star`, `Omni Blade`, and the comprehensive `Universe` armor set.
* **Custom Dimensions**: Explore the **Ore Continent** and the **Harvest Continent**, featuring unique biomes like `Melon Jungle` and `Pumpkin Gorge`.
* **Boss Encounters**: Challenge the `Universe Guardian` or the multi-phase `Skulk Behemoth`.

### Controls & Mechanics
* **Equipment Mode Toggle**: Press **`U`** (default) to switch modes for the Supreme Mobile, Universe Swords, and Console.
* **Universe Boots Dash**: While **sneaking**, double-tap movement keys (`W/A/S/D`) to perform a high-speed dash.
* **Remote Interaction**:
  * Use the `Universe Console` for block binding and remote menu access.
  * The `Supreme Mobile` can identify compatible blocks and open virtual GUIs remotely.

### Requirements
* **Minecraft**: `26.1`
* **Fabric Loader**: `>=0.19.1`
* **Fabric API**: `0.145.1+26.1`
* **Java**: `25`

---

## 🛠️ For Developers

> **[ !!! IMPORTANT !!! ]**: This project is currently under **active personal development**. To avoid version fragmentation and sync issues, please **do not fork** this project unless absolutely necessary.

### Technical Overview
* **Namespace**: `universejourney`
* **Entrypoints**:
  * Main: `roeyqian.universejourney.UniverseJourney`
  * Client: `roeyqian.universejourney.UniverseJourneyClient`
* **Custom Recipe Types**:
  * `universejourney:supreme_crafting`
  * `universejourney:universe_crafting`
  * `universejourney:universe_cooking`

### Build Instructions
The project uses Java 25. Ensure your environment is configured correctly before building.

```powershell
# Build the project
.\gradlew.bat build
```
Build artifacts can be found in `build/libs`.