# Godot + Arduino — blog project code

Companion code for the *"Godot Isn't Just for Games"* series on the
[Codebycandle blog](https://codebycandle.com/blog) — using the Godot 4 game
engine as a hardware control panel for an Arduino Uno.

Each folder is a self-contained project for one article: the Arduino sketch, the
Python serial↔UDP bridge, and the Godot project.

| Part | Article | Folder | What it does |
|------|---------|--------|--------------|
| 1 | [Your First Arduino Round-Trip](https://codebycandle.com/blog/godot-arduino-led-first-light) | [`godot-arduino-1-led-first-light/`](./godot-arduino-1-led-first-light) | A Godot button lights a real LED on D13, over a Python-to-UDP bridge. |
| 2 | A Live Joystick Dashboard *(coming soon)* | [`godot-arduino-2-joystick-dashboard/`](./godot-arduino-2-joystick-dashboard) | A KY-023 joystick streams `x,y,btn` telemetry into a glowing Godot XY pad. |

## The shape of it

```
Arduino  <--USB serial-->  bridge.py  <--UDP 127.0.0.1-->  Godot
```

Godot has no serial support, so a ~40-line Python bridge owns the COM port and
relays each line over UDP on localhost, in both directions. See each part's
README for wiring and run steps.

## Requirements

- Arduino Uno (or compatible) + the Arduino IDE
- Python 3 with `pyserial` (`pip install pyserial`)
- [Godot 4](https://godotengine.org/) (standard build — no GDExtension needed)

## License

Released under the [MIT License](./LICENSE) — use it freely.