# dodge_the_creeps **Repository Path**: lsy_admin/dodge_the_creeps ## Basic Information - **Project Name**: dodge_the_creeps - **Description**: 躲避怪物游戏 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-17 - **Last Updated**: 2026-07-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Dodge the Creeps - Godot 游戏项目 ## 项目概述 Dodge the Creeps 是一款使用 Godot 引擎开发的休闲躲避类游戏。玩家需要控制角色躲避不断涌现的敌人（Creeps），在有限的游戏空间中尽可能生存更长时间以获得更高的分数。游戏采用经典的街机玩法，配合多种类型的敌人和流畅的动画效果，为玩家带来紧张刺激的游戏体验。 本项目是一个完整的 Godot 4.x 游戏项目，包含所有必要的场景、脚本、美术资源和配置文件，可以直接在 Godot 编辑器中打开运行。项目结构清晰，代码注释完善，非常适合作为学习 Godot 游戏开发的参考案例。 ## 游戏特色 本游戏具有以下主要特色：首先是多样化的敌人类型，游戏设计了三种不同运动轨迹的敌人，包括飞行敌人、游泳敌人和步行敌人，每种敌人都有独特的移动模式和外观设计；其次是流畅的角色动画，玩家角色配备了向上移动和行走两种状态的动画贴图，使游戏画面更加生动自然；此外还有完善的界面系统，游戏包含 HUD（平视显示器）用于显示分数等关键信息，以及游戏结束时的音效反馈；最后是专业的音频配置，游戏配备了循环播放的背景音乐和游戏结束音效，营造出沉浸式的游戏氛围。 ## 技术架构 本项目基于 Godot 4.x 游戏引擎开发，采用 GDScript 作为主要脚本语言。项目遵循 Godot 引擎的最佳实践，使用节点式（Node-based）架构来组织游戏逻辑。 游戏的核心架构包含以下主要部分：Player（玩家节点）继承自 CharacterBody2D，负责处理玩家角色的移动控制、碰撞检测和动画状态管理；Mob（敌人节点）同样继承自 CharacterBody2D，用于实例化各种类型的敌人并控制其自动移动行为；Main（主场景节点）作为游戏的入口场景，负责管理游戏流程、生成敌人和处理游戏状态；HUD（界面节点）则负责显示分数、开始界面和游戏结束界面等 UI 元素。 ## 项目结构 ``` dodge_the_creeps/ ├── art/ # 美术资源目录 │ ├── House In a Forest Loop.ogg # 背景音乐循环 │ ├── enemyFlyingAlt_1.png # 飞行敌人贴图1 │ ├── enemyFlyingAlt_2.png # 飞行敌人贴图2 │ ├── enemySwimming_1.png # 游泳敌人贴图1 │ ├── enemySwimming_2.png # 游泳敌人贴图2 │ ├── enemyWalking_1.png # 步行敌人贴图1 │ ├── enemyWalking_2.png # 步行敌人贴图2 │ ├── gameover.wav # 游戏结束音效 │ ├── playerGrey_up1.png # 玩家向上移动贴图1 │ ├── playerGrey_up2.png # 玩家向上移动贴图2 │ ├── playerGrey_walk1.png # 玩家行走贴图1 │ └── playerGrey_walk2.png # 玩家行走贴图2 ├── fonts/ # 字体资源目录 │ ├── FONTLOG.txt # 字体变更日志 │ ├── LICENSE.txt # 字体许可证 │ └── Xolonium-Regular.ttf # Xolonium 字体文件 ├── hud.gd # HUD 界面脚本 ├── hud.tscn # HUD 场景文件 ├── main.gd # 主游戏逻辑脚本 ├── main.tscn # 主场景文件 ├── mob.gd # 敌人逻辑脚本 ├── mob.tscn # 敌人场景文件 ├── player.gd # 玩家控制脚本 ├── player.tscn # 玩家场景文件 ├── project.godot # Godot 项目配置文件 ├── .editorconfig # 编辑器配置 ├── .gitattributes # Git 属性配置 ├── .gitignore # Git 忽略配置 └── icon.svg # 项目图标 ``` ## 快速开始 ### 环境要求 在运行本项目之前，您需要准备以下开发环境：首先需要安装 Godot Engine 4.x 版本，建议使用最新的稳定版本以获得最佳兼容性；其次需要安装 Git 版本控制工具，用于克隆和管理项目代码；最后建议配备支持 OpenGL ES 3.0 或更高版本的显卡，以确保游戏画面正常渲染。 ### 安装步骤 获取本项目的完整代码非常简单。如果您已经安装了 Git 工具，可以在终端或命令行中执行以下命令来克隆项目仓库：`git clone https://gitee.com/lsy_admin/dodge_the_creeps.git`。克隆完成后，使用 Godot 编辑器打开项目目录中的 project.godot 文件即可加载整个项目。 ### 运行游戏 在 Godot 编辑器中加载项目后，您可以直接按 F5 键或点击编辑器右上角的运行按钮来启动游戏。首次运行可能需要稍等片刻让引擎完成资源导入和编译工作。游戏启动后，您将看到游戏的主界面，可以按照屏幕提示开始游戏。 ## 游戏操作 玩家通过键盘方向键控制角色移动。当前的移动方向包括上、下、左、右四个基本方向。在游戏过程中，玩家需要不断躲避从屏幕边缘出现的敌人，尽可能长时间生存以获取更高的分数。如果不幸被敌人碰到，游戏将结束并显示最终得分。 ## 核心脚本说明 为了帮助开发者更好地理解和修改本项目，以下是各个核心脚本的功能说明。 Player（player.gd）脚本负责玩家的移动控制和碰撞检测。它处理键盘输入以确定移动方向，并根据移动状态播放相应的动画。脚本还负责检测与敌人的碰撞事件，当碰撞发生时触发游戏结束流程。 Mob（mob.gd）脚本控制敌人的行为。它定义了敌人从屏幕边缘向内移动的逻辑，包括确定移动方向和速度。在敌人移出屏幕边界后，脚本会自动释放该敌人实例以节省内存资源。 Main（main.gd）脚本是游戏的主控制器，负责管理游戏流程。它处理游戏开始、进行中、结束等状态的转换，控制敌人的生成时机和频率，并协调 HUD 显示正确的信息。 HUD（hud.gd）脚本管理游戏的用户界面，包括显示当前分数、显示开始提示、以及在游戏结束时显示最终得分等功能。 ## 资源定制 本项目支持开发者进行多方面的定制化修改。如果您想修改游戏外观，可以替换 art 目录中的贴图文件，但请注意保持贴图的尺寸和格式与原文件一致以确保正常显示。在音效方面，您可以替换游戏结束音效和背景音乐，建议使用 ogg 格式的音频文件以获得最佳兼容性。如果需要调整游戏难度，可以修改 main.gd 中敌人的生成频率、生成数量以及移动速度等参数。 字体文件位于 fonts 目录下，替换 Xolonium-Regular.ttf 即可更改游戏中使用的字体风格，请确保新字体文件的许可证允许商业使用。 ## 许可证 本项目的源代码采用 MIT 许可证开源，您可以自由使用、修改和分发本项目的代码。项目中使用的字体 Xolonium 遵循其自身的许可证协议，详情请参考 fonts/LICENSE.txt 文件。美术资源的具体许可证信息请查阅相关文件或咨询资源原始作者。 ## 贡献指南 我们欢迎社区开发者为本项目贡献代码和提出改进建议。如果您发现了任何问题或有功能建议，请在 Gitee 的 Issues 页面提交报告。如果您希望为项目添加新功能或修复问题，可以 Fork 本项目后进行修改，然后提交 Pull Request 请求合并。在提交代码前，请确保代码风格与项目现有代码保持一致，并添加适当的注释说明。 ## 联系方式 如有任何问题或建议，您可以通过以下方式联系项目维护者：通过 Gitee 平台提交 Issues 寻求帮助；在项目页面留言讨论相关问题；或者访问 Gitee 项目主页了解更多信息。 感谢您对 Dodge the Creeps 项目的关注！希望这个游戏能为您带来愉快的体验，也期待看到您在此基础上创作出更加精彩的作品。