11.1 - Basic API (Podstawowe API)

etc/doc/tutorial/pl/11.1-Basic-API.md

@@ -1,136 +1,141 @@
-11.1 Basic API
+11.1 Podstawowe API
 
-# Basic Minecraft Pi API
+# Podstawowe API oferowane przez Minecraft Pi
 
-Sonic Pi currently supports the following basic interactions with Minecraft Pi:
+Sonic Pi aktualnie wspiera następujące podstawowe interakcje z Minecraft Pi: 
 
-* Displaying chat messages
-* Setting the position of the user
-* Getting the position of the user
-* Setting the block type at a given coordinate
-* Getting the block type at a given coordinate
+* Wyświetlanie wiadomości czat
+* Ustawianie pozycji gracza
+* Odczyt pozycji gracza
+* Ustawianie typu bloku na podanych współrzędnych
+* Zabieranie typu bloku na podanych współrzędnych
 
+Spróbujmy przyjrzeć się każemu z nich po kolei.
 
-Let's look at each of these in turn.
+## Wyświetlanie wiadomości w czacie
 
-## Displaying chat messages
+Zobaczmy jak łatwo jest kontrolować Minecraft Pi z Sonic Pi. Najpierw, 
+upewnij się, że zarówno Minecraft Pi jak i Sonic Pi są jednocześnie 
+otwarte a także, upewnij się, że udało Ci się wejść do świata Minecraft 
+i możesz się poruszać.
 
-Let's see just how easy it is to control Minecraft Pi from Sonic
-Pi. First, make sure you have both Minecraft Pi and Sonic Pi open at the
-same time and also make sure you've entered a Minecraft world and can
-walk around.
-
-In a fresh Sonic Pi workspace simply enter the following code:
+W czystym buforze Sonic Pi po prostu wprowadź poniższy kod: 
 
 ```
 mc_message "Hello from Sonic Pi"
 ```
 
-When you hit the *Run* button, you'll see your message flash up on the
-Minecraft window. Congratulations, you've written your first Minecraft
-code! That was easy wasn't it.
+Kiedy naciśniesz przycisk *Run*, zobaczysz migającą wiadomość w ekranie 
+Minecraft. Gratulacje, właśnie napisałeś swój pierwszy kod w Minecraft! 
+To było proste, prawda?
 
-## Setting the position of the user
+## Ustawianie pozycji gracza
 
-Now, let's try a little magic. Let's teleport ourselves somewhere! Try
-the following:
+Teraz, spróbujmy odrobine magii. Spróbujmy przeteleportować nas 
+w inne miejsce. Spróbuj następującego kodu: 
 
 ```
 mc_teleport 50, 50, 50
 ```
 
-When you hit *Run* - boom! You're instantantly transported to a new
-place. Most likely it was somewhere in the sky and you fell down either
-to dry land or into water. Now, what are those numbers: `50, 50, 50`?
-They're the coordinates of the location you're trying to teleport
-to. Let's take a brief moment to explore what coordinates are and how
-they work because they're really, really important for programming
+Kiedy naciśniesz *Run* - bum! Zostajesz błyskawicznie przetransportowany 
+w nowe miejsce. Bardzo prawdopodobne jest to, że to gdzieś w powietrzu 
+i spadniesz w dół na suchy ląd lub do wody. Teraz, co to za liczby: 
+`50, 50, 50`? Są to współrzędne miejsca do którego starasz się 
+przetleportować. Poświęćmy krótką chwilę żeby dowiedzieć się czym są 
+współrzędne i jak działają, ponieważ są one naprawdę ważne w programowaniu 
 Minecraft.
 
-## Coordinates
+## Współrzędne
+
+Wyobraź sobie mapę piratów z wielkim `X` oznacającym miejsce jakiegoś 
+skarbu. Dokładna lokalizacja `X` może być opisana przez podanie 
+dwóch liczb - jak daleko na mapie od lewej do prawej oraz jak daleko 
+od dołu mapy w górę. Na przykład `10cm` wszerz i `8cm` w górę. Te dwie 
+liczby `10` i `8` to współrzędne. Możesz bardzo łatwo wyobrazić sobie 
+opisywanie sekretnych miejsc ze skarbami za pomocą innej pary liczb. 
+Być może bardzo duża skrzynia złota znajduje się na `2` w poprzek 
+`9` w górę. 
 
-Imagine a pirate's map with a big `X` marking the location of some
-treasure. The exact location of the `X` can be described with two
-numbers - how far along the map from left to right and how far along the
-map from bottom to top. For example `10cm` across and `8cm` up. These
-two numbers `10` and `8` are coordinates. You could easily imagine
-describing the locations of other stashes of treasure with other pairs
-of numbers. Perhaps there's a big chest of gold at `2` across and `9`
-up...
+Teraz, w Minecraft dwie liczby to za mało. Potrzebujemy także wiedzieć 
+o tym, jak wysoko się znajdujemy. Dlatego też potrzebujemy 3 liczb: 
 
-Now, in Minecraft two numbers isn't quite enough. We also need to know
-how high we are. We therefore need three numbers:
+* Jak daleko od prawej do lewej w naszym świecie - `x`
+* jak daleko od przodu do tyłu w naszym świecie - `z`
+* Jak wysoko znajdujemy się w naszym świecie - `y`
 
-* How far from right to left in the world - `x`
-* How far from front to back in the world - `z`
-* How high up we are in the world - `y`
-One more thing - we typically describe these coordinates in this order
-`x`, `y`, `z`.
+Jeszcze jedna rzecz - zazwyczaj opisujemy te współrzędne w następującej 
+kolejności `x`, `y`, `z`.
 
-## Finding your current coordinates
+## Odczytywanie twojej aktualnej lokalizacji
 
-Let's have a play with coordinates. Navigate to a nice place in the
-Minecraft map and then switch over to Sonic Pi. Now enter the following:
+Spróbujmy pobawić się współrzędnymi. Przenieść się do jakiegoś 
+ładnego miejsca na mapie Minecraft następnie przełącz się do Sonic Pi. 
+Teraz wpisz następującą linijkę:
 
 ```
 puts mc_location
 ```
 
-When you hit the *Run* button you'll see the coordinates of your current
-position displayed in the log window. Take a note of them, then move
-forward in the world and try again. Notice how the coordinates changed!
-Now, I recommend you spend some time repeating exactly this - move a bit
-in the world, take a look at the coordinates and repeat. Do this until
-you start to get a feel for how the coordinates change when you
-move. Once you've understood how coordinates work, programming with the
-Minecraft API will be a complete breeze.
+Kiedy uruchomisz przycis *Run* zobaczysz współrzędne twojego aktualnego 
+położenia wyświetlone w panelu z logami. Zapisz je, następnie spróbuj 
+przemieścić się do przodu w świecie i spróbuj jeszcze raz. Zauważ, że 
+współrzędne się zmieniły! Teraz, zalecam Ci poświęcić Ci trochę czasu 
+na powtórzenie tego kilka razy - przenieś się gdzieś kawałek w twoim 
+świecie, zerknij na współrzędne i powtórz. Próbuj tego do momentu, 
+w którym poczujesz jak zmieniają się współrzędne gdy się poruszasz. 
+Gdy już zrozumiesz jak działają współrzędne, programowanie z API 
+oferowanym przez Minecraft będzie dla Ciebie bułką z masłem.
 
-## Let's Build!
+## Zbudujmy Coś!
 
-Now that you know how to find the current position and to teleport using
-coordinates, you have all the tools you need to start building things in
-Minecraft with code. Let's say you want to make the block with
-coordinates `40`, `50`, `60` to be glass. That's super easy:
+Teraz gdy już wiesz w jaki sposob znaleźć aktualną pozycje oraz w jaki 
+sposob możesz się teleportować korzystając z współrzędnych, posiadasz 
+już wszystkie narzędzia, których potrzebujesz aby zacząć budować rzeczy 
+w Minecraft za pomocą kodu. Powiedzmy, że chciałbyś stworzyć blok ze szkła 
+o współrzędnych `40`, `50`, `60`. Proste: 
 
 ```
 mc_set_block :glass, 40, 50, 60
 ```
 
-Haha, it really was that easy. To see your handywork just teleport
-nearby and take a look:
+Tak, tak, to naprawde jest takie proste. Aby obejrzeć swoje dzieło 
+po prostu przeteleportuj się niedaleko i zerknij na nie: 
+
 
 ```
 mc_teleport 35, 50, 60
 ```
 
-Now turn around and you should see your glass block! Try changing it to
-diamond:
+Teraz obróć się i powinieneś zobaczyć twój blok ze szkła. Spróbuj zmienić 
+go w diament: 
 
 ```
 mc_set_block :diamond, 40, 50, 60
 ```
 
-If you were looking in the right direction you might have even seen it
-change in front of your eyes! This is the start of something exciting...
+Jeśli patrzyłeś w odpowiednim kierunku to być może nawet zauważyłeś 
+jak zmienił się na twoich oczach! To początek czegoś ekscytującego...
 
-## Looking at blocks
+## Patrzenie na Bloki
 
-Let's look at one last thing before we move onto something a bit more
-involved. Given a set of coordinates we can ask Minecraft what the type
-of a specific block is. Let's try it with the diamond block you just
-created:
+Spróbujmy spojrzeć na ostatnią rzecz zanim zaczniemy coś bardziej 
+angażującego. Podająć zestaw współrzędnych możemy zapytać Minecraft 
+o to jakiego typu jest specyficzny blok. Spróbujmy tego z naszym 
+blokiem diamentu, który stworzyłeś przed chwilą:
 
 ```
 puts mc_get_block 40, 50, 60
 ```
 
-Yey! It's `:diamond`. Try changing it back to glass and asking again -
-does it now say `:glass`? I'm sure it does :-)
+Łał! To diament (`:diamond`)!. Spróbuj ponownie zmienić go w szkło 
+i jeszcze raz zapytać o typ - czy teraz pokazał szkło (`:glass`). 
+Jestem pewien, że tak :-)
 
-## Available block types
+## Dostępne typy bloków
 
-Before you go on a Minecraft Pi coding rampage, you might find this list
-of available block types useful:
+Zanim udasz oddasz się szaleństwu programowania z Minecraft Pi, być może 
+zainteresuje Cie poniższa lista dostępnych typów bloków:
 
         :air
         :stone