Skip to main content
 Warning: Unmaintained Version
Version: 0.4.2

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:

  1. Confirm that your server is running and accessible.
  2. Check if there are any network connectivity issues.
  3. Ensure your firewall settings are not blocking access.

For more detailed troubleshooting steps, refer to: Panel not loading.

No Entries Showing​

No Entries

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:

  1. Identify the required PlaceholderAPI placeholder extension. A list of extensions can be found here.
  2. Install the necessary extension using /papi ecloud install [extension_name]. For %player_name%, use /papi ecloud install player.
  3. 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%.
  4. 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.

Citizens Not Interacting or Duplicated NPC Names​

This issue often arises with an outdated version of the Citizens plugin that is incompatible with the current version of Typewriter. To resolve this, ensure you have the latest version of the Citizens plugin. You can download the latest version from Citizens on SpigotMC.

For further assistance, please reach out to our community on Discord. We're here to help make your experience with the Typewriter plugin as smooth as possible!