Teacher's Guide
move_forward()
Cú pháp
player.move_forward([number of steps])
Hàm này được sử dụng để di chuyển người chơi tiến về phía trước theo hướng mà họ đang đối mặt, miễn là không có va chạm cản trở quỹ đạo của người chơi. Bạn có thể chỉ định số bước muốn thực hiện lặp đi lặp lại hoặc để trống để hành động chỉ thực hiện một lần.
Nếu hàm không được cung cấp bất kỳ đối số nào, thì nó sẽ di chuyển người chơi tiến một bước.
Ví dụ
player.move_forward(3)
Mã này sẽ khiến người chơi di chuyển ba bước tiến về phía trước trên bản đồ.

turn_left()
Cú pháp
player.turn_left()
Hàm này được sử dụng để khiến người chơi quay trái, thay đổi hướng của họ sang bên trái của hướng hiện tại.
Ví dụ
player.turn_left()
player.move_forward()
Mã này sẽ khiến người chơi quay sang bên trái hướng hiện tại và tiến về phía trước theo hướng đó với mã tiếp theo.

turn_right()
Cú pháp
player.turn_right()
Hàm này được sử dụng để khiến người chơi quay phải, thay đổi hướng của họ sang bên phải của hướng hiện tại.
Ví dụ
player.turn_right()
player.move_forward()
Mã này sẽ khiến người chơi quay sang bên phải hướng hiện tại và tiến về phía trước theo hướng đó với mã tiếp theo.

push()
Cú pháp
player.push()
Hàm này được sử dụng để khiến người chơi đẩy một đối tượng theo hướng họ đang đối mặt, miễn là không có va chạm cản trở quỹ đạo của đối tượng.
Ví dụ
player.turn_left()
player.push()
Mã này sẽ khiến người chơi quay trái và đẩy một đối tượng di chuyển theo hướng mà họ đang đối mặt.

speak()
Cú pháp
player.speak([string to speak])
Hàm này được sử dụng để khiến người chơi nói ra một chuỗi được chỉ định trong đối số của hàm. Trong game, chuỗi này được hiển thị trên màn hình phía trên đầu người chơi.
Ví dụ
player.speak("Hello World")
Mã này sẽ hiển thị cụm từ “Hello World” phía trên đầu người chơi.

build()
Cú pháp
player.build([object to build])
Hàm này được sử dụng để khiến người chơi xây dựng một đối tượng được chỉ định trong đối số của hàm. Có một số đối tượng hạn chế mà người chơi có thể xây dựng bằng cách sử dụng hàm này và có những yêu cầu nhất định liên quan đến việc xây dựng mỗi đối tượng. Đối tượng sẽ được xây dựng phía trước hướng mà người chơi đang đối mặt, miễn là khu vực đó không bị chiếm bởi một đối tượng khác hoặc đối tượng không thể được xây dựng trên loại địa hình mà nó được xây dựng.
| Đối tượng | Chi phí | Đối số | Mô tả |
|---|---|---|---|
| Bridge | 4 logs | "bridge" | Xây cầu để vượt qua |
| Grain Stack | 4 grain | Class Object Name | Sản xuất thành khối ngũ cốc |
| Wood Road | 4 planks | Class Object Name | Thêm một dải lối đi bằng gỗ |
| Stone Road | 4 stone | Class Object Name | Thêm một dải lối đi bằng đá |
| Big Green house | 4 planks | Class Object Name | Xây Nhà Gà Lớn Màu Xanh |
| Small Blue house | 4 planks | Class Object Name | Xây Nhà Gà Nhỏ Màu Xanh |
| Big Orange house | 4 planks | Class Object Name | Xây Nhà Gà Lớn Màu Cam |
| Small Red house | 4 planks | Class Object Name | Xây Nhà Gà Nhỏ Màu Đỏ |
Ví dụ
player.build("bridge")
Mã này sẽ khiến người chơi xây một cây cầu phía trước theo hướng mà họ đang đối mặt.

water()
Cú pháp
player.water()
Hàm này có thể được sử dụng để tưới nước cho các đối tượng trong game, chẳng hạn như tưới cây trồng và nạp đầy khay nước. Trong game, điều này thường được sử dụng cho nông nghiệp và tự cung tự cấp.
Ví dụ
player.water()
Với mã này, người chơi có thể tưới nước cho một đối tượng theo hướng mà họ đang đối mặt.

collect()
Cú pháp
player.collect(string)
Hàm này được sử dụng để thu thập các tài nguyên mà bạn không thể giữ trong kho đồ của mình. Thường được sử dụng để bổ sung các mục kho có thể hết, ví dụ như nạp đầy bình nước.
Ví dụ
player.collect("water")
player.turn_left()
player.water()
Mã này sẽ khiến người chơi thu thập nước từ nguồn nước mà họ đang đối mặt, sau đó quay trái để tưới nước cho một đối tượng.

open()
Cú pháp
player.open()
Hàm này được sử dụng để mở cửa và các thùng chứa, điều này có thể hữu ích để vượt qua cửa vào hoặc mở thùng chứa để nhặt hoặc đặt các đối tượng.
Ví dụ
player.turn_left()
player.open()
player.move_forward()
Mã này sẽ khiến người chơi quay trái để mở cửa và sau đó đi qua nó.

close()
Cú pháp
player.close()
Hàm này được sử dụng để đóng cửa và các thùng chứa, điều này có thể hữu ích để đóng cửa sau khi đi qua hoặc đóng thùng chứa sau khi bạn đã đặt thứ gì đó vào bên trong.
Ví dụ
player.open()
player.collect("item")
player.close()
Mã này sẽ khiến người chơi mở một rương, nhặt một vật phẩm và sau đó đóng rương lại.

place()
Cú pháp
player.place(object)
Hàm này được sử dụng để đặt một đối tượng, món đồ hoặc biến vào vị trí cho phép đặt đối tượng. Thường được sử dụng để lưu trữ vật phẩm trong thùng chứa hoặc đặt các đối tượng ở các vị trí đã định.
Ví dụ
wheat = 6
player.place(wheat)
Mã này minh họa người chơi lưu trữ một số bên trong biến có tên wheat và sau đó sử dụng hàm place() để đặt biến vào vị trí được chỉ định.

combine()
Cú pháp
player.combine(mixture)
Hàm này được sử dụng để khiến người chơi kết hợp các đối tượng khác nhau lại với nhau để tạo ra một đối tượng hoàn toàn mới. Thường được sử dụng để kết hợp các thành phần tạo ra thức ăn, đồ uống hoặc các chất khác.
| Sự kết hợp | Các thành phần |
|---|---|
| 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 |
Ví dụ
player.combine(jar)
Mã này sẽ khiến người chơi lấy tất cả mọi thứ trong danh sách có tên “jar” và kết hợp chúng lại để tạo thành một món đồ/đối tượng mới.

plant()
Cú pháp
player.plant(dictionary,key)
Hàm này được sử dụng để trồng các đối tượng xuống đất, thường dành riêng cho việc trồng cây. Hàm này sử dụng dictionaries, nhận 2 đối số, tên của dictionary và key của dictionary.
Ví dụ
player.plant(seeds, "Eggplant")
player.water()
Trong đoạn mã trên, người chơi trồng hạt cà tím xuống đất và sau đó tưới nước cho chúng.

write()
Cú pháp
await player.write(message)
Cho phép hiển thị một thông điệp, đây là một hàm async cho phép hiển thị một popup chứa thông điệp được truyền vào hàm. Chương trình sẽ tạm dừng cho đến khi thông điệp được đóng lại.
Ví dụ
await player.write("Hello World")
Trong đoạn mã trên, một thông điệp popup sẽ hiển thị với nội dung "Hello World" và chương trình sẽ tạm dừng cho đến khi người chơi đóng thông điệp.

read()
Cú pháp
await player.read()
Cho phép hiển thị một thông điệp, đây là một hàm async cho phép hiển thị một popup với thông điệp đã được ghi sẵn trong level. Chương trình sẽ tạm dừng cho đến khi thông điệp được đóng lại.
Ví dụ
await player.read()
Trong đoạn mã trên, một thông điệp popup sẽ hiển thị với nội dung đã được ghi sẵn trong level, và chương trình sẽ tạm dừng cho đến khi người chơi đóng thông điệp.

question()
Cú pháp
await player.question(question)
Cho phép hiển thị một thông điệp kèm theo câu hỏi có hoặc không, đây là một hàm async cho phép hiển thị một popup với thông điệp được cung cấp và tạo ra một biến Boolean dựa trên lựa chọn của người dùng.
Ví dụ
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
Trong đoạn mã trên, một popup thông điệp sẽ hiển thị với câu hỏi kèm theo nút có và không, chương trình sẽ tạm dừng cho đến khi người chơi đưa ra lựa chọn.

display()
Cú pháp
await player.display("message")
Cho phép hiển thị một thông điệp, đây là một hàm async cho phép hiển thị một popup chứa thông điệp không có dữ liệu được ghi sẵn. Hàm này nhằm mục đích hiển thị dữ liệu thô mà không thể lập trình được một cách chính xác. Chương trình sẽ tạm dừng cho đến khi thông điệp được đóng lại. Khi được thiết lập nội bộ, không thể bao gồm nội dung có sẵn được lập trình để cho phép hiển thị bất cứ thứ gì.
Ví dụ
await player.display("Whatever I want to put here")
Trong đoạn mã trên, một popup thông điệp sẽ hiển thị với bất kỳ thông điệp nào bạn đặt vào, bất kể là gì. Trong trường hợp này, nó hiển thị "Whatever I want to put here".
