Gallery

Description

GlymeraInspect - See What You're Looking At!

A clean HUD overlay that shows you exactly what block, creature or object is in your crosshair - plus your gold balance.

What is GlymeraInspect?

GlymeraInspect adds a permanent info panel to the bottom-left of your screen. Look at any block, NPC or creature and instantly see its name, coordinates, distance, health and more. If the GlymeraMerchant plugin is installed, your current gold balance is displayed as well.

Works out of the box - no setup needed, every player gets the HUD automatically, and every player can switch it off with /inspect.

Requires Hytale 0.6.0 or newer (since v5.0.0). For 0.5.x servers use v4.0.0.

What It Shows

Blocks

Display name (the same name you see when hovering items in your inventory)
Item icon (48x48)
Coordinates (X, Y, Z)
Distance from you in blocks
Block type ID (internal name, useful for admins)
Crafting bench tier (if looking at a crafting bench)
Processing progress (percentage, if a bench is actively processing)
Container contents (item grid, if looking at a chest or container)

Entities & NPCs

Role name (the spawn command name, e.g. "Horse", "Trork_Warrior")
Health with color coding: green (>50%), yellow (25-50%), red (<25%)
Distance from you in blocks

Gold Balance (Optional)

Current balance in gold-yellow, bold
Only shown if the GlymeraMerchant plugin is installed on the server
Updates every 2 seconds
If GlymeraMerchant is not installed, the gold line simply doesn't appear

Commands

Command	Who	Description
`/inspect`	Everyone	Toggle the HUD on/off

The HUD is enabled by default for all players when they join. Use /inspect to hide it, and /inspect again to bring it back. The command needs no permission setup - it is open to everyone, operators included.

Installation

Place GlymeraInspect-6.0.0.jar in your server's mods/ folder
Start (or restart) the server
Done! No config file needed.

Optional: Install GlymeraMerchant alongside for the gold balance display.

Features

50-block range - See info about blocks up to 50 blocks away
Change-detected updates - The panel refreshes as soon as what you look at changes (up to 5 times per second), with a once-per-second heartbeat
Multi-block support - Correctly resolves furniture and multi-block structures to their base block
Inline HUD - Built entirely server-side, no client mods required
Plays nicely with other HUD plugins - Sent as direct HUD packets, so minimaps and other custom HUDs keep rendering alongside it
Toggle per player - Each player can independently show/hide the HUD
Non-intrusive - Compact panel in the bottom-left corner with semi-transparent background
Smart gold integration - Automatically detects if GlymeraMerchant is present, no config needed

Good to Know

GlymeraInspect does not occupy Hytale's custom-HUD registry slot; it renders through direct HUD packets. HUD plugins that back off when they see another custom HUD registered (some minimaps do) therefore keep working. The gold line is included so GlymeraMerchant's balance stays visible in the same panel.
Air/empty blocks are automatically filtered - the HUD only shows info when looking at something solid.
Entity detection has priority over blocks - if you're looking at an NPC standing on a block, you'll see the NPC info.
The gold balance is read from GlymeraMerchant's data files (plugins/GlymeraMerchant/data/balances.json) and cached for 2 seconds to avoid excessive file reads.

Performance

GlymeraInspect is lightweight:
- Raycast is Hytale's native TargetUtil - optimized by the engine
- Throttled updates - at most 5 HUD updates per second per player, and only when something changed; nothing is rebuilt while you keep looking at the same thing
- No file I/O per tick - Gold balance is cached and refreshed every 2 seconds
- No asset pack overhead - HUD is built entirely inline, no texture loading
- Minimal memory - One small HUD object per connected player

Made with care by Glymera for the Hytale community

Changelog

GlymeraInspect - Changelog

v7.0.0 (2026-09-02)

Fixed: HUD error "Failed to apply CustomUI HUD commands" when looking at a chest with modded items
- Reported with Aetherhaven block palettes in a chest. Items from some mods carry extra metadata on the item stack (palette id, custom name and description). Inspect passed the chest contents to the HUD item grid as-is, metadata included, and the client rejected the whole HUD update.
- The HUD now receives a plain copy of each item (item id and count only). Icons and stack counts are unchanged; there is nothing else the grid displays. Works for items from any mod, and for enchanted items with custom names.

v6.0.0 (2026-08-29)

Fixed

/inspect works for every player again. Since the Update 6 rebuild the toggle command was missing its player-permission override, so on 0.6.x only operators could switch the HUD off. The HUD is on by default for everyone; players can now toggle it themselves.
Upgrade: replace the jar, restart. No data or config involved.

v5.0.0 (2026-08-28) — Hytale 0.6.0 (Update 6)

Rebuilt for Hytale 0.6.0 (Update 6). Requires server 0.6.0 or newer; this version does not run on 0.5.x, and older versions of this plugin do not run on 0.6.0.
Migrated to the 0.6.0 APIs (network protocol hytale/3, new command-permission API, block/chunk/entity API changes). Everything that was open to players before is open to players again.
Upgrade: delete the old jar from mods/, drop in the new one and keep the plugin's data folder — configs and saved data carry over unchanged. Restart the server.

v4.0.0 (2026-06-02)

Fixed

Compatibility with other custom-HUD plugins (e.g. FastMiniMap). GlymeraInspect used to register its overlay in the server's HudManager. Some HUD plugins — such as FastMiniMap in its single-HUD compatibility mode — intentionally stop drawing as soon as they detect any other custom HUD registered there, to avoid HUD conflicts. The result was their HUD (for example the minimap) disappearing whenever GlymeraInspect was active. GlymeraInspect now sends its overlay through direct HUD packets and no longer occupies a HudManager registry slot, so those plugins keep rendering. No extra plugins are required for multiple HUDs to coexist.

Changed

Much lighter HUD traffic. The overlay is no longer fully rebuilt and cleared every server tick (30×/sec). Updates are now change-detected and throttled to at most 5×/sec, with a 1×/sec heartbeat, and are sent incrementally (scoped, without clearing the whole HUD layer).
Clean teardown: the overlay is now explicitly removed from all clients when the plugin shuts down or reloads.

Notes

Repositioning via GlymeraHUD still works — GlymeraHUD rewrites the HUD packet by its key, independent of the registry. The live drag-preview for the GlymeraInspect overlay refreshes about once per second.

v2.0.0 (2026-04-02)

Bug Fixes

Critical: Fixed Ghost Block Bug: Changed world.getChunk() to world.getChunkIfInMemory() in the block inspection tick. The old getChunk() call internally invoked loadChunkIfInMemory() which sets ChunkFlag.TICKING on the chunk every tick. This interfered with the server's ReplicateChanges system, causing block update packets to never be sent to clients. The result: any plugin using world.setBlock() (e.g. GlymeraWorker, GlymeraFarmer) would correctly update server-side block data, but clients would see ghost blocks that only disappeared after a server restart.

Technical Details

Root cause: world.getChunk(index) calls loadChunkIfInMemory(index) which executes worldChunkComponent.setFlag(ChunkFlag.TICKING, true). When called every tick from InspectTickSystem, this corrupted the chunk ticking lifecycle, preventing ChunkSystems.ReplicateChanges from processing changedPositions and sending ServerSetBlock packets.
Fix: world.getChunkIfInMemory(index) returns the chunk without modifying the TICKING flag. The chunk is guaranteed to be in memory since the player is nearby.
One line change in updateBlockInfo(): world.getChunk(chunkIdx) -> world.getChunkIfInMemory(chunkIdx)

v1.0.0 (2026-04-01)

Initial release - HUD overlay with block/entity inspection

Only Marc can read this.