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
Membaca ini 'Artikel pengrajin tambang wiki <http://minecraft.gamepedia.com/Commands#Target_selectors>'__ untuk membantu memahami apa target penyeleksi dalam pengrajin tambang, dan bagaimana menggunakannya.
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.