Bir Komut Kurmak
İlk adım, yeni bir :javadoc: CommandSpec oluşturucu elde etmektir. Oluşturucu, komut yardım iletilerini, komut bağımsız değişkenlerini ve komut mantığını değiştirme yöntemleri sağlar. Bu yöntemler zincirlenebilir.
Sonunda komutu oluşturmak için, :javadoc: CommandSpec.Builder # build () yöntemini çağırmak isteyeceksiniz.
Ondan sonra, komutu kaydettirmelisin.
Örnek: Basit Bir Komut Kurmak
import org.spongepowered.api.Sponge;
import org.spongepowered.api.text.Text;
import org.spongepowered.api.command.spec.CommandSpec;
PluginContainer plugin = ...;
CommandSpec myCommandSpec = CommandSpec.builder()
.description(Text.of("Hello World Command"))
.permission("myplugin.command.helloworld")
.executor(new HelloWorldCommand())
.build();
Sponge.getCommandManager().register(plugin, myCommandSpec, "helloworld", "hello", "test");
CommandSpec yapıcı yöntemlerine genel bakış
Yöntem |
Açıklama |
---|---|
‘’ executor’’ |
Komut mantığını tanımlar (See Writing a Command Executor). ** Hiçbir alt komut ayarlanmadıysa yürütmenin ayarlanması gereklidir **. |
“argümanlar” |
Bu komut için argüman belirtimini ayarlar (Bkz :doc: arguments). |
‘’ izin ‘’ |
Bu komutu kullanmadan önce kontrol edilecek izni ayarlayın. |
“açıklama” |
Bu komutun amacına ilişkin kısa, bir satırlık bir açıklama, yardım sistemi tarafından görüntülenir. |
“genişletilmişAçıklama” |
Daha uzun yardım listelerinde kullanılacak genişletilmiş bir açıklama ayarlar. Kısa açıklama eklenecektir. |
‘’ çocuk ‘’ |
Bu komutu, takma adlarıyla ekler (Bkz :doc: `childcommands ‘). |
‘’ çocuklar ‘’ |
Bu komutun alt komutlarını takma adlarıyla ayarlar (Bkz :doc: `childcommands ‘). |
‘’ inputTokenizer’’ |
Bağımsız değişkenlerin nasıl ayrıştırılacağını tanımlar. Varsayılan olarak, ayrıştırıcı komut girdisini boşluklarla böler. Teklifler tek bir argüman olarak sayılır. Örnek: `` / tpworld Çentik “Benim Dünyam” `` iki terimle sonuçlanacaktır: “Çentik” ve “Benim Dünyam”. |
“kurmak” |
Komutu kurar. Ondan sonra, komutu kaydettirmelisin. |
Komutanlığa Mektup Yazma
Basit bir komut oluşturmak için gereken tek bileşen komutun mantığını içeren komut yürütücü sınıfıdır.
Sınıf, :javadoc: CommandExecutor #execute (CommandSource, CommandContext) yöntemini tanımlayan :javadoc: CommandExecutor arayüzünü uygulamak zorundadır. Yöntem, komut yürütme üzerinde çağırılır ve iki bağımsız değişkeni vardır:
Komut çağrısının kaynağı (örneğin, konsol, komut bloğu veya bir oyuncu)
Ayrıştırılmış argümanları içeren komut bağlam nesnesi (Bkz :doc: argümanlar)
Örnek: Basit Komut Yürütücüsü
import org.spongepowered.api.command.CommandException;
import org.spongepowered.api.command.CommandResult;
import org.spongepowered.api.command.CommandSource;
import org.spongepowered.api.command.args.CommandContext;
import org.spongepowered.api.command.spec.CommandExecutor;
public class HelloWorldCommand implements CommandExecutor {
@Override
public CommandResult execute(CommandSource src, CommandContext args) throws CommandException {
src.sendMessage(Text.of("Hello World!"));
return CommandResult.success();
}
}
Tüyo
Komut yürütücüsünü komut oluşturma sürecinde tanımlamak için anonim sınıflar <https://docs.oracle.com/javase/tutorial/java/javaOO/anonymousclasses.html> _ kullanabilirsiniz (Bkz. Örnek :doc: argümanlar sayfası).
Yalnızca Oynatıcılara Yönelik Komutlar
Sometimes it is necessary that only players can execute a command (e.g. a /suicide
command).
Perform an instanceof
check to determine the type of the CommandSource:
import org.spongepowered.api.entity.living.player.Player;
import org.spongepowered.api.command.source.CommandBlockSource;
import org.spongepowered.api.command.source.ConsoleSource;
if (src instanceof Player) {
Player player = (Player) src;
player.sendMessage(Text.of("Hello " + player.getName() + "!"));
}
else if(src instanceof ConsoleSource) {
src.sendMessage(Text.of("Hello GLaDOS!"));
// The Cake Is a Lie
}
else if(src instanceof CommandBlockSource) {
src.sendMessage(Text.of("Hello Companion Cube!"));
// <3
}
Not
Komutu ** konsola uyumlu ** yapmak için isteğe bağlı bir `` [player] `` argümanı eklemenizi öneririz (örneğin `` / inticide [player] ``).
Bunun en kolay yolu, bir `` playerOrSource`` komut elemanı eklemektir (Bkz :doc: arguments).
Komuta Sonuçları
`` CommandExecutor # execute () `` yöntemi her zaman bir :javadoc: CommandResult döndürmelidir. Çoğu durumda, geri dönmek yeterlidir :javadoc: CommandResult # success () komutu başarılıysa veya :javadoc: CommandResult # empty () olmamışsa. Daha fazla bilginin iletilmesi gereken durumlarda, bir :javadoc: CommandResult # builder () kullanılmalıdır. Oluşturucu, bir tamsayıyı kabul eden ve aynı adın özniteliğini ayarlayacak çeşitli çeşitli yöntemler sağlar. Oluşturucu tarafından ayarlanmamış tüm özellikler boş kalacaktır.
Komut blokları, bu değerleri, birden fazla komut bloğundan oluşan detaylı yapılar için kullanılabilir olan puan tablosu istatistiklerini değiştirmek için kullanabilir. Verilere nasıl erişildiğine dair bir eğitim materyali burada bulunabilir: <https://minecraft.gamepedia.com/Tutorials/Command_stats> `.
Örnek: Bir Komut Sonrası Oluşturma
CommandResult result = CommandResult.builder()
.affectedEntities(42)
.successCount(1)
.build();
Bu örnek, 42 varlıktan etkilenen ve başarılı olan bir komut için bir `` CommandResult` ‘oluşturmak için bir oluşturucu kullanır.
Hata işleme
The execute()
method may also throw a CommandException, signaling that an error occurred while trying to
execute the command. If such an Exception is thrown, its message will be displayed to the command source, formatted as
an error. Also, the commands usage message will be displayed. An ArgumentParseException, a subtype of
CommandException
is automatically thrown if the commands arguments could not be parsed.