资源图标

[API/机制]PlaceholderAPI —— TR界的万用占位符它来了?[2.1] 1.0.0.7

没有下载许可
英文名称
PlaceholderAPI
中文名称
万用变量符
来源
原创
API类型
TerrariaServerAPI
插件类型
  1. 综合
  2. 信息
  3. API
语言支持
  1. 简体中文
适用版本
  1. 1.4
前置Mod/插件
TShock
原帖地址
此处
开源地址
https://github.com/BeanPaste233/PlaceholderAPI
API版本
2.1
PlaceholderAPI
万用占位符

简介​
你也许听说过MC界的PlaceholderAPI,这款插件的功能与其类似,方便插件用户在提示文本上提高自定义度,防止插件开发者重复造轮子,可以快速地使用此插件来注册相应的变量名。PlaceholderAPI 是一个插件/库,它允许服务器使用您喜欢的各种插件中的占位符(变量)

使用方法​
  • 对于腐竹:如果服务器有使用以该插件作为前置的插件,将此插件下载下来扔进插件文件夹重启即可
  • 对于开发者:下面是一段插件内置的测试代码
QQ截图20220317230658.png代码1是用来注册你的占位符
代码2是注册占位符执行替换前的钩子
OnGetText()方法就是用来给你的占位符传值的
PlaceholderAPI.Instance.placeholderManager.GetText(text,args.Player);就是获取处理后的文本 返回值是string类型
*值得注意的是最新版插件已经不用那么长来调用方法了,直接使用PlaceholderAPI.GetText()即可

测试图片​
QQ截图20220317231035.png
可以看到 他把我们的{player} 换成了 预先设置好的 BeanPasteTest

关于占位符的注册​
插件是不允许注册相同的占位符的,在这里做个规范统一一下,比如用{}给括起来或者使用%%给括起来也是可以的。

插件当前已注册占位符->
{player} 玩家名字
{group} 玩家所在组别
{helditem} 玩家手持物品ID
{region} 玩家所在区域
{playerDead} 玩家死亡状态
{playerMaxHP} 玩家最大血量
{playerMaxMana} 玩家最大蓝量
{playerHP} 玩家当前血量
{playerMana} 玩家当前蓝量

颜色代码参考​
图中的ss字符 更改为&即可
QQ截图20220404102136.png

尾言​
当前插件还处于测试阶段,很多代码都不是很成熟,欢迎广大插件开发者进行对接,帮助完善此插件。
有什么BUG和建议可以在帖子下方评论,我都会回复。有问题要及时反馈,创建良好插件交流板块从你我做起。

最新更新

  1. 新版本V1.0.0.7更新内容

    修复部分颜色字吞字现象(未测试) 调用GetText()方法时不用再绕一大串可直接使用PlaceholderAPI.GetText() 支持最新版TShock
  2. 新版本V1.0.0.6更新内容

    适配BeanChat复杂聊天栏上色乱码问题 修复玩家聊天栏展示物品乱码问题
  3. 新版本V1.0.0.5更新内容

    更新&+数字或字母 进行文本的上色 符合某些MC腐竹的使用习惯,也简化了繁琐的上色过程

* 这是一则由 Google AdSense 自动推荐的广告,与本站无关,不对其真实性与可靠性负责

顶部