• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
资源图标

授权转载 Allay PlaceHolder - 变量前置插件 v0.2.0

完成注册/登录后下载
版权类型
授权转载
版权链接
https://github.com/AllayMC/PlaceholderAPI
语言支持
English
前置组件
Allay
适配版本(基岩)
  1. 全版本
🧩 PlaceholderAPI
papi


Allay 官方变量 API 插件,灵感源自 Spigot 平台上著名的 PAPI 插件。




📥 安装方法
  • ReleaseAction 下载 .jar 文件。
  • 将其放入 plugins 文件夹中。
  • 重启服务器即可!




🛠️ 开发使用

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 许可证授权。
后退
顶部 底部