UltimateStack 开源项目安装与使用指南

UltimateStack 是一个为 Minecraft 设计的辅助模组，旨在提升玩家的游戏体验，通过允许高度定制化的物品堆叠大小，超越原版限制。以下是基于其 GitHub 仓库 PorPit/UltimateStack 编写的详细安装与使用说明。

1. 项目目录结构及介绍

UltimateStack 的项目目录遵循典型的 Minecraft 模组开发结构，大致结构如下：

UltimateStack/
├── src                           # 源代码目录
│   ├── main                      # 主要代码逻辑
│   │   └── java                  # Java 源码，存放模组的主要实现
│   │       └── com.example       # 示例包路径，实际替换为项目专属包路径
│   └── resources                 # 资源文件，包括纹理、语言文件等
│       └── assets                # 游戏内的资源，如模型、纹理
│           └── ultimatestack     # 项目特定资源
│               └── textures      # 模组特有的纹理
│               └── lang          # 多语言文件
├── .gitignore                    # Git 忽略文件列表
├── build.gradle                  # Gradle 构建脚本，用于编译和打包模组
└── LICENSE                       # 许可证文件

• src/main/java: 存储着模组的核心Java类，包括事件处理、物品定义、配置加载等功能。
• resources/assets: 存放模组的资产，如图片、语言文件，是模组界面、物品图标等的来源。
• build.gradle: Gradle构建文件，开发者通过该文件来配置编译选项、依赖项等。

2. 项目的启动文件介绍

对于 Minecraft 模组而言，并没有直接的“启动文件”，它的“启动”是指通过 Minecraft 游戏启动器载入游戏并激活模组。然而，若要从源码编译和测试模组，关键在于运行Gradle任务。使用命令行，进入项目根目录，执行 gradlew runClient 或者使用IDE（如IntelliJ IDEA或Eclipse）的对应插件来编译和启动带有模组的游戏环境。

3. 项目的配置文件介绍

UltimateStack 使用配置文件 config/UltimateStack/Setting.cfg 来让用户自定义堆叠大小和其他高级选项。主要配置部分包括：

- Setting.cfg                     # 核心配置文件
  - customore                      # 自定义矿物词典的堆叠大小
  - orelevelsetting               # 矿物词典优先级设置
  - orestackmaxsize               # 特定矿物词典堆叠大小
  - ItemMaxStackSize              # 单个物品的堆叠大小定制
  
  示例配置片段：
  
  ```properties
  customore {
    OreMaxStackSetting ...
  }
  
  orelevelsetting {
    I:alloyAdvanced=1
    ...
  }
  
  orestackmaxsize {
    I:alloyAdvanced=0
    ...
  }
  
  itemstackmaxsize {
    # 示例物品堆叠配置
    I:"examplemod:item_example"=128
    ...
  }

配置文件允许用户针对不同的物品和矿物词典细粒度控制堆叠上限，以此优化库存管理和自动化流程。

请注意，实际使用时，应根据模组的最新版本和文档调整配置细节。务必阅读GitHub仓库中的README.md或者最新发布的文档，以获得最准确的指导信息。