CITY CODER

📚 新手教程 ← 回首頁
教程 · 第 1 頁,共 5 頁 🏙️

歡迎來到 City Coder!

🤖
嗨嗨!我是你的城市助手 科科
我會帶你學會用 程式碼 蓋出自己的城市。
別擔心,超級簡單的,一起來吧!🎉

在 City Coder 裡,你可以用 Python 程式語言 來蓋房子、公園、學校……
就像在玩積木,但這次你要用 文字指令 告訴電腦要蓋什麼!

🎮
程式碼是什麼?
就像你在玩遊戲時,角色會按照你按的按鈕移動。
程式碼就是你給電腦的「按鈕說明書」!
⌨️ 你打指令
💻 電腦讀懂
🏠 城市蓋好!
教程 · 第 2 頁,共 5 頁

函式:你的魔法咒語

🤖
函式(function) 就像是一個魔法咒語!
你喊出咒語的名字,電腦就會照著做!✨

在 City Coder 裡,每種建築都有自己的函式名字:

🏠
build_house → 蓋一棟房子
build_park → 建造公園
build_school → 蓋一間學校

每個函式後面都要加上 ( )(括號),
括號裡面放的是你想告訴電腦的 細節資訊,叫做「參數」:

city_builder.py
# 在第 40 列、第 40 欄蓋一棟叫「小明的家」的房子
build_house(40, 40, name="小明的家")
🔵 build_house = 函式名稱 🟠 40, 40 = 位置(列, 欄) 🔴 "小明的家" = 名字標籤
🍕
比喻: 就像點披薩一樣!
訂披薩(尺寸=大, 口味="夏威夷")
函式是「訂披薩」,括號裡是你的要求!
教程 · 第 3 頁,共 5 頁 🗃️

變數:幫東西取名字

🤖
變數(variable) 就像一個有名字的箱子!
你可以把數字或文字放進去,之後直接叫它的名字來用!🗃️

比如說你想在地圖上蓋很多棟房子,都在差不多的地方——
與其每次都打一遍座標,不如把它存進一個「箱子」:

city_builder.py
# 把「中心位置」存進變數
center_row = 40
center_col = 40
# 用變數來蓋房子
build_house(center_row, center_col, name="第一棟")
build_house(center_row + 1, center_col, name="第二棟")
build_house(center_row + 2, center_col, name="第三棟")
🗃️
變數小技巧:
center_row = 40 代表「把 40 這個數字,放進叫做 center_row 的箱子」
以後你只要說 center_row,電腦就知道是 40 了!
🧠 動動腦:以下哪個是正確的變數名稱寫法?
A 1myVar = 10
B my_city = 40
C my city = 40
教程 · 第 4 頁,共 5 頁 ▶️

如何執行程式碼?

🤖
好了!你學會寫指令了。現在讓我告訴你怎麼讓電腦執行它,
然後在右邊地圖上看到你的城市長出來!🗺️
在左邊的 編輯器 裡打上你的程式碼
例如:build_house(40, 40, name="我的家")
按下左下角的綠色 ▶ 執行 按鈕 或按 Ctrl + Enter
電腦會讀你的程式,在右邊的 3D 地圖 上蓋出建築!
下方的 輸出紀錄 會告訴你每一行是成功了 ✓ 成功 還是有錯 ⚠ 錯誤

輸出紀錄長這樣:

▸ 開始執行 Python 程式碼…
✓ 第 1 行:build_house() → house
✓ 第 2 行:build_park() → park
✗ 第 3 行:build_house() — 函式需要指定 row 和 col
▸ 完成!共建造 2 個設施,1 個錯誤
💡
有錯誤也沒關係!
程式師每天都會犯錯,再修改就好了。
看看錯誤訊息說的是哪一行,去那行改一改再執行!
教程 · 第 5 頁,共 5 頁 🚀

你已經準備好了!

🤖
哇!你學了函式、變數,還知道怎麼執行程式。
現在就去蓋屬於你的未來城市吧! 💪

這是所有你可以使用的 建築指令
記得每個指令都要填上 row(列)col(欄)

🏠 build_house 🌳 build_park 📖 build_library 🏫 build_school 🏥 build_hospital 🏪 build_shop ⛲ build_fountain 🛣️ build_road ⚡ build_power_tower 💡 build_streetlight 🗑️ clear_all

快速複習一下,試試看這段程式碼:

city_builder.py
# 蓋一個小社區
build_house(40, 40, name="我的家")
build_park(41, 40, name="社區公園")
build_school(40, 42, name="我的學校")
build_road(40, 41, "h")
build_streetlight(39, 41)
🗺️
小提示: 在地圖上移動滑鼠可以看到每個格子的 row, col 座標!
右鍵拖曳可以旋轉視角,左鍵拖曳平移,滾輪縮放。