信息检索
开发中最常被问的"劣质问题"是:"XXX 该监听什么事件?""怎么设置玩家昵称?"——这些一查 JavaDoc 就有答案。学会自己查,比问人快。
Bukkit 按包划类,类名即作用
例:玩家移动该监听什么事件?
- 你想找的是"事件",打开 JavaDoc 看所有包,按名称判断该去
org.bukkit.event找 org.bukkit.event又分若干子包,与玩家有关的应在org.bukkit.event.player- 打开该包,玩家事件基本按
PlayerXxxxxEvent命名,一眼看到PlayerMoveEvent - 看它的描述:
Holds information for player movement events——就是它
例:怎么获取玩家飞行速度?
与玩家有关,方法应在 Player 类中。打开 Player 类详细介绍,按名称和方法描述检索,找到 getFlySpeed。
核心套路
| 你想找的 | 去哪个包/类 |
|---|---|
| 某个事件 | org.bukkit.event.<范围>(player/block/entity...) |
| 玩家的能力/操作 | org.bukkit.entity.Player |
| 方块操作 | org.bukkit.block.Block |
| 物品相关 | org.bukkit.inventory.ItemStack、Material |
| 配置读写 | org.bukkit.configuration |
命名规律
- 事件类都以
Event结尾:PlayerMoveEvent、BlockBreakEvent - 开头第一个词决定范围:
Player*是玩家相关、Block*是方块相关 - 看类名就能猜出功能,再看描述确认
JavaDoc 在哪
- SpigotMC 维护的 API 文档:hub.spigotmc.org/javadocs/spigot
- IDEA 里直接 Ctrl+点击类名/方法名,能看到源码和注释
别当伸手党
问问题前先问自己:这个能不能查到?能查到的别问。真的查不到、试过调试还不行,再问——并附上你试过什么。这样问出来的才是好问题。
下一篇:服务端与客户端
