一款 Minecraft 1.20.4 小型冒险拓展模组，同时提供 Forge 与 Fabric 两个加载器版本，
功能完全一致。模组 ID 均为 starrealm。
├── StarRealm/ # Forge 版（官方映射）
├── StarRealmFabric/ # Fabric 版（Yarn 映射 + Fabric API）
├── README.md # 项目总览（本文件）
└── LICENSE # MIT 许可证
原版后期冒险内容匮乏：钻石工具毕业后缺少新目标、战斗缺少惊喜、收集玩法单调。 本模组用一条完整的「挖矿 → 冶炼 → 铸器 → 战斗 → 烹饪」主线解决这个问题：
- 主世界地下埋藏会发光的星辉矿石，为目标各出一个可辨识的新资源。
- 通过冶炼把矿物转化为工具材料，形成完整材料进阶链。
- 三把特效武器（召雷之刃、强击战锤、高速星辉镐）让战斗与挖掘获得全新体验。
- 用星运曲奇提供随机的祝福彩蛋，给日常探险增加惊喜。
| 物品 | 获取方式 | 特性 |
|---|---|---|
| 星辉矿石 | 主世界 Y=-32 ~ 16 随机生成，每区块约 4 簇、每簇最大 6 块，昼夜恒定发光 | 需钻石镐以上采掘 |
| 星尘 | 开采星辉矿获得（2~4 个，受时运加成） | 烧炼成星辉锭 |
| 星辉锭 | 星尘烧炼获得（1 星尘 = 1 锭，100 刻，经验 0.8） | 合成全部星辉工具与曲奇 |
| 星辉之刃 | 2 星辉锭 + 1 木棍 | 攻击伤害 8、攻速 1.6；击中敌人 18% 概率召唤闪电 |
| 星辉镐 | 3 星辉锭 + 2 木棍 | 挖掘速度 9.0、耐久 1500、钻石级采掘等级 |
| 星辉战锤 | 4 星辉锭 + 2 木棍 | 攻击伤害 9、攻速极慢；命中附加 5 秒缓慢 II，25% 概率附加 5 秒虚弱 |
| 星运曲奇 | 2 小麦 + 1 星尘 = 2 块 | 食用随机获得祝福：速度 20s(35%) / 回复 10s(25%) / 力量 20s(15%) / 幸运 60s(60%) |
所有物品集中在创造模式物品栏「星辉域 StarRealm」标签页。
Realm 生成规则：星辉矿替换石头与深层板岩，均匀分布于 Y=-32~16，不受空气暴露影响。
Forge 版
- 安装 Minecraft 1.20.4 与 Forge 49.0.x（官方安装器）。
- 将
StarRealm/release/starrealm-0.1.0.jar放入.minecraft/mods/。
Fabric 版
- 安装 Minecraft 1.20.4 及 Fabric Loader 0.15.11+。
- 将
StarRealmFabric/release/starrealm-0.1.0.jar与 Fabric API（1.20.4 版） 一起放入.minecraft/mods/。
均要求 Java 17 或更高版本。
前置：JDK 17、可访问外网（需下载 Minecraft / Forge / Fabric 依赖）。
cd StarRealm\ & gradle build :: 产物 build/libs/starrealm-0.1.0.jar
cd StarRealmFabric\ & gradle build :: 产物 build/libs/starrealm-0.1.0.jar（需 Gradle 8.7+）- JDK 17 工具链：若 Gradle 无法自动下载，请在本机用户级配置
%USERPROFILE%\.gradle\gradle.properties中加入org.gradle.java.installations.paths=<JDK17 所在目录>（该配置属本机私有，不随项目发布）。 gradlew.bat可用，但 wrapper 需从services.gradle.org下载发行包，若网络受限请改用本地 Gradle。
生存主流程
- 深入地下（Y=-32 ~ 16）寻找发光的星辉矿石，用钻石镐以上采掘获得星尘。
- 冶炼：把星尘放入熔炉，得到星辉锭。
- 合成：按上表配方造出星辉之刃/星辉镐/星辉战锤。
- 战斗：手持武器左击敌人触发特效（闪电/缓慢+虚弱）。
- 烹饪：2 小麦 + 1 星尘做出 2 块星运曲奇，右键食用触发随机祝福。
备注
- 挖矿推荐带时运附魔：星尘产量增加（
uniform_bonus_count每级 +1）。 - 想要矿块收藏，用精准采集镐子，直接掉落矿石本体。
- 曲奇祝福含幸运（60 秒）——适合打怪前吃一块。
| 输入（玩家操作） | 输出（结果） |
|---|---|
| 用钻石镐开采星辉矿石 | 掉落 2~4 个星尘（时运 III 时最多 7 个）；无任何附魔时同 |
| 用精准采集附魔的镐开采星辉矿石 | 掉落 1 个星辉矿石本体 |
| 将 1 个星尘放入熔炉 | 1 个星辉锭 + 0.8 经验（熔炼 100 刻，约 5 秒） |
| 2 星辉锭 + 1 木棍（剑形状） | 星辉之刃 |
| 3 星辉锭 + 2 木棍（镐形状） | 星辉镐（耐久 1500、挖掘速度 9.0） |
| 4 星辉锭 + 2 木棍（SSS/SWS 形） | 星辉战锤 |
| 2 小麦 + 1 星尘（无序合成） | 星运曲奇 × 2 |
| 用星辉之刃击杀敌人 | 每次命中 18% 概率向被击中处落下雷电 |
| 用星辉战锤击中敌人 | 命中即附加缓慢 II（5 秒）；25% 概率再追加虚弱（5 秒） |
| 食用星运曲奇 | 随机获得：速度Ⅱ 20 秒（35%）/ 回复 10 秒（25%）/ 力量 20 秒（15%）/ 幸运 60 秒（60%） |
| 打开创造模式物品栏 | 「星辉域 StarRealm」标签页中一次性查看全部 8 个物品 |
gradle build |
生成可直接放入 mods 文件夹的 starrealm-0.1.0.jar |
- Fabric 版提示缺依赖？ 确认 mods 文件夹内同时安装了 Fabric API 与 Fabric Loader ≥ 0.15.11。
- Forge/Fabric 两个 jar 能同时放入 mods 吗？ 可以，两者互不冲突。
- 为什么挖不掉？ 星辉矿需要钻石镐或更高等级才能采掘。
- Loom 报“Mod was built with a newer version of Loom”：fabric-api 0.97.x 需 fabric-loom 1.6.5+，请升级 Gradle 与 Loom 版本。
MIT License。详细见各子项目 README。