本帖最后由 超神的冰凉 于 2021-12-24 19:14 编辑
其他功能：
服务端插件开发框架图形编辑器在线使用网址：点击进入我们的服务器插件下载地址：见上在线使用说明书：BNWIKI交流群：953752196
项目简介：blocklynukkit友好界面中文插件编辑器是由超神的冰凉发起的开源的服务器插件开发框架，其目的为致力于为中国广大服主提供清爽、强大、实用、简洁的中文服务器插件开发服务，使得更多想要开发自己的插件却对晦涩难懂的JAVA编程望而却步的服主能够很容易的，以拖拽的形式开发出自己想要的各种功能。blocklynukkit不仅是一个插件编辑器，它更是一个多语言插件加载器，支持JavaScript、Python、Lua、PHP和C/C++。您可以用这里面的任意一种或多种语言来开发服务器插件，BlocklyNukkit为所有语言提供统一的运行时api，可以与java无缝集成交互。我们的代码完全基于AGPL3.0开源，任何人都可以加入我们或者做出贡献，如果您是使用者或者服主，您可以在此进入教程学习如何使用本项目并构建自己的插件。现在blocklynukkit仅支持nukkit客户端，我们欢迎来自bukkit/spigot等服务端的开发者们移植到目标服务端~项目链接：https://github.com/Superice666/BlocklyNukkit教程链接：http://www.blocklynukkit.info/加载器链接：正式版 https://tools.blocklynukkit.com/BlocklyNukkit.jar
测试版 https://gitee.com/qdez/BlocklyNukkit_Loader/gitee_go/15181为什么我们要做这个：（仅代表个人拙见）如您所见，现在中国nk整个生态圈，乃至基岩版生态圈，在网易的操作下，跟之前比起来，几乎是一片废墟。现在的nk生态绝大部分是几位优秀的开发者所建立的，一旦发生了什么不好的事请，整个生态链一触即断，这是我，同样也是广大服主、玩家、开发者都不希望见到的局面。作为一个局内人，我深知一个好的生态的重要性。经过反复的思考，我决定以blocklynukkit这个项目为切入口，着手为这个社区做点什么。我深知我的力量渺小，能做的微乎其微，但是我做了，等我从这里离去的时候，我不会留下任何悔恨。BlocklyNukkit是做什么的：Blocklynukkit是一套专业级服务器插件开发框架，旨在使得各位服主都能制作属于自己的专属插件，让各位开发者更快速地制作插件、分发插件。新手也可以通过我们的图形化编辑器，您可以通过拖拽拼图的方式简单而轻松的创作插件，省去了很多不必要的操作。BlocklyNukkit的特点： · 零基础快速上手，友好的使用方式，近万字新手教程 · 云端一键部署安装，多端均可开发插件（手机/电脑） · vscode插件支持，编程开发插件快人一步· nukkit和BN双API，开发插件的最佳选择· 多样的表单主题，让你的服务器独树一帜！· 完全自定义物品支持，让服务器可玩性大幅提升 · 图形编辑器、javascript、python、lua、php、C/C++、java/scala可混合开发BlocklyNukkit可以做出什么样的插件：BlocklyNukkit是一个完整的插件开发框架，可以做出所有在服务端插件能力范围内的形式和内容的插件。BlocklyNukkit支持插件开发的方式：BlocklyNukkit支持如下4种插件开发方式：1、图形编辑器（十分简单，零基础开发）2、JavaScript（ECMA 5.1标准 + 部分ES6）3、Python（2.7版本）4、Lua （5.1版本）5、PHP （5.7版本）6、C/C++ (17版本)其他功能：
如何使用表单主题控制器：附属插件 BN表单主题控制器下载链接：https://github.com/Superice666/BlocklyNukkit/raw/master/BNThemeController.jar把这个jar包放在plugins文件夹里面，重启一次服务器，blocklynukkit解释器会调用表单主题控制器（1.1.8版本及以上），随后在./plugins/BlocklyNukkit/文件夹下面会生成：theme.yml文件，内容为其中"MINECRAFT"是主题的名称，修改MINECRAFT为你喜欢的主题名称，重启服务器第一次会同步主题所需资源，第二次会将主题资源包注入nk，也就是说，第一次安装主题需要一共重启3次，更换主题需要重启2次主题风格列表：（可以加群学习自己制作主题风格）
如何使用速建官网功能：
在BlocklyNukkit文件夹下会有port.yml，设置里面的端口为你希望的官网端口，设置完之后在浏览器输入 你的ip/域名:端口 即可打开服务器官网。但是在没有设置官网页面html文件之前会在浏览器显示错误，具体教程详见完整官方教程或站内快速搭建教程。
有用的资源：官方教程库(最全面)：http://www.blocklynukkit.info/图形编辑器教程链接：https://docs.qq.com/doc/DRkRpS0xmV2ZJbGdiQQ群：953752196直接进入编辑器：https://tools.blocklynukkit.com将js插件打包为jar包发布：https://www.mcbbs.net/thread-1022008-1-1.html下一页更精彩(*^_^*)
更新日志：旧版本下载：https://hub.fastgit.org/Superice666/BlocklyNukkit/tree/master/oldversions各开发版更新详细日志：https://hub.fastgit.org/Superice666/BlocklyNukkit/releases（1.2.8.1及以前版本的更新日志提供在帖子的置顶楼层了）## 1.2.9.7
Bug Fixed
- 修复了错误的命令介绍- 修复了非EconomyAPI兼容性- 修复了饮品无法在满饱食度情况下饮用bug- 修复了BNNPC Steve皮肤从外部调用无效bug- 修复了BNNPC死亡异常掉落物品的bug- 修复了WebSocket服务器启动报错bug- 修复了Ws卡死主线程问题
entity
- void setPlayerCompassTarget(Player player, position target) --设置玩家指南针指向位置- void setPlayerCape(Player player, String capeImagePath) --设置玩家的披风
## 1.2.9.6
Bug Fixed
- 修复了窗口回调接受窗口关闭无效的bug
Event
- AddMoneyEvent- ReduceMoneyEvent- SetMoneyEvent
New
- 小幅优化js加载性能- 在核心同级文件夹创建新文件debug.inf即可启动js加载计时
manager
- void customEventListener( String fullEventName, --要监听的事件的java类名 String callbackFunction, --事件回调函数 String priority --事件优先级，可选NORMAL MONITOR LOWEST LOW HIGH HIGHEST) --动态监听事件- WsClient createWsClient( String serverUrl, --远程ws服务器链接 String newWsConnectCallback, --ws成功连接回调 String closeWsConnectCallback, --ws客户端断开连接回调 String receiveStringCallback, --接收到字符串数据回调 String receiveDataCallback --接收到非字符串数据回调) --创建Ws客户端- WsServer createWsServer( int port, --端口 String newWsConnectCallback, --有新的ws客户端连接回调 String closeWsConnectCallback, --ws客户端断开连接回调 String receiveStringCallback, --接收到字符串数据回调 String receiveDataCallback --接收到非字符串数据回调) --创建WebSocket服务器- long timing.start() --启动计时，返回计时器id，对性能无影响- long timing.end(long id) --结束计时，返回经过的纳秒- long timing.finish(long id) --结束计时并将结果输出到控制台- long timing.finish(String info) --结束最近一次启动的计时器并将经过的时间输出到控制台，info将作为输出的前缀
blockitem
- @Comment(value = "注册新的简易物品, 允许任意自定义物品")public void registerSimpleItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "新物品的类别，可选construction nature equipment items") String type,@Comment(value = "是否展示为工具(竖着拿在手里)") boolean isDisplayAsTool,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的工具物品")public void registerToolItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "工具种类,可为sword shovel pickaxe axe hoe") String toolType,@Comment(value = "工具挖掘等级 0-空手,1-木,2-金,3-石,4-铁,5-钻石,6-下界合金") int toolTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "攻击伤害") int attackDamage,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的食物物品")public void registerFoodItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "食用持续时间(刻)") int eatTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的饮品物品")public void registerDrinkItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "饮用持续时间(刻)") int drinkTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的盔甲物品")public void registerArmorItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "盔甲种类,可为helmet chest leggings boots") String armorType,@Comment(value = "盔甲等级 0-无,1-皮革,2-铁,3-锁链,4-金,5-钻石,6-下界合金") int armorTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "提供的盔甲值") int armorPoint,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
## 1.2.9.5Bug Fixed
- 修复了自定义工具伤害问题- 修复js中java包重导入报错- 修复胡椒商店兼容性问题- 修复不同模块同名函数调用混乱问题
New
- 注册自定义物品速度加快- NPC寻路不再显示路径粒子
blockitem
- boolean isBlockWaterLogged(Block block) --检测方块是否为含水方块- void addSoundFile(String soundName, String fileName) --向材质包添加新的声音文件- void addArmorTexture(@Comment(value = "物品id") int id,@Comment(value = "盔甲物品栏材质图片路径") String inventoryPicturePath,@Comment(value = "盔甲穿着时材质图片路径") String modelPicturePath,@Comment(value = "4d盔甲模型文件(.json)，可不填") String modelJSONPath)--为自定义盔甲添加4d模型
BNNPC
- void start(Player player) --只对某一个玩家启动显示
entity
- RouteFinder buildRouteFinder(Entity entity) --为实体构建寻路器
manager
- void concurrentRun(String functionName, <E+>... args) --并行运行函数- void jvm.close(int returnCode / void) --强制关闭jvm并返回返回值，可不填，默认为0- JMemory jvm.getMemory() --获取jvm内存管理器- Class jvm.getJVMClass(String className) --根据类名获取jvm类对象- JClass jvm.newJVMClass(@Comment(value = "java类名") String className,@Comment("继承自的父类类名，可不填") String extendFromClass / void,@Comment("实现的接口类名，可不填") String... interfaceClasses / void) - 创建新的java类构造器
JClass
- JClass addConstructor(String modifier, String proxyFunction, String... argumentClasses)- 为新java类添加构造函数- modifier是构造函数修饰符，如public final等等- proxyFunction是对应处理的bn插件函数名，调用时传入构造函数的所有参数，第一个参数永远是类自身，其余为自定义参数- argumentClasses是构造函数自定义参数的类名- 返回自身，便于链式调用- JClass addField(String modifier, String fieldClass, String fieldName, Object defaultValue / void)- 为新java类添加字段（又称属性或成员变量）- modifier是字段修饰符，如public final等等- fieldClass是字段类名- fieldName是字段名称，需遵守java规范- defaultValue是字段的默认值，可以不填，默认没有默认值而非默认值为null- 返回自身，便于链式调用- JClass addMethod(String modifier, String returnClass, String methodName, String proxyFunction, String... argumentClasses)- 为新java类添加方法（又称成员函数）- modifier是方法修饰符，如public final等等- returnClass是方法返回值，无返回值填入void即可- methodName是方法名称- proxyFunction是对应处理的bn插件函数名，调用时传入方法的所有参数，第一个参数永远是类自身，其余为自定义参数- argumentClasses是构造函数自定义参数的类名- 返回自身，便于链式调用- JClass finish()- 完成java类构造，此时java类才可以使用，且不可再次更改- 返回自身，便于链式调用- Object newInstance(Object... args)- 实例化自身，即对自身构建的java类进行new- 必须在finish之后才能使用！
JMemory
- long getMax() --获取JVM最大可用内存大小- long getFree() --获取JVM剩余内存大小- long getTotal() --获取JVM总内存大小- void gc() --进行内存清理
RouteFinder
- Entity getEntity()- void setSearchLimit(int searchLimit)- int getSearchLimit()- void setStart(Vector3 start)- Vector3 getStart()- void setDestination(Vector3 destination)- Vector3 getDestination()- void setLevel(Level level)- Level getLevel()- void setBoundingBox(AxisAlignedBB bb)- AxisAlignedBB getBoundingBox()- boolean hasNext()- Node next()- boolean hasReachedNode(Vector3 vec)- Node get()- void forceStop()- void arrived()- boolean hasRoute()- boolean search()- boolean research()- boolean isSearching()- boolean isSuccess()
## 1.2.9.4
New
- Js已经支持for of循环- Js中修复了错误的=>实现- Js中新增宏注释：//pragma optimistic，添加后bn将会为此代码在载入期间激进地进行类型推导以优化运行时性能- bnp支持.phpfile后缀名- bnp和bnpx可以直接放入plugins文件夹加载- 小幅优化性能- js中可以直接使用类的全名使用java类，无需进行Java.type或require引入- 材质包不会无谓地重复生成
HttpHandler
- 回调参数中新增getRequestRawUrl函数
BNNPC
- 优化ai算法，避免npc消失bug
manager
- addCommandCompleter新增@sub规则，表示一个子命令补全选项- @Comment(value = "是否运行在PowerNukkit上")public boolean isPowerNukkit()
inventory
- @Comment(value = "新建一个漏斗物品栏")public HopperFakeInventory addHopperInv(@Comment(value = "包含的物品，需要使用`Java.to`函数转换") Item[] item,@Comment(value = "物品栏标题") String name)
blockitem
- @Comment(value = "注册新的简易物品, 允许任意自定义物品")public void registerSimpleItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "新物品的类别，可选construction nature equipment items") String type,@Comment(value = "是否展示为工具(竖着拿在手里)") boolean isDisplayAsTool,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的工具物品") public void registerToolItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "工具种类,可为sword shovel pickaxe axe hoe") String toolType,@Comment(value = "工具挖掘等级 0-空手,1-木,2-金,3-石,4-铁,5-钻石,6-下界合金") int toolTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "攻击伤害") int attackDamage,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的食物物品")public void registerFoodItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "食用持续时间(刻)") int eatTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的饮品物品")public void registerDrinkItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "饮用持续时间(刻)") int drinkTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的盔甲物品")public void registerArmorItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "盔甲种类,可为helmet chest leggings boots") String armorType,@Comment(value = "盔甲等级 0-无,1-皮革,2-铁,3-锁链,4-金,5-钻石,6-下界合金") int armorTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "提供的盔甲值") int armorPoint,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "添加新的盔甲材质")public void addArmorTexture(@Comment(value = "物品id") int id,@Comment(value = "盔甲物品栏材质图片路径") String inventoryPath,@Comment(value = "盔甲穿着时材质图片路径") String modelPath)
- @Comment(value = "添加新的物品材质")public void addItemTexture(@Comment(value = "物品id") int id,@Comment(value = "物品材质图片路径") String path)
- @Comment(value = "为指定id物品添加中文翻译名")public void addItemChineseTranslation(@Comment(value = "物品id") int id,@Comment(value = "中文名") String name)
- @Comment(value = "为指定id物品添加英文翻译名")public void addItemEnglishTranslation(@Comment(value = "物品id") int id,@Comment(value = "英文名") String name)
- @Comment(value = "向材质包中指定位置添加json文件")public void addResourcePackJsonEntry(@Comment(value = "材质包内相对位置，包含路径和文件全名") String entryPath,@Comment(value = "json文件内容") String json)
- @Comment(value = "向材质包中指定位置添加图片文件")public void addResourcePackPictureEntry(@Comment(value = "材质包内相对位置，包含路径和文件全名") String entryPath,@Comment(value = "要复制到材质包中的硬盘上的图片路径") String path)
world
- void defineChunkRenderAll(String callback,int priority / void)- 为所有世界添加地形渲染器- callback是渲染器回调函数- priority是优先级，优先级越大先调用，不填默认为0
entity
- @Comment(value = "构建4d展示模型") public BNModel buildModel(@Comment(value = "生成模型的位置") Position pos,@Comment(value = "模型4d皮肤id") String modelSkinID,@Comment(value = "模型长") double length,@Comment(value = "模型宽") double width,@Comment(value = "模型高") double height,@Comment(value = "模型缩放比例") double scale,@Comment(value = "定时回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","int"}, parameters = {"model", "tick"}, comments = {"执行此函数的模型实体", "当前实体运行刻"}) String tickCallback,@Comment(value = "定时回调函数回调间隔(刻)") int callTick,@Comment(value = "被攻击回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","cn.nukkit.event.entity.EntityDamageEvent"}, parameters = {"model", "damageEvent"}, comments = {"执行此函数的模型实体", "实体受到的伤害事件"}) String attackCallback,@Comment(value = "实体交互回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","cn.nukkit.Player","cn.nukkit.item.Item","cn.nukkit.math.Vector3"}, parameters = {"model","player","item","clickPos"}, comments = {"执行此函数的模型实体", "发起交互的玩家", "交互使用的物品", "交互点击的位置"})String interactCallback)
1.2.9.3Bug Fixed
- 修复了bnp无法加载自定义模块名问题- 修复了BN浮空字能被打的问题- 去掉了陈旧的bnmiscbuild命令
1.2.9.2Bug Fixed
- 修复了异步JSON与YAML互转的问题，大幅提升转换速度- js中可以使用箭头函数- js中可以通过require(java类名/文件名)来调用java类或其他插件- 修复了js解析器错误解析字符串中的正则表达式的问题- 修复了manager.doPathCreate无法创建文件夹问题- 修复了BlackBE合作API错误的问题- 修复了PowerNukkit1.4.0.x生物兼容问题- NPC有默认皮肤了
Module
- 通过注释宏：pragma module 模块名定义模块- 定义模块后，可以通过模块名来引入其他模块中的导出函数
manager
- void appendFile(String path,String text)- 追加写入文件内容
entity
- BNNPC buildNPC(Position pos,String name)- void displayHurt(Entity e)- void displayDie(Entity e)
blockitem
- void addFishingResult(String type,Item item,double chance)- 添加钓鱼产物，type为新增产物种类，item是产物物品，changce是概率权重- type可以取TREASURES;宝藏;JUNKS;垃圾;FISHES;鱼类，中英文皆可
algorithm
- Position buildPosition(double x,double y,double z,Level level)
New Event
- BNInitializedEvent- 在所有bn插件都初始化后发出- 无成员函数，无法被取消- BNClosedEvent- 在bn被nk要求关闭的时候发出- 无成员函数，无法被取消- StartFishingEvent- 在玩家开始钓鱼的时候发出- Player getPlayer() -返回钓鱼的玩家- EntityFishingHook getFishingHook() -返回钓鱼钩实体- void setCancelled(boolean cancel/void) -设置取消事件- boolean isCancelled() -事件是否被取消
BNPM
- 新增了BNPM插件管理器，用于一键安装、更新，快速分发插件- 命令： - bnpm install 插件名 -安装或更新指定插件 - bnpm delete 插件名 -卸载指定插件- 相关链接： - bnpm插件中心：https://wiki.blocklynukkit.com/bnpm/viewPlugin
Bug Fixed
- 修复射箭函数中参数依赖问题- 修复方块实体无法不坠落- 重构BNNPC的AI架构，修复bnnpc两格高出不去问题- 修复bn插件包资源文件解压错误问题- PHP更友善的debug- 修复PHP超时bug- 修复world.clearChunk- 修复localstroage缓存出错问题- 修复切换雷暴天气不下雨的问题- 清理部分无用的代码- js中可以使用pragma es6- 修复获取在线玩家报错问题
particle
- void drawDot(Position pos,int pid)- void drawDot(Position pos,int pid,Player toPlayer)- void drawDot(Position pos,int pid,int data)- void drawDot(Position pos,int pid,int r,int g,int b)- void drawDot(Position pos,int pid,int data,Player toPlayer)- void drawDot(Position pos,int pid,int r,int g,int b,Player toPlayer)- void drawEmitter(Position pos) --随机粒子发生器- void drawEmitter(Position pos,String id)- void drawEmitter(Position pos,String id,Player toPlayer)- 粒子发生器id列表：- minecraft:arrow_spell_emitter, minecraft:balloon_gas_particle, minecraft:basic_bubble_particle, minecraft:basic_bubble_particle_manual, minecraft:basic_crit_particle, minecraft:basic_flame_particle, minecraft:basic_portal_particle, minecraft:basic_smoke_particle, minecraft:bleach, minecraft:block_destruct, minecraft:block_slide, minecraft:blue_flame_particle, minecraft:breaking_item_icon, minecraft:breaking_item_terrain, minecraft:bubble_column_bubble, minecraft:bubble_column_down_particle, minecraft:bubble_column_up_particle, minecraft:camera_shoot_explosion, minecraft:campfire_smoke_particle, minecraft:campfire_tall_smoke_particle, minecraft:cauldron_spell_emitter, minecraft:cauldron_bubble_particle, minecraft:cauldron_splash_particle, minecraft:colored_flame_particle, minecraft:conduit_particle, minecraft:conduit_absorb_particle, minecraft:conduit_attack_emitter, minecraft:critical_hit_emitter, minecraft:crop_growth_emitter, minecraft:dolphin_move_particle, minecraft:dragon_breath_fire, minecraft:dragon_breath_lingering, minecraft:dragon_breath_trail, minecraft:dragon_death_explosion_emitter, minecraft:dragon_destroy_block, minecraft:dragon_dying_explosion, minecraft:enchanting_table_particle, minecraft:endrod, minecraft:end_chest, minecraft:elephant_tooth_paste_vapor_particle, minecraft:evocation_fang_particle, minecraft:evoker_spell, minecraft:cauldron_explosion_emitter, minecraft:death_explosion_emitter, minecraft:egg_destroy_emitter, minecraft:eyeofender_death_explode_particle, minecraft:misc_fire_vapor_particle, minecraft:explosion_particle, minecraft:explosion_manual, minecraft:eye_of_ender_bubble_particle, minecraft:falling_border_dust_particle, minecraft:falling_dust, minecraft:falling_dust_concrete_powder_particle, minecraft:falling_dust_dragon_egg_particle, minecraft:falling_dust_gravel_particle, minecraft:falling_dust_red_sand_particle, minecraft:falling_dust_sand_particle, minecraft:falling_dust_scaffolding_particle, minecraft:falling_dust_top_snow_particle, minecraft:fish_hook_particle, minecraft:fish_pos_particle, minecraft:guardian_attack_particle, minecraft:guardian_water_move_particle, minecraft:heart_particle, minecraft:honey_drip_particle, minecraft:huge_explosion_lab_misc_emitter, minecraft:huge_explosion_emitter, minecraft:ice_evaporation_emitter, minecraft:ink_emitter, minecraft:knockback_roar_particle, minecraft:lab_table_heatblock_dust_particle, minecraft:lab_table_misc_mystical_particle, minecraft:large_explosion, minecraft:lava_drip_particle, minecraft:lava_particle, minecraft:llama_spit_smoke, minecraft:magnesium_salts_emitter, minecraft:mobflame_emitter, minecraft:mobflame_single, minecraft:mobspell_emitter, minecraft:mob_block_spawn_emitter, minecraft:mob_portal, minecraft:mycelium_dust_particle, minecraft:nectar_drip_particle, minecraft:note_particle, minecraft:obsidian_glow_dust_particle, minecraft:obsidian_tear_particle, minecraft:phantom_trail_particle, minecraft:portal_directional, minecraft:portal_east_west, minecraft:portal_north_south, minecraft:portal_reverse_particle, minecraft:rain_splash_particle, minecraft:redstone_ore_dust_particle, minecraft:redstone_repeater_dust_particle, minecraft:redstone_torch_dust_particle, minecraft:redstone_wire_dust_particle, minecraft:rising_border_dust_particle, minecraft:shulker_bullet, minecraft:silverfish_grief_emitter, minecraft:soul_particle, minecraft:sparkler_emitter, minecraft:splash_spell_emitter, minecraft:sponge_absorb_water_particle, minecraft:squid_flee_particle, minecraft:squid_ink_bubble, minecraft:squid_move_particle, minecraft:stunned_emitter, minecraft:totem_particle, minecraft:totem_manual, minecraft:underwater_torch_particle, minecraft:villager_angry, minecraft:villager_happy, minecraft:water_drip_particle, minecraft:water_evaporation_actor_emitter, minecraft:water_evaporation_bucket_emitter, minecraft:water_evaporation_manual, minecraft:water_splash_particle_manual, minecraft:water_splash_particle, minecraft:water_wake_particle, minecraft:wither_boss_invulnerable
entity
- Entity spawnFallingBlock(Position pos, Block block, boolean enableGravity,boolean canBePlaced)- EntityArrow shootArrow(Position from,Position to,Entity shooter,boolean canPickUp,double multiply)- EntityArrow shootArrow(Position from,Position to,boolean canPickUp,double multiply)- EntityArrow shootArrow(Position from,Position to,double multiply)- EntityArrow shootArrow(Position from,Position to,boolean canPickUp)- EntityArrow shootArrow(Position from,Position to)- EntitySnowball shootSnowball(Position from,Position to,Entity shooter,boolean canPickUp,double multiply)- EntitySnowball shootSnowball(Position from,Position to,boolean canPickUp,double multiply)- EntitySnowball shootSnowball(Position from,Position to,double multiply)- EntitySnowball shootSnowball(Position from,Position to,boolean canPickUp)- EntitySnowball shootSnowball(Position from,Position to)
manager
- void removeCommand(String name) --移除名为name的命令- void sendMail(String smtpMailServer,String from,String to,String cc,String bcc,String subject,String content)- 发送电子邮件，默认为utf-8编码- \<E> syncCallFunction(String functionName,Object... args)--同步执行函数- void jvmGC() --垃圾回收，释放无用内存- String getPlayerDeviceOS(Player player) --获取玩家设备操作系统- boolean createHttpServer(int port)- void startHttpServer(int port)- boolean attachHandlerToHttpServer(int port,String path,String functionName)- boolean attachHandlerToHttpServer(int port,String path,F function)- 在指定端口的http服务器上绑定请求处理器，当请求path路径时该处理器被调用- 路径指去掉域名和端口后面，?的前面的部分，以/开头
http服务器回调函数
- 参数(HttpRequestEntry request);- request成员函数：- String getRequestUrl()- String getPath()- String getHeader()- String getMethod()- String getParameter()- String getProtocol()- String getFromAddress()- void addResponseHeaderEntry(String name,String value)- void addResponseHeader(String header)- void addDefaultResponseHeader()- void addDefaultResponseHeader(String charSet) - boolean response(int statusCode,String content)- boolean response(int statusCode,String content,String charSet)- boolean response(int statusCode,byte[] content)
blockitem
- void addShapedCraft(String shape,Item output,(String key,Item value)...)- 这是更舒服的添加有序合成API，shape是合成形状字符串，- 用一个字母或数字代表合成原材料的摆放方式，用"|"来连接三行，用空格来占格，如果最后的一行或列没有东西，请不要保留- output是合成产物，后面的参数是映射表，key是你之前的shape中的字符，value是这个key代表的物品- shape中有多少种字符串就得有多少个这也的映射参数- 例如 石镐:addShapedCraft("SSS| I | I ",石镐物品,"S",圆石物品,"I",木棍物品)- 工作台: addShapedCraft("MM|MM",工作台物品,"M",橡木木板物品)- void registerSimpleItem(int id,String name,int stackSize/void)- 注册简单的物品堆，只能覆写教育版物品，stackSize指定最大堆叠数量，不填为64- void makeDropItem(Position position, Item item, boolean fly) --fly指定生成物品时物品是否具有随机初速度- void blockUpdate(Position position)
BNNPC
- void reFresh() --强制客户端刷新bnnpc以防止隐身
## 1.2.9.0new
重构代码加载器代码，重构了bnqqbot代码，增强稳定性，精简解释器添加bn插件包功能，.bnp(bn插件集合包)和.bnpx(bn插件复合压缩包)可以放到blocklynukkit文件夹里面直接运行使用bnp命令可以操作包，bnp build <makefile路径>即可构建一个bn插件包makefile是一个json格式的包配置文件，由name,compress,plugins三个字段组成name为打包的插件包的名字(字符串)，compress为是否打出压缩插件包(boolean)，plugins是一个字符串数组，里面标注要打进包中的bn插件的路径，加载时从上到下加载，也可以打进去json yml xml txt格式的资源文件，资源文件将会被按顺序解压到打包时与nk核心的相对位置解压。js中可以使用console了现在js插件报错会显示正确的文件名了F(Closure function)函数用于包装闭包bnAPI中的;换行现在支持使用\\;来转义修复了php中F(闭包)函数返回类型错误的问题修复了logger(console)输出null或nil报错的问题修复了无法监听修改version命令的问题新增预处理语句pragma autoload false/true，是否让bn解释器自动加载此插件，默认true修复了射箭不会触发EntityDamageByEntityEvent问题修复了http处理时url无法自动编码问题
PHP
更新了基于quercusPHP6引擎的php插件编写支持quercus提供的运行环境请看http://quercus.caucho.com/quercus-3.1/doc/quercus.xtp兼容全部的java类、nukkit的api和bn的基对象，调用bn的api记得前面加$
C/C++
更新了基于webassembly技术栈的C/C++插件编写支持可以直接调用java并于java进行交互，一次编译，处处运行，支持windows linux macos
export
可以通过导出标记将bn插件中的函数导出到全局环境中，然后即可使用java类命令exportdevjar <BN插件名>将可以导出bn插件中的函数头到一个jar包里面便于开发
javascript:```javascriptexport function MyFun(arg1,arg2,arg3){}```
python:```python@exportdef MyFun(arg1,arg2,arg3): pass```
lua:```luafunction BlockPlaceEvent(ent)-->export
end```
php:```phpstatic function PlayerJoinEvent($event){
}```
logger
- 强化了logger的功能，现在可以将对象以json格式输出
database
- localStorage: 本地存储管理器- void localStorage.cacheAll() --从本地读取数据并缓存，增加运行时获取数据速度- String localStorage.cache(String key) --从本地读取指定数据并缓存- void localStorage.setItem(String key,String item) --设置指定key对应的数据为item- String localStorage.getItem(String key) --获取指定key对应的数据- void localStorage.removeItem(String key) --移除指定key对应的数据- String[] localStorage.getKeys() --获取所有的key- void localStorage.save() --强制立即保存数据，bn会每3秒检查并保存一次数据- memoryStorage: 内存共享存储管理器- void memoryStorage.setItem(Object key,Object item) --设置指定key对应的数据为item- String memoryStorage.getItem(Object key) --获取指定key对应的数据- void memoryStorage.removeItem(Object key) --移除指定key对应的数据- Object[] localStorage.getKeys() --获取所有的key
manager
- Player[] getOnlinePlayers()- String getResource(String name) -- 读取资源- void runCMD(String cmd) --执行命令行程序- boolean isPathExists(String path)- String[] getFolderFiles(String path)- int getFileSize(String path)- void deleteFile(String path)- void doPathCreate(String path)- boolean isPathReadable(String path)- boolean isPathWritable(String path)- void copyFile(String fromPath,String toPath)- void qq.stopBot()- void interrupt(String info) --强制中断当前函数运行- void downloadFromURL(String url,String saveDir,String saveName)- Thread runThread(String functionName,Object... args) --在新线程中执行函数并同步返回这个线程- void requireMinVersion(String minVersion,String failMessage) --检查bn解释器版本，如果太低停止运行并发出failMessage
entity
- void shootArrow(Position from,Position to,boolean canPickUp,double multiply)- void shootArrow(Position from,Position to,double multiply)- void shootArrow(Position from,Position to,boolean canPickUp)- void shootArrow(Position from,Position to)- void lookAt(Entity e,Position pos)
window
- int[] setPlayerBossBar的第二个text参数中若以#XXXXXX或者rgb(x,x,x)开头将会为boss血条设置自定义颜色- int[] setPlayerBossBar现在可以在text参数中使用;来添加多个bossbar- int[] setPlayerBossBar(Player player,String text,float len) --现在返回数组，包含每个创建的bossbar的id- void removePlayerBossBar(Player player,long id) --相关api现在支持指定bossbar的id操作- double getLengthOfPlayerBossBar(Player player,long id)- String getTextOfPlayerBossBar(Player player,long id)- void sendPlayerXboxInfo(Player from,Player to) --向to玩家展示from玩家的xbox信息- void startEndPoem(Player player) --让玩家屏幕上开始展示终末之诗- void setSwingStyle(String style) --设置swing的样式- 目前有：Darcula Intellij Metal Motif Multi Nimbus OS(系统样式)- JFrame getStyledSwingWindow(String title,int width,int height,String iconPath)- 根据之前设置的样式获取Swing窗口对象，iconPath为null或""将使用bnLOGO替代
WindowBuilders
- void showToPlayer(Player p,String callback,boolean acceptClose) - acceptClose用于指定是否在窗口关闭的时候调用一次回调函数
SimpleWindowBuilder
-buildButton(String text,String img)-button(String text,String img)-button(String text)-setAction(String actionFunctionName/F function)-action(String actionFunctionName/F function)-setTitle(String title)-title(String title)-setContext(String context)-context(String context)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)
ModalWindowBuilder
-setTitle(String title)-title(String title)-setContext(String context)-context(String context)-setButton1(String text)-setButton2(String text)-button1(String text)-button2(String text)-setAction(String callbackFunctionName/F function)-action(String callbackFunctionName/F function)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)
CustomWindowBuilder
-setTitle(String title)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-showAsSetting(Player p, String callbackFunctionName/F function)-showAsSetting(Player p, String imageURL, String callbackFunctionName/F function)-buildLabel(String text)-label(String text)-buildInput(String title,String placeholder)-input(String title,String placeholder)-buildInput(String title,String placeholder,String defaulttext)-input(String title,String placeholder,String defaulttext)-buildToggle(String title)-toggle(String title)-buildToggle(String title,boolean open)-toggle(String title,boolean open)-buildDropdown(String title,String inner)-dropdown(String title,String inner)-buildDropdown(String title,String inner,int index)-dropdown(String title,String inner,int index)-buildSlider(String title,double min,double max,int step,double defaultvalue)-slider(String title,double min,double max,int step,double defaultvalue)-buildSlider(String title,double min,double max,int step)-slider(String title,double min,double max,int step)-buildSlider(String title,double min,double max)-slider(String title,double min,double max)-buildStepSlider(String title,String options)-stepSlider(String title,String options)-stepslider(String title,String options)-buildStepSlider(String title,String options,int index)-stepSlider(String title,String options,int index)-stepslider(String title,String options,int index)-setAction(String callbackFunctionName/F function)-action(String callbackFunctionName/F function)
BNNPC
- void addExtraDropItem(Item item)- boolean hasDropItem(Item item)- void removeExtraDropItem(Item item)- Item[] getExtraDropItems()- Item[] getDropItems()- void setDropHand(boolean drop/void) --参数不填时默认为true- void setDropOffhand(boolean drop/void) --参数不填时默认为true- void addDropSlot(int slot) --指定背包槽位死亡掉落- int[] getDropSlots()- void removeDropSlot(int slot)- void doEmote(String action/void) --让npc执行指定的表情动作 - action可以是 Wave Punch Clap OverThere Hammer Fall Diamond Pickaxe - 也可以填写对应的中文 挥手 拳击 鼓掌 在那 锤子 摔倒 钻石 - 不填的话将上面的五个动作中任选一个 - 至于为什么只有8个: 因为剩下的要氪金购买之后才能获取uuid，冰凉没钱 - 欢迎大家贡献uuid- boolean directMove(Position to) --直线移动到某处
world
- void regenerateChunk(Position pos)- void defineChunkRenderByName(String forLevel,String callback,int priority / void) - forLevel是渲染器能够渲染的指定世界名称 - callback是渲染器回调函数 - priority是优先级，优先级越大先调用，不填默认为0- void drawPic(Position pos1,Position pos2,String img,int faceData) - 从pos1到pos2绘制img路径上的图片，faceData指定物品展示框的朝向，pos1和pos2必须在同一垂直面上
blockitem
- void registerSolidBlock(int id,String name,double hardness,double resistance,int toolType,boolean isSilkTouchable,int dropMinExp,int dropMaxExp,int mineTier) - 注册固体方块，参数分别为方块id(只能覆写教育版方块)，方块名称，方块硬度，方块抗爆炸度，挖掘工具，是否**准采集影响，最小掉落经验，最大掉落经验，挖掘等级 - 方块硬度越大挖掘时间越长，抗爆炸度越高越不容易被炸 - 挖掘工具0-无,1-剑,2-铲,3-镐,4-斧,5-剪刀 - 挖掘等级0-空手,1-木,2-金,3-石,4-铁,5-钻石- void registerSimpleItem(int id,String name) - 注册简单的物品堆，只能覆写教育版物品
## 1.2.8.4new
更新了qq机器人对接模块，使用小栗子qq机器人框架（因为这是唯一一个没跑路的免费机器人了），配好的包在bn群内下载您也可以从官网下载框架并自行安装tcpapi.dll插件到机器人框架中，bn通过tcpapi来与其交互添加了com.blocklynukkit.JavaAPI类来提供bn对java的api添加了调试工具，使用命令bndebug打开调试工具，可以查看变量和监控命令情况
Lua
添加了lua语言支持，版本为luaj5.2，可以通过lua来制作bn插件，接口与js和py完全相同您需要使用:来访问基对象函数，此外还提供了用于和java交互的luajava对象和asTable asList asMap三个全局函数详见bn开发文档
Bug Fixed
- 修复了熔炉配方nbt丢失问题- 修复了设置箱子和漏斗物品栏不好使的问题- 修复了py插件不可用问题- 修复了BNNPC在路径移动时被击退遁地问题- 修复了BNNPC导致的区块报错问题
BNNPC
- Array<Player> getPlayersIn(double distance)- Array<Entity> getEntitiesIn(double distance)- Player getNearestPlayer(double far)- Player getNearestPlayer()- void setEntityRideOn(Entity entity)- void isEntityRideOn(Entity entity)- void setEntityRideOff(Entity entity)- Player getRidingPlayer()
window
- setPauseScreenList(String list) --设置暂停界面右侧显示在线玩家区域的文字，用;分割多行
CustoWindowBuilder
-this showAsSetting(Player p, String imageURL, String callback) --支持图标，和按钮图标书写方式相同
manager
- void qq.startBot() 启动qq机器人进程- void qq.reDirectBot(String ip) - 将机器人重定向到指定ip地址，并使用那台电脑的小栗子qq机器人框架 - 要求目标电脑开放8404-TCP端口，并且在小栗子的tcpapi插件中允许远程控制- void qq.sendFriendMessage(String fromQQ,String toQQ,String message) 发送好友信息- void qq.sendGroupMessage(String fromQQ,String toGroup,String message) 发送群信息- void qq.sendGroupPicMessage(String fromQQ,String toGroup,String picturePaths,String message) - 发送qq图文消息 - picturePaths用;分割多个本地图片路径 - 消息中使用图片只需用%picture数字%即可，数字指代第几个路径的图片，从0开始算起- void qq.kickGroupMember(String fromQQ,String toGroup,String toQQ) --踢了指定群员,fromQQ是机器人账号- void qq.banSpeakGroupMember(String fromQQ,String toGroup,String toQQ,int second) --禁言指定群员- String getPlayerDeviceID(Player player) --获取玩家的手机或电脑设备标识码- String getPlayerDeviceModal(Player player) --获取玩家的设备型号- int getPlayerDeviceOS(Player player) -- 获取玩家的操作系统id- double getMoney(String player)- void reduceMoney(String player,double money)- void addMoney(String player,double money)- void setMoney(String player,double money)- void setNukkitCodeVersion(String string) -- 修改version命令显示的nk版本- void nodejs.eval(String str,boolean isPath) -- 使用nodejs运行str - 运行nodejs代码是sandbox在nodejs环境运行的，而非java环境 - 若isPath为true，则执行该路径的文件 - 否则将str作为nodejs代码执行 - 其中可以使用callFunction(String BNFunctionName,String args...)来调用bn插件的函数- void nodejs.newDocker(String dockerName,String str,boolean isPath) --开启一个常驻nodejs容器 - dockerName是创建的nodejs容器的名字，容器一旦创建就会立即开始执行其中的代码 - 重启创建后执行完代码不会被销毁，而是可以继续通过callDockerFunction调用其中方法 - 如果需要在其他bn插件调用其中的nodejs函数，需要使用registerFunction(String 函数名,Function 函数)注册 - 其余同nodejs.eval函数- void nodejs.closeDocker(String dockerName) --关闭指定的nodejs容器并释放占用资源- String callDockerFunction(String function,String... args) - 调用指定容器中的指定函数并向其传参，调用的函数必须先注册再使用，否则bn无法获取此函数内存地址进行调用 - 返回值将自动被转为字符串，如果被调函数无返回值则返回字符串"null" - function指定调用的函数，格式为 容器名::函数名（同其他地方的调用格式） - 若直接输入函数名，则将在所有未关闭容器中随机寻找一个有此名称函数的容器调用，若找不到，返回NO FUNCTION - args参数只接受字符串，数量不限，也可没有- TaskHandler createTask(String functionName, int delay ,\<E+\>... args)- TaskHandler createLoopTask(String functionName, int delay,\<E+\>... args) - 支持2-128个任意数量的参数，第一个参数为回调函数名，第二个为回调间隔tick，其余的是在调用函数时向函数传递的参数- void newPlugin(String path) --加载指定路径上的bn插件- void newJSPlugin(String name,String code) --根据代码字符串创建一个新的bn插件- void newPYPlugin(String name,String code)- void newLUAPlugin(String name,String code)- void addCommandCompleter(String cmd,String id,String completer) - 创建命令补全器，将被发送给玩家用作命令提示和tab补全 - cmd为要添加给的命令的名称，id为补全器标识符，随意只要不重复即可 - completer是补全器内容，由\<必选单元>和\[可选单元]由空格连缀组成 - 每个单元的内部格式为 名称:@类型=参数1;参数2;... 等于号及其后面的部分不是必须的 - 类型有：@target @blockpos @pos @int @float @string @text - 类型有：@message @command @json @filepath @operator - 例如：\<player:@target\> \<sentence:@message=BNNB!;blocklynukkit\> \[color:@text=red;green\]
EventLoader
- QQGroupMessageEvent --机器人收到qq群消息事件 - String getSelfQQ() --获取收到消息的qq账号 - String getFromQQ() --获取发送消息的qq账号 - String getFromGroup() --获取消息事件的qq群号 - String getMessage() -获取消息- QQFriendMessageEvent --机器人收到qq好友消息事件 - String getEventId() --获取事件id - String getEventSeed() --获取事件中的群消息标识码 - String getFromQQ() --获取发送消息的qq - String getSelfQQ() --获取接受到群消息的qq账号 - String getMessage() --获取事件的消息- QQOtherEvent - String getFromGroup() --获取触发事件的qq群号 - String getFromQQ() --获取触发事件的qq账号 - String getSelfQQ() --获取收到事件的qq账号 - String getSeq() --获取收到事件的标识id - int getType() --获取事件类型码
Entity
- void setPlayerExp(Player player,int exp)- int getPlayerExp(Player player)- void setPlayerExpLevel(Player player,int lel)- int getPlayerExpLevel(Player player)- void setPlayerHunger(Player player,int hunger)- int getPlayerHunger(Player player)- void makeSoundToPlayer(Player player,String sound)- Entity spawnEntity(String name,Position pos) --返回值更改
## 1.2.8.3
Bugs Fixed
- 修复了bnnpc浮空走路bug- 修复了浮空物品空事件报错- 现在的报错信息比以前好看多了
manager
- <E> callFunction(String functionname,Object... args) --callFunction会返回函数的返回值了- <E> getVariableFrom(String scriptName,String varName) --根据bn插件名和变量名获取变量内容- void putVariableTo(String scriptName,String varName,<E> var) --把变量值以指定变量名放到指定bn插件中- double getCPULoad()- int getCPUCores()- double getMemoryTotalSizeMB()- double getMemoryUsedSizeMB()- void forceDisconnect(Player player)- Array<String> getEventFunctions(Event event)- void getServerMotd(String host, int port, String callback) --根据服务器IP和端口获取在线人数信息
blockitem
- void setItemColor(Item item,int r,int g,int b)- void setItemUnbreakable(Item item,boolean unbreakable)
inventory
- Item getEntityHelmet(Entity entity)- Item getEntityChestplate(Entity entity)- Item getEntityLeggings(Entity entity)- Item getEntityBoots(Entity entity)- Item getEntityItemInHand(Entity entity)- Item getEntityItemInOffHand(Entity entity)- void setEntityItemHelmet(Entity entity,Item item)- void setEntityItemChestplate(Entity entity,Item item)- void setEntityItemLeggings(Entity entity,Item item)- void setEntityItemBoots(Entity entity,Item item)- void setEntityItemInHand(Entity entity,Item item)- void setEntityItemInOffHand(Entity entity,Item item)- Item getInventorySlot(Inventory inv,int slot)
window
- void forceClearWindow(Player player)- int getEventResponseIndex(PlayerFormRespondedEvent event)
entity
- boolean isPlayer(Entity e)- void spawnFallingBlock(Position pos, Block block, boolean enableGravity,boolean canBePlaced)
gameapi --新的基对象
- void createGame(String name,boolean useTeam,String startGameCallBack,String endGameCallBack,String mainLoopCallBack,String deathCallBack) -- 创建一个小游戏房间- void joinGame(Player player, String gameName) --让玩家进入指定名称的小游戏，自动匹配房间- void leaveGame(Player player) --让玩家从小游戏房间离开- boolean isPlayerInGame(Player player) --玩家是否正在玩某个小游戏- GameBase getPlayerRoom(Player player) --获取玩家正在玩的小游戏对象- Array<GameBase> getAllRoomByName(String gameName) --获取游戏名称相同的所有小游戏房间对象组成的数组- Array<String> getAllGameNames() --获取所有正在运行的小游戏房间的名字组成的数组- Messager getMessager(String prefix)- Messager getGameMessager(GameBase game)- Multiline getMultiline(String messageType)- InventoryMenu createInventoryMenu(String inventoryType, String title)- FormMenu createFormMenu(String title, String content)- void addMenuItem(InventoryMenu menu, int slot, Item item, String inventoryCallback)- void addMenuButton(FormMenu menu,String buttonText,String imageData,String formCallback)- Scoreboard getScoreboard(Player p)- void setObjective(Scoreboard sb, String objectiveName,String displayName)
GameBase --小游戏房间对象
EventLoader --73 new
- BlockFadeEvent- BlockFallEvent- BlockFromToEvent- BlockGrowEvent- BlockIgniteEvent- BlockPistonChangeEvent- BlockRedstoneEvent- DoorToggleEvent- CreatureSpawnEvent- CreeperPowerEvent- EntityArmorChangeEvent- EntityBlockChangeEvent- EntityCombustByBlockEvent- EntityCombustByEntityEvent- EntityCombustEvent- EntityDamageByBlockEvent- EntityDamageByChildEntityEvent- EntityExplodeEvent- EntityMotionEvent- EntityPortalEnterEvent- EntityRegainHealthEvent- EntityShootBowEvent- EntityVehicleEnterEvent- EntityVehicleExitEvent- ExplosionPrimeEvent- BrewEvent- EnchantItemEvent- InventoryMoveItemEvent- StartBrewEvent- ChunkLoadEvent- ChunkPopulateEvent- LevelInitEvent- LevelLoadEvent- LevelSaveEvent- LevelUnloadEvent- SpawnChangeEvent- ThunderChangeEvent- WeatherChangeEvent- PlayerAchievementAwardedEvent- PlayerAnimationEvent- PlayerAsyncPreLoginEvent- PlayerBlockPickEvent- PlayerBucketEmptyEvent- PlayerBucketFillEvent- PlayerChangeSkinEvent- PlayerChunkRequestEvent- PlayerCreationEvent- PlayerDropItemEvent- PlayerEatFoodEvent- PlayerEditBookEvent- PlayerFoodLevelChangeEvent- PlayerGameModeChangeEvent- PlayerGlassBottleFillEvent- PlayerInvalidMoveEvent- PlayerItemConsumeEvent- PlayerLocallyInitializedEvent- PlayerMapInfoRequestEvent- PlayerMouseOverEntityEvent- PlayerServerSettingsRequestEvent- PlayerSettingsRespondedEvent- PluginDisableEvent- PluginEnableEvent- PotionApplyEvent- PotionCollideEvent- PlayerDataSerializeEvent- RemoteServerCommandEvent- EntityEnterVehicleEvent- EntityExitVehicleEvent- VehicleCreateEvent- VehicleDamageEvent- VehicleDestroyEvent- VehicleMoveEvent- VehicleUpdateEvent- LightningStrikeEvent
1.2.8.2：修复bug- 修复了bnnpc和bn浮空字莫名其妙消失的问题
新增功能- 现在可以在js代码的开头加上一行注释//pragma es9来开启es9语言特性，但是会有些许性能损失，损失不大，可以放心使用- bninstall命令已经弃用，所有库全部打包进bn解释器jar，这样做是为了节约内存空间，能够节省至多50MB内存空间。
CustomWindowBuilder 高级菜单管理器新增2个成员函数- Custom showAsSetting(Player p, String callback) 将此高级表单作为玩家的服务器设置页面- Custom buildDropdown(String title,String inner,int index) 构建一个下拉菜单并指定默认选项
EventLoader新增1个事件- ChunkUnloadEvent 区块卸载事件
entity新增6个函数- void setPlayerExp(Player player,int exp) 设置玩家经验- int getPlayerExp(Player player) 获取玩家经验- void setPlayerExpLevel(Player player,int lel) 设置玩家等级- int getPlayerExpLevel(Player player) 获取玩家等级- void setPlayerHunger(Player player,int hunger) 设置玩家饥饿度- int getPlayerHunger(Player player) 获取玩家饥饿度
window新增2个函数- void makeTipsVar(String varname,String providerCallback) 创建动态的tips插件变量- void makeTipsStatic(String varname,String toReplace) 创建静态的tips插件变量
[/markdown]下一页更精彩(*^_^*)
UI表单主题预览图(BiliBili主题)：
UI表单主题预览图(流浪地球主题)：
UI表单主题预览图(山河无恙主题)：
UI表单主题预览图(东方之梦主题)：
预览图(旧版本)：
开源地址：https://github.com/Superice666/BlocklyNukkit记得来赞助一波哦：.png)
.png)
版主注：
基岩版插件&服务端板块偏技术型板块，这里并非是矿工茶馆。请在回复前再三思考，认真阅读版规，本版灌水处罚较其他板块更为严厉！
服务端插件开发框架
图形编辑器在线使用网址：点击进入
我们的服务器插件下载地址：见上
在线使用说明书：BNWIKI
交流群：953752196
项目简介：
blocklynukkit友好界面中文插件编辑器是由超神的冰凉发起的开源的服务器插件开发框架，其目的为致力于为中国广大服主提供清爽、强大、实用、简洁的中文服务器插件开发服务，使得更多想要开发自己的插件却对晦涩难懂的JAVA编程望而却步的服主能够很容易的，以拖拽的形式开发出自己想要的各种功能。
blocklynukkit不仅是一个插件编辑器，它更是一个多语言插件加载器，支持JavaScript、Python、Lua、PHP和C/C++。您可以用这里面的任意一种或多种语言来开发服务器插件，BlocklyNukkit为所有语言提供统一的运行时api，可以与java无缝集成交互。
我们的代码完全基于AGPL3.0开源，任何人都可以加入我们或者做出贡献，如果您是使用者或者服主，您可以在此进入教程学习如何使用本项目并构建自己的插件。
现在blocklynukkit仅支持nukkit客户端，我们欢迎来自bukkit/spigot等服务端的开发者们移植到目标服务端~
加载器链接：
为什么我们要做这个：
BlocklyNukkit是做什么的：
Blocklynukkit是一套专业级服务器插件开发框架，旨在使得各位服主都能制作属于自己的专属插件，让各位开发者更快速地制作插件、分发插件。新手也可以通过我们的图形化编辑器，您可以通过拖拽拼图的方式简单而轻松的创作插件，省去了很多不必要的操作。
BlocklyNukkit的特点：
· 零基础快速上手，友好的使用方式，近万字新手教程
· 云端一键部署安装，多端均可开发插件（手机/电脑）
· vscode插件支持，编程开发插件快人一步
· nukkit和BN双API，开发插件的最佳选择
· 多样的表单主题，让你的服务器独树一帜！
· 完全自定义物品支持，让服务器可玩性大幅提升
· 图形编辑器、javascript、python、lua、php、C/C++、java/scala可混合开发
BlocklyNukkit可以做出什么样的插件：
BlocklyNukkit是一个完整的插件开发框架，可以做出所有在服务端插件能力范围内的形式和内容的插件。
BlocklyNukkit支持插件开发的方式：
BlocklyNukkit支持如下4种插件开发方式：
1、图形编辑器（十分简单，零基础开发）
2、JavaScript（ECMA 5.1标准 + 部分ES6）
3、Python（2.7版本）
4、Lua （5.1版本）
5、PHP （5.7版本）
6、C/C++ (17版本)
有用的资源：
官方教程库(最全面)：http://www.blocklynukkit.info/
QQ群：953752196
直接进入编辑器：https://tools.blocklynukkit.com
将js插件打包为jar包发布：https://www.mcbbs.net/thread-1022008-1-1.html
下一页更精彩(*^_^*)
2021.12 数据，可能有更多内容
版主注：基岩版插件&服务端板块偏技术型板块，这里并非是矿工茶馆。请在回复前再三思考，认真阅读版规，本版灌水处罚较其他板块更为严厉！项目简介：blocklynukkit友好界面中文插件编辑器是由超神的冰凉发起的开源的服务器插件开发框架，其目的为致力于为中国广大服主提供清爽、强大、实用、简洁的中文服务器插件开发服务，使得更多想要开发自己的插件却对晦涩难懂的JAVA编程望而却步的服主能够很容易的，以拖拽的形式开发出自己想要的各种功能。blocklynukkit不仅是一个插件编辑器，它更是一个多语言插件加载器，支持JavaScript、Python、Lua、PHP和C/C++。您可以用这里面的任意一种或多种语言来开发服务器插件，BlocklyNukkit为所有语言提供统一的运行时api，可以与java无缝集成交互。我们的代码完全基于AGPL3.0开源，任何人都可以加入我们或者做出贡献，如果您是使用者或者服主，您可以在此进入教程学习如何使用本项目并构建自己的插件。现在blocklynukkit仅支持nukkit客户端，我们欢迎来自bukkit/spigot等服务端的开发者们移植到目标服务端~项目链接：https://github.com/Superice666/BlocklyNukkit教程链接：http://www.blocklynukkit.info/加载器链接：正式版 https://tools.blocklynukkit.com/BlocklyNukkit.jar
测试版 https://gitee.com/qdez/BlocklyNukkit_Loader/gitee_go/15181为什么我们要做这个：（仅代表个人拙见）如您所见，现在中国nk整个生态圈，乃至基岩版生态圈，在网易的操作下，跟之前比起来，几乎是一片废墟。现在的nk生态绝大部分是几位优秀的开发者所建立的，一旦发生了什么不好的事请，整个生态链一触即断，这是我，同样也是广大服主、玩家、开发者都不希望见到的局面。作为一个局内人，我深知一个好的生态的重要性。经过反复的思考，我决定以blocklynukkit这个项目为切入口，着手为这个社区做点什么。我深知我的力量渺小，能做的微乎其微，但是我做了，等我从这里离去的时候，我不会留下任何悔恨。BlocklyNukkit是做什么的：Blocklynukkit是一套专业级服务器插件开发框架，旨在使得各位服主都能制作属于自己的专属插件，让各位开发者更快速地制作插件、分发插件。新手也可以通过我们的图形化编辑器，您可以通过拖拽拼图的方式简单而轻松的创作插件，省去了很多不必要的操作。BlocklyNukkit的特点： · 零基础快速上手，友好的使用方式，近万字新手教程 · 云端一键部署安装，多端均可开发插件（手机/电脑） · vscode插件支持，编程开发插件快人一步· nukkit和BN双API，开发插件的最佳选择· 多样的表单主题，让你的服务器独树一帜！· 完全自定义物品支持，让服务器可玩性大幅提升 · 图形编辑器、javascript、python、lua、php、C/C++、java/scala可混合开发BlocklyNukkit可以做出什么样的插件：BlocklyNukkit是一个完整的插件开发框架，可以做出所有在服务端插件能力范围内的形式和内容的插件。BlocklyNukkit支持插件开发的方式：BlocklyNukkit支持如下4种插件开发方式：1、图形编辑器（十分简单，零基础开发）2、JavaScript（ECMA 5.1标准 + 部分ES6）3、Python（2.7版本）4、Lua （5.1版本）5、PHP （5.7版本）6、C/C++ (17版本)其他功能：
如何使用表单主题控制器：附属插件 BN表单主题控制器下载链接：https://github.com/Superice666/BlocklyNukkit/raw/master/BNThemeController.jar把这个jar包放在plugins文件夹里面，重启一次服务器，blocklynukkit解释器会调用表单主题控制器（1.1.8版本及以上），随后在./plugins/BlocklyNukkit/文件夹下面会生成：theme.yml文件，内容为
代码:
- theme: MINECRAFT
BiliBili B站2233主题风格
The_Wandering_Earth 流浪地球主题风格
TOHO 东方之梦国风主题风格
Landscapes_The_Same 山河无恙主题风格
更多风格持续更新中......
The_Wandering_Earth 流浪地球主题风格
TOHO 东方之梦国风主题风格
Landscapes_The_Same 山河无恙主题风格
更多风格持续更新中......
如何使用速建官网功能：
在BlocklyNukkit文件夹下会有port.yml，设置里面的端口为你希望的官网端口，设置完之后在浏览器输入 你的ip/域名:端口 即可打开服务器官网。但是在没有设置官网页面html文件之前会在浏览器显示错误，具体教程详见完整官方教程或站内快速搭建教程。
有用的资源：官方教程库(最全面)：http://www.blocklynukkit.info/图形编辑器教程链接：https://docs.qq.com/doc/DRkRpS0xmV2ZJbGdiQQ群：953752196直接进入编辑器：https://tools.blocklynukkit.com将js插件打包为jar包发布：https://www.mcbbs.net/thread-1022008-1-1.html下一页更精彩(*^_^*)
更新日志：旧版本下载：https://hub.fastgit.org/Superice666/BlocklyNukkit/tree/master/oldversions各开发版更新详细日志：https://hub.fastgit.org/Superice666/BlocklyNukkit/releases（1.2.8.1及以前版本的更新日志提供在帖子的置顶楼层了）## 1.2.9.7
Bug Fixed
- 修复了错误的命令介绍- 修复了非EconomyAPI兼容性- 修复了饮品无法在满饱食度情况下饮用bug- 修复了BNNPC Steve皮肤从外部调用无效bug- 修复了BNNPC死亡异常掉落物品的bug- 修复了WebSocket服务器启动报错bug- 修复了Ws卡死主线程问题
entity
- void setPlayerCompassTarget(Player player, position target) --设置玩家指南针指向位置- void setPlayerCape(Player player, String capeImagePath) --设置玩家的披风
## 1.2.9.6
Bug Fixed
- 修复了窗口回调接受窗口关闭无效的bug
Event
- AddMoneyEvent- ReduceMoneyEvent- SetMoneyEvent
New
- 小幅优化js加载性能- 在核心同级文件夹创建新文件debug.inf即可启动js加载计时
manager
- void customEventListener( String fullEventName, --要监听的事件的java类名 String callbackFunction, --事件回调函数 String priority --事件优先级，可选NORMAL MONITOR LOWEST LOW HIGH HIGHEST) --动态监听事件- WsClient createWsClient( String serverUrl, --远程ws服务器链接 String newWsConnectCallback, --ws成功连接回调 String closeWsConnectCallback, --ws客户端断开连接回调 String receiveStringCallback, --接收到字符串数据回调 String receiveDataCallback --接收到非字符串数据回调) --创建Ws客户端- WsServer createWsServer( int port, --端口 String newWsConnectCallback, --有新的ws客户端连接回调 String closeWsConnectCallback, --ws客户端断开连接回调 String receiveStringCallback, --接收到字符串数据回调 String receiveDataCallback --接收到非字符串数据回调) --创建WebSocket服务器- long timing.start() --启动计时，返回计时器id，对性能无影响- long timing.end(long id) --结束计时，返回经过的纳秒- long timing.finish(long id) --结束计时并将结果输出到控制台- long timing.finish(String info) --结束最近一次启动的计时器并将经过的时间输出到控制台，info将作为输出的前缀
blockitem
- @Comment(value = "注册新的简易物品, 允许任意自定义物品")public void registerSimpleItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "新物品的类别，可选construction nature equipment items") String type,@Comment(value = "是否展示为工具(竖着拿在手里)") boolean isDisplayAsTool,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的工具物品")public void registerToolItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "工具种类,可为sword shovel pickaxe axe hoe") String toolType,@Comment(value = "工具挖掘等级 0-空手,1-木,2-金,3-石,4-铁,5-钻石,6-下界合金") int toolTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "攻击伤害") int attackDamage,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的食物物品")public void registerFoodItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "食用持续时间(刻)") int eatTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的饮品物品")public void registerDrinkItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "饮用持续时间(刻)") int drinkTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
- @Comment(value = "注册新的盔甲物品")public void registerArmorItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "盔甲种类,可为helmet chest leggings boots") String armorType,@Comment(value = "盔甲等级 0-无,1-皮革,2-铁,3-锁链,4-金,5-钻石,6-下界合金") int armorTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "提供的盔甲值") int armorPoint,@Comment(value = "是否可装备在副手") boolean canOnOffhand,@Comment(value = "物品初始化函数") @CallbackFunction(classes = {"cn.nukkit.item.Item"}, parameters = {"self"}, comments = {"新创建的物品自身"}) String initFunction)
## 1.2.9.5Bug Fixed
- 修复了自定义工具伤害问题- 修复js中java包重导入报错- 修复胡椒商店兼容性问题- 修复不同模块同名函数调用混乱问题
New
- 注册自定义物品速度加快- NPC寻路不再显示路径粒子
blockitem
- boolean isBlockWaterLogged(Block block) --检测方块是否为含水方块- void addSoundFile(String soundName, String fileName) --向材质包添加新的声音文件- void addArmorTexture(@Comment(value = "物品id") int id,@Comment(value = "盔甲物品栏材质图片路径") String inventoryPicturePath,@Comment(value = "盔甲穿着时材质图片路径") String modelPicturePath,@Comment(value = "4d盔甲模型文件(.json)，可不填") String modelJSONPath)--为自定义盔甲添加4d模型
BNNPC
- void start(Player player) --只对某一个玩家启动显示
entity
- RouteFinder buildRouteFinder(Entity entity) --为实体构建寻路器
manager
- void concurrentRun(String functionName, <E+>... args) --并行运行函数- void jvm.close(int returnCode / void) --强制关闭jvm并返回返回值，可不填，默认为0- JMemory jvm.getMemory() --获取jvm内存管理器- Class jvm.getJVMClass(String className) --根据类名获取jvm类对象- JClass jvm.newJVMClass(@Comment(value = "java类名") String className,@Comment("继承自的父类类名，可不填") String extendFromClass / void,@Comment("实现的接口类名，可不填") String... interfaceClasses / void) - 创建新的java类构造器
JClass
- JClass addConstructor(String modifier, String proxyFunction, String... argumentClasses)- 为新java类添加构造函数- modifier是构造函数修饰符，如public final等等- proxyFunction是对应处理的bn插件函数名，调用时传入构造函数的所有参数，第一个参数永远是类自身，其余为自定义参数- argumentClasses是构造函数自定义参数的类名- 返回自身，便于链式调用- JClass addField(String modifier, String fieldClass, String fieldName, Object defaultValue / void)- 为新java类添加字段（又称属性或成员变量）- modifier是字段修饰符，如public final等等- fieldClass是字段类名- fieldName是字段名称，需遵守java规范- defaultValue是字段的默认值，可以不填，默认没有默认值而非默认值为null- 返回自身，便于链式调用- JClass addMethod(String modifier, String returnClass, String methodName, String proxyFunction, String... argumentClasses)- 为新java类添加方法（又称成员函数）- modifier是方法修饰符，如public final等等- returnClass是方法返回值，无返回值填入void即可- methodName是方法名称- proxyFunction是对应处理的bn插件函数名，调用时传入方法的所有参数，第一个参数永远是类自身，其余为自定义参数- argumentClasses是构造函数自定义参数的类名- 返回自身，便于链式调用- JClass finish()- 完成java类构造，此时java类才可以使用，且不可再次更改- 返回自身，便于链式调用- Object newInstance(Object... args)- 实例化自身，即对自身构建的java类进行new- 必须在finish之后才能使用！
JMemory
- long getMax() --获取JVM最大可用内存大小- long getFree() --获取JVM剩余内存大小- long getTotal() --获取JVM总内存大小- void gc() --进行内存清理
RouteFinder
- Entity getEntity()- void setSearchLimit(int searchLimit)- int getSearchLimit()- void setStart(Vector3 start)- Vector3 getStart()- void setDestination(Vector3 destination)- Vector3 getDestination()- void setLevel(Level level)- Level getLevel()- void setBoundingBox(AxisAlignedBB bb)- AxisAlignedBB getBoundingBox()- boolean hasNext()- Node next()- boolean hasReachedNode(Vector3 vec)- Node get()- void forceStop()- void arrived()- boolean hasRoute()- boolean search()- boolean research()- boolean isSearching()- boolean isSuccess()
## 1.2.9.4
New
- Js已经支持for of循环- Js中修复了错误的=>实现- Js中新增宏注释：//pragma optimistic，添加后bn将会为此代码在载入期间激进地进行类型推导以优化运行时性能- bnp支持.phpfile后缀名- bnp和bnpx可以直接放入plugins文件夹加载- 小幅优化性能- js中可以直接使用类的全名使用java类，无需进行Java.type或require引入- 材质包不会无谓地重复生成
HttpHandler
- 回调参数中新增getRequestRawUrl函数
BNNPC
- 优化ai算法，避免npc消失bug
manager
- addCommandCompleter新增@sub规则，表示一个子命令补全选项- @Comment(value = "是否运行在PowerNukkit上")public boolean isPowerNukkit()
inventory
- @Comment(value = "新建一个漏斗物品栏")public HopperFakeInventory addHopperInv(@Comment(value = "包含的物品，需要使用`Java.to`函数转换") Item[] item,@Comment(value = "物品栏标题") String name)
blockitem
- @Comment(value = "注册新的简易物品, 允许任意自定义物品")public void registerSimpleItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "新物品的类别，可选construction nature equipment items") String type,@Comment(value = "是否展示为工具(竖着拿在手里)") boolean isDisplayAsTool,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的工具物品") public void registerToolItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "工具种类,可为sword shovel pickaxe axe hoe") String toolType,@Comment(value = "工具挖掘等级 0-空手,1-木,2-金,3-石,4-铁,5-钻石,6-下界合金") int toolTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "攻击伤害") int attackDamage,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的食物物品")public void registerFoodItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "食用持续时间(刻)") int eatTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的饮品物品")public void registerDrinkItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "新物品的最大堆叠上限") int stackSize,@Comment(value = "提供的饥饿度") int nutrition,@Comment(value = "饮用持续时间(刻)") int drinkTime,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "注册新的盔甲物品")public void registerArmorItem(@Comment(value = "新物品的id") int id,@Comment(value = "新物品的名称") String name,@Comment(value = "盔甲种类,可为helmet chest leggings boots") String armorType,@Comment(value = "盔甲等级 0-无,1-皮革,2-铁,3-锁链,4-金,5-钻石,6-下界合金") int armorTier,@Comment(value = "工具耐久值") int durability,@Comment(value = "提供的盔甲值") int armorPoint,@Comment(value = "是否可装备在副手") boolean canOnOffhand)
- @Comment(value = "添加新的盔甲材质")public void addArmorTexture(@Comment(value = "物品id") int id,@Comment(value = "盔甲物品栏材质图片路径") String inventoryPath,@Comment(value = "盔甲穿着时材质图片路径") String modelPath)
- @Comment(value = "添加新的物品材质")public void addItemTexture(@Comment(value = "物品id") int id,@Comment(value = "物品材质图片路径") String path)
- @Comment(value = "为指定id物品添加中文翻译名")public void addItemChineseTranslation(@Comment(value = "物品id") int id,@Comment(value = "中文名") String name)
- @Comment(value = "为指定id物品添加英文翻译名")public void addItemEnglishTranslation(@Comment(value = "物品id") int id,@Comment(value = "英文名") String name)
- @Comment(value = "向材质包中指定位置添加json文件")public void addResourcePackJsonEntry(@Comment(value = "材质包内相对位置，包含路径和文件全名") String entryPath,@Comment(value = "json文件内容") String json)
- @Comment(value = "向材质包中指定位置添加图片文件")public void addResourcePackPictureEntry(@Comment(value = "材质包内相对位置，包含路径和文件全名") String entryPath,@Comment(value = "要复制到材质包中的硬盘上的图片路径") String path)
world
- void defineChunkRenderAll(String callback,int priority / void)- 为所有世界添加地形渲染器- callback是渲染器回调函数- priority是优先级，优先级越大先调用，不填默认为0
entity
- @Comment(value = "构建4d展示模型") public BNModel buildModel(@Comment(value = "生成模型的位置") Position pos,@Comment(value = "模型4d皮肤id") String modelSkinID,@Comment(value = "模型长") double length,@Comment(value = "模型宽") double width,@Comment(value = "模型高") double height,@Comment(value = "模型缩放比例") double scale,@Comment(value = "定时回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","int"}, parameters = {"model", "tick"}, comments = {"执行此函数的模型实体", "当前实体运行刻"}) String tickCallback,@Comment(value = "定时回调函数回调间隔(刻)") int callTick,@Comment(value = "被攻击回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","cn.nukkit.event.entity.EntityDamageEvent"}, parameters = {"model", "damageEvent"}, comments = {"执行此函数的模型实体", "实体受到的伤害事件"}) String attackCallback,@Comment(value = "实体交互回调函数") @CallbackFunction(classes = {"com.blocklynukkit.loader.other.Entities.BNModel","cn.nukkit.Player","cn.nukkit.item.Item","cn.nukkit.math.Vector3"}, parameters = {"model","player","item","clickPos"}, comments = {"执行此函数的模型实体", "发起交互的玩家", "交互使用的物品", "交互点击的位置"})String interactCallback)
1.2.9.3Bug Fixed
- 修复了bnp无法加载自定义模块名问题- 修复了BN浮空字能被打的问题- 去掉了陈旧的bnmiscbuild命令
1.2.9.2Bug Fixed
- 修复了异步JSON与YAML互转的问题，大幅提升转换速度- js中可以使用箭头函数- js中可以通过require(java类名/文件名)来调用java类或其他插件- 修复了js解析器错误解析字符串中的正则表达式的问题- 修复了manager.doPathCreate无法创建文件夹问题- 修复了BlackBE合作API错误的问题- 修复了PowerNukkit1.4.0.x生物兼容问题- NPC有默认皮肤了
Module
- 通过注释宏：pragma module 模块名定义模块- 定义模块后，可以通过模块名来引入其他模块中的导出函数
manager
- void appendFile(String path,String text)- 追加写入文件内容
entity
- BNNPC buildNPC(Position pos,String name)- void displayHurt(Entity e)- void displayDie(Entity e)
blockitem
- void addFishingResult(String type,Item item,double chance)- 添加钓鱼产物，type为新增产物种类，item是产物物品，changce是概率权重- type可以取TREASURES;宝藏;JUNKS;垃圾;FISHES;鱼类，中英文皆可
algorithm
- Position buildPosition(double x,double y,double z,Level level)
New Event
- BNInitializedEvent- 在所有bn插件都初始化后发出- 无成员函数，无法被取消- BNClosedEvent- 在bn被nk要求关闭的时候发出- 无成员函数，无法被取消- StartFishingEvent- 在玩家开始钓鱼的时候发出- Player getPlayer() -返回钓鱼的玩家- EntityFishingHook getFishingHook() -返回钓鱼钩实体- void setCancelled(boolean cancel/void) -设置取消事件- boolean isCancelled() -事件是否被取消
BNPM
- 新增了BNPM插件管理器，用于一键安装、更新，快速分发插件- 命令： - bnpm install 插件名 -安装或更新指定插件 - bnpm delete 插件名 -卸载指定插件- 相关链接： - bnpm插件中心：https://wiki.blocklynukkit.com/bnpm/viewPlugin
Bug Fixed
- 修复射箭函数中参数依赖问题- 修复方块实体无法不坠落- 重构BNNPC的AI架构，修复bnnpc两格高出不去问题- 修复bn插件包资源文件解压错误问题- PHP更友善的debug- 修复PHP超时bug- 修复world.clearChunk- 修复localstroage缓存出错问题- 修复切换雷暴天气不下雨的问题- 清理部分无用的代码- js中可以使用pragma es6- 修复获取在线玩家报错问题
particle
- void drawDot(Position pos,int pid)- void drawDot(Position pos,int pid,Player toPlayer)- void drawDot(Position pos,int pid,int data)- void drawDot(Position pos,int pid,int r,int g,int b)- void drawDot(Position pos,int pid,int data,Player toPlayer)- void drawDot(Position pos,int pid,int r,int g,int b,Player toPlayer)- void drawEmitter(Position pos) --随机粒子发生器- void drawEmitter(Position pos,String id)- void drawEmitter(Position pos,String id,Player toPlayer)- 粒子发生器id列表：- minecraft:arrow_spell_emitter, minecraft:balloon_gas_particle, minecraft:basic_bubble_particle, minecraft:basic_bubble_particle_manual, minecraft:basic_crit_particle, minecraft:basic_flame_particle, minecraft:basic_portal_particle, minecraft:basic_smoke_particle, minecraft:bleach, minecraft:block_destruct, minecraft:block_slide, minecraft:blue_flame_particle, minecraft:breaking_item_icon, minecraft:breaking_item_terrain, minecraft:bubble_column_bubble, minecraft:bubble_column_down_particle, minecraft:bubble_column_up_particle, minecraft:camera_shoot_explosion, minecraft:campfire_smoke_particle, minecraft:campfire_tall_smoke_particle, minecraft:cauldron_spell_emitter, minecraft:cauldron_bubble_particle, minecraft:cauldron_splash_particle, minecraft:colored_flame_particle, minecraft:conduit_particle, minecraft:conduit_absorb_particle, minecraft:conduit_attack_emitter, minecraft:critical_hit_emitter, minecraft:crop_growth_emitter, minecraft:dolphin_move_particle, minecraft:dragon_breath_fire, minecraft:dragon_breath_lingering, minecraft:dragon_breath_trail, minecraft:dragon_death_explosion_emitter, minecraft:dragon_destroy_block, minecraft:dragon_dying_explosion, minecraft:enchanting_table_particle, minecraft:endrod, minecraft:end_chest, minecraft:elephant_tooth_paste_vapor_particle, minecraft:evocation_fang_particle, minecraft:evoker_spell, minecraft:cauldron_explosion_emitter, minecraft:death_explosion_emitter, minecraft:egg_destroy_emitter, minecraft:eyeofender_death_explode_particle, minecraft:misc_fire_vapor_particle, minecraft:explosion_particle, minecraft:explosion_manual, minecraft:eye_of_ender_bubble_particle, minecraft:falling_border_dust_particle, minecraft:falling_dust, minecraft:falling_dust_concrete_powder_particle, minecraft:falling_dust_dragon_egg_particle, minecraft:falling_dust_gravel_particle, minecraft:falling_dust_red_sand_particle, minecraft:falling_dust_sand_particle, minecraft:falling_dust_scaffolding_particle, minecraft:falling_dust_top_snow_particle, minecraft:fish_hook_particle, minecraft:fish_pos_particle, minecraft:guardian_attack_particle, minecraft:guardian_water_move_particle, minecraft:heart_particle, minecraft:honey_drip_particle, minecraft:huge_explosion_lab_misc_emitter, minecraft:huge_explosion_emitter, minecraft:ice_evaporation_emitter, minecraft:ink_emitter, minecraft:knockback_roar_particle, minecraft:lab_table_heatblock_dust_particle, minecraft:lab_table_misc_mystical_particle, minecraft:large_explosion, minecraft:lava_drip_particle, minecraft:lava_particle, minecraft:llama_spit_smoke, minecraft:magnesium_salts_emitter, minecraft:mobflame_emitter, minecraft:mobflame_single, minecraft:mobspell_emitter, minecraft:mob_block_spawn_emitter, minecraft:mob_portal, minecraft:mycelium_dust_particle, minecraft:nectar_drip_particle, minecraft:note_particle, minecraft:obsidian_glow_dust_particle, minecraft:obsidian_tear_particle, minecraft:phantom_trail_particle, minecraft:portal_directional, minecraft:portal_east_west, minecraft:portal_north_south, minecraft:portal_reverse_particle, minecraft:rain_splash_particle, minecraft:redstone_ore_dust_particle, minecraft:redstone_repeater_dust_particle, minecraft:redstone_torch_dust_particle, minecraft:redstone_wire_dust_particle, minecraft:rising_border_dust_particle, minecraft:shulker_bullet, minecraft:silverfish_grief_emitter, minecraft:soul_particle, minecraft:sparkler_emitter, minecraft:splash_spell_emitter, minecraft:sponge_absorb_water_particle, minecraft:squid_flee_particle, minecraft:squid_ink_bubble, minecraft:squid_move_particle, minecraft:stunned_emitter, minecraft:totem_particle, minecraft:totem_manual, minecraft:underwater_torch_particle, minecraft:villager_angry, minecraft:villager_happy, minecraft:water_drip_particle, minecraft:water_evaporation_actor_emitter, minecraft:water_evaporation_bucket_emitter, minecraft:water_evaporation_manual, minecraft:water_splash_particle_manual, minecraft:water_splash_particle, minecraft:water_wake_particle, minecraft:wither_boss_invulnerable
entity
- Entity spawnFallingBlock(Position pos, Block block, boolean enableGravity,boolean canBePlaced)- EntityArrow shootArrow(Position from,Position to,Entity shooter,boolean canPickUp,double multiply)- EntityArrow shootArrow(Position from,Position to,boolean canPickUp,double multiply)- EntityArrow shootArrow(Position from,Position to,double multiply)- EntityArrow shootArrow(Position from,Position to,boolean canPickUp)- EntityArrow shootArrow(Position from,Position to)- EntitySnowball shootSnowball(Position from,Position to,Entity shooter,boolean canPickUp,double multiply)- EntitySnowball shootSnowball(Position from,Position to,boolean canPickUp,double multiply)- EntitySnowball shootSnowball(Position from,Position to,double multiply)- EntitySnowball shootSnowball(Position from,Position to,boolean canPickUp)- EntitySnowball shootSnowball(Position from,Position to)
manager
- void removeCommand(String name) --移除名为name的命令- void sendMail(String smtpMailServer,String from,String to,String cc,String bcc,String subject,String content)- 发送电子邮件，默认为utf-8编码- \<E> syncCallFunction(String functionName,Object... args)--同步执行函数- void jvmGC() --垃圾回收，释放无用内存- String getPlayerDeviceOS(Player player) --获取玩家设备操作系统- boolean createHttpServer(int port)- void startHttpServer(int port)- boolean attachHandlerToHttpServer(int port,String path,String functionName)- boolean attachHandlerToHttpServer(int port,String path,F function)- 在指定端口的http服务器上绑定请求处理器，当请求path路径时该处理器被调用- 路径指去掉域名和端口后面，?的前面的部分，以/开头
http服务器回调函数
- 参数(HttpRequestEntry request);- request成员函数：- String getRequestUrl()- String getPath()- String getHeader()- String getMethod()- String getParameter()- String getProtocol()- String getFromAddress()- void addResponseHeaderEntry(String name,String value)- void addResponseHeader(String header)- void addDefaultResponseHeader()- void addDefaultResponseHeader(String charSet) - boolean response(int statusCode,String content)- boolean response(int statusCode,String content,String charSet)- boolean response(int statusCode,byte[] content)
blockitem
- void addShapedCraft(String shape,Item output,(String key,Item value)...)- 这是更舒服的添加有序合成API，shape是合成形状字符串，- 用一个字母或数字代表合成原材料的摆放方式，用"|"来连接三行，用空格来占格，如果最后的一行或列没有东西，请不要保留- output是合成产物，后面的参数是映射表，key是你之前的shape中的字符，value是这个key代表的物品- shape中有多少种字符串就得有多少个这也的映射参数- 例如 石镐:addShapedCraft("SSS| I | I ",石镐物品,"S",圆石物品,"I",木棍物品)- 工作台: addShapedCraft("MM|MM",工作台物品,"M",橡木木板物品)- void registerSimpleItem(int id,String name,int stackSize/void)- 注册简单的物品堆，只能覆写教育版物品，stackSize指定最大堆叠数量，不填为64- void makeDropItem(Position position, Item item, boolean fly) --fly指定生成物品时物品是否具有随机初速度- void blockUpdate(Position position)
BNNPC
- void reFresh() --强制客户端刷新bnnpc以防止隐身
## 1.2.9.0new
重构代码加载器代码，重构了bnqqbot代码，增强稳定性，精简解释器添加bn插件包功能，.bnp(bn插件集合包)和.bnpx(bn插件复合压缩包)可以放到blocklynukkit文件夹里面直接运行使用bnp命令可以操作包，bnp build <makefile路径>即可构建一个bn插件包makefile是一个json格式的包配置文件，由name,compress,plugins三个字段组成name为打包的插件包的名字(字符串)，compress为是否打出压缩插件包(boolean)，plugins是一个字符串数组，里面标注要打进包中的bn插件的路径，加载时从上到下加载，也可以打进去json yml xml txt格式的资源文件，资源文件将会被按顺序解压到打包时与nk核心的相对位置解压。js中可以使用console了现在js插件报错会显示正确的文件名了F(Closure function)函数用于包装闭包bnAPI中的;换行现在支持使用\\;来转义修复了php中F(闭包)函数返回类型错误的问题修复了logger(console)输出null或nil报错的问题修复了无法监听修改version命令的问题新增预处理语句pragma autoload false/true，是否让bn解释器自动加载此插件，默认true修复了射箭不会触发EntityDamageByEntityEvent问题修复了http处理时url无法自动编码问题
PHP
更新了基于quercusPHP6引擎的php插件编写支持quercus提供的运行环境请看http://quercus.caucho.com/quercus-3.1/doc/quercus.xtp兼容全部的java类、nukkit的api和bn的基对象，调用bn的api记得前面加$
C/C++
更新了基于webassembly技术栈的C/C++插件编写支持可以直接调用java并于java进行交互，一次编译，处处运行，支持windows linux macos
export
可以通过导出标记将bn插件中的函数导出到全局环境中，然后即可使用java类命令exportdevjar <BN插件名>将可以导出bn插件中的函数头到一个jar包里面便于开发
javascript:```javascriptexport function MyFun(arg1,arg2,arg3){}```
python:```python@exportdef MyFun(arg1,arg2,arg3): pass```
lua:```luafunction BlockPlaceEvent(ent)-->export
end```
php:```phpstatic function PlayerJoinEvent($event){
}```
logger
- 强化了logger的功能，现在可以将对象以json格式输出
database
- localStorage: 本地存储管理器- void localStorage.cacheAll() --从本地读取数据并缓存，增加运行时获取数据速度- String localStorage.cache(String key) --从本地读取指定数据并缓存- void localStorage.setItem(String key,String item) --设置指定key对应的数据为item- String localStorage.getItem(String key) --获取指定key对应的数据- void localStorage.removeItem(String key) --移除指定key对应的数据- String[] localStorage.getKeys() --获取所有的key- void localStorage.save() --强制立即保存数据，bn会每3秒检查并保存一次数据- memoryStorage: 内存共享存储管理器- void memoryStorage.setItem(Object key,Object item) --设置指定key对应的数据为item- String memoryStorage.getItem(Object key) --获取指定key对应的数据- void memoryStorage.removeItem(Object key) --移除指定key对应的数据- Object[] localStorage.getKeys() --获取所有的key
manager
- Player[] getOnlinePlayers()- String getResource(String name) -- 读取资源- void runCMD(String cmd) --执行命令行程序- boolean isPathExists(String path)- String[] getFolderFiles(String path)- int getFileSize(String path)- void deleteFile(String path)- void doPathCreate(String path)- boolean isPathReadable(String path)- boolean isPathWritable(String path)- void copyFile(String fromPath,String toPath)- void qq.stopBot()- void interrupt(String info) --强制中断当前函数运行- void downloadFromURL(String url,String saveDir,String saveName)- Thread runThread(String functionName,Object... args) --在新线程中执行函数并同步返回这个线程- void requireMinVersion(String minVersion,String failMessage) --检查bn解释器版本，如果太低停止运行并发出failMessage
entity
- void shootArrow(Position from,Position to,boolean canPickUp,double multiply)- void shootArrow(Position from,Position to,double multiply)- void shootArrow(Position from,Position to,boolean canPickUp)- void shootArrow(Position from,Position to)- void lookAt(Entity e,Position pos)
window
- int[] setPlayerBossBar的第二个text参数中若以#XXXXXX或者rgb(x,x,x)开头将会为boss血条设置自定义颜色- int[] setPlayerBossBar现在可以在text参数中使用;来添加多个bossbar- int[] setPlayerBossBar(Player player,String text,float len) --现在返回数组，包含每个创建的bossbar的id- void removePlayerBossBar(Player player,long id) --相关api现在支持指定bossbar的id操作- double getLengthOfPlayerBossBar(Player player,long id)- String getTextOfPlayerBossBar(Player player,long id)- void sendPlayerXboxInfo(Player from,Player to) --向to玩家展示from玩家的xbox信息- void startEndPoem(Player player) --让玩家屏幕上开始展示终末之诗- void setSwingStyle(String style) --设置swing的样式- 目前有：Darcula Intellij Metal Motif Multi Nimbus OS(系统样式)- JFrame getStyledSwingWindow(String title,int width,int height,String iconPath)- 根据之前设置的样式获取Swing窗口对象，iconPath为null或""将使用bnLOGO替代
WindowBuilders
- void showToPlayer(Player p,String callback,boolean acceptClose) - acceptClose用于指定是否在窗口关闭的时候调用一次回调函数
SimpleWindowBuilder
-buildButton(String text,String img)-button(String text,String img)-button(String text)-setAction(String actionFunctionName/F function)-action(String actionFunctionName/F function)-setTitle(String title)-title(String title)-setContext(String context)-context(String context)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)
ModalWindowBuilder
-setTitle(String title)-title(String title)-setContext(String context)-context(String context)-setButton1(String text)-setButton2(String text)-button1(String text)-button2(String text)-setAction(String callbackFunctionName/F function)-action(String callbackFunctionName/F function)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)
CustomWindowBuilder
-setTitle(String title)-showToPlayer(Player p)-showToPlayer(Player p,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function)-show(Player p)-show(Player p,boolean accpetClose)-show(Player p,String callbackFunctionName/F function)-show(Player p,String callbackFunctionName/F function,boolean acceptClose)-showToPlayer(Player p,String callbackFunctionName/F function,boolean acceptClose)-showAsSetting(Player p, String callbackFunctionName/F function)-showAsSetting(Player p, String imageURL, String callbackFunctionName/F function)-buildLabel(String text)-label(String text)-buildInput(String title,String placeholder)-input(String title,String placeholder)-buildInput(String title,String placeholder,String defaulttext)-input(String title,String placeholder,String defaulttext)-buildToggle(String title)-toggle(String title)-buildToggle(String title,boolean open)-toggle(String title,boolean open)-buildDropdown(String title,String inner)-dropdown(String title,String inner)-buildDropdown(String title,String inner,int index)-dropdown(String title,String inner,int index)-buildSlider(String title,double min,double max,int step,double defaultvalue)-slider(String title,double min,double max,int step,double defaultvalue)-buildSlider(String title,double min,double max,int step)-slider(String title,double min,double max,int step)-buildSlider(String title,double min,double max)-slider(String title,double min,double max)-buildStepSlider(String title,String options)-stepSlider(String title,String options)-stepslider(String title,String options)-buildStepSlider(String title,String options,int index)-stepSlider(String title,String options,int index)-stepslider(String title,String options,int index)-setAction(String callbackFunctionName/F function)-action(String callbackFunctionName/F function)
BNNPC
- void addExtraDropItem(Item item)- boolean hasDropItem(Item item)- void removeExtraDropItem(Item item)- Item[] getExtraDropItems()- Item[] getDropItems()- void setDropHand(boolean drop/void) --参数不填时默认为true- void setDropOffhand(boolean drop/void) --参数不填时默认为true- void addDropSlot(int slot) --指定背包槽位死亡掉落- int[] getDropSlots()- void removeDropSlot(int slot)- void doEmote(String action/void) --让npc执行指定的表情动作 - action可以是 Wave Punch Clap OverThere Hammer Fall Diamond Pickaxe - 也可以填写对应的中文 挥手 拳击 鼓掌 在那 锤子 摔倒 钻石 - 不填的话将上面的五个动作中任选一个 - 至于为什么只有8个: 因为剩下的要氪金购买之后才能获取uuid，冰凉没钱 - 欢迎大家贡献uuid- boolean directMove(Position to) --直线移动到某处
world
- void regenerateChunk(Position pos)- void defineChunkRenderByName(String forLevel,String callback,int priority / void) - forLevel是渲染器能够渲染的指定世界名称 - callback是渲染器回调函数 - priority是优先级，优先级越大先调用，不填默认为0- void drawPic(Position pos1,Position pos2,String img,int faceData) - 从pos1到pos2绘制img路径上的图片，faceData指定物品展示框的朝向，pos1和pos2必须在同一垂直面上
blockitem
- void registerSolidBlock(int id,String name,double hardness,double resistance,int toolType,boolean isSilkTouchable,int dropMinExp,int dropMaxExp,int mineTier) - 注册固体方块，参数分别为方块id(只能覆写教育版方块)，方块名称，方块硬度，方块抗爆炸度，挖掘工具，是否**准采集影响，最小掉落经验，最大掉落经验，挖掘等级 - 方块硬度越大挖掘时间越长，抗爆炸度越高越不容易被炸 - 挖掘工具0-无,1-剑,2-铲,3-镐,4-斧,5-剪刀 - 挖掘等级0-空手,1-木,2-金,3-石,4-铁,5-钻石- void registerSimpleItem(int id,String name) - 注册简单的物品堆，只能覆写教育版物品
## 1.2.8.4new
更新了qq机器人对接模块，使用小栗子qq机器人框架（因为这是唯一一个没跑路的免费机器人了），配好的包在bn群内下载您也可以从官网下载框架并自行安装tcpapi.dll插件到机器人框架中，bn通过tcpapi来与其交互添加了com.blocklynukkit.JavaAPI类来提供bn对java的api添加了调试工具，使用命令bndebug打开调试工具，可以查看变量和监控命令情况
Lua
添加了lua语言支持，版本为luaj5.2，可以通过lua来制作bn插件，接口与js和py完全相同您需要使用:来访问基对象函数，此外还提供了用于和java交互的luajava对象和asTable asList asMap三个全局函数详见bn开发文档
Bug Fixed
- 修复了熔炉配方nbt丢失问题- 修复了设置箱子和漏斗物品栏不好使的问题- 修复了py插件不可用问题- 修复了BNNPC在路径移动时被击退遁地问题- 修复了BNNPC导致的区块报错问题
BNNPC
- Array<Player> getPlayersIn(double distance)- Array<Entity> getEntitiesIn(double distance)- Player getNearestPlayer(double far)- Player getNearestPlayer()- void setEntityRideOn(Entity entity)- void isEntityRideOn(Entity entity)- void setEntityRideOff(Entity entity)- Player getRidingPlayer()
window
- setPauseScreenList(String list) --设置暂停界面右侧显示在线玩家区域的文字，用;分割多行
CustoWindowBuilder
-this showAsSetting(Player p, String imageURL, String callback) --支持图标，和按钮图标书写方式相同
manager
- void qq.startBot() 启动qq机器人进程- void qq.reDirectBot(String ip) - 将机器人重定向到指定ip地址，并使用那台电脑的小栗子qq机器人框架 - 要求目标电脑开放8404-TCP端口，并且在小栗子的tcpapi插件中允许远程控制- void qq.sendFriendMessage(String fromQQ,String toQQ,String message) 发送好友信息- void qq.sendGroupMessage(String fromQQ,String toGroup,String message) 发送群信息- void qq.sendGroupPicMessage(String fromQQ,String toGroup,String picturePaths,String message) - 发送qq图文消息 - picturePaths用;分割多个本地图片路径 - 消息中使用图片只需用%picture数字%即可，数字指代第几个路径的图片，从0开始算起- void qq.kickGroupMember(String fromQQ,String toGroup,String toQQ) --踢了指定群员,fromQQ是机器人账号- void qq.banSpeakGroupMember(String fromQQ,String toGroup,String toQQ,int second) --禁言指定群员- String getPlayerDeviceID(Player player) --获取玩家的手机或电脑设备标识码- String getPlayerDeviceModal(Player player) --获取玩家的设备型号- int getPlayerDeviceOS(Player player) -- 获取玩家的操作系统id- double getMoney(String player)- void reduceMoney(String player,double money)- void addMoney(String player,double money)- void setMoney(String player,double money)- void setNukkitCodeVersion(String string) -- 修改version命令显示的nk版本- void nodejs.eval(String str,boolean isPath) -- 使用nodejs运行str - 运行nodejs代码是sandbox在nodejs环境运行的，而非java环境 - 若isPath为true，则执行该路径的文件 - 否则将str作为nodejs代码执行 - 其中可以使用callFunction(String BNFunctionName,String args...)来调用bn插件的函数- void nodejs.newDocker(String dockerName,String str,boolean isPath) --开启一个常驻nodejs容器 - dockerName是创建的nodejs容器的名字，容器一旦创建就会立即开始执行其中的代码 - 重启创建后执行完代码不会被销毁，而是可以继续通过callDockerFunction调用其中方法 - 如果需要在其他bn插件调用其中的nodejs函数，需要使用registerFunction(String 函数名,Function 函数)注册 - 其余同nodejs.eval函数- void nodejs.closeDocker(String dockerName) --关闭指定的nodejs容器并释放占用资源- String callDockerFunction(String function,String... args) - 调用指定容器中的指定函数并向其传参，调用的函数必须先注册再使用，否则bn无法获取此函数内存地址进行调用 - 返回值将自动被转为字符串，如果被调函数无返回值则返回字符串"null" - function指定调用的函数，格式为 容器名::函数名（同其他地方的调用格式） - 若直接输入函数名，则将在所有未关闭容器中随机寻找一个有此名称函数的容器调用，若找不到，返回NO FUNCTION - args参数只接受字符串，数量不限，也可没有- TaskHandler createTask(String functionName, int delay ,\<E+\>... args)- TaskHandler createLoopTask(String functionName, int delay,\<E+\>... args) - 支持2-128个任意数量的参数，第一个参数为回调函数名，第二个为回调间隔tick，其余的是在调用函数时向函数传递的参数- void newPlugin(String path) --加载指定路径上的bn插件- void newJSPlugin(String name,String code) --根据代码字符串创建一个新的bn插件- void newPYPlugin(String name,String code)- void newLUAPlugin(String name,String code)- void addCommandCompleter(String cmd,String id,String completer) - 创建命令补全器，将被发送给玩家用作命令提示和tab补全 - cmd为要添加给的命令的名称，id为补全器标识符，随意只要不重复即可 - completer是补全器内容，由\<必选单元>和\[可选单元]由空格连缀组成 - 每个单元的内部格式为 名称:@类型=参数1;参数2;... 等于号及其后面的部分不是必须的 - 类型有：@target @blockpos @pos @int @float @string @text - 类型有：@message @command @json @filepath @operator - 例如：\<player:@target\> \<sentence:@message=BNNB!;blocklynukkit\> \[color:@text=red;green\]
EventLoader
- QQGroupMessageEvent --机器人收到qq群消息事件 - String getSelfQQ() --获取收到消息的qq账号 - String getFromQQ() --获取发送消息的qq账号 - String getFromGroup() --获取消息事件的qq群号 - String getMessage() -获取消息- QQFriendMessageEvent --机器人收到qq好友消息事件 - String getEventId() --获取事件id - String getEventSeed() --获取事件中的群消息标识码 - String getFromQQ() --获取发送消息的qq - String getSelfQQ() --获取接受到群消息的qq账号 - String getMessage() --获取事件的消息- QQOtherEvent - String getFromGroup() --获取触发事件的qq群号 - String getFromQQ() --获取触发事件的qq账号 - String getSelfQQ() --获取收到事件的qq账号 - String getSeq() --获取收到事件的标识id - int getType() --获取事件类型码
Entity
- void setPlayerExp(Player player,int exp)- int getPlayerExp(Player player)- void setPlayerExpLevel(Player player,int lel)- int getPlayerExpLevel(Player player)- void setPlayerHunger(Player player,int hunger)- int getPlayerHunger(Player player)- void makeSoundToPlayer(Player player,String sound)- Entity spawnEntity(String name,Position pos) --返回值更改
## 1.2.8.3
Bugs Fixed
- 修复了bnnpc浮空走路bug- 修复了浮空物品空事件报错- 现在的报错信息比以前好看多了
manager
- <E> callFunction(String functionname,Object... args) --callFunction会返回函数的返回值了- <E> getVariableFrom(String scriptName,String varName) --根据bn插件名和变量名获取变量内容- void putVariableTo(String scriptName,String varName,<E> var) --把变量值以指定变量名放到指定bn插件中- double getCPULoad()- int getCPUCores()- double getMemoryTotalSizeMB()- double getMemoryUsedSizeMB()- void forceDisconnect(Player player)- Array<String> getEventFunctions(Event event)- void getServerMotd(String host, int port, String callback) --根据服务器IP和端口获取在线人数信息
blockitem
- void setItemColor(Item item,int r,int g,int b)- void setItemUnbreakable(Item item,boolean unbreakable)
inventory
- Item getEntityHelmet(Entity entity)- Item getEntityChestplate(Entity entity)- Item getEntityLeggings(Entity entity)- Item getEntityBoots(Entity entity)- Item getEntityItemInHand(Entity entity)- Item getEntityItemInOffHand(Entity entity)- void setEntityItemHelmet(Entity entity,Item item)- void setEntityItemChestplate(Entity entity,Item item)- void setEntityItemLeggings(Entity entity,Item item)- void setEntityItemBoots(Entity entity,Item item)- void setEntityItemInHand(Entity entity,Item item)- void setEntityItemInOffHand(Entity entity,Item item)- Item getInventorySlot(Inventory inv,int slot)
window
- void forceClearWindow(Player player)- int getEventResponseIndex(PlayerFormRespondedEvent event)
entity
- boolean isPlayer(Entity e)- void spawnFallingBlock(Position pos, Block block, boolean enableGravity,boolean canBePlaced)
gameapi --新的基对象
- void createGame(String name,boolean useTeam,String startGameCallBack,String endGameCallBack,String mainLoopCallBack,String deathCallBack) -- 创建一个小游戏房间- void joinGame(Player player, String gameName) --让玩家进入指定名称的小游戏，自动匹配房间- void leaveGame(Player player) --让玩家从小游戏房间离开- boolean isPlayerInGame(Player player) --玩家是否正在玩某个小游戏- GameBase getPlayerRoom(Player player) --获取玩家正在玩的小游戏对象- Array<GameBase> getAllRoomByName(String gameName) --获取游戏名称相同的所有小游戏房间对象组成的数组- Array<String> getAllGameNames() --获取所有正在运行的小游戏房间的名字组成的数组- Messager getMessager(String prefix)- Messager getGameMessager(GameBase game)- Multiline getMultiline(String messageType)- InventoryMenu createInventoryMenu(String inventoryType, String title)- FormMenu createFormMenu(String title, String content)- void addMenuItem(InventoryMenu menu, int slot, Item item, String inventoryCallback)- void addMenuButton(FormMenu menu,String buttonText,String imageData,String formCallback)- Scoreboard getScoreboard(Player p)- void setObjective(Scoreboard sb, String objectiveName,String displayName)
GameBase --小游戏房间对象
EventLoader --73 new
- BlockFadeEvent- BlockFallEvent- BlockFromToEvent- BlockGrowEvent- BlockIgniteEvent- BlockPistonChangeEvent- BlockRedstoneEvent- DoorToggleEvent- CreatureSpawnEvent- CreeperPowerEvent- EntityArmorChangeEvent- EntityBlockChangeEvent- EntityCombustByBlockEvent- EntityCombustByEntityEvent- EntityCombustEvent- EntityDamageByBlockEvent- EntityDamageByChildEntityEvent- EntityExplodeEvent- EntityMotionEvent- EntityPortalEnterEvent- EntityRegainHealthEvent- EntityShootBowEvent- EntityVehicleEnterEvent- EntityVehicleExitEvent- ExplosionPrimeEvent- BrewEvent- EnchantItemEvent- InventoryMoveItemEvent- StartBrewEvent- ChunkLoadEvent- ChunkPopulateEvent- LevelInitEvent- LevelLoadEvent- LevelSaveEvent- LevelUnloadEvent- SpawnChangeEvent- ThunderChangeEvent- WeatherChangeEvent- PlayerAchievementAwardedEvent- PlayerAnimationEvent- PlayerAsyncPreLoginEvent- PlayerBlockPickEvent- PlayerBucketEmptyEvent- PlayerBucketFillEvent- PlayerChangeSkinEvent- PlayerChunkRequestEvent- PlayerCreationEvent- PlayerDropItemEvent- PlayerEatFoodEvent- PlayerEditBookEvent- PlayerFoodLevelChangeEvent- PlayerGameModeChangeEvent- PlayerGlassBottleFillEvent- PlayerInvalidMoveEvent- PlayerItemConsumeEvent- PlayerLocallyInitializedEvent- PlayerMapInfoRequestEvent- PlayerMouseOverEntityEvent- PlayerServerSettingsRequestEvent- PlayerSettingsRespondedEvent- PluginDisableEvent- PluginEnableEvent- PotionApplyEvent- PotionCollideEvent- PlayerDataSerializeEvent- RemoteServerCommandEvent- EntityEnterVehicleEvent- EntityExitVehicleEvent- VehicleCreateEvent- VehicleDamageEvent- VehicleDestroyEvent- VehicleMoveEvent- VehicleUpdateEvent- LightningStrikeEvent
1.2.8.2：修复bug- 修复了bnnpc和bn浮空字莫名其妙消失的问题
新增功能- 现在可以在js代码的开头加上一行注释//pragma es9来开启es9语言特性，但是会有些许性能损失，损失不大，可以放心使用- bninstall命令已经弃用，所有库全部打包进bn解释器jar，这样做是为了节约内存空间，能够节省至多50MB内存空间。
CustomWindowBuilder 高级菜单管理器新增2个成员函数- Custom showAsSetting(Player p, String callback) 将此高级表单作为玩家的服务器设置页面- Custom buildDropdown(String title,String inner,int index) 构建一个下拉菜单并指定默认选项
EventLoader新增1个事件- ChunkUnloadEvent 区块卸载事件
entity新增6个函数- void setPlayerExp(Player player,int exp) 设置玩家经验- int getPlayerExp(Player player) 获取玩家经验- void setPlayerExpLevel(Player player,int lel) 设置玩家等级- int getPlayerExpLevel(Player player) 获取玩家等级- void setPlayerHunger(Player player,int hunger) 设置玩家饥饿度- int getPlayerHunger(Player player) 获取玩家饥饿度
window新增2个函数- void makeTipsVar(String varname,String providerCallback) 创建动态的tips插件变量- void makeTipsStatic(String varname,String toReplace) 创建静态的tips插件变量
[/markdown]下一页更精彩(*^_^*)
UI表单主题预览图(BiliBili主题)：
（学习用这种软件跟学编程没啥区别的感觉
还是支持一下
还是支持一下
建议项目不要用任何项目名称的缩写，例如nk，建议直接是Nukkit
PQguanfang 发表于 2020-3-16 09:40
建议项目不要用任何项目名称的缩写，例如nk，建议直接是Nukkit
知道了，谢谢！
流弊啊，这东西太棒了
本帖最后由 一只鸽纸 于 2020-4-24 15:07 编辑
现在我一个啥都不会的服主也能稍微写点基础插件了，谢谢作者
现在我一个啥都不会的服主也能稍微写点基础插件了，谢谢作者
D6666666d 6666666
今天我们推出了安卓客户端，希望能给手机用户一个更好的使用体验！
3.18更新：
修复windows乱码问题
修复windows乱码问题
666，太厉害了
66666666666666支持
顶顶顶顶顶顶顶顶
3/20更新：添加了方块和物品的支持
赞，感谢为中国MC生态贡献
真棒，可创造无限可能的插件！
果子狸大人 发表于 2020-3-24 11:25
真棒，可创造无限可能的插件！
感谢您的支持！
我想知道为什么装上显示无法单独使用本插件难道还有什么前置吗
1971106843 发表于 2020-3-27 17:36
我想知道为什么装上显示无法单独使用本插件难道还有什么前置吗
前置插件EconomyAPI,ScoreboardAPI，可以在blocklynukkit编辑器上下载
适用于bn的gamesdk已经开始开发，相信能不负众望，让各位bn用户快速开发nukkit顶级的小游戏插件！
今日更新：支持UI表单个性化主题
这个好，像我这样不懂JAVA开发的人有救了！这绝对是要支持的~
mcbbs有你真精彩
楼主，为什么我无法保存插件，连前置也下不了
图形化编程对于编程基础不会的人来说确实可以让他们快速入门了
我不是art 发表于 2020-4-4 00:51
楼主，为什么我无法保存插件，连前置也下不了
您好，我们经过测试，可以在安卓7及以上、Windows7及以上、winserver 2012及以上系统正常运行，如果您还有问题，欢迎加群解决问题
超神的冰凉 发表于 2020-4-5 11:22
您好，我们经过测试，可以在安卓7及以上、Windows7及以上、winserver 2012及以上系统正常运行，如果您还 ...
无法保存插件，无法下载，使用的是win7系统，编程界面下面是一堆字，只有查看教程有用
我不是art 发表于 2020-4-5 17:11
无法保存插件，无法下载，使用的是win7系统，编程界面下面是一堆字，只有查看教程有用
...
请使用最新版谷歌/火狐/edge内核的浏览器，不支持IE浏览器，msvc的webview，过老的浏览器和某些劣质国产浏览器
牛逼啊，哈哈哈哈
今天修复了内置http服务器被gc吃掉的问题
BlocklyNukkit已经联手BlackBE云黑，支持查询云黑
已经对接noteblockapi，允许开发者播放红石音乐
太强了支持作者更新
好像是PC端的。
Future_star 发表于 2020-4-11 18:43
好像是PC端的。
您好，我是blocklynukkit的开发者，我们的项目是用于be基岩版的nukkit服务端的哦。
我们的项目自制，没有抄袭别人的代码。
超神的冰凉 发表于 2020-4-11 22:44
您好，我是blocklynukkit的开发者，我们的项目是用于be基岩版的nukkit服务端的哦。
我们的项目自制，没有 ...
等等...我的意思是这个软件没有安卓端的。。。
Future_star 发表于 2020-4-12 07:39
等等...我的意思是这个软件没有安卓端的。。。
您好，我们提供安卓客户端，请您加群下载
超神的冰凉 发表于 2020-4-12 08:28
您好，我们提供安卓客户端，请您加群下载
嗯嗯，谢谢大大
超神的冰凉 发表于 2020-4-12 08:28
您好，我们提供安卓客户端，请您加群下载
请问这个是这么用的吗？C:\Users\Admin\Desktop\Nukkiut\plugins\20200412092757.png
Future_star 发表于 2020-4-12 09:31
请问这个是这么用的吗？
您可以查看我们的教程（帖子底部）来获取详细的使用教程，您给我这一个图我无法准确判断是否正确使用
1.2.1版本更新新增私有监听器，http服务器支持文件传输
补充：blocklynukkit的js开发教程 https://liuliqwq.gitee.io/2020/04/11/bnjs/
本帖最后由 超神的冰凉 于 2020-7-25 22:29 编辑
[markdown]
> v1.2.8.1 更新 7.25
> > 更新了生物模块，添加了数据库模块，添加了工具模块，内置了http服务器用于速建服务器官网
> > 添加了创造背包修改模块，添加了地形与世界模块
> v1.1.7更新(合并1.1.6)
> > 添加了容器物品栏模块
> v1.2.8.0 更新 6/20
此更新合并了1.2.7.5 1.2.7.6 1.2.7.7 三个内测版本的更新
> v1.2.7.4 更新 6/20
> > 更新内容
> v1.2.7.3 更新 5/15
> > 更新内容
> v1.2.7.2 更新 5/13
> > 更新内容
> v1.2.7.1 更新 5/12
> > 修复部分老版本nk/pn内核无法加载的错误
> v1.2.7.0 更新 5/11
> > 长期支持版本(LTS)，更新太多了
> v1.2.6更新 5/6
> > 对每个js文件运行时沙箱隔离，添加了命名空间和跨命名空间调用，添加了物品nbt和窗口默认值。
> v1.2.5更新 5/3
> > 添加粒子模块，添加药水获取功能，完善同步锁机制，优化性能，修复7个bug
> v1.2.4更新 4/25
> > 添加浮空字功能，完善生物模块，新增实体被其他实体/玩家事件，内置标准按钮图片
> v1.2.3 更新 4/19
> > 修复一堆bug
> v1.2.2 更新 4/18
> > 更新http模块，可以使用js插件发送GET/POST请求，可以通过http远程调用函数并传参，详见开发文档
> v1.2.1+更新 4/15
> > 发布BlocklyNukkit专用IDE(呕心沥血上千行代码)，优化jar包更新策略，彻底取消placeholderAPI作为硬前置
> v1.2.1更新 4/13
> > 新增私有事件映射，优化http服务器可使用 ip/域名:端口/file/文件名 来远程下载或者引用BlocklyNukkit/file文件夹里面的文件
> v1.2.0更新 4/11
> > 对接BlackPE云黑，可以使用bn直接查询云黑名单，添加了红石音乐模块(基于开源组件NoteBlockAPI)
> v1.1.9更新> > 更新了生物模块，添加了数据库模块，添加了工具模块，内置了http服务器用于速建服务器官网
> v1.1.8+更新
> > 更新了自定义UI表单主题模块（热更新）
> v1.1.8更新> > 添加了创造背包修改模块，添加了地形与世界模块
> v1.1.7更新(合并1.1.6)
> > 添加了容器物品栏模块
> v1.1.5更新
> > 添加了方块自然生成，液体流动和刷石机事件
> v1.1.4更新
> > 更新了自定义bn高级工作台，支持概率合成、nbt合成、延时合成
> v1.1.3更新
> > 修复了bugs，添加自定义熔炉配方
> v1.1.2更新
> > 添加了自定义工作台有序/无序配方，优化了网络连接
> v1.1.1更新
> > 添加了项目导出功能，增加了对物品附魔nbt的支持
> v1.1.0更新
> 添加了对物品名称和lore的支持
> v1.0.9更新
> > 添加物品方块模块，解释器底层改动以提升性能
> v1.0.8更新
> > 添加了自定义高级ui表单功能，完善了玩家模块的功能
> v1.0.7更新
> > 添加了简单窗口ui表单和对话框的支持，完善自定义函数回调
> v1.0.6更新
> > 添加了内置算法，增加了玩家模块
> v1.0.5更新
> > 添加了对事件的支持，新增更多事件，支持js云端同步
> v1.0.4更新
> > 构建了安卓客户端，新增对4D皮肤的支持
> v1.0.3更新
> > 优化了性能体验，添加了更多模块
> v1.0.2更新
> > 修改了一些bug和文字错误
> v1.0.1更新
> > 添加了新模块，修复bug
> v1.0.0
> > blocklynukkit正式发布啦！
BlocklyNukkit js开发工具发布:
https://kingdom_of_dragon.gitee.io/blocklynukkit/jseditor.html
https://kingdom_of_dragon.gitee.io/blocklynukkit/jseditor.html
预览版更新：支持通过httpAPI调用js函数
JavaScript还是比较简单的语言，相比于JAVA
HHQart 发表于 2020-4-19 15:59
JavaScript还是比较简单的语言，相比于JAVA
感谢您的支持，欢迎加入我们
BN NB!!!!!!
今日修复bug：编辑器l和I不分和转换数组的代码正常错误