故障排除指南

欢迎使用Typewriter插件故障排除指南。本文档旨在帮助用户解决在使用Paper Spigot的Typewriter插件时遇到的常见问题。在通过Discord或GitHub寻求帮助之前，我们建议您查看此综合列表，其中包含常见问题及其解决方案。这种主动的方法可以帮助您更快、更高效地解决问题。

面板无法加载

如果您遇到面板无法加载的问题，请按照以下步骤操作：

1. 确认您的服务器正在运行并可访问。
2. 检查是否存在网络连接问题。
3. 确保您的防火墙设置没有阻止访问。

有关更详细的故障排除步骤，请参阅：面板无法加载。

没有显示条目

此问题通常发生在未安装任何扩展时。要解决此问题，请确保按照**基本扩展安装教程**中的步骤正确安装扩展。

安装扩展时出现错误：“plugin.yml未找到”

如果您在安装扩展时遇到类似以下的错误消息：

[08:49:35 ERROR]: [DirectoryProviderSource] 加载插件时出错：目录'plugins/BasicExtension.jar'加载失败！
java.lang.RuntimeException: 目录'plugins/BasicExtension.jar'加载失败！
        ...
Caused by: java.lang.IllegalArgumentException: 目录'plugins/BasicExtension.jar'不包含paper-plugin.yml或plugin.yml！无法确定插件类型，无法从中加载插件！

这通常表示扩展未放置在正确的文件夹中。有关正确放置的说明，请参阅正确扩展放置。

占位符未正确解析

如果PlaceholderAPI的占位符（例如%player_name%）在Typewriter中未正确解析，请按照以下故障排除步骤操作：

1. 确定所需的PlaceholderAPI占位符扩展。扩展列表可以在此处找到。
2. 使用/papi ecloud download [extension_name]安装必要的扩展。对于%player_name%，请使用/papi ecloud download player。
3. 通过运行/papi parse me <placeholder>检查占位符在正常使用中是否正确解析。对于%player_name%，请使用/papi parse me %player_name%。
4. 如果占位符在正常使用中有效但在Typewriter中仍然无效，请尝试重启服务器。

如果这些步骤未能解决问题，请通过在我们的Discord上创建工单联系我们以获得进一步支持。