Teacher's Guide
move_forward()
Składnia
player.move_forward([number of steps])
Funkcja ta służy do przesuwania gracza do przodu w kierunku, w którym patrzy, o ile nie występuje kolizja blokująca trajektorię gracza. Możesz określić liczbę kroków, które funkcja ma wykonać, lub pozostawić ten argument pusty, co spowoduje wykonanie akcji tylko raz.
Jeśli funkcja nie otrzyma żadnych argumentów, gracz przesunie się o jeden krok do przodu.
Przykład
player.move_forward(3)
Ten kod spowoduje, że gracz przesunie się o trzy kroki do przodu na mapie.

turn_left()
Składnia
player.turn_left()
Funkcja ta powoduje, że gracz skręca w lewo, zmieniając kierunek na lewy względem aktualnego ustawienia.
Przykład
player.turn_left()
player.move_forward()
Ten kod spowoduje, że gracz skręci w lewo względem swojego aktualnego kierunku i przesunie się do przodu w tym kierunku.

turn_right()
Składnia
player.turn_right()
Funkcja ta powoduje, że gracz skręca w prawo, zmieniając kierunek na prawy względem aktualnego ustawienia.
Przykład
player.turn_right()
player.move_forward()
Ten kod spowoduje, że gracz skręci w prawo względem swojego aktualnego ustawienia i przesunie się do przodu w tym kierunku.

push()
Składnia
player.push()
Funkcja ta służy do popchnięcia obiektu przez gracza w kierunku, w którym patrzy, o ile nie występuje kolizja blokująca trajektorię obiektu.
Przykład
player.turn_left()
player.push()
Ten kod spowoduje, że gracz skręci w lewo i popchnie ruchomy obiekt w kierunku, w którym patrzy.

speak()
Składnia
player.speak([string to speak])
Funkcja ta powoduje, że gracz wypowiada ciąg znaków podany jako argument funkcji. W grze jest to przedstawione przez wyświetlenie napisu nad głową gracza.
Przykład
player.speak("Hello World")
Ten kod spowoduje, że nad głową gracza pojawi się napis "Hello World".

build()
Składnia
player.build([object to build])
Funkcja ta służy do budowania obiektu określonego jako argument. Dostępny jest ograniczony wybór obiektów, które gracz może zbudować za pomocą tej funkcji, a budowa każdego z nich wiąże się z określonymi wymaganiami. Obiekty zostaną zbudowane przed graczem, w kierunku, w którym patrzy, o ile teren nie jest zajęty przez inny obiekt lub dany obiekt nie może być zbudowany na tym typie terenu.
| Obiekt | Koszt | Argument | Opis |
|---|---|---|---|
| Most | 4 kłody | "bridge" | Buduje most umożliwiający przejście |
| Stos zbóż | 4 grain | Class Object Name | Tworzy stos zbóż |
| Drewniana droga | 4 deski | Class Object Name | Dodaje pasek drewnianej ścieżki |
| Kamienna droga | 4 stone | Class Object Name | Dodaje pasek kamiennej ścieżki |
| Duży zielony dom | 4 deski | Class Object Name | Buduje Kurnik |
| Mały niebieski dom | 4 deski | Class Object Name | Buduje Kurnik |
| Duży pomarańczowy dom | 4 deski | Class Object Name | Buduje Kurnik |
| Mały czerwony dom | 4 deski | Class Object Name | Buduje Kurnik |
Przykład
player.build("bridge")
Ten kod spowoduje, że gracz zbuduje most przed sobą, w kierunku, w którym patrzy.

water()
Składnia
player.water()
Funkcja ta służy do podlewania obiektów w grze, takich jak uprawy lub napełnianie tacek wodnych. W grze zazwyczaj wykorzystywana jest przy pracach rolniczych i gospodarstwach.
Przykład
player.water()
Dzięki temu kodowi gracz może podlać obiekt w kierunku, w którym patrzy.

collect()
Składnia
player.collect(string)
Funkcja ta służy do zbierania zasobów, które nie trafiają do ekwipunku. Zazwyczaj używana jest do uzupełniania elementów ekwipunku, które mogą się wyczerpać, na przykład do napełnienia kantyny wodą.
Przykład
player.collect("water")
player.turn_left()
player.water()
Ten kod spowoduje, że gracz zbierze wodę ze źródła, w kierunku którego patrzy, następnie skręci w lewo, aby podlać obiekt.

open()
Składnia
player.open()
Funkcja ta służy do otwierania drzwi i pojemników, co bywa przydatne przy przekraczaniu wejść lub otwieraniu pojemników w celu zabrania lub umieszczenia obiektów.
Przykład
player.turn_left()
player.open()
player.move_forward()
Ten kod spowoduje, że gracz skręci w lewo, aby otworzyć drzwi, a następnie przejdzie przez nie.

close()
Składnia
player.close()
Funkcja ta służy do zamykania drzwi i pojemników, co może być przydatne, gdy trzeba zamknąć drzwi za sobą lub po umieszczeniu czegoś wewnątrz pojemnika.
Przykład
player.open()
player.collect("item")
player.close()
Ten kod spowoduje, że gracz otworzy skrzynię, zbierze przedmiot, a następnie zamknie skrzynię.

place()
Składnia
player.place(object)
Funkcja ta służy do umieszczania obiektu, przedmiotu lub zmiennej w miejscu, gdzie dozwolone jest umieszczanie przedmiotów. Zwykle używana jest do przechowywania przedmiotów w pojemniku lub ustawiania obiektów w wyznaczonych miejscach.
Przykład
wheat = 6
player.place(wheat)
Ten kod ilustruje, jak gracz przechowuje wartość w zmiennej o nazwie wheat, a następnie funkcja place() umieszcza tę zmienną w wyznaczonym miejscu.

combine()
Składnia
player.combine(mixture)
Funkcja ta służy do łączenia różnych obiektów w celu stworzenia zupełnie nowego przedmiotu. Zwykle używana jest do łączenia składników w celu przygotowania jedzenia, napoju lub innych substancji.
| Kombinacja | Składniki |
|---|---|
| Sos rzodkiewkowy | 3 milk, 2 cream, 3 lettuce, 5 radish |
| Sok owocowy | 1 water, 1 empty jar, 1 orange, 1 peach, 1 pear, 1 apple |
| Sok winogronowy | 1 grape, 1 empty jar |
| Mleko jagodowe | 1 milk, (1 red berry or 1 strawberry) |
| Sałatka | 2 carrot, 2 tomato, 6 lettuce, 2 cucumber |
Przykład
player.combine(jar)
Ten kod spowoduje, że gracz weźmie wszystko z listy o nazwie "jar" i połączy je, tworząc nowy przedmiot/obiekt.

plant()
Składnia
player.plant(dictionary,key)
Funkcja ta służy do sadzenia obiektów w ziemi, co zazwyczaj dotyczy uprawy roślin. Funkcja korzysta ze słowników, przyjmując dwa argumenty: nazwę słownika oraz klucz słownika.
Przykład
player.plant(seeds, "Eggplant")
player.water()
W powyższym kodzie gracz sadzi nasiona bakłażana w ziemi, a następnie je podlewa.

write()
Składnia
await player.write(message)
Funkcja ta pozwala wyświetlić wiadomość. Jest to funkcja asynchroniczna (async), która wyświetla okienko z komunikatem podanym jako argument. Program zostaje wstrzymany do momentu zamknięcia wiadomości.
Przykład
await player.write("Hello World")
W powyższym kodzie wyświetlane jest okienko z komunikatem "Hello World", a program zostaje wstrzymany do momentu, gdy gracz zamknie wiadomość.

read()
Składnia
await player.read()
Funkcja ta pozwala wyświetlić wiadomość. Jest to funkcja asynchroniczna (async), która wyświetla okienko z wcześniej nagraną wiadomością osadzoną w poziomie. Program zostaje wstrzymany do momentu zamknięcia wiadomości.
Przykład
await player.read()
W powyższym kodzie wyświetlane jest okienko z nagraną wiadomością umieszczoną na poziomie, co powoduje wstrzymanie programu do momentu, gdy gracz zamknie wiadomość.

question()
Składnia
await player.question(question)
Funkcja ta pozwala wyświetlić komunikat z pytaniem typu tak lub nie. Jest to funkcja asynchroniczna (async), która wyświetla okienko z podanym pytaniem i zwraca wartość logiczną w zależności od odpowiedzi.
Przykład
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
W powyższym kodzie wyświetlane jest okienko z pytaniem oraz przyciskami "tak" i "nie", co powoduje wstrzymanie programu do momentu dokonania wyboru przez gracza.

display()
Składnia
await player.display("message")
Funkcja ta pozwala wyświetlić wiadomość. Jest to funkcja asynchroniczna, która wyświetla okienko z komunikatem, który nie posiada wstępnie zdefiniowanych danych. Służy do wyświetlania surowych danych, których nie można odpowiednio zaprogramować. Program zostaje wstrzymany do momentu zamknięcia wiadomości. Przy wewnętrznej konfiguracji nie można dołączyć żadnej zautomatyzowanej treści, aby umożliwić wyświetlenie czegokolwiek.
Przykład
await player.display("Whatever I want to put here")
W powyższym kodzie wyświetlane jest okienko z dowolną wiadomością, którą podasz, niezależnie od jej treści. W tym przypadku wyświetla się "Whatever I want to put here".
