Troubleshooting

Troubleshooting Guide

This page lists common issues encountered with Elite Holograms and their potential solutions.

General Issues

Issue: Commands are not working / "Unknown command" error.

• Solution 1: Mod Not Loaded Correctly.
  • Ensure the Elite Holograms JAR file is in your server's mods folder.
  • Verify you have the correct version of the mod for your server's Minecraft version and mod loader (Forge/NeoForge).
  • Check your server console/logs for any error messages related to Elite Holograms during startup.
• Solution 2: Incorrect Command Syntax.
  • Double-check the command you are typing against the Commands guide. Pay attention to spacing and argument order.
  • Use the in-game tab completion to help fill out commands and arguments.
• Solution 3: Permission Issues.
  • If not using LuckPerms or FTB Ranks, ensure you are an OP with at least permission level 2 (check server.properties).
  • If using a permissions mod, ensure you or the relevant group has been granted the necessary Permissions nodes.
  • Use the diagnostic tools provided by your permissions mod (e.g., /lp verbose on or /lp user <user> permission check <permission.node>) to verify permissions.

Issue: Holograms are not appearing after creation or server restart.

• Solution 1: Incorrect World or Coordinates.
  • When creating a hologram, it spawns at your feet. Ensure you are in the intended location and world.
  • Use /eh info <id> to check the saved world and coordinates of the hologram.
• Solution 2: Hologram Despawned or Deleted.
  • It might have been accidentally deleted. Try /eh list to see if it still exists.
• Solution 3: Client-Side Rendering Issues.
  • Try disconnecting from the server and rejoining.
  • Rarely, other client-side mods might interfere with rendering. Try testing with a minimal mod setup if the issue persists.
• Solution 4: (NeoForge Specific) Player Visibility.
  • If other players cannot see a hologram that you can, ensure you are on the latest version of Elite Holograms for NeoForge, as this has seen specific improvements for multiplayer visibility.

Issue: Placeholders are not working or showing as raw text (e.g., %player%).

• Solution 1: Incorrect Placeholder Name.
  • Verify the placeholder name exactly matches the list on the Placeholders page (e.g., it's %players%, not %playersonline%).
• Solution 2: Placeholders Disabled (Unlikely).
  • The built-in placeholder system is always enabled. This is usually not the cause.
• Solution 3: Player-Specific Placeholders in Server-Only Context.
  • Player-specific placeholders like %player% will only resolve correctly when a specific player is viewing the hologram. In some contexts (like console output or if a hologram line is somehow processed without a player target), they might show the raw tag or a default value.

Issue: Server is lagging or crashing.

• Solution 1: Mod Conflict.
  • While Elite Holograms is designed for performance, conflicts with other mods can occur. Try to identify if the issue started after adding Elite Holograms or another mod. Test with a minimal modpack if necessary.
• Solution 2: Too Many Complex Holograms (Rare).
  • Having an extremely large number of holograms with frequently updating placeholders could contribute to load, but this is rare for typical usage.
• Solution 3: Report the Issue.
  • If you suspect a bug within Elite Holograms, please gather relevant logs (latest.log, debug.log, crash reports if any) and report it on our GitHub Issues page with as much detail as possible, including your mod list and steps to reproduce the problem.

Permissions Issues

Issue: Players without OP cannot use any /eh commands, even with a permissions mod installed.

• Solution 1: Permissions Not Set Up Correctly.
  • Ensure you have actually assigned the Elite Holograms permission nodes to the relevant groups/players in LuckPerms or FTB Ranks. Simply installing the permissions mod is not enough.
  • Double-check the spelling and hierarchy of the permission nodes (e.g., eliteholograms.create).
• Solution 2: Permissions Mod Not Detected.
  • Check your server startup log for messages from Elite Holograms indicating whether it detected LuckPerms or FTB Ranks. If it didn't, it will fall back to OP-only mode.
  • Ensure your permissions mod is up-to-date and correctly installed.

Issue: Granted eliteholograms.admin but still can't use all commands.

• Solution: The eliteholograms.admin node typically covers administrative commands like /eh reload. For full access to all hologram manipulation commands, the wildcard eliteholograms.* is generally used for admin roles, or individual sub-nodes (.create, .edit, etc.) must be granted.

Reporting Bugs

If you encounter an issue not listed here, or if the provided solutions do not help, please help us by reporting it!

1. Gather Information:
   • Elite Holograms version, Minecraft version, Forge/NeoForge version.
   • A list of other mods installed.
   • Relevant server logs (logs/latest.log, logs/debug.log).
   • Crash report if the game crashed.
   • Clear steps to reproduce the issue.
2. Report on GitHub Issues:
   • Go to the Elite Holograms GitHub Issues Page (replace with your actual link).
   • Create a new issue, providing all the information you gathered.

Thank you for helping improve Elite Holograms!