跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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

中文简介正在准备中。当前显示原文说明。

thedivergentai/Game-Dev-Agentic-Skills8792026年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-Skills8792026年10月17日 更新

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

中文简介正在准备中。当前显示原文说明。

thedivergentai/Game-Dev-Agentic-Skills8792026年10月17日 更新

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

中文简介正在准备中。当前显示原文说明。

thedivergentai/Game-Dev-Agentic-Skills8792026年10月17日 更新

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

中文简介正在准备中。当前显示原文说明。

thedivergentai/Game-Dev-Agentic-Skills8792026年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-Skills8792026年10月17日 更新

查看 thedivergentai 的全部技能

报告此技能的问题