FAQ & Troubleshooting

Frequently Asked Questions

How do I reload the plugin?

Use /lpc reload to reload all configuration files. Note that database.yml changes and private message toggles require a full server restart.

Chat format changes aren't showing up

1. Make sure you edited the correct format file in formats/
2. Run /lpc reload
3. If using group-specific formats, check that the file name in formats/groups/ matches the player's LuckPerms/Vault primary group name

PlaceholderAPI placeholders show as raw text

1. Verify PlaceholderAPI is installed and running: /papi list
2. Check that placeholder-api: true is set in config.yml under hooks:
3. Make sure you're using %placeholder% syntax (not {placeholder})
4. Some placeholders require additional expansion downloads: /papi ecloud download <expansion>

Players can't use colors in chat

Color permissions are controlled in two places:

1. advanced/groups.yml — Set can-use-colors: true for the group
2. Individual permissions — Grant lpcpro.color.<color> or lpcpro.color.*

The swear filter is too aggressive / not aggressive enough

• Too aggressive: Remove words from the blocked-words list in moderation/moderation.yml
• Not aggressive enough: Add more words to the list. Evasion detection (leet speak, separators, repeated chars) is automatic for every listed word.

How do I disable a feature?

Most features have an enabled: toggle in their config file:

How do I change the default chat channel?

Edit chat/channels.yml:

settings:
  default-channel: "global"  # Change to your preferred channel name

How do I set up per-group chat formats?

1. Create a format file at formats/groups/<groupname>.yml
2. The file name must match the player's LuckPerms/Vault primary group name
3. Use the same format structure as formats/chat.yml
4. Run /lpc reload

Private messages are disabled

Check config.yml:

enable-private-messages: true

This setting requires a server restart to take effect.

How do I allow my server's IP/domain in chat?

Add it to the allowed domains list in moderation/moderation.yml:

anti-advertising:
  allowed-domains:
    - "yourserver.com"
    - "discord.gg"

---

Troubleshooting

Plugin won't enable

• Check your server console for error messages
• Verify your Java version meets your server's requirements (java -version)
• Verify you're running Paper or Spigot 1.17+
• Check for conflicting plugins

Database connection failed

• Verify your MySQL credentials in database.yml
• Ensure the database exists with utf8mb4_unicode_520_ci collation
• Check that your MySQL server is accessible from the Minecraft server
• Try type: local (SQLite) to verify the issue is database-related

Non-English characters appear garbled

Add -Dfile.encoding=UTF-8 to your server's startup flags:

java -Dfile.encoding=UTF-8 -jar server.jar

For MySQL, ensure the database uses utf8mb4 character set.

Message deletion not working

• Verify ProtocolLib is installed and up to date
• Check that protocol-lib: true is set in config.yml
• Verify the player has lpcpro.chat.delete permission

Emojis / Glyphs not rendering

• Verify ItemsAdder or Oraxen is installed
• Check the corresponding hook is enabled in config.yml
• Make sure emoji/glyph names match exactly (including case)
• Don't enable both ItemsAdder and Oraxen simultaneously

Getting "No permission" errors

• Check that permission nodes match between your permission plugin and LPC Pro
• Use /lp user <player> permission check <permission> to debug LuckPerms permissions
• Review the Commands & Permissions page for correct permission nodes

High memory usage or lag

• If using SQLite, consider switching to MySQL for larger servers
• Increase the tab list update-interval-ticks value to reduce update frequency
• Disable features you don't use
• Check that auto-game-interval-minutes isn't set too low