Generazione di Traduzioni 26.2

Una guida per configurare la generazione di traduzioni con datagen.

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 estenda FabricLanguageProvider e compilane i metodi di base:

public class ExampleModEnglishLangProvider extends FabricLanguageProvider {
	public ExampleModEnglishLangProvider(FabricPackOutput 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 holderLookup, 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(ExampleModEnglishLangProvider::new);

Creare Traduzioni

Oltre a creare traduzioni crude, traduzioni da Identifier, e copiarli da un altro file esistente (passando un Path), ci sono metodi ausiliari per tradurre oggetti, blocchi, tag, statistiche, entità, effetti dei mob, schede dell'inventario, 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.example-mod.greeting", "Hello there!");

È anche possibile importare le traduzioni da un file JSON già esistente nella tua mod. Metti il file da qualche parte fuori dalla cartella generata, poi passa il percorso a translationBuilder.add:

{
  "text.example-mod.existing": "Loaded from an existing language file."
}

try {
	Path existingLanguageFile = packOutput.getModContainer()
			.findPath("assets/example-mod/lang/en_us.existing.json")
			.orElseThrow();
	translationBuilder.add(existingLanguageFile);
} catch (IOException e) {
	throw new RuntimeException("Failed to add existing language file", e);
}

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.literal:

ChatComponent chatHud = Minecraft.getInstance().gui.getChat();
chatHud.addMessage(Component.literal("Hello there!")); 
chatHud.addMessage(Component.translatable("text.example-mod.greeting"));