StrippedBroadcast

插件

· 作者 Fulminazzo

一个简单插件,用于为指定玩家显示格式化的聊天消息。

0 本站下载 0 关注 更新于 3 年前

最新 4.0 · 1.20.2 · Bukkit / BungeeCord

一键开服(送7天)

StrippedBroadcast 是对 Plugin RawMsg 的复刻。
该插件的主要目的是在聊天栏发送一条类似于 broadcast 命令的消息。然而,发送时消息不会带有前缀,且发送者可以指定一个玩家组来接收该消息。它还提供了一个可供任何开发者使用的 API。

命令

StrippedBroadcast 的主要且唯一的命令是,正如你所猜到的,/sbc(即 /simplebroadcast 的缩写)。其语法为:
/sbc <targets> <message> ​
正如插件自身在执行命令时所解释的那样,第一个参数应代表广播的目标。这些目标可以是:

  • all,用于服务器上的所有在线玩家;
  • <player> 或 player=<player>,仅指定的一名用户将看到该消息;
  • me,命令执行者的别名;
  • world=<world>,用于存在于该世界中的所有玩家;
  • perm=<permission>,用于拥有该权限的任何玩家;
  • op 或 perm=op,用于服务器上的所有 OP 玩家;
  • group=<group>;StrippedBroadcast 与 LuckPerms 兼容,因此“group”参数允许用户指定特定的玩家组;
  • item=<item>;用于服务器中持有该物品的所有玩家;
  • effect=<effect>;用于拥有指定效果的所有玩家;
  • gamemode=<gamemode>;用于处于该游戏模式的所有玩家;
  • money=<money>;用于拥有该金额金币的所有玩家。

表达式

StrippedBroadcast 还能将表达式作为目标。用户可以指定某些条件,这些条件将返回一个兼容玩家的列表。
每个表达式都应括在括号内,但也可以在一个括号内嵌套更多括号。
示例:
/sbc (world=world_the_nether && (perm=bukkit.* || perm=minecraft.*)) Looks like you are the king of hell! ​
你还会注意到,表达式接受关键字 AND (&&) 和 OR (||)。它们的功能非常简单:

  • 在上述示例中,OR 关键字用于获取拥有权限 "bukkit.*" 或 权限 "minecraft.*" 的所有玩家;
  • 然后使用 AND 关键字来获取身处下界且拥有上述两个权限之一的玩家。

此外,该插件支持 Tab 补全功能,这将有助于提醒用户关闭括号或插入特定关键字。

权限

StrippedBroadcast 唯一的权限是 "sbc.main",它将允许用户执行 /sbc 命令。

颜色

自 Minecraft 1.16 更新以来,游戏中添加了十六进制颜色。现在,StrippedBroadcast 不仅能够使用默认的 Minecraft 颜色代码("&"),还能使用字符 # 来自定义颜色。如果你使用的是 1.16 或更高版本,当输入 "#" 时,插件会建议所有可用于颜色代码的有效字母和数字。此外,还有一种新的彩虹效果可用。要使用它,只需在消息前键入 [RAINBOW] 即可。示例:
/sbc all [RAINBOW] StrippedBroadcast v1.2 is an amazing plugin!

BungeeCord

最近发布了一个与 BungeeCord 兼容的 StrippedBroadcast 版本。它使用了与 Spigot 版本相同的功能,但部分参数有所变化:

  • all,用于服务器中所有在线的玩家;
  • player,唯一将看到该消息的用户;
  • 服务器("server=<server>"),用于存在于该服务器中的玩家;
  • 权限("perm=<permission>"),用于拥有该权限的任何玩家;
  • 组("group=<group>"),用于属于该组的任何玩家(需要 LUCKPERMS)。

BungeeCord 也提供了 API,其命名方式与 Spigot API 相同,后加一个 "B"(例如 PlayerUtilsB 是插件 BungeeCord 部分的 PlayerUtils)。主类可通过名称 StrippedBroadcastBungee 访问,其中包含向玩家列表发送消息的所有方法。

API

老实说,我不确定这个插件 API 将如何被实现,但我非常好奇开发者们能创造出什么。无论如何,在你的项目中导入该插件后,你就可以开始使用了。有两个类是你需要关注的:

StrippedBroadcast

StrippedBroadcast 类包含静态方法 sendStrippedBroadcast。这会将给定的消息(它可以是字符串、字符串列表甚至数组)发送给指定的玩家列表。示例如下:

String[] strings = new String[]{"This", "is", "a", "cool", "message"};
StrippedBroadcastEvent.sendStrippedBroadcast(Bukkit.getOnlinePlayers(), strings);

StrippedBroadcastEvent 和 StrippedBroadcastEventB

StrippedBroadcastEvent 和 StrippedBroadcastEventB 是在使用插件命令或方法发送消息时调用的事件。它们包含两个变量:涉及的玩家列表和发送的消息。

@EventHandler
public void onMessageSent(StrippedBroadcastEvent event) {
   event.getMessage();
}
@EventHandler
public void onBungeeMessageSent(StrippedBroadcastEventB event) {
   event.getMessage();
}

PlayersUtil

PlayersUtil 类包含所有可用于根据特定输入获取玩家列表的方法。就像 /sbc 命令一样,PlayersUtil 支持任何类型的输入值,从世界、权限、游戏模式、玩家名称等等... 若要获取所有可用方法的更准确列表,你可以查看 GitHub 页面:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源