场景自动重载插件

一款用于Godot引擎的插件,能够自动检测并重新加载外部修改的场景文件,提高开发效率。

  • by HaD0Yun
  • PowerShell
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 HaD0Yun/godot-auto-reload-plugin

使用说明

Godot自动重新加载插件

外部修改时自动重新加载场景-非常适合MCP(模型上下文协议)与Godot的集成。

特性

  • 自动检测外部文件更改
  • 在没有确认弹出窗口的情况下重新加载场景
  • 轻量级(1秒轮询间隔)
  • 易于启用/禁用

安装

选项1:一键安装(Windows)

# Run in your Godot project folder
irm https://raw.githubusercontent.com/HaD0Yun/godot-auto-reload-plugin/main/install.ps1 | iex

选项2:手动安装

  1. 下载或克隆此存储库
  2. 复制 addons/auto_reload 将文件夹添加到Godot项目的 addons/ 文件夹
  3. 在Godot中打开您的项目
  4. 首选 Project > Project Settings > Plugins
  5. 启用“自动重新加载场景”

选项3:Git克隆

cd your-godot-project
git clone https://github.com/HaD0Yun/godot-auto-reload-plugin.git temp_plugin
mv temp_plugin/addons/auto_reload addons/
rm -rf temp_plugin

用法

一旦启用,插件将:

  1. 监控当前打开的场景是否有外部更改
  2. 检测到更改时自动重新加载
  3. 将状态消息打印到输出面板

输出消息

[AutoReload] Plugin activated - watching for external changes
[AutoReload] Detected change in: res://your_scene.tscn
[AutoReload] Reloaded: res://your_scene.tscn

警告

数据丢失风险:如果同时在编辑器中和外部修改场景,则编辑器更改将丢失。

最佳实践:

  • 使用MCP进行修改
  • 仅将Godot编辑器用于查看
  • 外部修改前保存

禁用

  1. 首选 Project > Project Settings > Plugins
  2. 取消选中“自动重新加载场景”

或删除 addons/auto_reload 文件夹。

许可证

MIT许可证