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
• Remote Expansions - Download expansions in-game with /WPAPI exp
• 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 exp list                 - Browse available expansions
/WPAPI exp download luckperms   - Install an expansion
/WPAPI reload                   - Reload all expansions

Built-in Placeholders

Player

Server

Available Expansions

Download additional expansions directly in-game:

/WPAPI exp download all  - Install all available expansions

Third-Party Downloads & Data Storage

This plugin downloads expansion files from a third-party website. Here's how it works:

Download Source

Expansions are downloaded from the official WiFlow documentation site:

• API Endpoint: https://docs.wiflow.dev/api/ecloud/
• Expansion List: https://docs.wiflow.dev/api/ecloud/expansions

All expansion files are hosted on Cloudflare Pages infrastructure with HTTPS encryption.

What Gets Downloaded

• Expansion JAR files (Java plugin code)
• Expansion metadata (name, version, author, description)

Where Data is Stored

Downloaded expansions are saved locally to your server:

mods/WiFlowPlaceholderAPI/expansions/   <- Downloaded JAR files
mods/WiFlowPlaceholderAPI/cache/        <- Cached expansion data (auto-expires)

No data is uploaded or sent to external servers. The plugin only makes read-only GET requests to fetch expansion files.

Security Measures

• HTTPS Only - All downloads use encrypted HTTPS connections
• Checksum Verification - Downloaded files are verified against SHA-256 checksums before loading
• Sandboxed Loading - Expansions run in isolated classloaders with limited permissions
• Open Source - All official expansion source code is available on GitHub
• Manual Review - All marketplace expansions are manually reviewed before publishing

When you use the /WPAPI exp download command, expansion files are downloaded from the cloud at docs.wiflow.dev.

All Commands

Aliases: /placeholderapi, /papi, /wfpapi

Installation

Hytale/
└── mods/
    ├── WiFlowPlaceholderAPI-1.0.1.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 →

Support

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