Troubleshooting & FAQ

Common diagnostic steps and solutions for YEmojis configuration issues.

Chat Emojis Are Not Replacing

1. Check Event Priority

If your chat plugin (such as LPC or another v5 MiniMessage formatter) intercepts and finalizes chat messages early, YEmojis may not receive the raw message.

Open plugins/YEmojis/config.yml.
Set chat.event-priority to HIGHEST or MONITOR.
Run /yemojis reload.

2. Verify Permissions

By default, players need the yemojis.use permission node. If permissions.require-category-permissions is set to true, ensure players also have category-specific permissions (e.g. yemojis.use.items, yemojis.use.flags).

Shulker Box Previews Not Showing in Inventories

ProtocolLib Requirement: Real-time packet rewriting of inventory tooltips requires ProtocolLib 5.3.0+ running on Paper 1.21.11 and above (1.21.11+).
Verify Configuration: Ensure shulker-previews.inventory-tooltips is set to true in config.yml.

Server Console Check: Look for ProtocolLib hook status during startup:

[YEmojis] ProtocolLib detected. Packet-level shulker tooltips active.

Dialog Picker Does Not Open

Paper 1.21 Dialog menus use the native Paper Dialog API.

If you are running an older build or an incompatible fork, switch general.menu-type from dialog to chest in config.yml.
Run /yemojis reload to switch to standard 54-slot chest inventories.

GeoIP Country Flags Return Fallback

Localhost and LAN IP addresses (127.0.0.1, 192.168.x.x) do not have physical geographic locations. When testing on a local server, YEmojis will assign the configured geoip.fallback-country (default US).
On public production servers with real client IPs, country codes are resolved and cached on player join.

Common Error Messages

Error Message	Cause	Solution
`No permission.`	Missing `yemojis.use` or `yemojis.gui` node	Add permission node in LuckPerms.
`Emoji limit reached.`	Player exceeded `chat.max-emojis-per-message`	Grant `yemojis.bypass.limit` or increase limit in `config.yml`.
`Showcase on cooldown.`	Player sent multiple `[item]` tags too quickly	Adjust `showcase.cooldown-seconds` or grant `yemojis.bypass.cooldown`.