Skip to content

README.md

Latest commit

 

History

History
87 lines (64 loc) · 3.23 KB

README.md

File metadata and controls

87 lines (64 loc) · 3.23 KB
Raw

Testing ChatGPT Codex 5.6 Sol for creating a Blender PlugIn

Custom Pie Menu Creator

Custom Pie Menu Creator is a Blender add-on for building nested pie menus from Blender's add-on preferences. Menus and keyboard shortcuts are stored in the user preferences, so they do not modify or travel with the active .blend file.

Current add-on version: 2.1.1
Minimum Blender version: 5.1

Features

  • Configure menus under Edit > Preferences > Add-ons > Custom Pie Menu Creator.
  • Add either an action or a submenu to each of the eight pie-menu slots.
  • Assign a keyboard shortcut to any menu.
  • Apply and save shortcuts in Blender's user preferences.
  • Import and export JSON backups manually.
  • Load the bundled starter preset on first use or restore it later.

The bundled preset contains four shortcut menus—Modelling, Linking, Parent, and Modifiers—and three submenus used by Modelling: Surface Snap, Vertex Snap, and Transform. The default shortcuts are the number-row keys 1 through 4.

Installation

  1. Download the release ZIP. Do not extract it.
  2. In Blender, open Edit > Preferences > Add-ons.
  3. Choose Install from Disk and select the ZIP.
  4. Enable Custom Pie Menu Creator.
  5. Expand the add-on preferences to edit menus or load the bundled preset.

To build the installable ZIP from a source checkout:

python scripts/build_release.py

The archive is written to dist/ with the required CustomPieMenus/ package directory inside it.

Configuration and storage

Menu definitions are stored in Blender's user preferences through AddonPreferences; they are not properties of the current scene and are not saved in project files. Press Apply & Save Settings after changing menus or shortcuts.

CustomPieMenuConfig.json is a bundled starter preset, not the live settings store. Load Bundled Preset replaces the current preference-backed menus. The import and export buttons can be used for explicit backups.

Actions may contain an operator identifier or Python code. Python actions run inside Blender with bpy available and C bound to bpy.context. Only import presets from sources you trust.

Development

The project has no third-party Python dependencies. These checks can run without importing Blender's bpy module:

python scripts/validate_project.py
python -m py_compile __init__.py scripts/validate_project.py scripts/build_release.py
python scripts/build_release.py

GitHub Actions runs the same checks and attaches an installable ZIP to each successful workflow run. A final functional test should still be performed in the minimum supported Blender version before publishing a release.

Repository layout

  • __init__.py — add-on implementation and metadata
  • CustomPieMenuConfig.json — bundled starter preset
  • LICENSE — GNU LGPL v3-or-later license terms
  • LICENSE.GPL — incorporated GNU GPL v3 license terms
  • scripts/validate_project.py — metadata and preset validation
  • scripts/build_release.py — installable ZIP builder

License

Custom Pie Menu Creator is licensed under the GNU Lesser General Public License v3.0 or later, identified by SPDX as LGPL-3.0-or-later. The incorporated GNU GPL v3 terms are included in LICENSE.GPL.