[精讚] [會員登入]
144

【PaperMC - API】如何發送指令到伺服器內

How to sending or executing commands to server

分享此文連結 //n.sfs.tw/15879

分享連結 【PaperMC - API】如何發送指令到伺服器內@小編過路君子
(文章歡迎轉載,務必尊重版權註明連結來源)
2022-06-25 03:41:34 最後編修
2022-06-25 01:43:31 By 過路君子
 

哈囉大家好,這裡是吃了幾個小時錯誤的小編過路君子

外加吃了至少幾十幾百次的錯誤,慢慢嘗試才終於成功讓伺服器執行指令並且沒有任何錯誤被拋出!

 

 

小編基本上找了十幾篇的文章、論壇,基本上使用的場景都是只有單個檔案的狀況下。

換句話說,如果今天我們的專案使用上了 package 並且是要從外部的 class 去呼叫的話,那些論壇上的方式基本上不可以直接照搬,原因下面會提到。

 

這邊小邊就放出兩篇論壇的討論文章,基本上小編是從這兩篇慢慢地推導出來如何正確地從外部 class 去讓我們的伺服器執行指令(暱稱隨意排列),有興趣的人可以前往參考。

  1. fabio030, harry0198, ysl3000, escad & anikalinn. (2020, February 10). Error: Asynchronous Command Dispatch! Spigot. https://www.spigotmc.org/threads/error-asynchronous-command-dispatch.417150/
  2. s3ns3iw00, 24763, norska, zodiak & Drkmaster83. (2017, December 13). Dispatch Command. Spigot. https://www.spigotmc.org/threads/dispatch-command.290137/

 

那廢話不多說,我們開始吧,照慣例先丟上目錄結構吧:

(所有圖片點擊都可以放大、變高清)

 

小編這邊特別解釋 Editor.java 和 RemoteConsole.java 這兩個檔案。

Edirot.java 為插件的進入點,也就是說,onEnable() 等等事件是註冊在這個檔案內;RemoteConsole.java 則是外部 class 會去呼叫 dispatchCommand() 這個函式。

這兩個檔案都位在 package editor.passing.jinzan 下。

 

接下來就是一堆程式碼了,小編也不廢話了。

Editor.java

package editor.passing.jinzan; 

import java.lang.Runnable;
import org.bukkit.event.Listener;
import org.bukkit.plugin.java.JavaPlugin;
import editor.passing.jinzan.RemoteConsole;


public class Editor extends JavaPlugin implements Listener
{
	@Override 
	public void onEnable() 
	{
		// 註冊事件觸發器
		this.getServer().getPluginManager().registerEvents(this, this);

		// 實體化我們的虛擬控制台
		// 一定要將 this 傳入,待會我們會用到
		// this 的變數型態有包含 Interface org.bukkit.plugin.Plugin
		RemoteConsole remoteConsole = new RemoteConsole(this);
	}
}

RemoteConsole.java

package editor.passing.jinzan;

import org.bukkit.Bukkit;
import java.lang.Runnable;
import editor.passing.jinzan.Editor;
import org.bukkit.scheduler.BukkitRunnable;


class RemoteConsole
{
	private Editor plugin;
	
	public RemoteConsole(Editor plugin)
	{
		// 初始化
		this.plugin = plugin;
	}

	public dispatchCommand(String command)
	{
		// 請求伺服器將「執行我們的指令」的請求放入隊列中
		new BukkitRunnable()
		{
			@Override
			public void run()
			{
				// 請求伺服器執行我們的指令
				Bukkit.getServer().dispatchCommand(Bukkit.getServer().getConsoleSender(), command);
			}
		}.runTask(this.plugin);
	}
}

Bukkit.getServer().dispatchCommand(@NotNull Plugin plugin) 必須放在 BukkitRunnable 內才不會報錯且正常執行,否則會看到以下的錯誤:

[02:05:08 FATAL]: Thread Thread-14 failed main thread check: command dispatch
java.lang.Throwable: null
    at org.spigotmc.AsyncCatcher.catchOp(AsyncCatcher.java:15) ~[paper-1.18.1.jar:git-Paper-187]
    at org.bukkit.craftbukkit.v1_18_R1.CraftServer.dispatchCommand(CraftServer.java:873) ~[paper-1.18.1.jar:git-Paper-187]
    at editor.passing.jinzan.RemoteConsole.<init>(RemoteConsole.java:37) ~[Paper_Plugin_7-1.5.9.jar:?]
    at editor.passing.jinzan.Editor$1.run(Editor.java:51) ~[Paper_Plugin_7-1.5.9.jar:?]
    at java.lang.Thread.run(Thread.java:833) ~[?:?]

 

剩下的事情就簡單了,只要呼叫 remoteConsole.dispatchCommand() 就可以直接執行我們的指令囉。

例如 remoteConsole.dispatchCommand("say hello")。

 

 

 

後記

這種寫法主要是要用於複合實做上使用,就是兩個不同的套件要協同執行的時候會用,因為對方套件內絕對不會有我們需要的 API,所以我們只好自己寫一個接口傳入對方的套件內,然後直接呼叫。

當然要直接暴力一點把整個 Editor 傳進對方的套件內也不是不可以啦,但是每次要呼叫指令就要玩一次 RemoteConsole.java,跟直接呼叫 remoteConsole.dispatchCommand() 在糾錯和除錯上級別差太多了。

END

你可能感興趣的文章

【Maven】[Wicket](Java) 如何部署Wicket到Wildfly內 Wicket 是一個 Java 下的套件,換言之,我們的網頁伺服器後端是由 Java 來撰寫的

【JDA/discord bot】取得頻道第一筆或最新(最後一筆)的歷史訊息 在不處理訊息的先後順序下取得相關的歷史訊息

【ESXI & Oepnwrt】基本錯誤處理 Oepnwrt 為一個自由度超高的軟體,很多事情都能請其幫忙完成,但也因此很複雜,這邊簡單的介紹幾個錯誤的處理方式

【Wicket】[Header]如何讀取來自客戶端地檔頭和傳送自訂擋頭至客戶端 當需要設定檔頭或是讀取來自客戶端的檔頭時,這些程式碼就很好用

【Python3】[Django] (Windows / Liunx) 如何從零開始創建一個網站 除了最基本的運作以外,還小小的加上了如何自導向特定目錄。

【Wildfly/jBoss】[Linux] 如何從無到有建立Wildfly網頁伺服器 包含一切所需的指令

我有話要說

>>

限制:留言最高字數1000字。 限制:未登入訪客,每則留言間隔需超過10分鐘,每日最多5則留言。

訪客留言

[無留言]

隨機好文

[活動] 2017年4/1雲空幻想愚人節活動彩蛋&攻略 (紀念性質) 雲空幻想2017年的愚人節活動介紹同時也是本小編的第一篇網路文章(*^ω^)♪

希萌創意預計在今年7月繼東津萌米之後再次推出新遊戲--食用性少女! 今天來介紹希萌創意的心企劃案,來讓大家知道這個消息!讓大家的錢包君一起來減肥吧!Ψ(☆w☆)

【分享、整合串】什麼?!高捷少女竟然有二創小說!! 由時零宇宙大大在巴哈上面連載的二創高捷少女小說,就讓我們來看看,究竟在時零大大的巧手下,高捷少女們會擦出什麼樣的火花吧!

高捷少女:地下城的探險少女⑤ 小穹寫好後,耐耐看了一遍。「我想我應該辦得到。」她說完跪坐在地上,然後把古箏安放在大腿上,並將樂譜放在前面的地板。「要開始囉。」耐耐閉上眼睛,深呼吸一口氣,小穹等人在一旁看著她,心中暗自替她打氣。

高捷少女:耐耐的新年驚喜① 耐耐拿出手機。「我回來囉。」她說。幾分鐘後,木門緩緩打開。當它完全開啟的那一刻,小穹手中的包包掉到地上;艾米揉揉雙眼,確定自己看見的景象;婕兒的三魂七魄飛到了九霄雲外。