SuperAPI AI 工具集

project-templates

编程与开发

查看项目

更新于 10-16 22:43

技能介绍

用途

Project Templates 是一套面向 Godot 引擎的游戏项目模板与脚手架蓝图,按题材划分,用于快速启动原型开发。资料明确覆盖三种类型:2D 平台跳跃、俯视角 RPG 与 3D FPS。其核心思路是用题材专属的目录结构、AutoLoad 模式与模块化架构来支撑快速原型。

主要能力

目录结构模板

2D 平台跳跃模板目录包含:project.godot、autoloads(game_manager.gd、audio_manager.gd、scene_transitioner.gd)、scenes(main_menu、game、pause_menu)、entities(player 及其 player_states、enemies 及 base_enemy.gd、goblin)、levels(level_1、tilesets)、ui(hud、themes)、audio(music、sfx)、resources(data)。

俯视角 RPG 模板目录包含:autoloads(game_data.gd、dialogue_manager.gd、inventory_manager.gd)、entities(player、npcs、interactables)、maps(overworld、dungeons、interiors)、systems(combat、dialogue、quests、inventory)、ui(inventory_ui、dialogue_box、quest_log)、resources(items、quests、dialogues)。

3D FPS 模板目录包含:autoloads(game_manager.gd、weapon_manager.gd)、player(player.tscn、player.gd、camera_controller.gd、weapons(weapon_base.gd、pistol、rifle))、enemies(ai_controller.gd、soldier)、levels(level_1、level_2)、ui(hud、crosshair)、resources(weapons、pickups)。

核心脚本模板

game_manager.gd 是 AutoLoad 模板,负责游戏状态管理:暂停、场景切换、计分。提供 game_started、game_paused(paused)、level_completed 信号,以及 current_level、score、is_paused 状态变量,并包含 start_game、pause_game、complete_level 等方法。

inventory_manager.gd 是 RPG 模板中的物品栏系统,提供 item_added、item_removed 信号,维护 inventory 数组,并包含 add_item、remove_item、has_item 方法。

player.gd 是 3D FPS 玩家控制器,继承 CharacterBody3D,使用 speed、jump_velocity 导出变量,读取默认重力,在 _ready() 中设置 Input.MOUSE_MODE_CAPTURED,在 _physics_process 中处理重力、跳跃、基于 Input.get_vector 的移动方向与 move_and_slide。

输入映射模板

模板建议统一包含以下动作:move_left、move_right、move_up、move_down、jump、interact、pause、ui_accept、ui_cancel,并给出键盘与手柄按键的对应示例。

使用方式

资料给出的使用步骤为:

  1. 复制模板结构
  2. 在 project.godot 中重命名项目
  3. 注册 AutoLoad
  4. 配置 Input Map
  5. 开始开发

适用场景

适用于在 Godot 中启动新游戏原型时,需要按题材获得目录组织、核心系统脚本与输入配置起点的开发者。适合作为原型阶段的起点,而非直接发布用的成品结构。

限制与注意事项

资料以“NEVER”清单形式给出限制:不要硬编码场景路径(否则会带来重构噩梦),应使用 AutoLoad + 常量或场景注册表;不要忘记 AutoLoad 注册(模板包含 game_manager.gd 但未加入 Project Settings 则脚本不会加载,必须加到 Project → AutoLoad);不要在不配合分组的情况下使用 get_tree().paused(整树暂停会连暂停菜单一起冻结,应使用 process mode 分组,PROCESS_MODE_PAUSABLE 与 PROCESS_MODE_ALWAYS);FPS 模板不要跳过 Input.MOUSE_MODE_CAPTURED(否则游玩时鼠标光标可见,应在 player 的 _ready() 中设置);不要直接照搬模板(用平台跳跃模板做 RPG 会造成架构债务,应先理解结构再适配)。

资料未提供该模板的收费、价格、具体平台版本或效果保证信息。