godot-performance SKILL.md skillA

godot-performance from mindsmaster/godot-claude-code-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mindsmaster/godot-claude-code-skills/godot-performance@git:20261026.fb9861c

Pins git:20261026.fb9861c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mindsmaster/godot-claude-code-skills
Path
skills/godot-performance/SKILL.md
Versions recorded
5
Latest version
git:20261026.fb9861c, committed Oct 26, 2026
First version recorded
Oct 21, 2026
Size
20,323 bytes
Repository stars
3
License
MIT

排查卡顿 掉帧 帧率低 内存增长时用,也用于几百个怪物 子弹同屏、CharacterBody 拥挤变慢、每帧重建网格、线程池只用上两三个核、C# 跨界开销。先测再改 Profiler Monitors。不降画面与数量的内置解法 管理器统一驱动、MultiMesh、Server、对象池、空间哈希、WorkerThreadPool 分块、网格局部更新、物理插值、线程加载、着色器编译卡顿、每帧分配。Godot performance, stutter, many entities.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Godot 性能

先测再改:定位瓶颈,选内置方案,再测一次确认。不管具体渲染特效,也不管 GDScript 与 C# 的语法写法,着色器去 godot-shaders-vfx,3D 剔除与 LOD 去 godot-3d,语法去 godot-gdscript 与 godot-csharp。

目标 4.7,最低 4.4。

## 不降效果

默认只做同画面、同数量、同更新频率下的优化:合批调度、纯计算并行、只更新变化的部分、去掉重复查询。下面这些会降画面或改行为,用户没点名就不提出:隔帧更新或按距离降频、屏幕外的东西停止运动、降 `physics_ticks_per_second`、调小 `max_slides` 或物理迭代、压缩顶点精度、关阴影、减数量。屏幕外停用(下文 `VisibleOnScreenEnabler2D`)只用于看不见时停了也不影响结果的东西。

## 先查内置

| 现象 | 用这个 | 别自己写 |
|---|---|---|
| 数千个相同物体 | `MultiMeshInstance2D`、`MultiMeshInstance3D` 加 `MultiMesh` | 每个物体一个 Sprite 或 MeshInstance 节点 |
| 数千颗 2D 子弹或粒子 | `RenderingServer` 的 canvas item 与 `PhysicsServer2D`,或一个节点的 `_draw()` 画全部,或 `MultiMesh` 加数组存状态,至少做对象池 | 每颗子弹一个 Area2D 加 Sprite2D 节点 |
| 屏幕外的敌人或装置仍在运行 | `VisibleOnScreenEnabler2D`、`VisibleOnScreenEnabler3D` | 手写矩形相交判断 |
| 只用于事件响应的节点 | 去掉空的 `_process`,`set_process(false)` | 空 `_process` 留着 |
| 周期逻辑 | `Timer` 节点 | `_process` 里累加计时 |
| 移动抖动 | 物理插值 | 在 `_process` 里手动推进物理体 |
| 大批量计算 | `WorkerThreadPool.add_group_task()` 按块分,传 `high_priority` | 自建 `Thread` 池 |
| 几百个同类实体各自 `_physics_process` | 一个管理器循环处理全部,见 [many-entities.md](references/many-entities.md) | 每个实体一个回调 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mindsmaster/godot-claude-code-skills/godot-performance@sha256:4cbc073215681bcd

The line at the top of this page pins the label git:20261026.fb9861c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nivwhjrp3ogtdn74.svg)](https://markdownregistry.com/a/art_nivwhjrp3ogtdn74)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 21, 2026 and Oct 26, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261026.fb9861c latest2026-10-26 fb9861c 20,323 BA view · diff
git:20261024.5ffa8742026-10-24 5ffa874 17,934 BA view · diff
git:20261022.cc5309b2026-10-22 cc5309b 18,148 BA view · diff
git:20261022.1b16bcd2026-10-22 1b16bcd 17,860 BA view · diff
git:20261021.f61cfbe2026-10-21 f61cfbe 17,762 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (20323 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mindsmaster/godot-claude-code-skills · 3 stars · license MIT · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_nivwhjrp3ogtdn74
GET https://markdownregistry.com/api/v1/resolve?ref=mindsmaster/godot-claude-code-skills/godot-performance
GET https://markdownregistry.com/api/v1/blob/4cbc073215681bcdc8abff95683e82e0b6d3659ab8d26a0af19e76fbf5fe5d2a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mindsmaster/godot-claude-code-skills

CLAUDE.md CLAUDE.md file
mindsmaster/godot-claude-code-skills · CLAUDE.md
git:20261023.4c61c60 · audit A · 3 stars
godot-2d-in-3d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-2d-in-3d/SKILL.md · 在 Godot 4 的 3D 场景里放 2D 角色时用,2.5D 纸片人 HD-2D 像素角色配 3D 场景。Sprite3D AnimatedSprite3D billboard 正对镜头、pixel_size、投影阴影…
git:20261024.5ffa874 · audit A · 3 stars
godot-2d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-2d/SKILL.md · 写 Godot 4 的 2D 场景时用。CharacterBody2D 角色移动与平台跳跃、碰撞层、Area2D、TileMapLayer 瓦片地图与地形自动接边、Camera2D 跟随 平滑 limit…
git:20261024.5ffa874 · audit A · 3 stars
godot-3d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-3d/SKILL.md · 搭建或调试 Godot 4 的 3D 场景时用。CharacterBody3D 角色移动、第一 第三人称相机 SpringArm3D、Jolt 物理与碰撞层、RayCast3D 查询、渲染器与光照 GI 选型 SDFGI VoxelGI…
git:20261024.5ffa874 · audit A · 3 stars
godot-animation SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-animation/SKILL.md · 写动画 缓动 角色状态动画 UI 动效 转场 精灵帧动画时用。AnimationPlayer 与 RESET 轨道、AnimationTree 状态机 BlendSpace、Tween create_tween 链式与…
git:20261024.5ffa874 · audit A · 3 stars
godot-audio SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-audio/SKILL.md · 写音效 音乐 音量设置 脚步声 战斗音乐切换 节奏同步时用,音效在游戏里发闷 模糊 与原文件听感不一样时也用。Audio bus 布局 Music SFX Voice、滑条调音量…
git:20261026.d9bd45f · audit A · 3 stars
godot-builtin-first SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-builtin-first/SKILL.md · 在 Godot 4 项目里动手写任何功能之前先用,看到 project.godot .tscn .gd,或要自己写相机 缓动 状态机 UI 布局 JSON 加载 输入映射 音频池 存档 场景切换 编辑器工具时。先查引擎有没有现成的节点…
git:20261106.4e282b0 · audit A · 3 stars
godot-csharp SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-csharp/SKILL.md · 在 Godot 里写 C# 时用。partial class 与源码生成器、[Export] [Signal] [GlobalClass] [Tool]、信号连接与断开、SignalName PropertyName 与…
git:20261103.d5bb6c3 · audit A · 3 stars
godot-editor-tooling SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-editor-tooling/SKILL.md · 写 Godot 4 编辑器扩展时用。@tool 工具脚本、@export_tool_button、EditorPlugin 与 plugin.cfg、EditorInspectorPlugin 定制…
git:20261106.16b31f7 · audit A · 3 stars
godot-gdscript SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-gdscript/SKILL.md · 写或改 GDScript 时用。静态类型 := 与 Array[T] Dictionary[K, V]、class_name、@export @onready、信号 connect emit lambda、await…
git:20261024.5ffa874 · audit A · 3 stars
godot-headless-testing SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-headless-testing/SKILL.md · 在终端里验证 Godot 4 改动时用,看不到编辑器也能自己跑通。修完脚本报错要确认整个项目没有脚本错误和 GDScript 警告,改完 GDScript 场景 C# 想自己验证,写冒烟测试 自动化测试,配 CI。--headless…
git:20261024.5ffa874 · audit A · 3 stars
godot-input SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-input/SKILL.md · 写移动 跳跃 攻击 视角控制 改键菜单 手柄支持时用。InputMap 动作代替硬编码按键、get_axis get_vector 死区、键盘手柄双绑定、_unhandled_input…
git:20261024.5ffa874 · audit A · 3 stars

Every file in mindsmaster/godot-claude-code-skills

Browse by kind, by grade A, or by owner.