海普森

hypsum

hypsum是一种为Hytale服务器添加占位符的简单方式。它让你可以在消息和文本中显示动态信息。本插件既适用于服务器管理员，也适用于开发者。

🚀 功能特性

• ⚡ 快速：工作迅速，不会拖慢你的服务器。
• 🛡 安全：无无限循环或损坏的消息。
• 👤 玩家名称：可为不同玩家显示不同内容。
• ⚙️ 可自定义：更改占位符的外观（例如使用{}代替%%）。

💻 开发者指南

Hypsum API的最新版本是1.1。 使用你选择的构建工具将Hypsum API添加到你的项目中。

🐘 Gradle

将其添加到你的build.gradle或build.gradle.kts文件中：

Kotlin

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

Groovy

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

🦢 Maven

将其添加到你的pom.xml文件中：

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

📝 创建一个占位符

以下是你添加一个新占位符的方法：

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();
    }
});

🔍 使用你的占位符

在字符串中替换占位符：

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

确保在你的插件manifest.json文件中将Hypsum添加为依赖项，以使用这些功能。 如果你想要一个可选的集成，请使用OptionalDependencies代替。

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

祝你使用Hypsum愉快编程！🔥

---

© 2026 CraftlyWorks | 依据MIT许可证授权