[NEW API]新API的部分事物的讲解(新手请路过，可能会持续更新)

本帖最后由 y185110754 于 2014-6-30 13:52 编辑

各位骚年你们好，我是来自PMPCT的组长juhua。。。

今天给大家带来的是新API的过渡篇，很多写手很难从旧的API中过渡过来这是为何呢，下面由我来为各位少年讲解。。。

那么新核的插件是否都是phar格式？不，答案是否定，因为你写出来的插件是php格式的源码，所以他不可能不会被识别和运行；

但是为何我却无法加载我的插件源码呢？不，少年是你缺少识别和运行它的工具(devtool)

devtools讲解:

devtools是一个出自PM官方的一个很强大的工具，他的功能是识别运行插件源码和将源码压制为phar格式
使用方法:
1.首先先将devtools放入插件目录中
1.将插件的所有文件打包放在一个xxx的文件夹里扔进PM主目录下plugin文件夹内
2.运行服务器，控制台看到"[INFO] Loading source plugin xxxxxxx v1.0.0"的紫色提示时代表你的插件没有任何问题可以运行了
3.输入/makeplugin XXXX(你的插件的名字与之前的紫字提示的XXXX那里相同注意大小写)将插件源码压制为phar格式的插件
4.从主目录下plugin文件夹的devtools文件夹内将phar格式的插件取出
5.你可以在官网的插件主页上发布你的插件，也可以在mcbbs论坛上发布，或者扔给你盆友。(放在PM的插件官网请检查你的插件里是否有恶意代码或者有非英文的语言出现，否则将不会通过允许发布你的插件)

那么新核的插件会有哪些文件呢？请查看官方所列举出来的示例插件(第三方的示例插件)

plugin.yml
此文件的功能为整合插件所有指令和事件的权限分配，以及指令注册，插件的所有描述等
src文件夹
将所有插件的代码放入其中，使用plugin关联插件的主要工作文件

plugin.yml例子(使用的官方的例子):

name: ExamplePlugin #插件的名字与namespace相同即可
main: ExamplePlugin\MainClass #关键插件的主要工作文件
version: 1.0.0 #插件版本(可带中文注意编码utf-8)
api: [1.0.0] #此处不做解释按部就班即可
load: POSTWORLD #copy即可不做解释
author: PocketMine Team #不做解释
<pre><div class="line" id="LC9">depend: [xxxx]#当你这个插件引用到了别的插件的函数或者变量时，请记住加上他</div></pre>description: Example plugin showing the new API #对于插件的描述等同于old api在注释里的那堆描述
website: https://github.com/PocketMine/ExamplePlugin #此条可有可无(放X网地址的少年自己注意点儿)
commands: #copy下来
example: #此处与namepace相同即可
description: Example command #主要指令的描述
usage: "Usage: /example" #指令用法
aliases: [ex, exe]
permission: exampleplugin.command.example #格式为namespace.command.指令名
permissions: #开始分配权限
exampleplugin.command.example: #copy上面对应的部分即可
description: "Allows the user to run the example command" #此处格式为"允许使用xxxx指令"
default: true #true值为默认允许所有人使用这个指令，false为禁用指令，op为只有管理员才能使用这个指令

复制代码

src/xxx/main.php实例讲解:

<?php
namespace ExamplePlugin; /*命名空间与plugin.yml的name处相同即可*/
use pocketmine\command\Command;
use pocketmine\command\CommandSender;
use pocketmine\event\Listener;
use pocketmine\event\player\PlayerRespawnEvent;
use pocketmine\Player;
use pocketmine\plugin\PluginBase;
use pocketmine\Server;
use pocketmine\utils\TextFormat;
/*以上这一大段都是需要的引用，你的插件使用的PM所给出的函数和变量还有类都必须要引用过来，那么函数和变量以及类在哪里能看到呢，不着急两个方法1.将整个PM仔仔细细由外而内琢磨透彻，2.使用给出的函数和变量列表(这些东西我有可加帖子后的群找群主要)*/
class MainClass extends PluginBase implements Listener{ /*mainclass为文件名，可根据自己的命名更改*/
public function onLoad(){
$this->getLogger()->info(TextFormat::WHITE . "I've been loaded!");
}
/*此段必须有，这是在开始运行服务器时运行此处的所有代码*/
public function onEnable(){
$this->getServer()->getPluginManager()->registerEvents($this, $this);
$this->getServer()->getScheduler()->scheduleRepeatingTask(new BroadcastPluginTask($this), 120);
$this->getLogger()->info(TextFormat::DARK_GREEN . "I've been enabled!");
}
/*此段必须有，这是在加载完成后的一系列提示*/
public function onDisable(){
$this->getLogger()->info(TextFormat::DARK_RED . "I've been disabled!");
}
/*此段必须有，当你输入/stop关闭服务器的指令时，运行此处的所有代码*/
public function onCommand(CommandSender $sender, Command $command, $label, array $args){
switch($command->getName()){
case "example":
$sender->sendMessage("Hello ".$sender->getName()."!");
return true; /*当你在return值之前有"$sender->sendMessage("Hello ".$sender->getName()."!");"之类的回复消息的代码时值必须为true*/
default:
return false;
}
}

复制代码

应邀各位少年的积极请求和懒蛋的不作为我实在看不下去了于是我还是把函数和变量什么的列出来:

copy中下次更新会添加。、。。

教程更新动态：

●2014/6/24 22:50 完成开头及对插件的部分文件的不完全描述，对于主要开发使用工具功能和使用进行了不详尽的讲解

●2014/6/30 13：50 对plugin.yml文件的说明补充和后续讲解的预告。。。

声明：

●本贴是送给正在往NEW API过渡的写过old api的插件的少年看的，不是的自己先学好php基础再来。

●本帖可能会持续更新。。

●本帖的内容如若不喜可无视。

广告：
PMPCT广招程序猿代码写手键盘撸手
入组审核外群(入群找群主申请即可)：329034682
审核通过即可进入内群享受群组福利(大量插件源码，大神指导，追踪官方动态等)
脑残骚年慎入！

回复: