Teacher's Guide
move_forward()
Sintaks
player.move_forward([number of steps])
Fungsi ini digunakan untuk membuat pemain bergerak ke hadapan dalam arah yang sedang dihadapinya dengan syarat tidak terdapat sebarang perlanggaran yang menghalang trajektori pemain. Anda boleh menetapkan bilangan langkah yang diingini untuk fungsi ini dijalankan berulang, atau anda boleh membiarkannya kosong dan ia akan melaksanakan tindakan tersebut sekali sahaja.
Jika fungsi ini tidak diberikan apa-apa argumen, maka ia akan menggerakkan pemain ke hadapan sebanyak satu langkah.
Contoh
player.move_forward(3)
Kod ini akan membuat pemain bergerak tiga langkah ke hadapan dalam peta.

turn_left()
Sintaks
player.turn_left()
Fungsi ini digunakan untuk membuat pemain berpusing ke kiri, mengubah arah mereka ke sebelah kiri dari arah semasa mereka.
Contoh
player.turn_left()
player.move_forward()
Kod ini akan membuat pemain berpusing ke kiri dari arah yang sedang dihadapinya dan bergerak ke hadapan dalam arah tersebut dengan kod susulan.

turn_right()
Sintaks
player.turn_right()
Fungsi ini digunakan untuk membuat pemain berpusing ke kanan, mengubah arah mereka ke sebelah kanan dari arah semasa mereka.
Contoh
player.turn_right()
player.move_forward()
Kod ini akan membuat pemain berpusing ke kanan dari arah semasa mereka dan bergerak ke hadapan dalam arah tersebut dengan kod susulan.

push()
Sintaks
player.push()
Fungsi ini digunakan untuk membuat pemain menolak objek ke arah yang sedang dihadapinya dengan syarat tidak terdapat perlanggaran yang menghalang trajektori objek tersebut.
Contoh
player.turn_left()
player.push()
Kod ini akan membuat pemain berpusing ke kiri dan menolak objek yang boleh digerakkan ke arah yang sedang dihadapinya.

speak()
Sintaks
player.speak([string to speak])
Fungsi ini digunakan untuk membuat pemain melafazkan satu rentetan yang ditentukan dalam argumen fungsi ini. Dalam permainan, ini ditunjukkan dengan rentetan yang dipaparkan di atas kepala pemain.
Contoh
player.speak("Hello World")
Kod ini akan memaparkan frasa “Hello World” di atas kepala pemain.

build()
Sintaks
player.build([object to build])
Fungsi ini digunakan untuk membuat pemain membina objek yang ditentukan dalam argumen fungsi ini. Terdapat pilihan terhad objek yang boleh dibina oleh pemain menggunakan fungsi ini dan terdapat syarat-syarat tertentu yang berkaitan dengan pembinaan setiap objek. Objek akan dibina di hadapan arah yang sedang dihadapinya pemain dengan syarat kawasan tersebut tidak diduduki oleh objek lain atau objek tersebut tidak boleh dibina di jenis terain yang sedang digunakan.
| Objek | Kos | Argumen | Penerangan |
|---|---|---|---|
| Bridge | 4 logs | "bridge" | Membina jambatan untuk dilalui |
| Grain Stack | 4 grain | Class Object Name | Menghasilkan timbunan gandum |
| Wood Road | 4 planks | Class Object Name | Menambah jalur laluan kayu |
| Stone Road | 4 stone | Class Object Name | Menambah jalur laluan batu |
| Big Green house | 4 planks | Class Object Name | Membina Rumah Ayam Besar Hijau |
| Small Blue house | 4 planks | Class Object Name | Membina Rumah Ayam Kecil Biru |
| Big Orange house | 4 planks | Class Object Name | Membina Rumah Ayam Besar Oren |
| Small Red house | 4 planks | Class Object Name | Membina Rumah Ayam Kecil Merah |
Contoh
player.build("bridge")
Kod ini akan membuat pemain membina jambatan di hadapan pemain dalam arah yang sedang dihadapinya.

water()
Sintaks
player.water()
Fungsi ini boleh digunakan untuk menyiram objek dalam permainan, seperti menyiram tanaman dan mengisi semula dulang air. Dalam permainan, ini biasanya digunakan untuk pertanian dan penjagaan rumah.
Contoh
player.water()
Dengan menggunakan kod ini, pemain boleh menyiram objek dalam arah yang sedang dihadapinya.

collect()
Sintaks
player.collect(string)
Fungsi ini digunakan untuk mengumpul sumber yang tidak boleh diklaim sebagai sebahagian daripada inventori anda. Ini biasanya digunakan untuk mengisi semula item inventori yang boleh habis, contohnya mengisi semula kantung air dengan air.
Contoh
player.collect("water")
player.turn_left()
player.water()
Kod ini akan membuat pemain mengumpul air dari sumber air yang sedang dihadapinya, kemudian berpusing ke kiri untuk menyiram objek.

open()
Sintaks
player.open()
Fungsi ini digunakan untuk membuka pintu dan bekas, yang boleh berguna untuk melintasi pintu masuk atau membuka bekas untuk mengambil atau meletakkan objek.
Contoh
player.turn_left()
player.open()
player.move_forward()
Kod ini akan membuat pemain berpusing ke kiri untuk membuka pintu dan kemudian melintasinya.

close()
Sintaks
player.close()
Fungsi ini digunakan untuk menutup pintu dan bekas, yang berguna untuk menutup pintu di belakang anda atau menutup bekas selepas anda meletakkan sesuatu di dalamnya.
Contoh
player.open()
player.collect("item")
player.close()
Kod ini akan membuat pemain membuka peti, mengambil satu item dan kemudian menutup peti tersebut selepasnya.

place()
Sintaks
player.place(object)
Fungsi ini digunakan untuk meletakkan suatu objek, item atau pembolehubah di lokasi yang dibenarkan untuk meletakkan objek. Ini biasanya digunakan untuk menyimpan item dalam bekas atau meletakkan objek di lokasi tertentu.
Contoh
wheat = 6
player.place(wheat)
Kod ini menggambarkan pemain menyimpan satu nombor ke dalam pembolehubah yang dinamakan wheat dan kemudian fungsi place() digunakan untuk meletakkan pembolehubah tersebut di lokasi yang ditetapkan.

combine()
Sintaks
player.combine(mixture)
Fungsi ini digunakan untuk membuat pemain menggabungkan beberapa objek bersama-sama untuk menghasilkan objek baru. Ini biasanya digunakan untuk menggabungkan bahan-bahan untuk membuat makanan, minuman atau bahan lain.
| Gabungan | Bahan-bahan |
|---|---|
| Radish Dressing | 3 milk, 2 cream, 3 lettuce, 5 radish |
| Fruit Juice | 1 water, 1 empty jar, 1 orange, 1 peach, 1 pear, 1 apple |
| Grape Juice | 1 grape, 1 empty jar |
| Berry Milk | 1 milk, (1 red berry or 1 strawberry) |
| Salad | 2 carrot, 2 tomato, 6 lettuce, 2 cucumber |
Contoh
player.combine(jar)
Kod ini akan membuat pemain mengambil segala-galanya dalam senarai yang dinamakan “jar” dan menggabungkannya untuk membentuk item/objek baru.

plant()
Sintaks
player.plant(dictionary,key)
Fungsi ini digunakan untuk menanam objek ke dalam tanah, yang biasanya diperuntukkan untuk menanam tanaman. Fungsi ini menggunakan kamus (dictionaries), ia mengambil 2 argumen, nama kamus dan kunci kamus tersebut.
Contoh
player.plant(seeds, "Eggplant")
player.water()
Dalam kod di atas, pemain menanam benih terung ke dalam tanah dan kemudian menyiramnya.

write()
Sintaks
await player.write(message)
Membenarkan mesej untuk dipaparkan, ini adalah fungsi async yang membolehkan pop-up menunjukkan mesej yang dimuat ke dalam fungsi. Program akan berhenti seketika sehingga mesej ditutup.
Contoh
await player.write("Hello World")
Dalam kod di atas, mesej pop-up dipaparkan dengan mesej "Hello World" yang memberhentikan program sehingga pemain menutup mesej tersebut.

read()
Sintaks
await player.read()
Membenarkan mesej untuk dipaparkan, ini adalah fungsi async yang membolehkan pop-up menunjukkan mesej yang telah direkodkan terlebih dahulu dalam level. Program akan berhenti sehingga mesej ditutup.
Contoh
await player.read()
Dalam kod di atas, mesej pop-up dipaparkan dengan mesej yang telah direkodkan terlebih dahulu yang disematkan secara manual dalam level, memberhentikan program sehingga pemain menutup mesej tersebut.

question()
Sintaks
await player.question(question)
Membenarkan mesej untuk dipaparkan dengan soalan ya atau tidak, ini adalah fungsi async yang membolehkan pop-up menunjukkan mesej yang disediakan dan menghasilkan pembolehubah Boolean berdasarkan input.
Contoh
async def question_function():
answer = await player.question("Question you would like to ask")
if answer:
# Actions to take if answer is Yes
else:
# Actions to take if answer is No
Dalam kod di atas, mesej pop-up dipaparkan dengan soalan yang mempunyai butang ya dan tidak, memberhentikan program sehingga pemain membuat pilihan.

display()
Sintaks
await player.display("message")
Membenarkan mesej untuk dipaparkan, ini adalah fungsi async yang membolehkan pop-up menunjukkan mesej yang tidak mempunyai data pra-rakaman. Ini direka untuk digunakan memaparkan data mentah yang tidak boleh dikodkan dengan sempurna. Program akan berhenti sehingga mesej ditutup. Apabila ditetapkan secara dalaman, tiada kandungan yang dikodkan boleh disertakan agar ia boleh memaparkan apa sahaja.
Contoh
await player.display("Whatever I want to put here")
Dalam kod di atas, mesej pop-up dipaparkan dengan apa sahaja mesej yang anda masukkan tanpa mengira apa ianya. Dalam kes ini ia memaparkan "Whatever I want to put here".
