Membuat Teks

Teks API digunakan untuk membuat teks yang diformat, yang mana bisa dikirim ke pemain bentuk pesan obrolan, dan juga bisa digunakan di beberapa tempat seperti buku-buku dan tanda-tanda.

Teks yang tidak diformat

Seringkali, semua yang anda butuhkan adalah teks yang belum diformat. Terformat teks tidak memerlukan penggunaan teks pembangun, dan merupakan bentuk yang paling sederhana dari teks untuk membuat.

Contoh:

import org.spongepowered.api.text.Text;

Text unformattedText = Text.of("Hey! This is unformatted text!");

Kode kutipan digambarkan di atas akan kembali tidak berwarna, teks terformat dengan no tindakan teks dikonfigurasi.

Pembuat Teks

Teks pembangun antarmuka memungkinkan untuk penciptaan teks diformat dalam "blok bangunan" gaya.

Tip

Baca ini artikel Wikipedia untuk membantu pemahaman tujuan pembangun pola desain perangkat lunak.

Warna

Salah satu penggunaan teks builder adalah penambahan warna untuk teks, seperti yang digambarkan di bawah ini.

Contoh: Teks Berwarna

import org.spongepowered.api.text.format.TextColors;

Text coloredText = Text.builder("Woot! Golden text is golden.").color(TextColors.GOLD).build();

Setiap warna yang ditentukan dalam TextColors kelas dapat digunakan ketika mewarnai teks. Beberapa warna dapat digunakan dalam teks dengan menambahkan teks tambahan dengan warna yang berbeda:

Contoh: Teks Multi-warna

Text multiColoredText = Text.builder("Sponges are ").color(TextColors.YELLOW).append(
        Text.builder("invincible!").color(TextColors.RED).build()).build();

Penataan

Pembangun teks juga bisa digunakan untuk mode teks, termasuk menggaris bawahi, memiringkan, dll.

Contoh: Teks Bergaya

import org.spongepowered.api.text.format.TextStyles;

Text styledText = Text.builder("Yay! Styled text!").style(TextStyles.ITALIC).build();

Seperti dengan warna, beberapa gaya bisa digunakan dengan menggabung teks yang dibentuk secara terpisah.

Contoh: Multi-Teks bergaya

Text multiStyledText = Text.builder("I'm italicized! ").style(TextStyles.ITALIC)
        .append(Text.builder("I'm bold!").style(TextStyles.BOLD).build()).build();

Mewarnai & Styling Shortcut

Metode javadoc: Text # of (Object ...) memberikan cara sederhana untuk menambahkan warna dan styling ke teks Anda dengan cara yang jauh lebih ringkas.

Contoh: Warna & Gaya jalan pintas

Text colorAndStyleText = Text.of(TextColors.RED, TextStyles.ITALIC, "Shortcuts for the win!");

Tindakan Teks

Teks builder juga menawarkan kemampuan untuk membuat tindakan untuk teks. Setiap tindakan yang ditentukan dalam TextActions kelas dapat digunakan ketika membuat teks tindakan untuk teks. Metode di bawah ini adalah sebuah contoh kecil dari apa yang teks tindakan yang dapat dilakukan.

Contoh: Teks dengan Tindakan

import org.spongepowered.api.text.action.TextActions;

Text clickableText = Text.builder("Click here!").onClick(TextActions.runCommand("tell Spongesquad I'm ready!")).build();

Pada metode diatas, pemain bisa meng-klik teks "Klik disini" untuk menjalankan perintah tertentu.

Catatan

Beberapa tindakan teks, seperti TextActions#changePage(int), hanya dapat digunakan dengan item buku.

Tip

Sama halnya dengan warna, beberapa tindakan bisa ditambahkan ke teks. Bahkan tindakan teks dapat digunakan bersama dengan warna karena antarmuka pola pembangun.

Penyeleksi

Target pemilih yang digunakan untuk menargetkan pemain atau badan yang memenuhi kriteria tertentu. Target pemilih sangat berguna ketika membuat minigame plugin, tetapi memiliki berbagai aplikasi.

Tip

Baca ini Minecraft wiki artikel untuk membantu memahami apa target pemilih di Minecraft, dan bagaimana menggunakan mereka.

Untuk menggunakan penyeleksi dalam teks, anda harus menggunakan :javadoc:`Pemilih.Pembangun antarmuka. Hal ini diilustrasikan dalam contoh berikut.

Contoh: Selector-Teks yang dihasilkan

import org.spongepowered.api.text.selector.Selector;

Text adventurers = Text.builder("These players are in adventure mode: ").append(
        Text.of(Selector.parse("@a[m=2]"))
).build();

Dalam contoh ini, target pemilih @[m=2] menargetkan setiap pemain yang berada dalam mode petualangan. Ketika metode ini disebut, Teks akan dikembalikan mengandung nama pengguna online setiap pemain yang ada di mode petualangan.