buscript

插件

· 作者 dumptruckman

Bukkit 插件/库,支持运行可扩展的 JavaScript 脚本

0 本站下载 0 关注 更新于 9 年前
一键开服(送7天)

Buscript 为服务器提供了从文本文件运行 JavaScript 的能力。除了 JavaScript 本身提供的功能外,buscript 还添加了一些全局函数,旨在让脚本的编写变得简单易懂,希望任何人都能轻松上手!

最新的开发版本始终可以在 找到

命令

目前只有一个命令

/run <script> [player]
权限: buscript.run
<script> 是包含你希望运行的脚本的文件名。Buscript 会在 plugins/Buscript/scripts 目录下查找该文件名。由于这表示一个文件名,因此必须包含文件扩展名。如果你的脚本文件是 myscript.txt,那么你需要输入 /run myscript.txt。
[player] 是 可选的。此字段用于指定脚本的目标对象。通常,如果你要使用它,目标应该是当前在线的玩家。
run 命令总是会重新加载文件,因此如果你修改了脚本,无需进行任何特殊操作。
如果命令未找到脚本,它将尝试为你创建该文件(尽管它是空白的且不会执行任何操作。)

脚本

脚本是包含 JavaScript 代码的文本文件。对于不熟悉编程的人来说,这听起来可能有些吓人,但幸运的是,buscript 提供了几种易于使用的方法来创建基本脚本。

你的脚本文件必须位于 Buscript 插件自动为你创建的 scripts 目录中。文件扩展名可以是任何形式(甚至没有扩展名),只要文件包含有效的 JavaScript 即可。

脚本特性

  • 易于使用的全局函数,包括运行命令、广播消息、权限管理等。
  • 这些全局函数中使用的所有字符串都可以访问 "%target%",它代表脚本的当前目标。示例:broadcast("Hello, %target%")
  • 能够以 100% 的可靠性在稍后时间运行另一个脚本,即使服务器崩溃也能做到!
  • Buscript 定义了全局变量 target,以便对脚本的目标进行更高级的操作。
  • 全局变量 server 也可用,它允许直接访问 Bukkit 服务器变量,就像你在插件内部工作一样!

详细脚本特性

全局函数和变量

示例脚本

/run broadcast-sample.txt dumptruckman
broadcast-sample.txt:
  broadcast("Hey everyone, §c%target% §fis a cool guy!")
  command("op %target%")
这是一个简单的脚本,它会告诉服务器上的所有人目标对象(在本例中是 dumptruckman)有多酷,然后将其设为管理员。
它还会给名字加上颜色,想想看。
/run perm-sample.txt dumptruckman
perm-sample.txt:
  message("%target%", "You have just been given flight in the creative world for 30 minutes!")
  addPerm("creative", "%target%", "flight.permission")
  runLater("remove-perm.txt", "30m", "%target%")
remove-perm.txt:
  message("%target%", "Your flight power has been removed, hope you weren't up there!")
  removePerm("creative", "%target%", "flight.permission")
请注意 这两个脚本需要 Vault 和一个与 Vault 兼容的权限管理器,以便在玩家不在线时也能正常工作。
你也可以改用 command() 函数来运行你自己的权限命令,而无需使用 Vault。
另外注意 "flight.permission" 并不是一个真实的权限。你实际启用飞行的权限可能有所不同(甚至可能不存在!)

面向开发者

源代码:
Javadoc:
Maven 仓库:
Maven pom 信息:

  <groupId>com.dumptruckman.minecraft</groupId>
  <artifactId>buscript</artifactId>
  <version>1.0-SNAPSHOT</version>

你可以轻松地将此作为库而非插件使用,只需将其添加到你自己的插件中即可。建议使用 Maven 进行阴影打包(shading),并可能将代码重新定位到新的命名空间。
之后,简单创建一个

new Buscript(yourPlugin)

从这里开始,你将找到运行自己脚本所需的所有方法,甚至添加你自己的全局方法!

如果你希望以插件的形式扩展 Buscript 的功能,主插件类 BuscriptPlugin 提供了一个便捷的 getAPI() 方法来返回其持有的 Buscript 对象。

Javadoc 可通过 Maven 仓库下载。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源