Initial Grid++ game

README.md

@@ -0,0 +1,27 @@
+# Grid++ 學生範本 repo
+
+把這個資料夾的內容當作你的遊戲 repo 起點。你**只需要改 `main.cpp` 和 `map.txt`**。
+
+## 檔案
+
+| 檔案 | 說明 | 要不要改 |
+|---|---|---|
+| `main.cpp` | 你的遊戲主程式(用 Grid++ 引擎) | ✅ 這是你寫遊戲的地方 |
+| `map.txt` | 地圖(第一行是「列數 欄數」,接著是地圖) | ✅ 可改 |
+| `.gitea/workflows/build.yml` | 自動編譯設定 | ❌ 通常不用動 |
+
+> 引擎標頭(`GridPlusPlus.h` 等)、素材產生器(`create_assets.py`)、網頁外殼都已內建在
+> 編譯映像裡,你的 repo 不必自帶。
+
+## 怎麼用
+
+1. 在本機用 raylib native 開發、測試你的遊戲。
+2. `git push` 到老師的 Gitea。
+3. push 後會自動編譯成 WASM 網頁。成功後到 Actions 的 log 最後一行,
+   會看到你的公開連結:`http://<本機IP>:8080/<你的學號>/<commit前8碼>/`
+4. 用瀏覽器打開那個連結就能玩。
+
+## 注意
+
+- 編譯有 **2 分鐘** 上限、限制記憶體/CPU,別寫無窮迴圈。
+- 編譯環境**連不到外網**,不要在程式裡嘗試下載東西。