Schermate personizzate

INFO

Questa pagina si riferisce a schermate normali, non quelle gestite - queste schermate sono quelle aperte dal giocatore sul client, non quelle gesitite dal server.

Le schermate sono essenzialmente le GUI con cui il giocatore interagisce, come lo schermo del titolo, la schermata di pausa ecc.

Puoi creare le tue schermate per mostrare contenuti personalizzati, un menu delle impostazioni personalizzato, e altro.

Creare una Schermata

Per creare una schermata, devi estendere la classe Screen e sovrascrivere il metodo init - puoi opzionalmente sovrascrive anche il metodo render - ma assicurati di chiamate il suo metodo super altrimenti non renderizzerà il background, i widget, ecc.

Dovresti prendere nota del fatto che:

• I Widget non vengono creati nel constructor perché la schermata non è stata ancora inizializzata a quel punto - e alcune variabili, come width e height, non sono ancora disponibili o non ancora accurate.
• Il metodo init viene chiamata quando lo schermo viene inizializzato, e questo è il posto migliore per create i widget.
  • Aggiungi i widget usando il metodo addDrawableChild, che accetta qualsiasi widget disegnabile.
• Il metodo render viene chiamato ogni frame - puoi accedere al contesto di disegno (draw context), e alla posizione del mouse da questo metodo.

Ad esempio, possiamo creare una semplice schermata che ha un bottone e un'etichetta al di sopra.

public class CustomScreen extends Screen {
		// :::3
		// Add a custom widget to the screen.
		// x, y, width, height
		CustomWidget customWidget = new CustomWidget(40, 80, 120, 20);
		this.addDrawableChild(customWidget);
		// :::3

Aprire la Schermata

Puoi aprire la schermata usando il metodo setScreen di MinecraftClient - puoi farlo da vari posti, come un'associazione ad un tasto, un comando, o un gestore dei pacchetti del client.

MinecraftClient.getInstance().setScreen(
  new CustomScreen(Text.empty())
);

Chiudere la Schermata

Se vuoi chiudere lo schermo, semplicemente imposta la schermada su null:

MinecraftClient.getInstance().setScreen(null);

Se vuoi essere sofisticato, e tornare alla schermata precedente, puoi passare la schermata corrente nel costruttore CustomScreen e conservalo in una variabile, per poi tornare alla schermata precedente usando il metodo close.

public Screen parent;
public CustomScreen(Text title, Screen parent) {
	super(title);
	this.parent = parent;
}

@Override
public void close() {
	this.client.setScreen(this.parent);
}

Ora, aprendo la schermata personalizzata, puoi passare la schermata corrente come secondo argomento - quindi quando chiami CustomScreen#close - ritornerà alla schermata precedente.

Screen currentScreen = MinecraftClient.getInstance().currentScreen;
MinecraftClient.getInstance().setScreen(
  new CustomScreen(Text.empty(), currentScreen)
);