godot-init

Bootstraps Godot 4 project structure and verifies existing project configuration.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/zerox-core/AI_Game --skill godot-init-zerox-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-init
Source: https://github.com/zerox-core/AI_Game/tree/main/.claude/skills/godot-init
Command: npx skills add https://github.com/zerox-core/AI_Game --skill godot-init-zerox-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Godot 4 project requires manually creating directory structures, writing a valid project.godot with input mappings, and wiring a main scene, which is error-prone and repetitive. ## Core Features & Use Cases - New Project Scaffolding: Creates the standard scripts/, scenes/, and assets/ directory layout plus a complete project.godot with display, rendering, and input settings. - Input Action Setup: Preconfigures standard input actions (move_left, move_right, move_up, move_down, shoot, jump, pause) mapped to WASD, mouse, Space, and Escape. - Existing Project Verification: Scans an existing project via MCP tools, reports project name, main scene, and file counts, then fixes gaps like missing directories or an unset main scene. - Use Case: When starting a new 2D game, ask the assistant to initialize the project and immediately get a runnable main scene with pixel-art texture filtering configured. ## Quick Start Initialize a new Godot 4 project in the current directory with the standard folder structure, input actions, and a runnable main scene.

Frequently Asked Questions about godot-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new Godot 4 project structure?

Create scripts/, scenes/, and assets/ directories, then write a project.godot with config_version=5, an application name, and a main scene path. Add a minimal main.tscn with an attached GDScript and run it to verify the setup.

How to configure input actions in project.godot for Godot 4?

Define actions in the [input] section using InputEventKey or InputEventMouseButton objects with physical_keycode values. Standard mappings include WASD for movement, Space for jump, Escape for pause, and left mouse button for shoot.

Does this work with existing Godot projects?

Yes, it scans existing projects using godot_get_project_state, reports the project name, main scene, and file counts, then fixes gaps such as missing directories, absent main scenes, or incomplete project.godot settings.

How do I set pixel art texture filtering in Godot 4?

Set rendering/textures/canvas_textures/default_texture_filter=0 in project.godot for nearest-neighbor pixel art rendering. Use a value of 1 for smooth linear filtering instead.

Why does my Godot project fail to launch after initialization?

Common causes are a missing or incorrect run/main_scene path in project.godot or a scene file referencing a nonexistent script. Use godot_run_scene and godot_get_errors via MCP to identify and fix the issue.