Suggerimenti dei Comandi

Minecraft ha un potente sistema di suggerimento comandi che viene usato in molti posti, come nel comando /give. Questo sistema ti permette di suggerire valori per argomenti dei comandi all'utente, da cui possono poi selezionare - è un ottimo modo per rendere i tuoi comandi più user-friendly ed ergonomici.

Provider di Suggerimenti

Un SuggestionProvider viene usato per creare una lista di suggerimenti che verrà mandata al client. Un provider di suggerimenti è un'interfaccia funzionale che accetta un CommandContext e un SuggestionBuilder e restituisce alcune Suggestions. Il SuggestionProvider restituisce un CompletableFuture siccome i suggerimenti potrebbero non essere disponibili immediatamente.

Usare i Provider di Suggerimenti

Per usare un provider di suggerimenti, devi chiamare il metodo suggests nel costruttore di argomenti. Questo metodo accetta un SuggestionProvider e restituisce il costruttore di argomenti modificato con l'aggiunta del suggestion provider.

No lines matched.

No lines matched.

Provider di Suggerimenti Predefiniti

Ci sono alcuni provider di suggerimenti predefiniti che puoi usare:

Provider di Suggerimenti	Descrizione
SuggestionProviders.SUMMONABLE_ENTITIES	Suggerisce tutte le entità che possono essere evocate.
SuggestionProviders.AVAILABLE_SOUNDS	Suggerisce tutti i suoni che possono essere riprodotti.
LootCommand.SUGGESTION_PROVIDER	Suggerisce tutte le loot table disponibili.
SuggestionProviders.ALL_BIOMES	Suggerisce tutti i biomi disponibili.

Creare un Provider di Suggerimenti Personalizzato

Se un provider predefinito non soddisfa i tuoi requisiti, puoi creare il tuo provider di suggerimenti personalizzato. Per fare questo, devi creare una classe che implementa l'interfaccia SuggestionProvider e fare override del metodo getSuggestions.

Per questo esempio, creeremo un provider di suggerimenti che suggerisce tutti i nomi utente dei giocatori sul server.

No lines matched.

Per usare questo provider di suggerimenti, passeresti semplicemente una sua istanza al metodo .suggests nel costruttore di comandi.

No lines matched.

No lines matched.

Ovviamente, i provider di suggerimenti possono essere più complessi, siccome possono anche leggere il contesto dei comandi per fornire suggerimenti basati sullo stato del comando - per esempio quali argomenti sono già stati forniti.

Ciò potrebbe essere ad esempio leggere l'inventario del giocatore e suggerire oggetti, o entità che sono vicine al giocatore.