Troubleshooting

Troubleshooting

🚧 Note: More troubleshooting tips (cross-platform, binary builds, UI) are planned! See Roadmap.md for details.

This guide covers common problems and solutions for Graphite users.

---

Build Issues

• CMake not found: Install CMake (sudo apt install cmake)
• g++ not found: Install g++ (sudo apt install g++)
• OpenGL errors: Make sure OpenGL libraries are installed (sudo apt install libgl1-mesa-dev)
• Submodules missing: Clone with --recursive or run git submodule update --init --recursive

---

Runtime Errors

• Segmentation fault: Use sandbox mode (-s flag) to prevent crashes during script editing
• Script not loading: Check that Graphite.cpp exists and is valid
• DLL not found: Ensure build completed successfully and output files are in the correct directory
• Window does not open: Verify graphics drivers and OpenGL support

---

Script Issues

• Script not updating: Make sure you save changes and rebuild if needed
• Draw/Init/Destroy not called: Implement all required methods in your script
• Points not visible: Check coordinates and color values

---

Package Problems

• Package not found: Confirm repo name follows graphite-xyz convention
• Header files missing: Copy headers to gp_packages/ as instructed
• Verification issues: Contact Daynlight for package verification

---

Getting Help

• Check the FAQ and documentation
• Open an issue on GitHub with details
• Join discussions or ask on Reddit

---

If your problem is not listed, please report it for further assistance!