# Astralrail Cube

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

## Basic Information

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

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Minecraft

## README

# Astralrail Cube

Minecraft Forge Mod

## 简介

Astralrail Cube 是一个深受《崩坏：星穹铁道》启发的 Minecraft Forge MOD，为游戏添加了丰富的魔法系统、自定义实体、武器装备以及各种独特的游戏内容。

**注意**：本mod的设定世界观基于《崩坏：星穹铁道》（As stated in setting.md）

## 特性

### 🔮 魔法系统
- 多种自定义法术（Spell）
- 法术书与法杖系统
- 不同的魔法学派（Spell Schools）
- 强大的法术效果

### ⚔️ 武器与工具
- 预知系列工具（Prognostic Tools）- 带有特殊显示效果的锋利工具
- 平衡之剑（Balance）
- 各类魔法武器

### 🛡️ 装备
- 守护者套装（Preservation Armor）- 提供特殊保护效果
- 多功能饰品（Curios）

### 👑 Boss与实体
- **Seraphina（塞拉菲娜）** - 强大的Boss实体
- **次元斩（Dimensional Slash）** - Seraphina的其中一个技能，具有服务端伤害判定与客户端表现同步
- **AmberHammerEntity** - 琥珀之锤实体
- 各类自定义实体

### 🌌 次元斩渲染
- 世界空间多段斩击、领域圆环、粒子爆发与玻璃碎片~
- 屏幕破裂、折射扭曲、黑白冲击帧、泛光处理、镜头震动
- 独立的斩击、压迫、空间切割与玻璃破碎音效！
- 服务端统一处理伤害、判定、多人同步~
- 提供20项玩家配置参数，可调整主视觉、粒子、屏幕效果与音量...

### 🎨 渲染效果
- 自定义着色器（Shaders）
- 次元斩世界渲染（Dimensional Slash）
- 黑洞效果（Black Hole）
- 宇宙特效（Cosmic Effects）
- 错误/故障风格渲染（Glitch/Error Effects）
- 自定义字体渲染

### 🌍 世界生成
- **Celesticomet Ore（星弦矿石）** - 自定义矿物
- **The House of the Lost（失落的房屋）** - 自定义结构

### ⚙️ 功能方块
- **黑洞方块（BlackHoleBlock）** - 吸引效果
- **路径升华方块（PathAscensionBlock）** - 合成系统

## 依赖

本mod需要以下前置mod：

- [Minecraft Forge](https://files.minecraftforge.net/)
- [Iron's Spells And Spellbooks](https://www.curseforge.com/minecraft/mc-mods/irons-spells-and-spellbooks) - 魔法系统
- [Curios](https://www.curseforge.com/minecraft/mc-mods/curios) - 饰品槽位
- [Jade/ WAILA](https://www.curseforge.com/minecraft/mc-mods/jade) - 信息显示（可选）
- [JEI](https://www.curseforge.com/minecraft/mc-mods/jei) - 合成表（可选）

**可选**：
- [Optifine](https://www.optifine.net/) - 提供更好的着色器支持

## 安装

1. 安装 Minecraft Forge
2. 安装所有依赖mod
3. 下载本mod并放入 `mods` 文件夹
4. 启动游戏

## 配置

配置文件位置：
原来是`./config/astralrail_cube/`

现在：
- `./config/astralrail_cube-client.toml` - 客户端视觉与音频设置
- `./config/astralrail_cube-common.toml` - 通用游戏设置

### 客户端配置
- 黑洞渲染参数
- 琥珀锤渲染颜色
- 粒子效果开关
- 后处理效果设置
- 次元斩渲染与音频参数

### 次元斩配置
- 玩家可以在Minecraft的模组配置页面中直接调整20项参数
- 客户端设置只影响本地视觉与音频，不会改变服务端伤害判定和顺序
- 开发者可以在 `SlashTuning.DeveloperDefaults` 中调整20项默认值，并在 `SlashPreset` 中维护高级渲染预设

### 服务器配置
- 琥珀锤伤害值
- 治疗值
- 技能伤害加成

## 命令

本mod提供以下命令（需要OP权限）：

- `/astralrail_rail` - 主命令
- 调试相关命令
- 实体操作命令

## 开发

### 技术栈
- Java 17+
- Kotlin
- Minecraft Forge 1.20.1
- Mixin
- 自定义CoreMod

### 项目结构
```
src/main/java/seraphina/astralrail_cube/
├── client/           # 客户端渲染相关
├── common/           # 通用代码（物品、方块、实体等）
├── mixins/           # Mixin注入
├── network/          # 网络包处理
├── sercive/          # 核心服务
└── util/             # 工具类
```

### 次元斩相关目录
- `client/render/dimensional/` - 客户端渲染、屏幕特效、镜头与音频
- `client/particle/dimensional/` - 次元斩的专属粒子
- `common/skill/dimensional/` - 服务端技能、伤害判定与顺序
- `client/render/dimensional/config/` - 玩家配置适配与开发者预设

## 次元斩来源与授权

次元斩系统的移植来源信息请参阅 [NOTICE.md](./NOTICE.md)

音频的来源信息请参阅 [DIMENSIONAL_SLASH_SOUND_CREDITS.md](./src/main/resources/assets/astralrail_cube/sounds/DIMENSIONAL_SLASH_SOUND_CREDITS.md)

## 许可证
本项目仅供学习交流使用。