Blok testowy

Ten element dotyczy wyłącznie Java Edition.

Blok testowy

Typ	Przybory operatora
Fizyka	Nie
Przezroczystość	Nie
Emisja światła	Nie
Odporność na eksplozje	3 600 000
Palność	Nie
Rzadkość	Epicka
Narzędzie	Żadne
Odnawialne	Nie
Możliwość grupowania	Tak (64)

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 trybu kreatywnego tylko wtedy, gdy gracz ma włączoną opcję „Przybory operatora”. W trybie przetrwania są niezniszczalne i niemożliwe do zdobycia.

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

Zastosowanie

Bloki testowe umożliwiają przeprowadzanie w grze odpowiednika 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 always_pass, który zawsze daje wynik „zaliczony”.

Testy mają przypisane:

• Typ block_based lub function. 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 tym filmie (ang.)

Blok instancji testowej

Domyślny interfejs bloku instancji testowej

Blok ten funkcjonuje podobnie do 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”.

• 
  Interfejs bloku testowego w trybie „rozpoczęcie“
• 
  Interfejs bloku testowego w trybie „rejestr“
• 
  Interfejs bloku testowego w trybie „niepowodzenie“
• 
  Interfejs bloku testowego w trybie „zaliczenie“

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

Nazwa	ID słowne	Forma	Klucz tłumaczenia
Blok testowy	test_block	Blok, przedmiot	block.minecraft.test_block
Blok instancji testowej	test_instance_block	Blok, przedmiot	block.minecraft.test_instance_block

Stany bloku

Tylko blok testowy posiada stany bloku.

Nazwa	Wartość domyślna	Możliwe wartości	Opis
mode	start	start log fail accept	Funkcja, którą pełni blok testowy.

Historia

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