|
|
| （未显示另一用户的1个中间版本） |
| 第7行： |
第7行： |
| | | | |
| | == 利用工具 == | | == 利用工具 == |
| | + | |
| | + | ===官方工具(疑似已炸)=== |
| | | | |
| | 官方提供了一个极其好用的工具网页. 它可以让你方便地生成一个新的, 配置好的'''BungeeCord'''插件项目. | | 官方提供了一个极其好用的工具网页. 它可以让你方便地生成一个新的, 配置好的'''BungeeCord'''插件项目. |
| 第17行： |
第19行： |
| | | | |
| | 如果你是新手, 你大可以勾选''Include a listener for me, please.''. 这样他会为你生成一个玩家连接的监听器. | | 如果你是新手, 你大可以勾选''Include a listener for me, please.''. 这样他会为你生成一个玩家连接的监听器. |
| | + | |
| | + | ===IntelliJ IDEA插件=== |
| | + | |
| | + | 在MarketPlace中搜索“Minecraft Development”，安装后重启IDEA，创建项目选择Minecraft>BungeeCord |
| | | | |
| | ==创建你的第一个BungeeCord插件 (代理)== | | ==创建你的第一个BungeeCord插件 (代理)== |
| − | 恭喜你决定创建自己第一个BungeeCord插件啦! 这个教程会使你打好基础.<br>
| + | ===设置你的项目=== |
| − | Java 编程的知识是需要的.([[Bukkit/插件开发教程#学习Java|我没有Java基础]])
| + | |
| | + | **使用插件创建时可跳过** |
| | | | |
| − | ===设置你的项目===
| |
| | 这个教程只包括IntelliJ IDEA(一款IDE)，其他IDE的操作相似. | | 这个教程只包括IntelliJ IDEA(一款IDE)，其他IDE的操作相似. |
| | 在[https://www.spigotmc.org/wiki/create-your-first-bungeecord-plugin-proxy-spigotmc 原文]处附有Eclipse的操作<br> | | 在[https://www.spigotmc.org/wiki/create-your-first-bungeecord-plugin-proxy-spigotmc 原文]处附有Eclipse的操作<br> |
| | | | |
| − | 首先打开你的IDE,创建一个新的项目,在弹出的选项卡中选择Maven.(图片暂时传不上去,或[https://www.spigotmc.org/wiki/create-your-first-bungeecord-plugin-proxy-spigotmc 原文])<br> | + | 首先打开你的IDE,创建一个新的项目,在弹出的选项卡中选择Maven.你应该有与下图相似的界面:<br> |
| − | 点击Next,里面会有一下几类文本框:
| |
| − | *Name - 对应的是你的项目的名称
| |
| − | *Directory - 项目文件保存的路径
| |
| − | *GroupId - 输入你的包名
| |
| − | *AntifactId - 输入你插件的名称
| |
| | | | |
| − | 现在,只修改Name.然后点击Finish按钮,你的IDE会跳转，并展示pom.xml文件.<br>
| |
| − | 我们要在'''</project>前'''添加一些内容.<br>
| |
| − | <pre><repositories>
| |
| − | <repository>
| |
| − | <id>bungeecord-repo</id>
| |
| − | <url>https://oss.sonatype.org/content/repositories/snapshots</url>
| |
| − | </repository>
| |
| − | </repositories>
| |
| | | | |
| − | <build>
| + | ===创建主类=== |
| − | <plugins>
| |
| − | <plugin>
| |
| − | <groupId>org.apache.maven.plugins</groupId>
| |
| − | <artifactId>maven-compiler-plugin</artifactId>
| |
| − | <version>3.6.1</version>
| |
| − | <configuration>
| |
| − | <source>1.8</source>
| |
| − | <target>1.8</target>
| |
| − | </configuration>
| |
| − | </plugin>
| |
| − | </plugins>
| |
| − | </build>
| |
| | | | |
| − | <dependencies>
| + | **使用插件创建时刻跳过** |
| − | <dependency>
| |
| − | <groupId>net.md-5</groupId>
| |
| − | <artifactId>bungeecord-api</artifactId>
| |
| − | <version>1.16-R0.5-SNAPSHOT</version>
| |
| − | <type>jar</type>
| |
| − | <scope>provided</scope>
| |
| − | </dependency>
| |
| − | <dependency>
| |
| − | <groupId>net.md-5</groupId>
| |
| − | <artifactId>bungeecord-api</artifactId>
| |
| − | <version>1.16-R0.5-SNAPSHOT</version>
| |
| − | <type>javadoc</type>
| |
| − | <scope>provided</scope>
| |
| − | </dependency>
| |
| − | </dependencies></pre>
| |
| | | | |
| − | 这会在你的项目里添加BungeeCord的依赖.如果你使用IDEA,它会问你是否从pom.xml文件导入,选择导入.如果它询问正在更改的语言级别,允许它重新加载项目.
| + | 新建->Java Class |
| − | ===创建主类===
| |
| − | 现在展开TestPlugin,src,main,应该看起看来是这样的(:(脑补一下):<br>
| |
| | | | |
| − | 右键java，然后创建一个新包,命名为me.username.testplugin.接下来右键新建的包,创建一个新类,命名为TestPlugin.IDE会为你打开文件,如果它没有打开，那么你自己打开(。﹏。)<br>
| + | 导入net.md_5.bungee.api.plugin.Plugin |
| − | 现在,我们可以创建基本的插件.这一章节仅仅聚焦于制作一个仅在启动时显示一条信息的插件.别的章节你可以使自己的插件拥有更多功能.
| |
| | | | |
| − | 在TestPlugin'''之后'''在'''{'''之前加入'''extends Plugin'''<br>
| + | 在public class xxx后添加“extends Plugin” |
| − | 代码:<source lang="java">
| |
| − | package me.username.testplugin;
| |
| | | | |
| − | import net.md_5.bungee.api.plugin.Plugin;
| + | ===要让它被载入=== |
| | | | |
| − | public class TestPlugin extends Plugin {
| + | 在bungee.yml/plugin.yml中添加：main: (你的包名).(创建的主类名) |
| − | @Override
| |
| − | public void onEnable() {
| |
| − | // 你不应该显示启动信息
| |
| − | // bungeeCord已经帮你做了
| |
| − | getLogger().info("Yay! It loads!");
| |
| − | }
| |
| − | }
| |
| − | | |
| − | </source>
| |
| | | | |
| | + | ===编译=== |
| | | | |
| − | ===要让它被载入=== | + | ====IntelliJ IDEA==== |
| − | 现在我们可以创建plugin.yml文件，以便让BungeeCord识别出这是一个插件，然后告诉它怎样去载入它.右键resources,新建文件plugin.yml.在这个文件中,添加如下内容:<br>
| |
| − | <source lang="xml">
| |
| − | name: TestPlugin
| |
| − | main: me.username.testplugin.TestPlugin
| |
| − | version: 1.0
| |
| − | #author可加可不加
| |
| − | author: username
| |
| − | </source>
| |
| − | 如果plugin.yml已经被Bukkit载入,你也可以新建bungee.yml.
| |
| | | | |
| − | ===编译===
| + | Maven：右侧菜单选择Maven->生命周期->package，输出通常储存在target目录中 |
| − | '''恭喜，我们马上就要完成了'''
| |
| − | <br>现在应该编译了.在右侧展开Maven项目窗口(如果你没有看见它,点击视图View再点击工具按钮Tool Buttons),展开你的项目,展开Lifecycle,双击clean,再双击包package.Maven会编译你的项目.现在打开你的项目路径,再target中寻找你的插件.安装并打开BungeeCord端.如果有一行日志像这样:<br>
| |
| − | <br><big>
| |
| − | [INFO] Enabled plugin TestPlugin version 1.0 by username
| |
| − | </big><br><br>
| |
| − | '''那么你成功了！！！！！'''<br>
| |
| − | 重编译插件，就在按着步骤来一遍
| |
| | | | |
| − | ===对开发者的话===
| + | Gradle：右侧菜单选择Gradle->build->build，输出通常储存在./build/libs目录中 |
| − | 如果你是一名Bukkit插件开发者，并且对任何内容都非常熟悉，因为BungeeCord API深受Bukkit API的启发。许多概念(eventhandler和scheduler)保持相同，一些类和方法名称是相同的。
| |
| | | | |
| − | ==事件处理API教程== | + | ====控制台==== |
| − | BungeeCord有一个丰富的事件API，它的行为类似于Bukkit的系统，但有些不同。本章描述如何创建监听器(Listener)和创建自己的事件.
| |
| − | ===创建你的监听器=== | |
| − | 要想利用BungeeCord中的事件，在你的项目中创建一个新类.文件名任意，但出于本教程的目的，我们打算叫它
| |
| − | <br><big>Events.java</big><br>
| |
| − | 一旦你创建了你想要用作监听器的新类，你就必须在BungeeCord中实现监听器接口.你可以让你的类声明看起来像:<br>
| |
| − | <pre> public class Events implements Listener </pre><br>
| |
| − | 一旦你在你的类中实现了Listener，你就可以监听任何BungeeCord事件并对其做出反应.(查看所有的事件)
| |
| − | <br>举个简单的例子，我们将使用BungeeCord中的PostLoginEvent.让我们添加第一个监听器:
| |
| − | <br><pre>
| |
| − | public class Events implements Listener {
| |
| − | @EventHandler
| |
| − | public void onPostLogin(PostLoginEvent event) {
| |
| − |
| |
| − | }
| |
| − | }
| |
| − | </pre><br>
| |
| | | | |
| − | 每当玩家(ProxiedPlayer)成功通过身份验证并准备连接到服务器时会调用PostLoginEvent.通过我们的监听器，我们可以向所有其他玩家发送这样的消息，表示他们已经加入了BungeeCord 客户端网:
| + | Maven：（需自行安装Maven）运行mvn package |
| − | <br><pre>
| |
| − | public class Events implements Listener {
| |
| − | @EventHandler
| |
| − | public void onPostLogin(PostLoginEvent event){
| |
| − | for (ProxiedPlayer player : ProxyServer.getInstance().getPlayers()) {
| |
| − | player.sendMessage(new TextComponent(event.getPlayer().getName() + " has joined the"
| |
| − | + "network."));
| |
| − | }
| |
| − | }
| |
| − | }
| |
| − | </pre><br>
| |
| − | 完成Events类之后，必须在主类中注册监听器.像这样:
| |
| − | <br><pre>
| |
| − | public class Main extends Plugin {
| |
| − | @Override
| |
| − | public void onEnable() {
| |
| − | getProxy().getPluginManager().registerListener(this, new Events());
| |
| − | }
| |
| − | }
| |
| − | </pre><br>
| |
| − | 确保你使用的是事件列表中的事件，这样你就可以在你的插件中适当地与事件进行交互。
| |
| − | ===创建你自己的事件===
| |
| | | | |
| | + | Gradle：运行.\gradlew build（需创建的项目中有gradlew.bat或gradlew文件，没有则自行安装Gradle后运行gradle build） |
| | | | |
| | + | ===对开发者的话=== |
| | + | ==事件处理API教程== |
| | ==常有的误区== | | ==常有的误区== |
| | ==创建基础的命令功能 (代理)== | | ==创建基础的命令功能 (代理)== |
本条目已有一定量的内容，但仍需完善
欢迎参与本条目的完善工作。
你可以从以下几个方面入手
- 参阅格式化手册，并对该页面进行相应格式排版工作；
- 日常检查是否内容有更新版本并更新该页面；
- 修复该页面中已出现/潜在的问题
介绍
BungeeCord是一个转发服务端. 你也可以把它理解为代理服务端. 鉴于国内似乎没有BungeeCord插件, 我觉得写一篇教程会好些.
利用工具
官方工具(疑似已炸)
官方提供了一个极其好用的工具网页. 它可以让你方便地生成一个新的, 配置好的BungeeCord插件项目.
该页面的地址 [1]
只要简单地输入Plugin name, Plugin package, Plugin author, Plugin version
他就会自动为你生成一个项目, 和一些基础的代码.
如果你是新手, 你大可以勾选Include a listener for me, please.. 这样他会为你生成一个玩家连接的监听器.
IntelliJ IDEA插件
在MarketPlace中搜索“Minecraft Development”，安装后重启IDEA，创建项目选择Minecraft>BungeeCord
创建你的第一个BungeeCord插件 (代理)
设置你的项目
这个教程只包括IntelliJ IDEA(一款IDE)，其他IDE的操作相似.
在原文处附有Eclipse的操作
首先打开你的IDE,创建一个新的项目,在弹出的选项卡中选择Maven.你应该有与下图相似的界面:
创建主类
新建->Java Class
导入net.md_5.bungee.api.plugin.Plugin
在public class xxx后添加“extends Plugin”
要让它被载入
在bungee.yml/plugin.yml中添加：main: (你的包名).(创建的主类名)
编译
IntelliJ IDEA
Maven：右侧菜单选择Maven->生命周期->package，输出通常储存在target目录中
Gradle：右侧菜单选择Gradle->build->build，输出通常储存在./build/libs目录中
控制台
Maven：（需自行安装Maven）运行mvn package
Gradle：运行.\gradlew build（需创建的项目中有gradlew.bat或gradlew文件，没有则自行安装Gradle后运行gradle build）
对开发者的话
事件处理API教程
常有的误区
创建基础的命令功能 (代理)
Bukkit 和 BungeeCord 插件消息通道
聊天组件 API
在服务器之间传送玩家 (代理)
使用BungeeCord配置文件系统
通过BungeeCord创建计分板
创建一个Bungee的插件 (不需要Maven)
