NeraxisPlaceholders
Advanced Placeholder Engine / PlaceholderAPI Alternative for Hytale
Build dynamic scoreboards, HUDs, chat formats, tab lines, and UI text with powerful placeholders.
Information
- Product Type: PlaceholderAPI / text parsing backend plugin
- Primary Purpose: Provide dynamic placeholders for scoreboards, chat, HUD, tab, and configurable UI text
- Visual Scope: This plugin does not add a custom in-game menu or GUI by itself
- Integration Model: Output is displayed through other plugins/systems that consume placeholders
Product Overview
NeraxisPlaceholders is a full placeholder system for Hytale servers.
It is designed for both server owners and plugin developers.
This plugin gives you:
- Ready-to-use placeholders for player, server, world, and system data
- Advanced text parser with fallback, modifier chain, nested placeholders, and escaping
- Compatibility placeholders so users can migrate from common public placeholder formats
- Developer API to register custom expansions in your own plugins
SEO-friendly summary: this resource is a Hytale Placeholder API, PlaceholderAPI alternative, and dynamic text engine for scoreboards, chat formatting, and HUD systems.
Who Should Use This
- Server owners who want dynamic text in scoreboards, chat, HUDs, announcements, and UI configs
- Developers who need a clean API for custom placeholders
- Communities migrating from other placeholder plugins
Core Parser Features
- Basic format: %identifier_argument%
- Fallback: %identifier_argument|fallback text%
- Modifier chain: %identifier_argument::upper::truncate:12%
- Nested parse: expansion output can contain placeholders and will be resolved
- Escape literal %: %%
- Unknown placeholders stay unchanged (safe behavior for mixed configs)
Built-in Expansions (Complete)
player
- name, username, uuid, id, language, world_uuid
- x, y, z, pos_x, pos_y, pos_z, position_x, position_y, position_z
- yaw, pitch, roll, rotation_yaw, rotation_pitch, rotation_roll
- position, pos, xyz
- ping_raw, ping_direct, ping_tick
- queued_packets, is_connected, is_local_connection, is_lan_connection
- loaded_chunks, loading_chunks, max_chunks_per_second
server
- name, server_name, motd
- max_players, maxplayers, player_max
- online, online_players, player_count
- worlds, boot_iso, uptime_seconds, uptime_hms
- is_booting, is_booted, is_shutting_down
world
- name, uuid, tick, players
- daytime_seconds, nighttime_seconds
- is_paused, is_ticking, is_alive
system
- plugin_version, ready, expansion_count
- java_version, os_name, os_arch, cpu_cores
- memory_used_mb, memory_free_mb, memory_total_mb, memory_max_mb
- jvm_uptime_seconds, now_iso, now_epoch, request_epoch
Compatibility + Short Aliases
Rival-compatible defaults:
- %player_name%
- %player_uuid%
- %player_pos_x%
- %player_pos_y%
- %player_pos_z%
- %server_online%
- %server_max_players%
- %server_name%
Short aliases without prefix:
- %online% -> %server_online%
- %motd% -> %server_motd%
- %max_players% -> %server_max_players%
- %maxplayers% -> %server_max_players%
- %player_count% -> %server_online%
Supported Modifiers
- upper, lower, trim, capitalize, reverse, length
- fixed:<scale>, round:<scale>
- truncate:<maxLength>
- prepend:<text>, append:<text>
- replace:<from>,<to>
In-Game Usage Examples
Code:
Players: %online%/%max_players%
Server: %server_name%
MOTD: %motd%
Ping: %player_ping_raw|N/A% ms
Pos: %player_pos_x::fixed:1%, %player_pos_y::fixed:1%, %player_pos_z::fixed:1%
Memory: %system_memory_used_mb%MB / %system_memory_max_mb%MB
How Server Owners Use It
- Install the jar in server/mods
- Start server
- Use placeholders in scoreboard/chat/HUD/config files of your plugins
- Optionally use fallback and modifiers for cleaner output
Example config-like lines:
Code:
title: "%server_name%"
line1: "Players: %server_online%/%server_max_players%"
line2: "Name: %player_name%"
line3: "Coords: %player_x::fixed:1%, %player_y::fixed:1%, %player_z::fixed:1%"
line4: "Uptime: %server_uptime_hms%"
How Developers Use The API
Parse text:
Java:
String output = NeraxisPlaceholderApi.setPlaceholders(playerRef, "Hello %player_name%!");
Register custom expansion:
Java:
public final class ExampleExpansion implements PlaceholderExpansion {
@Override public String getIdentifier() { return "example"; }
@Override public String getAuthor() { return "YourName"; }
@Override public String getVersion() { return "1.0.0"; }
@Override
public String onRequest(PlaceholderContext context, String argument) {
return switch (argument) {
case "value" -> "123";
case "hello" -> "Hello " + (context.getPlayer() != null ? context.getPlayer().getUsername() : "Console");
default -> null;
};
}
}
NeraxisPlaceholderApi.registerExpansion(new ExampleExpansion());
Performance and Safety
- Thread-safe expansion registry
- Recursion/depth limit to prevent infinite placeholder loops
- Graceful failure behavior (safe null/blank handling)
- No DRM / no license lock / no hidden telemetry layer in this resource
Requirements
- Hytale Server API compatible with 2026.01.24+
- Java 25
Installation
- Stop the server
- Upload neraxisplaceholders-1.1.0.jar to server/mods
- Start the server
- Use placeholders immediately
Visual Note (Why No Fixed Images)
NeraxisPlaceholders is a PlaceholderAPI-style backend plugin, not a standalone visual UI plugin.
It provides placeholder values and parsing logic, while the final on-screen appearance is controlled by
the plugin or config where placeholders are used (scoreboard plugin, chat formatter, HUD system, etc.).
Because of this architecture:
- There is no single fixed "default interface" to screenshot
- Visual results vary from server to server depending on implementation
- This resource should be evaluated primarily as an API/engine feature plugin
Typical usage contexts:
- Scoreboard lines
- Chat message templates
- HUD/overlay labels
- Status and monitoring text
NeraxisPlaceholders gives your server modern, flexible, and developer-ready placeholders for free.
