Edytujesz Blok testowy

{{Ekskluzywne|java}}
{{Blok
|wygląd=Blok testowy rozpoczęcie.png; Blok testowy rejestr.png; Blok testowy niepowodzenie.png; Blok testowy zaliczenie.png
|wygląd2=Blok instancji testowej.png
|invwygląd=Blok testowy start
|invwygląd2=Blok instancji testowej
|typ=Przybory operatora
|fizyka=Nie
|przezroczystość=Nie
|światło=Nie
|palność=Nie
|narzędzie=Żadne
|odnawialne=Nie
|łączenie=Tak (64)
|rzadkość=Epicka
}}
'''Blok testowy''' (ang. ''Test Block'') oraz '''blok instancji testowej''' (ang. ''Test Instance Block'') - bloki umożliwiające przeprowadzanie testów na mechanikach gry. Używają one funkcji, która w kodzie gry jest nazwana „GameTest”.

== Otrzymywanie ==
Bloki występują w ekwipunku [[Tryb kreatywny|trybu kreatywnego]] tylko wtedy, gdy gracz ma włączoną [[Ustawienia|opcję]] „Przybory operatora”. W trybie przetrwania są niezniszczalne i niemożliwe do zdobycia.

Blok testowy występuje w czterech stanach: {{BlockSprite|blok-testowy-rozpoczęcie}} „rozpoczęcie”, {{BlockSprite|blok-testowy-rejestr}} „rejestr”, {{BlockSprite|blok-testowy-niepowodzenie}} „niepowodzenie” i {{BlockSprite|blok-testowy-zaliczenie}} „zaliczenie”. Każdy z tych stanów jest dostępny na karcie przyborów operatora.

== Zastosowanie ==
Bloki testowe umożliwiają przeprowadzanie w grze odpowiednika [https://pl.wikipedia.org/wiki/Test_jednostkowy testów jednostkowych] na oprogramowaniu. Ich głównym zastosowaniem jest sprawdzanie przez gracza, jak dana [[modyfikacja]] lub [[paczka danych]], którą zainstalował, wpływa na konkretną mechanikę gry. Również konkretne testy mogą być zapisywane w paczkach danych: bloki testowe nie są zbyt użyteczne bez zastosowania paczek, jako że jedynym testem domyślnie wbudowanym w grę jest <code>always_pass</code>, który zawsze daje wynik „zaliczony”.

Testy mają przypisane:
* Typ <code>block_based</code> lub <code>function</code>. Pierwszy bazuje na blokach testowych, drugi natomiast wykorzystuje funkcje i jest niemożliwy do użycia bez użycia narzędzi deweloperskich lub modyfikacji.
* Strukturę testową, przywoływaną przez blok instancji testowej.
* Środowisko testowe, czyli zbiór warunków gry, w jakich przeprowadzany jest test. W skład środowiska testowego wchodzą np. [[zasady gry]], [[pogoda]] oraz pora dnia/nocy.

Dokładne działanie wraz z przykładowym testem zostało objaśnione w [https://www.youtube.com/watch?v=6elLSg0y7X4 tym filmie] (ang.)

=== Blok instancji testowej ===
[[Plik:interfejs_BIT.png|left|thumb|Domyślny interfejs bloku instancji testowej]]
Blok ten funkcjonuje podobnie do [[Blok struktur|bloku struktur]]. Pola „Rozmiar struktury testu” definiują wymiary X, Y i Z przestrzeni, w której będzie odbywał się test. Po wpisaniu tych wartości i naciśnięciu przycisku „Gotowe” wyświetli się obrys przestrzeni testowej, zawsze na południowy wschód od bloku instancji (w kierunku +X, +Z). Można ponadto ustawić kąt obrotu struktury testowej i obecność [[byt]]ów.

Jeśli wgrana jest paczka danych z testami, w bloku instancji można wybrać test, a on wyświetli informacje o teście i przywoła odpowiadającą strukturę testową. Test można uruchomić przyciskiem „Wczytaj i uruchom”.

W zależności od wyniku testu, blok wyemituje z siebie kolorową pionową strugę światła, taką samą, jak [[magiczna latarnia]]. Struga będzie w kolorze szarym podczas trwania testu, zielona po zaliczeniu testu, a czerwona po jego niezaliczeniu.

{{-}}
=== Bloki testowe ===
Każdy typ ma własny, prosty interfejs. Pomiędzy typami można przełączać przyciskiem, który widnieje ponad przyciskiem „Gotowe”.

<gallery>
interfejs_BT_rozpoczęcie.png|Interfejs bloku testowego w trybie „rozpoczęcie“
interfejs_BT_rejestr.png|Interfejs bloku testowego w trybie „rejestr“
interfejs_BT_niepowodzenie.png|Interfejs bloku testowego w trybie „niepowodzenie“
interfejs_BT_zaliczenie.png|Interfejs bloku testowego w trybie „zaliczenie“
</gallery>

Blok „rozpoczęcie“ wysyła pojedynczy sygnał redstone w momencie rozpoczęcia testu. Blok „zaliczenie“, otrzymawszy sygnał redstone, powoduje zakończenie testu z wynikiem pozytywnym, a blok „niepowodzenie“ z wynikiem negatywnym. Oba mogą wysłać przy tym opcjonalną wiadomość. Blok „rejestr“ służy wyłącznie do wysyłania wiadomości.

== Wartości danych ==
=== ID ===
{| class="wikitable"
|-
! Nazwa !! ID słowne !! Forma !! Klucz tłumaczenia
|-
|{{BlockSprite|blok-testowy}} Blok testowy
|{{Code|test_block}}
|Blok, przedmiot
|{{Code|block.minecraft.test_block}}
|-
|{{BlockSprite|blok-instancji-testowej}} Blok instancji testowej
|{{Code|test_instance_block}}
|Blok, przedmiot
|{{Code|block.minecraft.test_instance_block}}
|}

=== Stany bloku ===
Tylko blok testowy posiada stany bloku.
{| class="wikitable"
|-
! Nazwa !! Wartość domyślna !! Możliwe wartości !! Opis
|-
|{{code|mode}} || {{code|start}} || {{code|start}}<br>{{code|log}}<br>{{code|fail}}<br>{{code|accept}} || Funkcja, którą pełni blok testowy.
|}

== Historia ==
{{Historia|w}}
{{Historia||1.15|snap=19w34a|Pierwsze użycie funkcji „GameTest” w kodzie gry.}}
{{Historia||1.17|snap=21w13a|Funkcja „GameTest” może być używana przez twórców [[Modyfikacje|modyfikacji]] do gry.}}
{{Historia||1.21.5|snap=25w03a|Dodano bloki testowe i bloki instancji testowej.
|Funkcja „GameTest” stała się prostsza w użyciu i umożliwiają to [[Paczka danych|paczki danych]].}}
{{Historia|||snap=25w10a|Zmieniono tekstury bloków testowych i bloków instancji testowej.}}
{{Historia|foot}}

{{Bloki}}

[[de:Testblock]]
[[en:Test Block]]
[[es:Bloque de pruebas]]
[[fr:Bloc de test]]
[[it:Blocco di test]]
[[ja:テストブロック]]
[[ko:테스트 블록]]
[[pt:Bloco de Teste]]
[[ru:Тестовый блок]]
[[uk:Тестовий блок]]
[[zh:测试方块]]