Starsand 岛屿 GUI 离线模组

此处提供包含源代码的最新版本
Python 源代码
第1步：设置你的游戏文件夹

• 点击 自动检测 自动查找您的Steam安装位置（如果不是Steam，请找到您的StarsandIsland.exe）
• 或点击 "浏览..." 手动选择位置 StarsandIsland.exe 位于
• 示例： C:\Program Files (x86)\Steam\steamapps\common\StarsandIsland
  

第2步：加载我的模组包或你的模组包 

• 点击 📂 浏览文件夹 从文件夹加载模组
• 点击 📦 浏览压缩包 从.zip文件中加载模组
• 或者简单点 点击拖放 将.zip文件或文件夹直接拖到模组列表中
  

第3步：安装模组

• 从列表中选择一个模组
• 点击 安装所选 （或双击该模组）
• 工具将自动备份原始文件并安装模组
• 状态将变为 ✓ 已安装
  

第4步：需要时卸载

• 选择一个已安装的模组
• 点击 卸载所选 （或再次双击它）
• 原始文件已自动从备份中恢复
• 状态恢复为 未安装
  

📝 Mod结构要求
要使MOD与此管理器兼容，其必须遵循以下结构：

你的模组名称/
└── local/
    ├── 1026/
    │ └── *.ab 文件
    ├── 1280/
    │ └── *.ab 文件
    └── 2049/
        └── *.ab 文件

• 模组必须包含一个 本地 文件夹
• 内部 本地, 应该会有编号文件夹（如1026、1280、2049等）
• 这些文件夹中包含 .ab (资源包) 用于修改游戏的文件
  

注意： 如果你的.zip文件多了一层文件夹（例如， ModName/ModName/local），该工具会自动修复结构。

🛠️ 包含附加工具
此包还包含 mod_hub.py, 一款高级资源浏览器和编辑器：

• 浏览资源包 — 探索游戏中所有的.ab文件
• 3D网格查看器 — 实时预览带纹理的3D模型
• 纹理查看器 — 查看并导出游戏纹理
• 导出资源 — 将网格导出为 .obj 文件，纹理导出为 .png
• 替换纹理 — 将你自己的纹理导入游戏中
• 替换网格 — 导入自定义 .obj 模型以替换游戏内网格
• 搜索与筛选 — 按名称或类型查找特定素材
  

⚠️重要注意事项

• 始终备份您的游戏文件 改装前（尽管此工具会自动处理）
• 该工具将在以下位置创建备份： Mod_Backups/ 文件夹
• 解压后的.zip文件将存储在 Mods_Extracted/ 文件夹
• 如果您手动删除游戏文件，请使用 卸载 按钮以恢复原始状态
• 可同时安装多个模组——工具会跟踪每个模组拥有哪些文件。
  

🐛 故障排除
Mod必须包含一个带有.ab文件的“local”文件夹

• 检查你的模组结构——它需要一个 本地 文件夹
• 确保.ab文件位于编号文件夹内（如1026、1280等）。
  

未找到游戏文件夹

• 点击“浏览...”并导航到相应位置 StarsandIsland.exe 位于
• 不要选择 本地 文件夹——选择游戏根目录