Skip to content

Troubleshooting

Optional Hook Does Not Work

Confirm the integration plugin is installed, enabled, and named as expected. EssentialsLite's integrations are soft dependencies, so a missing plugin does not necessarily prevent startup. Check startup logs for hook or dependency errors, then verify the relevant feature configuration.

Placeholders Are Empty

Install and enable PlaceholderAPI. EssentialsLite registers the essentials expansion only when PAPI is present. Core commands do not require PAPI, but expansion values do.

WorldGuard RTP Behavior Differs

Check the random-teleport WorldGuard hook configuration and the installed WorldGuard major version. EssentialsLite has distinct WorldGuard 6 and 7 hook behavior. Also confirm that the target world and location are evaluated through the configured RTP safety path.

MineClans Blocks /sethome

MineClans protects enemy faction claims from /sethome. Confirm the player is not setting a home inside an enemy claim before treating the result as a hook failure. The integration uses MineClans' local API.

RTP-Zone Hologram Missing

Install and enable FancyHolograms or DecentHolograms, then inspect rtp-zones.hologram.provider-order. EssentialsLite tries available hologram providers in that configured order. A missing or disabled provider cannot create the hologram.

Reflective Hook Failure

SMPRegions, ZelChat, and TAB use reflective adapters. Check startup logs for missing classes or provider/API errors and verify the third-party plugin version before changing EssentialsLite core settings. TAB is reflective even though it is not a descriptor soft dependency.

Folia Scheduling Symptoms

The plugin descriptor marks Folia as supported and EssentialsLite uses FoliaAPI, but that does not guarantee blanket runtime compatibility for every server or optional hook. Check the affected world, region, or entity ownership and avoid assuming legacy global scheduler behavior.

External Storage Fails

MySQL and Redis are optional, configuration-backed integrations. Verify that the feature is intentionally enabled, its configuration is complete, and the external service is reachable. Local operation does not require either service.