SimpleAPI - 简易API

💡关于 SimpleAPI

SimpleAPI 是一个轻量级的 API，旨在处理我的插件所需的大量 NMS 与其他底层任务。它虽然是一个 API，但服务器管理员也能直接使用其提供的多种实用功能。

❓常见问题解答

服务器启动时卡顿，如何修复？

• 关闭非 API 功能，这将减少启动时的任务负载。
• 你也可以尝试在 bstats 文件夹中禁用 BStats 插件统计。

为什么你的许多插件都需要这个 API？

• 我的许多插件依赖它，主要是因为它们共享相同的类库，包括插件更新提示器。这能避免你在登录时收到大量重复的刷屏消息。
• 这也使得所有插件能保持结构一致，只需更新 SimpleAPI 中的代码，而无需频繁更新其他 7 个或更多结构不同的插件。

使用 `/reload` 或 `/plugman reload` 重载时插件崩溃了？

• 永远不要使用这些命令来重载插件。它们总是会导致问题。/reload 命令本身就有长期存在的警告，提示它可能破坏插件。
• 许多插件（包括 SimpleAPI）需要按特定顺序加载（例如 SimpleAPI 必须在 SimplePets 之前加载），重载命令会破坏这个顺序。

为什么这个 API 功能这么多？API 不是只应该提供类库吗？

• 我制作这个插件作为 API 是因为我的其他插件都在使用它，同时我也将其开放给所有人使用。
• 我同意这个“API”确实做了比通常 API 更多的事情，但这些额外功能都是为了让你或你的服务器受益。如果你愿意，可以打开 Language.yml 文件，将 API-Only 设为 true，然后重启服务器。

🔧重要提示

如果你不喜欢额外功能，请不要直接给予差评。这些功能都是可以禁用的，它们完全是可选的。

🎮命令列表

拥有相应权限的玩家可以使用以下命令

• /action <player> <message> - 在玩家快捷栏上方发送消息。（权限：SimpleAPI.command.action）
• /tab <player> <header> [footer] - 设置玩家标签页的页眉和/或页脚信息。（权限：SimpleAPI.command.tab）
• /titlemaker <player> <title> [subtitle] - 向玩家发送标题消息，无需处理复杂的 JSON 文本格式。（权限：SimpleAPI.command.title）
• /particlemaker <particlename> <amount> [offset,offsetY,offsetZ] - 在你所在位置生成粒子效果。（权限：SimpleAPI.command.particle）
• /history <username> - 查询指定玩家的历史/当前用户名。（权限：SimpleAPI.command.history）

> 提示：在游戏中将鼠标悬停在命令用法上可以查看更多详细信息。

⭐API 功能与开发者资源

主要功能特性

开发者可以使用以下类与接口（更多功能请查阅 JavaDocs）：

• 消息与界面：ITellraw, IActionMessage, ITitleMessage, ITabMessage, IAnvilGui
• 实体与目标：IClearGoals, IGlow, IPathfinderGoal
• 物品与方块：ITileEntitySkull, SkullMaker, ItemMaker, LeatherArmorMaker, CompassMaker
• 工具与工具类：ParticleAPI, IParticlePacket, PageMaker<T>, AdvMap, Lore
• 插件管理：SpigotPluginHandler（更新提示与统计）, Reflection

注意事项

• 如果你的服务器版本不受支持，部分功能可能无法工作（其中一些功能有备用方案，例如 ITellraw、IActionMessage 和 ITitleMessage 会以聊天消息形式发送）。
• 随着插件发展，会添加或更改更多功能。我对自己插件的所有更新都将使用此 API，以使代码更简洁美观。

JavaDocs 链接：http://brainsynder.us/doc/simpleapi

Maven 仓库：即将推出。

✨使用此 API 的插件

以下插件依赖 SimpleAPI

• SimpleParticles
• SimpleGadgets
• ATrailer
• AntiHackedPotions
• CSkulls
• SimplePets
• TitleJoin
• SimpleMobs
• SimpleMobs-Addon
• Gender

🔧如何仅使用 API 功能？

如果你只想将其作为纯 API 使用，可以按以下步骤操作：

• 打开插件目录下的 Language.yml 配置文件。
• 找到 API-Only 配置项。
• 将其值从 false 改为 true。
• 重启你的服务器。

这样将禁用所有面向玩家的额外功能（如可合成的 LightLevelDetector 物品），仅保留核心 API 类库。LightLevelDetector 物品的合成配方为在工作台中放置一个火把和一根木棍，使用需要权限 SimpleAPI.lightdetector.use。