Java Players

Java Players for Aquadactyl A Blueprint addon that adds a Java Players tab to your Minecraft Java servers. The installable package is dist/mcplayers.blueprint. Features • Full player names through Minecraft Query, with the reported online count and capacity. • TCP status fallback clearly labelled as a sample; hidden names are distinguished from an empty server. • Case-insensitive search, alphabetical ordering, individual username copying and copying the returned list. • Automatic refresh every 15 seconds while the page is visible, a manual refresh button and an optional polling toggle. • A responsive charcoal interface that uses the panel's configured primary colour. • Real player avatars and body renders from your Nitrocraft API, with local pixel fallbacks. • Confirmed kick, ban, unban, OP, de-OP and whitelist actions, including offline username lookup. • Read-only inventory, equipment and Ender Chest inspection, item metadata, health, food, XP and saved player state. • Minecraft inventory item images, including 3D block renders, with category icons for modded or unavailable items. • Minecraft hearts, hunger icons and an experience bar showing saved progress toward the next level. • Saved inventory snapshots support both standard Java world/playerdata files and Aquadactyl's world/players/data layout. • Permission checks, a 10-second shared server cache, a concurrency lock and bounded query timeouts. • An admin setup page and inline instructions for enabling the full list. Version 1.1.4 adds the Minecraft HUD for saved health, hunger and XP progress. Version 1.1.3 adds actual Minecraft item images to inventory slots and item details. Version 1.1.2 fixes full Query detection on Paper and other Java servers that identify Minecraft with gameid. Legacy gamename replies are also accepted. Previously, valid full replies using gameid fell back to a status sample even with Query enabled and reachable. Install this update and refresh the Java Players tab. Compatibility Built against Aquadactyl/aquadactyl and its bundled Blueprint beta-2026-08. The addon uses Aquadactyl's React 19, Zustand ServerContext, TanStack Query, Lucide, shared Axios client and GameDig 5.3.3. The PHP backend runs inside the panel and launches the Node query helper through Symfony Process, following the panel's existing game query approach. This release supports Minecraft Java, including compatible modded servers. Proxies must expose their own Minecraft Query or Java status endpoint. Bedrock's status protocol does not return player names and is unsupported. Compatibility with stock Pterodactyl or older Blueprint installations has not been tested. No additional dependencies are installed into the panel, and no core panel files are patched by addon scripts. Blueprint manages the normal route, component and CSS hooks. Removing the extension removes those hooks. Install Copy dist/mcplayers.blueprint into the panel root, then run: Use your actual panel directory if it is different. For Aquadactyl's local Docker stack, run from this addon directory: Blueprint registers the backend and frontend, rebuilds assets and refreshes application caches. Open Admin → Extensions → Java Players for setup instructions. Use the gear button and choose your Minecraft Java eggs under Route eggs. Blueprint defaults to showing the tab on every egg; other games show a clear unsupported message. Server owners and administrators can view the page. Subusers need the existing Send console commands (control.console) permission. The backend enforces both server membership and this permission; hiding a navigation item alone is not the access check. | Feature | Required permission | | --- | --- | | Player list, profiles, kick, ban, unban and whitelist actions | Send console commands (control.console) | | OP and de-OP | Server owner or panel administrator, with console access | | Saved inventory | Console access plus List files (file.read) and Read file contents (file.read-content) | Every backend endpoint enforces these permissions. Actions require confirmation, accept only supported commands and valid Java usernames, and are recorded in the panel activity log. The response means the command was submitted to Wings; check the console for Minecraft's actual result. Whitelist actions change the list, not the server's whitelist enable setting. Commands require a running server. Nitrocraft profiles No API key is needed for the documented public player, avatar and body-render endpoints. The browser resolves usernames through https://nitrocraft.uk/players/, then loads avatars and body images from the same service. Identity lookups are cached for 20 minutes, shared between the list and dialog, and avatars load as they approach the visible area. Requests omit panel credentials and referrers. Failed skin requests leave a local pixel avatar or an unavailable message. Nitrocraft provides skins and profile identity. Server actions and inventory inspection use Aquadactyl's authenticated backend and Wings. Nitrocraft UUIDs are not used to locate server saves, which can use different offline-mode UUIDs. Saved inventory snapshots Open Manage beside a player, or enter an offline username, then select Saved inventory. The addon reads the world configured by level-name in server.properties, checking both playerdata/.dat and players/data/.dat under that world. It resolves the server's UUID from usercache.json, then a supplied Java status UUID, then the offline UUID fallback. If an online-mode player's UUID is absent from the cache and status sample, their save may not be discoverable by username alone. The viewer supports legacy item tags, modern item components and the newer equipment compound. It shows main inventory, hotbar, armour, offhand, Ender Chest, item IDs and metadata, selected slot, health, food, XP, location and state from ops.json, banned-players.json and whitelist.json. The save timestamp is shown when Wings provides it; unavailable state is labelled unknown. Refresh rereads the files without forcing Minecraft to save. These are saved, read-only snapshots, not live inventories. Minecraft may have unsaved changes, and custom plugin storage formats are not supported. No Minecraft plugin or RCON is required. Inspection never changes player data. NBT decoding, file sizes, nesting, item metadata and request rates are bounded. Health, hunger and experience The inventory HUD uses the game's full, half and empty heart and hunger sprites, with a green XP bar and a separate level number. Fractional HP is displayed numerically; hearts round upward to the next half heart, as in the game. Health above 20 adds extra hearts, up to 50 icons, while the number shows the saved HP. Hunger fills from right to left on its standard 20-point scale. XP bar progress comes from the saved XpP fraction, independently of XpLevel. Missing or invalid progress is labelled unavailable rather than inferred from the level. Missing health and hunger are labelled unknown. These values retain the same saved-snapshot limitations as the inventory. The eight Minecraft 26.3 HUD sprites are bundled with the addon and served by the panel, so they need no external image request. Sources and attribution are in components/hud/README.md. Item images Vanilla items use native Minecraft inventory renders from Owen1212055/mc-assets, covering tools, armour and 3D blocks. The addon uses the Minecraft 26.3 collection at fixed revision bc96011714c0eb3770bd641a3b86459ad5f860c7, delivered through jsDelivr. Images load lazily, remain crisp when scaled, and use the existing category icon while loading or if an image fails. Item details show a larger image. Only validated vanilla minecraft: IDs select remote images. Modded namespaces use category icons. Images depict the default item model; resource packs, custom models, potion colours and other metadata-based visual variants are not rendered. The browser sends only the vanilla item name to the image host, with anon