Bukkit 1.12.2-R0.1-SNAPSHOT API 中文文档

Bukkit 是一个Minecraft服务器插件开发框架.

离线版本下载: 1.12.2版本 | 1.13及以上版本

本文档是由 BukkitAPI汉化组 进行汉化的非官方版本, 官方发布的英文原文版可在此处找到. 汉化版仅供参考, 出现冲突时请以英文版为准.

由于译者水平精力有限, 难免在译文处理上出现不足或没翻译完全之处. 欢迎批评指正或提交PullRequest/Issues到此翻译项目的仓库.

此汉化文档版本为 Bukkit 1.12.2-R0.1-SNAPSHOT, 并不会与英文版的发布完全同步, 但我们会尽可能地保持更新. 与原文出现出入请见谅.

本文档用于开发插件, 并将各个主题内容分为相应的包. 本文档不涉及运行时服务器, 为项目贡献代码的步骤以及workspace的设置. Java基础知识是开发一个Bukkit插件的先决条件.

若要开发插件, 请参阅 plugin包. 此包涵盖了插件的基本要求.

若要处理事件并触发代码, 请参阅 event包.

程序包

程序包	说明
org.bukkit	Bukkit的常用类.
org.bukkit.advancement
org.bukkit.attribute
org.bukkit.block	用于操作在世界内的三位像素(方块)，包括一些特定的状态.
org.bukkit.block.banner
org.bukkit.block.structure
org.bukkit.boss
org.bukkit.command	与处理玩家输入的非聊天消息（即命令）相关的类.
org.bukkit.command.defaults	通过Bukkit实现来模拟Minecraft原生命令(1.12后所有模拟命令被删除)并提供一些其他必要的命令.
org.bukkit.configuration	专门用于处理插件运行时配置的类.
org.bukkit.configuration.file	致力于简化配置的读取和保存操作的类.
org.bukkit.configuration.serialization	面向Bukkit配置实现使配置可以被执行序列化的类
org.bukkit.conversations	致力于简化玩家与插件的直接通信的类(玩家与插件的对话，典型的场景比如操作的确认、提供插件所需数据).
org.bukkit.enchantments	与物品堆对应的附魔相关的类，作为物品元数据的一部分.
org.bukkit.entity	为在世界内存在的非三维像素单位(实体)提供的接口，包含玩家、怪物、抛射物等.
org.bukkit.entity.minecart	为不同种类的矿车提供的接口.
org.bukkit.event	用于处理触发代码的执行的类.
org.bukkit.event.block	与方块被改变或与世界进行交互等情况相关的事件.
org.bukkit.event.enchantment	与附魔台操作相关的事件.
org.bukkit.event.entity	与实体相关的事件，不包括 一些直接引用的更具体的实体类型.
org.bukkit.event.hanging	与悬挂实体相关的事件.
org.bukkit.event.inventory	与物品栏操作相关的事件.
org.bukkit.event.player	与玩家相关的事件.
org.bukkit.event.server	与服务器程序状态变化有关的事件.
org.bukkit.event.vehicle	与载具实体相关的事件.
org.bukkit.event.weather	与天气状态变化相关的事件.
org.bukkit.event.world	与世界状态和变化有关的事件.
org.bukkit.generator	简化世界生成实现的类.
org.bukkit.help	用于操作默认的命令和主题帮助系统的类(你可以将你的命令帮助添加到系统命令帮助系统(help命令)内等等).
org.bukkit.inventory	参与操作玩家物品栏和物品交互的类.
org.bukkit.inventory.meta	用于操作可以被存储在物品堆的额外数据的接口.
org.bukkit.map	用于简化处理地图显示内容的类.
org.bukkit.material	代表每种体素(意义可参考维基百科或百度百科相关条目，即物品被抽象为体素)的种类和状态.
org.bukkit.material.types
org.bukkit.metadata	用于提供在每种Minecraft概念上的插件指定数据的数据层.
org.bukkit.permissions	用于提供玩家二态属性的类(推测二态为是管理员与不是管理员两种状态).
org.bukkit.plugin	专门用于在运行时加载软件模组(插件)的类.
org.bukkit.plugin.java	用Java编写的处理插件的类.
org.bukkit.plugin.messaging	用于设定插件至客户端的消息传输协议的类.
org.bukkit.potion	代表每种药水属性和操作的类的集合.
org.bukkit.projectiles	代表一个抛射物的抛射源的类的集合.
org.bukkit.scheduler	用于使插件以指定时间间隔运行代码的类，包括线程安全.
org.bukkit.scoreboard	用于管理客户端计分板显示系统的类.
org.bukkit.util	提供多种目的和单一目的的类以简化各种编程概念.
org.bukkit.util.io	用于处理Bukkit对象流的相关类.
org.bukkit.util.noise	噪声相关工具.
org.bukkit.util.permissions	为permission杂项功能提供的静态方法.