Allay 官方变量 API 插件,灵感源自 Spigot 平台上著名的 PAPI 插件。
Maven / Gradle 依赖配置:
代码:
repositories {
mavenCentral()
}
dependencies {
// 引入 PAPI 核心依赖
compileOnly(group = "org.allaymc", name = "papi", version = "0.2.0")
}
代码调用示例:
Java:
@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
var joinMessage = "{player_name} 加入了服务器!他的游戏模式是 {game_mode}";
// 调用 PAPI 解析变量
joinMessage = PlaceholderAPI.getAPI().setPlaceholder(event.getPlayer(), joinMessage);
event.setJoinMessage(joinMessage);
}
坐标与基础信息:
- {x}, {y}, {z} - 玩家坐标
- {player_name} - 玩家 ID
- {player_display_name} - 玩家显示名称
- {ping} - 玩家延迟
- {locale} - 玩家语言设置
状态与属性:
- {health} / {max_health} - 血量信息
- {food_level} - 饥饿值
- {exp_level} / {exp_progress} - 经验等级与进度
- {game_mode} - 游戏模式
- {is_sneaking} - 是否潜行(还包括冲刺、飞行、游泳等状态)
装备与背包:
- {hand_item} - 主手物品
- {offhand_item} - 副手物品
- {helmet_item} - 头盔(及其他护甲槽变量)
服务器与环境:
- {online} / {max_online} - 在线人数
- {dimension} - 维度名称
- {date} / {time} - 现实日期与时间
- {mc_version} - 游戏版本
- Java 版本: 21 或更高
- Allay 版本: 0.17.0 或更高
欢迎 Fork 本仓库并提交 Pull Request 来完善代码。
本项目采用 LGPL v3 许可证授权。