PyBtnBox 6.0.1 —— 用按钮执行 Python 脚本（Blender 5.2+）-游戏CG

📦 资产下载本包为 PyBtnBox 6.0.1（作者 Ou_Chiang），解压后共 7 个文件、合计 77,150 字节。根目录含 blender_manifest.toml（id=py_btn_box、version 6.0.1、blender_version_min 5.2.0）与 __init__.py 注册入口；顶层条目：__init__.py、blender_manifest.toml、modules.py、operators.py、panel_modules.py、panels.py、properties.py。

PyBtnBox 把常用脚本变成按钮：脚本无需注册类，方便加载修改；用菜单与面板组织按钮。设根文件夹(须以 pybtnbox_menus 开头)，子文件夹=菜单、.py=按钮，在文本编辑器侧栏编辑后点按钮执行。

· 按钮执行 Python 脚本，无需注册 class
· 菜单与面板组织按钮
· 根文件夹自动识别（名称须以 pybtnbox_menus 开头）
· 子文件夹=菜单，菜单内 .py 文件=按钮
· 在文本编辑器侧栏编辑菜单/按钮与脚本
· 改完脚本点面板按钮即执行
· _menuData.json 定义菜单布局

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：偏好设置 > 插件 > PyBtnBox 设定根文件夹路径（以 pybtnbox_menus 开头）；在文本编辑器 > 侧栏 > PyBtnBox 编辑菜单与按钮、加载编辑脚本；之后在面板点击按钮执行。

把高频脚本做成按钮面板；团队内非程序员也能点按钮跑脚本；按项目组织一批小工具脚本。

问：要钱吗？答：免费开源，GPL-3.0-or-later。问：需要哪版 Blender？答：5.2 及以上。问：做什么？答：用按钮一键执行 Python 脚本。问：脚本要注册类吗？答：不用。问：目录怎么组织？答：根文件夹下子文件夹=菜单、.py=按钮。

核心功能

安装与用法

适用场景

把高频脚本做成按钮面板；团队内非程序员也能点按钮跑脚本；按项目组织一批小工具脚本。

常见问题

深度解读

写了不少小脚本的人都有个共同问题：脚本散在各处，用的时候要么翻文本编辑器找、要么记快捷键，团队里不会写代码的同事更是完全用不上。PyBtnBox 的思路很直接——把脚本变成「按钮面板」：每个 .py 脚本就是面板上的一个按钮，点一下就执行，还能用菜单把一堆按钮分组，按项目/用途收纳。更省心的是，按钮执行的脚本不需要注册任何 class，所以加载和修改都轻松，改完脚本点一下面板按钮就能验证。组织方式也贴合直觉：你设一个根文件夹（名字必须以 pybtnbox_menus 开头以便识别），根下的每个子文件夹自动成为一个菜单，菜单里的 .py 文件自动变成按钮；布局用 _menuData.json 描述，在文本编辑器侧栏里就能编辑菜单与按钮。需要清醒的边界：脚本本身的功能与安全由你负责，插件只负责「点按钮执行」；根文件夹命名规则必须遵守，否则不识别；它适合「已知脚本、想更快调用」的场景，不适合替不写代码的人自动生成脚本。但对想把零散脚本收成一套顺手的操作面板的人，它是把脚本「产品化」的最快方式。

包内文件说明

本包为 PyBtnBox 6.0.1（作者 Ou_Chiang），解压后共 7 个文件、合计 77,150 字节。根目录含 blender_manifest.toml（id=py_btn_box、version 6.0.1、blender_version_min 5.2.0）与 __init__.py 注册入口；顶层条目：__init__.py、blender_manifest.toml、modules.py、operators.py、panel_modules.py、panels.py、properties.py。

原产品页：https://extensions.blender.org/add-ons/py-btn-box/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。

文章版权归作者所有，未经允许请勿转载。

THE END