马上登录/注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有账号?立即注册
x
本帖最后由 command_god 于 2024-5-5 03:20 编辑
本文档是由 BukkitAPI汉化组 进行汉化的非官方版本, 官方发布的英文原文版可在[color=var(--color-a-link)] 此处找到. 汉化版仅供参考, 出现冲突时请以[color=var(--color-a-link)] 英文版为准.
由于译者水平精力有限, 难免在译文处理上出现不足或没翻译完全之处. 欢迎批评指正或提交 PullRequest/Issues 到 此翻译项目的仓库.
此汉化文档版本为 Spigot-API 1.20-R0.1-SNAPSHOT, 并不会与英文版的发布完全同步, 但我们会尽可能地保持更新. 与原文出现出入请见谅.
本文档用于开发插件, 并将各个主题内容分为相应的包. 本文档不涉及运行时服务器, 为项目贡献代码的步骤以及 workspace 的设置. Java基础知识是开发一个 Bukkit 插件的先决条件. 若要开发插件, 请参阅 [color=var(--color-a-link)]plugin包. 此包涵盖了插件的基本要求. 注意: 虽然 Bukkit API 尽一切努力保证稳定性, 但这仍不是完全保证的, 尤其是跨越各大版本的情况下. 特别地, 以下列举了非 API 的不完整列表.
实现接口. Bukkit API 被设计为只能由服务器软件实现. 除非某个类/接口明显被设计为扩展用途 (例如BukkitRunnable), 或者有明确标识, 它不应被插件实现. 虽然有时这很管用, 但仍不保证可以这么做, 由此产生的 bug 官方将忽略, 风险自担.
构造并调用内部事件. 即使官方尽可能尝试向后兼容, 但有时候向事件添加新字段且不破坏已存在的构造器是不可能的. 为了保证 API 能持续演进, 因此事件构造器不属于插件 API.
实现类. Bukkit API 中的具体的实现类(比如以"Simple"打头的的类)不属于API. 您应该通过它们的接口来访问它们.
|