FAQ

How do I unlock starred features?
Star the repository on GitHub at https://github.com/v4lkyr0/Buildware-Tools, then provide your GitHub Personal Access Token when prompted. A tutorial link is available directly in the tool.

---

Setup.py fails with a Python version error.
Buildware-Tools requires Python 3.10 or higher. Download the latest version at https://www.python.org/downloads/ and make sure to check "Add Python to PATH" during installation.

---

A module is missing after running Setup.py.
Run python Setup.py again — it will detect and install only what is missing. If it still fails, run pip install -r requirements.txt manually.

---

My plugin is not showing in the menu.
Go to Plugin Manager → Manage Plugins, select your plugin and set its status to Shown. Plugins are hidden by default after installation.

---

Can I install a plugin without the buildware-plugin tag?
No. The tag is required for security. It ensures the repository is explicitly intended to be a Buildware-Tools plugin.

---

How do I update a plugin?
Go to Plugin Manager → Manage Plugins → select the plugin → Update. If an update is available, it will be shown directly in the plugin list.

---

How do I create my own plugin?
See the Creating a Plugin guide.

---

Where can I find community plugins?
All community plugins are listed at https://github.com/topics/buildware-plugin.

---

The tool opens but nothing works / crashes immediately.
Make sure you are running the tool from its root directory and that all dependencies are installed via python Setup.py.

---

Does Buildware-Tools work on macOS?
Yes, macOS is supported alongside Windows and Linux.