WiFlow's PlaceholderAPI

Centralized placeholder system for Hytale. Parse placeholders, create expansions, share data between plugins.

Think PlaceholderAPI but for Hytale.

Features

Universal Placeholders - Use {identifier_placeholder} syntax across all compatible plugins

Built-in Expansions - Player and server placeholders included out of the box

Expansion Marketplace - Download expansions in-game with /WPAPI marketplace

Hot Reload - Load and unload expansions without restarting the server

High Performance - Template caching and MethodHandle reflection for minimal overhead

Public API - Other plugins can parse placeholders and create custom expansions

Quick Start

/WPAPI list - List all loaded expansions /WPAPI parse {player_name} - Test placeholder parsing /WPAPI marketplace list - Browse available expansions /WPAPI marketplace download luckperms - Install an expansion /WPAPI reload - Reload all expansions

Built-in Placeholders

Player

Placeholder Description

{player_name} Player's username

{player_uuid} Player's UUID

{player_world} Current world name

{player_x} X coordinate

{player_y} Y coordinate

{player_z} Z coordinate

{player_online} "true" or "false"

Server

Placeholder Description

{server_online} Online player count

{server_max} Max player slots

{server_tps} Server TPS

{server_memory_used} Used memory (MB)

{server_memory_max} Max memory (MB)

{server_memory_percent} Memory usage %

Marketplace Expansions

Download additional expansions directly in-game:

Expansion Placeholders Required Plugin

LuckPerms prefix, suffix, group LuckPerms

OrbisGuard region, region_owners, region_members, flag_* OrbisGuard

Economy balance, balance_formatted EconomySystem

Hyfaction name, power, members, claims, role Hyfaction

Essentials homes, homes_max, warps Essentials

CombatLog active, time, attacker, attacker_type CombatLog

KillingSpree current, best, kills, deaths, kdr KillingSpree

OrbisMines name, reset_time, resetting, blocks_broken OrbisMines

SimpleClaims claim_owner, is_claimed, can_build, party_* SimpleClaims

/WPAPI marketplace download all - Install all available expansions

All Commands

Command Description

/WPAPI list List loaded expansions

/WPAPI info <id> Show expansion details

/WPAPI parse <text> Parse placeholders in text

/WPAPI reload Reload all expansions

/WPAPI marketplace list [page] Browse marketplace

/WPAPI marketplace info <id> Show expansion info

/WPAPI marketplace download <id|all> Download expansion(s)

/WPAPI marketplace update <id|all> Update expansion(s)

/WPAPI marketplace status Show marketplace status

/WPAPI marketplace refresh Refresh expansion list

/WPAPI marketplace search <query> Search expansions

Aliases: /placeholderapi, /papi, /wfpapi

Installation

Hytale/ └── mods/ ├── WiFlowPlaceholderAPI-1.0.0.jar <- Main plugin └── WiFlowPlaceholderAPI/ └── expansions/ <- Downloaded expansions go here ├── luckperms-1.1.0.jar └── orbisguard-1.1.0.jar

For Developers

Using Placeholders

import com.wiflow.placeholderapi.WiFlowPlaceholderAPI; import com.wiflow.placeholderapi.context.PlaceholderContext;

// Create context for a player PlaceholderContext context = PlaceholderContext.builder() .player(player) .playerUuid(player.getPlayerRef().getUuid()) .playerName(player.getPlayerRef().getUsername()) .worldName(player.getWorld().getName()) .build();

// Parse placeholders String result = WiFlowPlaceholderAPI.setPlaceholders(context, "Hello {player_name}!"); // result: "Hello Steve!" Creating a Custom Expansion

public class MyExpansion extends PlaceholderExpansion {

@Override public String getIdentifier() { return "myplugin"; }

@Override public String getAuthor() { return "YourName"; }

@Override public String getVersion() { return "1.0.0"; }

@Override public String onPlaceholderRequest(PlaceholderContext context, String params) { return switch (params) { case "score" -> getScore(context.getPlayerUuid()); case "level" -> getLevel(context.getPlayerUuid()); default -> null; }; } } Register via ServiceLoader: META-INF/services/com.wiflow.placeholderapi.expansion.PlaceholderExpansion

Full API documentation &rarr;

Support

Questions or issues? Join the Discord server or contact w1fl0w.