本文へ移動
cccskills
無料GitHub で公開

godot-version-migration

Full-history Godot version migration hub. Use when upgrading any Godot project toward the library target (currently 4.7)—from 1.x/2.x legacy eras through 3→4 and hop-by-hop 4.x minors—or finding Domain Skill-scoped migration notes. Trigger keywords: upgrade Godot, migrate Godot version, Godot 3 to 4, Godot 2 to 3, upgrading_to_godot, version migration, breaking changes, convert-3to4, TileMapLayer, AnimationMixer, engine.cfg, project.godot.

インストール方法を見る

含まれるファイル(100)

  • SKILL.md6.5 KB
  • references/2d-animation.md2.8 KB
  • references/2d-physics.md3.2 KB
  • references/3d-lighting.md4.1 KB
  • references/3d-materials.md3.9 KB
  • references/3d-world-building.md3.4 KB
  • references/ability-system.md2.4 KB
  • references/adapt-2d-to-3d.md3.7 KB
  • references/adapt-3d-to-2d.md3.7 KB
  • references/adapt-desktop-to-mobile.md2.7 KB
  • references/adapt-mobile-to-desktop.md2.9 KB
  • references/adapt-single-to-multiplayer.md2.2 KB
  • references/agent-vision.md2.5 KB
  • references/ai-navigation.md3.2 KB
  • references/animation-player.md2.8 KB
  • references/animation-tree-mastery.md3.4 KB
  • references/audio-systems.md2.6 KB
  • references/autoload-architecture.md4.0 KB
  • references/bridges/3-to-4.md1.7 KB
  • references/camera-systems.md2.6 KB
  • references/characterbody-2d.md2.8 KB
  • references/combat-system.md2.1 KB
  • references/composition-apps.md3.2 KB
  • references/composition.md4.0 KB
  • references/debugging-profiling.md4.1 KB
  • references/dialogue-system.md3.2 KB
  • references/economy-system.md2.5 KB
  • references/era-index.md896 B
  • references/export-builds.md3.6 KB
  • references/game-loop-collection.md3.6 KB
  • references/game-loop-harvest.md3.6 KB
  • references/game-loop-time-trial.md3.6 KB
  • references/game-loop-waves.md3.6 KB
  • references/gdscript-mastery.md3.5 KB
  • references/genre-action-rpg.md2.8 KB
  • references/genre-battle-royale.md2.3 KB
  • references/genre-card-game.md3.5 KB
  • references/genre-educational.md4.9 KB
  • references/genre-fighting.md3.4 KB
  • references/genre-horror.md3.9 KB
  • references/genre-idle-clicker.md3.5 KB
  • references/genre-metroidvania.md2.3 KB
  • references/genre-moba.md3.2 KB
  • references/genre-open-world.md3.5 KB
  • references/genre-party.md2.4 KB
  • references/genre-platformer.md2.7 KB
  • references/genre-puzzle.md3.5 KB
  • references/genre-racing.md3.3 KB
  • references/genre-rhythm.md2.5 KB
  • references/genre-roguelike.md2.4 KB
  • references/genre-romance.md3.6 KB
  • references/genre-rts.md3.4 KB
  • references/genre-sandbox.md2.5 KB
  • references/genre-shooter-fps.md3.7 KB
  • references/genre-shooter.md2.6 KB
  • references/genre-simulation.md2.5 KB
  • references/genre-sports.md3.9 KB
  • references/genre-stealth.md3.2 KB
  • references/genre-survival.md2.8 KB
  • references/genre-tower-defense.md3.2 KB
  • references/genre-visual-novel.md3.6 KB
  • references/hop-index.md30.0 KB
  • references/input-handling.md3.0 KB
  • references/inventory-system.md3.3 KB
  • references/legacy/2-to-3.md1.3 KB
  • references/legacy/pre-2-context.md801 B
  • references/mechanic-revival.md3.6 KB
  • references/mechanic-secrets.md3.6 KB
  • references/monte-carlo-balancer.md3.3 KB
  • references/multiplayer-networking.md2.6 KB
  • references/navigation-pathfinding.md3.2 KB
  • references/particles.md4.2 KB
  • references/performance-optimization.md4.9 KB
  • references/physics-3d.md4.9 KB
  • references/platform-console.md2.4 KB
  • references/platform-desktop.md2.7 KB
  • references/platform-mobile.md2.8 KB
  • references/platform-vr.md3.9 KB
  • references/platform-web.md2.3 KB
  • references/procedural-generation.md3.0 KB
  • references/project-foundations.md3.7 KB
  • references/project-templates.md3.1 KB
  • references/quest-system.md2.4 KB
  • references/raycasting-queries.md3.2 KB
  • references/resource-data-patterns.md2.9 KB
  • references/rpg-stats.md2.5 KB
  • references/save-load-systems.md3.1 KB
  • references/scene-management.md3.7 KB
  • references/server-architecture.md2.3 KB
  • references/shaders-basics.md3.3 KB
  • references/signal-architecture.md4.0 KB
  • references/state-machine-advanced.md3.2 KB
  • references/testing-patterns.md3.6 KB
  • references/theme-easter.md3.3 KB
  • references/tilemap-mastery.md2.8 KB
  • references/turn-system.md3.5 KB
  • references/tweening.md4.2 KB
  • references/ui-containers.md3.2 KB
  • references/ui-rich-text.md3.0 KB
  • references/ui-theming.md3.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Godot Version Migration

Orchestrator for engine version upgrades from early Godot through the library target. Domain Skills document current APIs; this hub owns the upgrade path.

Library target: Godot 4.7+

Corpus: docs changelog · interactive changelog · download archive · GitHub releases · migrating index

NEVER Do

  • NEVER skip majors — route 1.x → 2.x → latest 3.x → 4.0 before any 4.x minor ladder.
  • NEVER skip 4.x hops — upgrade 4.0 → 4.1 → … → 4.7 one minor at a time; stabilize after each hop.
  • NEVER claim automatic 1.x→4.x conversion or bit-exact autopilot.
  • NEVER treat Domain Skill bodies as migration changelogs — load references/<topic>.md (mirrored from each skill’s references/migration-notes.md).
  • NEVER load all module notes at once — only subsystems present in the project.
  • NEVER mix server/client Godot minors for high-level multiplayer (especially across 4.2→4.3 SceneMultiplayer protocol changes).
  • NEVER choose Mesh “Restart & Upgrade” without VCS backup (4.1→4.2 mesh format).
  • NEVER run the 3→4 converter without a full backup (tool does not backup).

Version detect

  1. Read project.godot (config_version, config/features) or legacy engine.cfg.
  2. Ask the user if files are ambiguous.
  3. Map to an era in references/era-index.md.

Workflow router (MANDATORY)

Detected eraLoadDo NOT
1.x / early 2legacy/pre-2-context.mdInvent a 1→4 converter
2.xlegacy/2-to-3.md then stabilize on latest 3.xJump straight to 4.7 notes
3.xbridges/3-to-4.md + official 3→4 guideSkip latest-3.x stabilize gate
4.x < 4.7Official hop guide + hop-index.md module notes for touched systemsSkip minors
Already 4.7+godot-master / Domain SkillsTreat this hub as a coding tutorial

Steps (4.x minors)

  1. While current < 4.7, perform exactly one hop to current + 0.1.
  2. Open the official upgrading page for the destination version.
  3. From hop-index.md, open only module notes for subsystems present in the project.
  4. Apply fixes; open in the new editor; playtest; repeat.

Hop table

Majors / bridges

EraResource
1.x archaeologylegacy/pre-2-context.md
2.x → 3.xlegacy/2-to-3.md
3.x → 4.0bridges/3-to-4.md · official guide
Ladder overviewera-index.md

4.x minors

HopOfficial guide
4.0 → 4.1https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.1.html
4.1 → 4.2https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.2.html
4.2 → 4.3https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.3.html
4.3 → 4.4https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.4.html
4.4 → 4.5https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.5.html
4.5 → 4.6https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.6.html
4.6 → 4.7https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.7.html

Cross-skill checklist: references/hop-index.md

Module directory

Mirrored Domain Skill migration notes live at references/<topic>.md (e.g. references/2d-physics.md). Hub-native legacy/, bridges/, and era-index.md are not Domain Skill mirrors.

sync_godot_version_migration.py --all

Reference

Official docs

Related Skills

Master

  • godot-master — Library router for current Domain Skill modules after migration is complete.

Downstream / consumers

  • godot-analyst — Score architecture on the target APIs after hops land.
  • godot-auditor — Never-list / legacy-syntax verification after upgrades.
  • godot-builder — CI / headless bake against the new engine target after each hop.

Complements

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Bevy ECS skill for 2D sprite animation. Keywords: Bevy, sprite, animation, AnimationPlayer, AnimationClip, 2D.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

Bevy ECS skill for 3D lights. Keywords: Bevy, lighting, directional, point, spot, bevy_light, PBR.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

Bevy ECS skill for PBR materials. Keywords: Bevy, StandardMaterial, PBR, material, ExtendedMaterial.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

Bevy ECS skill for 3D level assembly. Keywords: Bevy, level, scene, mesh, world, ECS.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

Bevy ECS skill for abilities. Keywords: Bevy, ability, cooldown, ECS, gameplay.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

Bevy ECS skill for moving a Bevy game from 2D to 3D. Keywords: Bevy, 2D, 3D, adapt, camera, sprite.

日本語の概要は準備中です。原文の説明を表示しています。

thedivergentai/Game-Design-Agentic-Skills8452026年10月13日 更新

thedivergentai のスキルをすべて見る

このスキルの問題を報告する