# Astralrail Cube

**Repository Path**: daichangs_mc/astralrail-cube

## Basic Information

- **Project Name**: Astralrail Cube
- **Description**: 星轨立方
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Minecraft

## README



# 星轨立方

## 简介

AstralRail Cube (astralrail_cube) 是一个基于《崩坏：星穹铁道》(Honkai: Star Rail) 世界观的 Minecraft Forge 模组。本模组为游戏添加了来自「星穹铁道」的角色能力、武器、装甲、法术以及独特的游戏机制，旨在将「星穹铁道」的战斗与探索体验带入 Minecraft 世界。

### 核心特性

*   **「存护」与「巡猎」装备**：
    *   **存护套装 (Preservation Armor)**：提供强力减伤和生命恢复效果的装甲套装的完整部件。
    *   **预演工具 (Prognostic Tools)**：包含剑、镐、斧、锄、铲在内的特殊工具。装备后会根据使用次数或攻击次数触发特殊效果，并显示独特的耐久条样式。
    *   **「开拓」法术 (Trailblazer Arcana)**：基于 **Irons Spellbooks** 框架的独特魔法学派，包含 Karma Smite（业债闪击）、Health Back（生命归还）、Lethal Beam（致命光束）等强大法术。
*   **独特的合成与工艺**：
    *   **明托淬炼 (Path Transmuter)**：一种全新的特殊工作台，允许玩家通过「转置」改变物品的属性或形态（配方可通过 JEI 查看）。
*   **独特维度**：
    *   **存在的地平线 (Horizon of Existence)**：一个专属的自定义维度。
*   **视觉特效**：
    *   **宇宙渲染 (Cosmic Rendering)**：为特定物品（如「永恒」系列道具）提供流动的、色彩斑斓的粒子特效和自定义字体渲染。

## 依赖

本模组需要以下环境才能运行：

*   **Minecraft**: `1.20.1`
*   **Minecraft Forge**: `1.20.1-47.4.16` 或更高版本
*   **Irons Spellbooks** (必需): 用于支持模组的法术系统。
*   **Curios** (必需): 用于支持饰品栏位（如佩戴「Trailblaze Lens」）。
*   **JEI** (推荐): 用于浏览「Path Transmuter」的合成配方。

## 安装指南

1.  确保你已安装 **Minecraft 1.20.1** 以及对应版本的 **Forge**。
2.  下载并安装前置模组 **Irons Spellbooks** 和 **Curios**。
3.  从 releases 页面下载本模组的最新版本 JAR 文件。
4.  将 JAR 文件放入 `.minecraft/mods` 文件夹中。
5.  启动游戏，在模组列表中确认 `Astralrail Cube` 已加载。

## 物品与配方

### 工具与武器
*   **预言剑 (Prognostic Sword)**: 具有高攻速和「巡猎」特性的近战武器，支持格挡(Partial Blocking)机制。
*   **预言镐 (Prognostic Pickaxe)**: 快速采掘工具。
*   **其他工具**: 预言斧、预言锄、预言铲。

### 魔法物品
*   **开拓透镜 (Trailblaze Lens)**: 一个强大的饰品，赋予持有者使用「开拓」学派法术的能力。
*   **法术卷轴**: 包含各种功能性的魔法卷轴。

### 资源
*   **路径水晶 (Path Crystal)** & **路径工具胚胎 (Path Tool Embryo)**: 用于在路径转置器中制作和升级工具的核心材料。

## 杂项与配置

*   **配置**: 模组配置位于 `config/astralrail_cube-common.toml` (通用配置) 及相关文件。
*   **命令**: 模组包含管理员命令 `/ac`，用于调试实体状态（如同步 Boss 血量）。
*   **兼容性**: 包含针对 `OmniMob` (OmniHealth) 的兼容性修补，以确保 Seraphina 等 Boss 的血量显示正常。

## 致谢

*   **Honkai: Star Rail**: 提供了绝妙的美术设计和世界观。
*   **Irons Spellbooks**: 提供了强大且灵活的法术 API。
*   **Minecraft Forge 社区**: 提供了优秀的开发工具。

---

**模组版本**: 1.0.0  
**支持语言**: 英文 (en_us), 中文 (zh_cn)