hypsum

hypsum

hypsum is a simple way to add placeholders to Hytale servers. It lets you show dynamic information in messages and text. This plugin is both for server administrators as well as developers.

🚀 Features

⚡ Fast: Works quickly without slowing down your server.

🛡 Safe: No infinite loops or broken messages.

👤 Player Names: Can show different things for different players.

⚙️ Customizable: Change how your placeholders look (like using {} instead of %%).

💻 Developer Guide

The latest version of Hypsum API is 1.1. Add Hypsum API to your project using your build tool of choice.

🐘 Gradle

Add this to your build.gradle or build.gradle.kts:

Kotlin

dependencies { compileOnly("com.craftlyworks.hypsum:api:1.1") }

Groovy

dependencies { compileOnly 'com.craftlyworks.hypsum:api:1.1' }

🦢 Maven

Add this to your pom.xml:

<dependency> <groupId>com.craftlyworks.hypsum</groupId> <artifactId>api</artifactId> <version>1.1</version> <scope>provided</scope> </dependency>

📝 Create a Placeholder

Here is how you add a new placeholder:

import com.craftlyworks.hypsum.api.HypsumProvider; import com.craftlyworks.hypsum.api.placeholder.Placeholder;

HypsumApi api = HypsumProvider.get(); api.registerPlaceholder(new Placeholder() { @Override public String getIdentifier() { return "my_placeholder"; }

@Override public String getValue(PlayerRef player) { return "Hello, " + player.getDisplayName(); } });

🔍 Use your Placeholders

To replace placeholders in a string:

String text = "Welcome %my_placeholder%!"; String result = HypsumProvider.get().process(player, text); // Result: "Welcome Hello, PlayerName!"

Make sure to add Hypsum as a dependency in your plugin manifest.json to use these features. If you want an optional integration, use OptionalDependencies instead.

{ "Dependencies": { "com.craftlyworks.hypsum:Hypsum": ">=1.1" } }

Enjoy coding with Hypsum! 🔥

© 2026 CraftlyWorks | Licensed under MIT License