Skip to content
godot-extract-to-scenes logo

Extract Code-Created Objects to Scenes

godot-extract-to-scenes

Use when building Godot features and your code creates nodes with .new() instead of using scenes. Detects Timer.new(), Area2D.new(), Sprite2D.new() and other code-created objects. Automatically generates .tscn scene files, updates parent scripts with @onready references, and creates reusable comp...

Asreonn/godot-superpowers0installs4stars

SKILL.md

Full skill instructions

Extract Code-Created Objects to Scenes

Core Principle

Every node should be a scene. Code-created objects with .new() should be rare exceptions for truly dynamic content.

What This Skill Does

Finds patterns like:

var timer = Timer.new()
timer.wait_time = 2.0
timer.one_shot = true
add_child(timer)

Transforms to:

@onready var timer: Timer = $Timer
# Timer is now a scene node, configured in editor

Detection Patterns

Scans for:

  • Timer.new()
  • Area2D.new(), CollisionShape2D.new()
  • Sprite2D.new(), AnimatedSprite2D.new()
  • AudioStreamPlayer.new(), AudioStreamPlayer2D.new()
  • Control.new(), Label.new(), Button.new()
  • Any Node*.new() pattern

When to Use

You're Building New Features

Your code creates objects dynamically that should actually be scenes.

You're Refactoring Legacy Code

Old code has .new() calls that make nodes invisible in editor.

You Want Inspector Visibility

You want to configure properties in the Godot editor, not in code.

Process

  1. Scan - Find all .new() patterns in .gd files
  2. Analyze - Determine node type, properties, parent relationships
  3. Generate - Create .tscn scene files with proper configuration
  4. Update - Replace code creation with @onready references
  5. Commit - Git commit per component extracted

Example Transformation

Before:

# player.gd
func _ready():
    var hitbox = Area2D.new()
    hitbox.name = "Hitbox"
    var collision = CollisionShape2D.new()
    var shape = RectangleShape2D.new()
    shape.size = Vector2(32, 48)
    collision.shape = shape
    hitbox.add_child(collision)
    add_child(hitbox)

After:

# player.gd
@onready var hitbox: Area2D = $Hitbox
# Hitbox is now configured as scene node in player.tscn

Generated File:

# components/​hitbox_component.tscn
[gd_scene load_steps=2 format=3]

[sub_resource type="RectangleShape2D" id="1"]
size = Vector2(32, 48)

[node name="Hitbox" type="Area2D"]

[node name="CollisionShape2D" type="CollisionShape2D" parent="."]
shape = SubResource("1")

What Gets Created

  • Component library in components/ directory
  • .tscn scene files with proper node hierarchy
  • Preset .tres files for reusable configurations
  • Updated parent scripts with @onready references
  • Git commits documenting each extraction

Smart Detection

Skips intentional dynamic creation:

  • Objects created in loops (spawning enemies)
  • Objects created conditionally (different weapon types)
  • Objects with variable types (plugin systems)

Focuses on static objects:

  • Same object created every time
  • Properties set to constant values
  • Should exist in editor for visibility

Integration

Works with:

  • godot-split-scripts - Extract, then split large scripts
  • godot-add-signals - Use signals with extracted components
  • godot-refactor (orchestrator) - Runs as part of full refactoring

Safety

  • Every operation creates a git commit
  • Validation tests run after extraction
  • Auto-rollback on test failure
  • Original code preserved in git history

When NOT to Use

Don't extract if:

  • Object is created dynamically (in loop, based on data)
  • Object type varies at runtime
  • Object is truly temporary (created and destroyed frequently)
  • Code is already using PackedScene.instantiate()

These are legitimate uses of .new() and should remain as code.

More skills from Asreonn

godot-sync-camera-positions logo
Asreonn/godot-superpowers

godot-sync-camera-positions

Use when Godot background layers or elements follow the camera at runtime but show incorrect position in editor. Detects camera-following patterns and syncs editor position to match typical runtime state. Makes editor preview accurately show what players will see during gameplay.

4 0
View
godot-refactor logo
Asreonn/godot-superpowers

godot-refactor

Use when Godot project has code-created objects, tight coupling via direct references, monolithic scripts over 150 lines, or needs scene-first architecture with signals and composition. Orchestrates all 5 code quality mini-skills: extract-to-scenes, split-scripts, add-signals, extract-resources, ...

4 0
View
godot-split-scripts logo
Asreonn/godot-superpowers

godot-split-scripts

Use when Godot scripts exceed 150 lines or have multiple responsibilities. Detects scripts doing too many things (player movement + combat + inventory + UI). Automatically splits into focused scripts following Single Responsibility Principle, preserves behavior exactly, and creates git commits pe...

4 0
View
godot-convert-shaders logo
Asreonn/godot-superpowers

godot-convert-shaders

Converts Godot 3.x shader code to Godot 4.x shader syntax. Updates SCREEN_TEXTURE to screen_texture uniform, DEPTH_TEXTURE to depth_texture uniform, texture() function changes, built-in varyings updates, and light function signature changes. Essential for rendering and visual effect migrations.

4 0
View
godot-migrate-tilemap logo
Asreonn/godot-superpowers

godot-migrate-tilemap

Migrates legacy TileMap (Godot 4.0-4.2) to new TileMapLayer system (Godot 4.3+). Handles TileMap node conversion, API migration (set_cell to set_cells_terrain_connect), TileSet resource updates, physics layer mapping, navigation layer conversion, and custom data preservation. Essential for upgrad...

4 0
View
godot-setup-animationtree logo
Asreonn/godot-superpowers

godot-setup-animationtree

Use when setting up AnimationTree nodes for state machine-driven animation, creating AnimationNodeStateMachine graphs, configuring BlendSpace2D/3D for locomotion blending, implementing state transition conditions, or creating animation blend trees for complex animation mixing. Supports player cha...

4 0
View
godot-extract-resources logo
Asreonn/godot-superpowers

godot-extract-resources

Use when Godot code has hardcoded game data in const arrays, dictionaries, or embedded values. Detects inline data like enemy stats, item definitions, level configurations. Automatically extracts to .tres resource files, making data visible in editor, easily modifiable, and supports data-driven d...

4 0
View
godot-modernize-input logo
Asreonn/godot-superpowers

godot-modernize-input

Use when handling input in Godot 4.x projects and need to modernize patterns. Generates Input Map configurations from hardcoded key checks, sets up joypad rumble (Godot 4.x feature), implements gyroscope/accelerometer input on mobile, creates context-sensitive input handling for different game st...

4 0
View
godot-sync-parallax logo
Asreonn/godot-superpowers

godot-sync-parallax

Use when Godot ParallaxBackground/ParallaxLayer nodes show incorrect positions in editor due to parallax multipliers. Calculates correct editor positions based on camera start position and parallax motion scale. Makes parallax layers preview realistically in editor, matching gameplay appearance.

4 0
View
godot-generate-tests logo
Asreonn/godot-superpowers

godot-generate-tests

Use when developing Godot games and need comprehensive test coverage for GDScript classes, signals, scene initialization, and integration flows. Generates GUT framework unit tests, integration tests, mock/stub helpers, and CI/CD test runner configuration.

4 0
View
godot-setup-export logo
Asreonn/godot-superpowers

godot-setup-export

Use when setting up multi-platform exports for Godot projects, configuring export presets, icons, feature tags, build scripts, or CI/CD pipelines

4 0
View
godot-fix-positions logo
Asreonn/godot-superpowers

godot-fix-positions

Use when Godot project has position conflicts between editor (.tscn) and code (.gd), camera-following backgrounds, or runtime positions don't match editor preview. Orchestrates all 3 position sync mini-skills: sync-static-positions, sync-camera-positions, and sync-parallax. Each operation targets...

4 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View