본문으로 건너뛰기
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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(101)

  • 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/rea.md2.9 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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

Spawn and tune Bevy 0.20 directional, point, and spot lights, cascade shadows, distance fog, and a nearest-light shadow budget. Use when a 3D scene needs a sun, local lights, or fog on the camera. Keywords: DirectionalLight, PointLight, SpotLight, CascadeShadowConfig, DistanceFog, bevy_light.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

Rewrite Bevy 2D actors and cameras into 3D meshes and Camera3d while keeping gameplay components. Use when a Bevy 2D game should gain a perspective camera, mesh draw, and a planar velocity lifted onto XZ. Keywords: Camera2d, Camera3d, Sprite, Mesh3d, StandardMaterial, WishVelocity.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedivergentai/Game-Dev-Agentic-Skills8782026년 10월 17일 업데이트

thedivergentai의 스킬 모두 보기

이 스킬의 문제 신고