Generazione di Traduzioni 1.21.4

Una guida per configurare la generazione di traduzioni con datagen.

WARNING

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

PREREQUISITI

Assicurati di aver prima completato il processo di configurazione della datagen.

Configurazione

Anzitutto, creeremo il nostro fornitore. Ricorda: i fornitori sono ciò che ci genera effettivamente i dati. Crea una classe che extends FabricLanguageProvider e compilane i metodi di base:

public class FabricDocsReferenceEnglishLangProvider extends FabricLanguageProvider {
	protected FabricDocsReferenceEnglishLangProvider(FabricDataOutput dataOutput, CompletableFuture<HolderLookup.Provider> registryLookup) {
		// Specifying en_us is optional, as it's the default language code
		super(dataOutput, "en_us", registryLookup);
	}

	@Override
	public void generateTranslations(HolderLookup.Provider wrapperLookup, TranslationBuilder translationBuilder) {
	}
}

TIP

Ti servirà un fornitore diverso per ogni lingua che vorrai generare (per esempio un ExampleEnglishLangProvider e un ExamplePirateLangProvider).

Per completare la configurazione, aggiungi questo fornitore alla tua DataGeneratorEntrypoint nel metodo onInitializeDataGenerator.

pack.addProvider(FabricDocsReferenceItemTagProvider::new);

Creare Traduzioni

Oltre a creare traduzioni crude, traduzioni da ResourceLocation, e copiarli da un altro file esistente (passando un Path), ci sono metodi ausiliari per tradurre oggetti, blocchi, tag, statistiche, entità, effetti di stato, gruppi di oggetti, attributi di entità, e incantesimi. Basta chiamare add sul translationBuilder con ciò che vuoi tradurre e ciò a cui dovrebbe essere tradotto:

translationBuilder.add("text.fabric_docs_reference.greeting", "Hello there!");

Usare le Traduzioni

Le traduzioni generate prendono il posto di molte traduzioni aggiunte in altri tutorial, ma puoi anche usarle in ogni punto in cui usi un oggetto Component. Nel nostro esempio, se volessimo permettere ai pacchetti risorse di tradurre il nostro saluto, usiamo Component.translatable invece di Component.nullToEmpty:

ChatHud chatHud = Minecraft.getInstance().gui.getChat();
chatHud.addMessage(Component.literal("Hello there!")); 
chatHud.addMessage(Component.translatable("text.fabric_docs_reference.greeting"));