Troubleshooting Guide
Welcome to the Typewriter Plugin Troubleshooting Guide. This document aims to assist users in resolving common issues encountered while using the Typewriter plugin for Paper Spigot. Before reaching out for assistance on Discord or GitHub, we encourage you to review this comprehensive list of frequently encountered issues and their solutions. This proactive approach can help you solve your problem more quickly and efficiently.
Panel Not Loading
If you encounter issues with the panel not loading, please follow these steps:
- Confirm that your server is running and accessible.
- Check if there are any network connectivity issues.
- Ensure your firewall settings are not blocking access.
For more detailed troubleshooting steps, refer to: Panel not loading.
No Entries Showing
This issue typically occurs when no adapters are installed. To resolve this, ensure that adapters are correctly installed by following the steps outlined in the Basic Adapter Installation Tutorial.
Error: "plugin.yml not found" When Installing an Adapter
If you encounter an error message similar to the following when installing an adapter:
[08:49:35 ERROR]: [DirectoryProviderSource] Error loading plugin: Directory 'plugins/BasicAdapter.jar' failed to load!
java.lang.RuntimeException: Directory 'plugins/BasicAdapter.jar' failed to load!
...
Caused by: java.lang.IllegalArgumentException: Directory 'plugins/BasicAdapter.jar' does not contain a paper-plugin.yml or plugin.yml! Could not determine plugin type, cannot load a plugin from it!
This typically indicates that the adapter is not placed in the correct folder. For instructions on proper placement, see Correct Adapter Placement.
Placeholders Not Parsing Correctly
If placeholders from PlaceholderAPI, such as %player_name%
, aren't being parsed correctly in Typewriter, follow these troubleshooting steps:
- Identify the required PlaceholderAPI placeholder extension. A list of extensions can be found here.
- Install the necessary extension using
/papi ecloud install [extension_name]
. For%player_name%
, use/papi ecloud download player
. - Check if the placeholder is parsed correctly in normal usage by running
/papi parse me <placeholder>
. For%player_name%
, use/papi parse me %player_name%
. - If the placeholder works in normal usage but still not in Typewriter, try restarting your server.
If these steps do not resolve the issue, please contact us for further support by creating a ticket on our Discord.