Skip to content

Troubleshooting

Jump to bottom
Ayush Singh edited this page Oct 24, 2026 · 1 revision

Troubleshooting

This page covers common ReinChat issues and steps to help identify their cause.

ReinChat Does Not Load

  • Confirm that both ReinChat and its required dependency, ReinCore, are installed in the server's plugins/ directory.
  • Check the server console for startup errors or dependency messages.
  • Make sure the JAR files are installed directly in plugins/, not inside another subdirectory.
  • Check that the server and plugin versions are compatible.

For more details, see Installation.

Configuration Changes Do Not Apply

  1. Check the edited file for YAML indentation and formatting errors.
  2. Confirm that you edited the correct file in plugins/ReinChat/.
  3. Run /reinchat reload.
  4. Check the server console for errors during the reload.

Some changes to commands or dynamically registered channel commands may require a full server restart if they do not register correctly after reloading.

Keep a backup of your configuration files before making significant changes.

A Command Does Not Work

  • Check that the command is available in ReinChat.
  • Verify that the sender has the required permission.
  • Check whether the command or alias conflicts with another plugin.
  • For chat channel commands, check the relevant YAML file in plugins/ReinChat/channels/.

Refer to Commands and Permissions.

Chat Channels Are Missing or Not Working

If a channel command is unavailable or messages are not being sent or received:

  • Check the channel's YAML file in plugins/ReinChat/channels/.
  • Confirm that enabled is not set to false.
  • Check the configured command and aliases.
  • Verify the sender's permission and the recipient's read-permission.
  • Check the channel's apply-filters setting if messages are being blocked or modified.
  • Review the console for configuration or command-registration errors.

See Chat Channels for details.

Tags or Chat Colors Are Unavailable

  • Confirm that the tag or color is configured in the appropriate file.
  • Use the configured ID rather than its display name when selecting an option.
  • Check the relevant permission and any applicable permission-bundle settings.
  • If you changed menu settings, close and reopen the menu after reloading.

See Tags & Chat Colors.

Item and Inventory Previews Do Not Work

If [item], [inv], or [ec] does not produce the expected preview:

  • Confirm that the relevant shortcut is configured in config.yml.
  • Check that the sender has the corresponding reinchat.show.* permission.
  • For [item], make sure the sender is holding an item.
  • Check whether the chat display cooldown is active.
  • For inventory snapshots, check whether the snapshot has expired and whether the viewer has the required permission.

See Item & Inventory Previews.

PlaceholderAPI Placeholders Do Not Resolve

  • Confirm that PlaceholderAPI is installed and enabled.
  • Check the console for messages or errors related to the PlaceholderAPI integration.
  • Verify that you are using the correct placeholder spelling.
  • Make sure the feature or configuration field supports PlaceholderAPI placeholders.

ReinChat provides its own placeholders for equipped tags. See PlaceholderAPI.

Broadcasts Are Not Appearing

Automatic broadcasts

  • Confirm that enabled is set to true in broadcasts.yml.
  • Check interval-seconds.
  • Make sure the messages list contains entries.
  • Check the console for configuration or reload errors.

Manual broadcasts

  • Confirm that manual.enabled is set to true.
  • Check the permission configured under manual.permission.
  • Verify that the sender has the required permission.

See Broadcasts.

Where to Find Error Logs

The server's latest log is located at:

logs/latest.log

When investigating a problem, look for errors or warnings mentioning ReinChat, ReinCore, or the feature that is failing. Include the relevant error and stack trace when reporting an issue.

Avoid sharing database credentials, webhook URLs, passwords, or other secrets from your configuration files.

Reporting an Issue

If the problem persists, provide the following information when reporting it:

  • ReinChat version.
  • ReinCore version.
  • Paper server version.
  • A clear description of the problem and how to reproduce it.
  • Relevant console errors or stack traces.
  • The relevant configuration section, with secrets removed.
  • Any steps you have already tried.

Providing these details makes it easier to identify and reproduce the issue.

For feature-specific guidance, see Configuration, Commands, and Permissions.

Clone this wiki locally