Medieval Fantasy City Generator从零开始使用指南

Medieval Fantasy City Generator是一款开源的中世纪幻想城市生成工具，能够帮助开发者和创作者快速构建具有中世纪建筑风格和布局的虚拟城市，广泛应用于游戏开发、模拟环境构建等领域。本指南将以问题-解决方案的形式，为新手用户提供从环境配置到参数自定义的全方位操作指导。

环境配置步骤

安装必要依赖

1. 确保已安装Haxe开发环境，这是项目运行的基础
2. 打开终端，执行以下命令安装OpenFL和msignal库：

   haxelib install openfl
   haxelib install msignal
   

获取项目代码

1. 克隆项目仓库到本地：

   git clone https://gitcode.com/gh_mirrors/to/TownGeneratorOS
   

2. 进入项目目录：

   cd TownGeneratorOS
   

编译并运行项目

1. 在项目根目录下执行编译命令：

   haxe build.hx
   

2. 运行编译生成的可执行文件

💡 常见错误提示：

• 若提示"haxelib: command not found"，说明Haxe未正确安装或未添加到系统环境变量
• 编译失败时检查是否已安装所有必要依赖库
• 确保命令在项目根目录下执行

参数自定义技巧

找到配置文件

项目的核心配置文件位于Source/com/watabou/towngenerator/Main.hx，这里包含了城市生成的主要参数。

修改城市生成参数

1. 用文本编辑器打开Main.hx文件
2. 查找并修改以下关键参数：
   • 城市大小：调整citySize变量值
   • 建筑密度：修改buildingDensity参数
   • 道路宽度：调整roadWidth数值
3. 保存修改后重新编译项目

📌 进阶建议：

• 尝试修改Source/com/watabou/towngenerator/wards/目录下的各个区域生成逻辑
• 通过调整Source/com/watabou/geom/中的几何算法，可以改变城市的整体布局风格
• 修改Source/com/watabou/towngenerator/mapping/Palette.hx文件可以自定义城市的色彩方案

💡 常见错误提示：

• 修改参数后城市无法生成，可能是参数值超出合理范围
• 若编译时报错，检查是否修改了代码结构或语法
• 建议修改前备份原始配置文件，以便出现问题时恢复

编译错误解决方法

缺少依赖库错误

1. 仔细阅读错误提示，确定缺少的库名称
2. 使用haxelib安装缺失的库：

   haxelib install [缺失的库名称]
   

代码语法错误

1. 根据错误提示找到对应的文件和行号
2. 检查代码语法，特别注意Haxe语言的语法规范
3. 修正错误后重新编译

📌 进阶建议：

• 使用支持Haxe语法的IDE（如VS Code配合Haxe插件）可以提前发现语法错误
• 定期同步项目最新代码，以获取bug修复和功能更新
• 遇到复杂问题可查看项目中的LICENSE和README.md文件获取更多信息

💡 常见错误提示：

• "Class not found"错误通常表示缺少相关库或类文件
• "Syntax error"提示需要检查对应行的代码语法
• 编译超时可能是因为电脑性能不足或代码存在死循环逻辑

通过以上步骤，您可以顺利开始使用Medieval Fantasy City Generator创建独特的中世纪幻想城市。随着对项目的深入了解，您可以探索更多高级功能和自定义选项，创造出更加丰富多样的城市景观。