📟 Pyxel Matrix

Pyxel Matrix is a desktop utility designed for GB Studio developers to streamline the creation of complex data structures. By converting visual grids into optimized GBVM (Game Boy Virtual Machine) code, it allows for easy management of RPG stats, item databases, and environmental triggers.

---

🌟 Features

• Human-Centric Indexing: Uses 1-based indexing for rows and columns. Row 1, Column 1 is 101; Row 5, Column 8 is 508.
• Intelligent GBVM Export:
  • Numbers: Automatically uses VM_SET_CONST.
  • Variables: Automatically cleans human names into VAR_ symbols and uses VM_SET.
• Data Portability: Full support for importing and exporting CSV and JSON files.
• Sleek UI: A custom-themed "Shaded Matrix" interface (Charcoal and Muted Green) designed for long development sessions.

---

🛠️ Implementation Example

To retrieve data from the matrix within GB Studio:

1. Set Mapping: Set your Mapping variable to the desired coordinate (e.g., 508).
2. Execute Script: Call the custom GBVM script generated by this tool.
3. Result: Your Result variable will now contain the value stored at that coordinate.

---

📂 Source Code

The core logic of this tool is written in Python using the Tkinter library. You can view, audit, or contribute to the source code here:

📜 Pyxel_Matrix.py (Source)

---

📦 Standalone Version

standalone Windows executable is available in the Releases section.

---

📝 License & Credits

• Developed by: contactpyxelmorph-afk
• Target Engine: GB Studio 3.1+
• License: MIT License - Feel free to use and modify for your own game projects.