Rendering nel HUD 1.21.11

Impara a usare l'API Fabric Hud per renderizzare sul HUD.

WARNING

Questa pagina si applica alla versione 1.21.11. La documentazione delle versioni meno recenti potrebbe essere incompleta.

Abbiamo già parlato brevemente di come renderizzare cose sulla HUD nelle pagine Concetti di Rendering di Base e Disegnare nella GUI, per cui in questa pagina ci concentreremo sull'API Hud e sul parametro DeltaTracker.

HudRenderCallback

WARNING

Nel passato Fabric ha fornito HudRenderCallback per renderizzare al HUD. A causa di alcuni cambiamenti al rendering nel HUD, questo evento è diventato estremamente limitato, ed è deprecato dalla versione 0.116 dell'API di Fabric. Usarlo è fortemente sconsigliato.

HudElementRegistry

Fabric fornisce l'API Hud per renderizzare e sovrapporre elementi nella HUD.

Per iniziare, dobbiamo registrare un listener a HudElementRegistry che registri i tuoi elementi. Ogni elemento è un HudElement. Un'istanza di HudElement è solitamente una lambda che accetta una GuiGraphics e un'istanza di DeltaTracker come parametro. Leggi HudElementRegistry e le Javadoc correlate per maggiori dettagli sull'uso dell'API.

Le grafiche GUI possono essere usate per accedere a varie utilità di rendering fornite dal gioco, e per accedere allo stack di matrici puro. Dovresti dare un'occhiata alla pagina Disegnare sulla GUI per saperne di più a riguardo.

Delta Tracker

La classe DeltaTracker ti permette di ottenere il valore corrente di gameTimeDeltaPartialTick. gameTimeDeltaPartialTick è l'"avanzamento" tra il tick del gioco precedente e quello successivo.

Per esempio, ipotizzando uno scenario a 200 FPS, il gioco esegue un nuovo tick più o meno ogni 10 frame. A ogni frame, gameTimeDeltaPartialTick indica quanto siamo distanti tra un tick e l'altro. Nel corso di 11 frame, potresti ottenere:

Frame	gameTimeDeltaPartialTick
1	1: Nuovo tick
2	1/10 = 0.1
3	2/10 = 0.2
4	3/10 = 0.3
5	4/10 = 0.4
6	5/10 = 0.5
7	6/10 = 0.6
8	7/10 = 0.7
9	8/10 = 0.8
10	9/10 = 0.9
11	1: Nuovo tick

Puoi ottenere gameTimeDeltaPartialTick chiamando deltaTracker.getGameTimeDeltaPartialTick(false), dove il parametro booleano è ignoreFreeze, che in sostanza ti permette semplicemente d'ignorare l'utilizzo del giocatore del comando /tick freeze.

In pratica, dovresti solo usare gameTimeDeltaPartialTick quando le tue animazioni dipendono dai tick di Minecraft. Per animazioni basate sul tempo usa Util.getMillis(), che misura il tempo del mondo reale.

In questo esempio, useremo Util.getMillis() per interpolare linearmente il colore di un quadrato che viene renderizzato nel HUD.

public class HudRenderingEntrypoint implements ClientModInitializer {
	@Override
	public void onInitializeClient() {
		// Attach our rendering code to before the chat hud layer. Our layer will render right before the chat. The API will take care of z spacing.
		HudElementRegistry.attachElementBefore(VanillaHudElements.CHAT, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "before_chat"), HudRenderingEntrypoint::render);
	}

	private static void render(GuiGraphics graphics, DeltaTracker tickCounter) {
		int color = 0xFFFF0000; // Red
		int targetColor = 0xFF00FF00; // Green

		// You can use the Util.getMillis() function to get the current time in milliseconds.
		// Divide by 1000 to get seconds.
		double currentTime = Util.getMillis() / 1000.0;

		// "lerp" simply means "linear interpolation", which is a fancy way of saying "blend".
		float lerpedAmount = Mth.abs(Mth.sin((float) currentTime));
		int lerpedColor = ARGB.linearLerp(lerpedAmount, color, targetColor);

		// Draw a square with the lerped color.
		// x1, x2, y1, y2, color
		graphics.fill(0, 0, 10, 10, lerpedColor);
	}
}

Perché non provi a usare gameTimeDeltaPartialTick e a vedere cosa succede all'animazione quando esegui il comando /tick freeze? Dovresti vedere che l'animazione si congela appena gameTimeDeltaPartialTick diventa una costante, supponendo di aver passato false come parametro di DeltaTracker#getGameTimeDeltaPartialTick.