ISS Studio - 可视化游戏开发工具
ISS Studio 是一个专为 ISS (Interactive Story System) 框架设计的可视化游戏开发环境，旨在降低游戏开发的门槛，让开发者能够通过直观的界面快速创建游戏。
🎯 主要特性
📁 项目管理
- 项目创建向导 - 使用预设模板快速创建新项目
- 项目浏览器 - 树形结构浏览项目文件
- 最近项目 - 快速访问最近打开的项目
- 项目模板 - 内置多种游戏类型模板
✏️ 可视化编辑器
- 配置编辑器 - TOML 配置文件的可视化编辑
- 脚本编辑器 - Lua 脚本编辑，支持语法高亮和自动补全
- UI 设计器 - 拖拽式界面设计工具
- 战斗编辑器 - 可视化战斗流程设计
🎮 实时预览
- 游戏预览 - 实时预览游戏效果
- 热重载 - 修改配置后自动刷新预览
- 多种预览模式 - 游戏预览、UI 预览、配置预览
🛠️ 开发工具
- 资源管理器 - 管理游戏资源文件（图片、音频、脚本等）
- 属性面板 - 编辑选中对象的属性
- 调试控制台 - 实时查看日志和执行命令
- 配置验证 - 自动检测配置错误
🚀 快速开始
安装依赖
pip install PySide6 toml Pillow psutil send2trash jinja2 PyYAML
启动工具
cd tools/iss-studio
python run.py
创建第一个项目
- 点击 "新建项目" 按钮
- 选择项目模板（推荐从 "简单 RPG" 开始）
- 填写项目信息
- 选择保存位置
- 点击 "创建项目"
📖 使用指南
项目结构
创建的项目包含以下目录结构：
my-game/
├── game.toml # 主配置文件
├── configs/ # 配置文件目录
│ ├── player.toml # 玩家配置
│ ├── monsters.toml # 怪物配置
│ └── items.toml # 物品配置
├── scripts/ # Lua 脚本目录
│ ├── main.lua # 主脚本
│ ├── player.lua # 玩家逻辑
│ └── combat.lua # 战斗逻辑
├── assets/ # 资源文件目录
│ ├── images/ # 图片资源
│ ├── sounds/ # 音频资源
│ └── data/ # 数据文件
├── build/ # 构建输出目录
└── docs/ # 文档目录
编辑器使用
配置编辑器
- 文本模式 - 直接编辑 TOML 文本
- 可视化模式 - 通过表单编辑配置
- 分割视图 - 同时显示文本和可视化界面
- 语法验证 - 自动检查 TOML 语法错误
脚本编辑器
- 语法高亮 - Lua 语法高亮显示
- 自动补全 - ISS API 自动补全
- 函数列表 - 显示脚本中的所有函数
- 语法检查 - 基本的 Lua 语法检查
UI 设计器
- 组件工具箱 - 拖拽添加 UI 组件
- 属性面板 - 编辑组件属性
- 画布 - 可视化设计界面
- 预设布局 - 常用 UI 布局模板
战斗编辑器
- 流程设计 - 可视化设计战斗流程
- 节点系统 - 使用节点构建战斗逻辑
- 连接管理 - 管理节点之间的连接
- 预设流程 - 内置常用战斗模式
资源管理
导入资源
- 在资源管理器中点击 "导入资源"
- 选择要导入的文件
- 文件会自动复制到项目的 assets 目录
资源分类
- 图片 - PNG, JPG, GIF 等格式
- 音频 - MP3, WAV, OGG 等格式
- 脚本 - Lua, Python 等脚本文件
- 配置 - TOML, JSON, YAML 等配置文件
资源预览
- 选择资源文件可在预览面板中查看
- 支持图片预览、文本内容预览
- 显示文件详细信息（大小、修改时间等）
项目运行和构建
运行项目
- 点击工具栏的 "运行" 按钮
- 或使用快捷键 F5
- 项目将在 ISS 引擎中运行
构建项目
- 点击工具栏的 "构建" 按钮
- 或使用快捷键 Ctrl+B
- 生成可分发的游戏包
🎨 内置模板
简单 RPG
- 基础的角色扮演游戏框架
- 包含玩家、怪物、战斗系统
- 适合初学者学习
挂机 RPG
- 自动战斗的挂机类游戏
- 离线收益系统
- 升级和装备系统
回合制 RPG
- 经典回合制战斗
- 技能和道具系统
- 适合制作传统 JRPG
文字冒险
视觉小说
- 包含立绘和背景的视觉小说
- 分支剧情系统
- 多结局支持
卡牌游戏
- 基础卡牌游戏框架
- 卡牌系统和战斗逻辑
- 卡组构建功能
🔧 高级功能
自定义模板
- 在
resources/templates/ 目录下创建新模板
- 添加
template.toml 配置文件
- 重启工具即可在新建项目时使用
插件系统
主题定制
- 支持自定义 UI 主题
- 深色/浅色主题切换
- 自定义颜色方案
🐛 故障排除
常见问题
Q: 工具启动失败
A: 检查是否安装了所有依赖，运行 python run.py 查看详细错误信息
Q: 项目预览不工作
A: 确保 ISS 引擎已正确安装并在系统 PATH 中
Q: 文件保存失败
A: 检查文件权限，确保有写入权限
Q: 资源导入失败
A: 检查文件格式是否支持，文件是否损坏
获取帮助
- 查看控制台输出的错误信息
- 检查日志文件
~/.iss-studio/logs/iss_studio.log
- 在 GitHub 上提交 Issue
📝 更新日志
v1.0.0 (2024-01-01)
- 初始版本发布
- 基础项目管理功能
- 配置和脚本编辑器
- UI 设计器和战斗编辑器
- 资源管理器
- 实时预览功能
🤝 贡献
欢迎贡献代码、报告 Bug 或提出功能建议！
- Fork 项目
- 创建功能分支
- 提交更改
- 发起 Pull Request
📄 许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件
👥 开发团队
- ISS Framework Team
- 贡献者列表见 CONTRIBUTORS.md
让游戏开发变得简单而有趣！ 🎮✨