MiniPlayerTitle

青春版 PlayerTitle 玩家称号插件。

Go to file

zhangyuheng b6fa012ed0 All checks were successful Java CI-CD with Maven / build (push) Successful in 58m15s Details 修复了sqlite报错问题		2024-04-05 21:01:02 +08:00
.gitea/workflows	修改CI-CD go为国内镜像	2024-03-25 11:09:06 +08:00
.github/workflows	add github CI-CD	2024-01-18 10:00:14 +08:00
resources	update README.md & logo	2024-03-28 11:09:08 +08:00
src/main	修复了sqlite报错问题	2024-04-05 21:01:02 +08:00
.gitignore	init project	2024-01-04 00:20:08 +08:00
LICENSE	Initial commit	2024-01-03 23:48:38 +08:00
pom.xml	修复了sqlite报错问题	2024-04-05 21:01:02 +08:00
README.md	新增sqlite支持	2024-04-05 20:05:23 +08:00

README.md

开源地址 | 文档地址

简易玩家称号插件

PlayerTitle 青春版

说明

本插件为 PlayerTitle 的简易版，基本实现了其大部分功能
由于历史原因 PlayerTitle 使用玩家名称而非 UUID 作为数据库主键，因此玩家改名后称号会丢失，本插件使用 UUID 作为主键，不会出现该问题

功能介绍

本插件支持 PlayerTitle 的新版RGB颜色格式（详情见下文）
支持 PostgresSQL 和 Sqlite 数据库
本插件使用 TUI 作为简易的交互方式，非 PlayerTitle 的箱子UI
支持设置称号限量销售、限时销售
支持玩家使用称号币自定义称号

支持版本

1.20.1+ (Paper、Folia)

安装方法

将插件放入服务器的 plugins 目录下
重启服务器
在 plugins/MiniPlayerTitle/config.yml 中配置
重启服务器

使用方法

使用 /mplt 指令打开 TUI 界面

主页

点击【称号背包】可查看自己拥有的所有称号；
点击【称号商店】可查看商店中出售的称号；
点击【自定义称号】可查看自定义称号的相关帮助信息；

称号背包

称号背包中会显示当前拥有的所有称号以及相应到到期时间。
点击【卸下】可以取消当前正在使用的称号，点击【使用】会装备对应称号或替换当前称号。
每页最多显示5条信息，可以点击【下一页】向后翻页。
鼠标移动到称号上可以显示相应称号的描述信息。
称号有效期只能精确到天，例如：20240115表示此称号将在2024年1月16日开始无法使用。

称号商店

称号商店会显示称号销售列表、拥有的称号币余额、出售称号的价格、可购买天数、销售截止日期、可购买余量信息。
每页最多显示5条信息，可以点击【下一页】向后翻页。
点击【购买】即可购买相应的称号，称号购买后不会自动装备，需要前往背包手动使用。
在一个称号没有过期时无法再次购买此称号。
售卖截止日期只能精确到天。

自定义称号

在自定义称号帮助页面会显示当前管理员配置的自定义称号规则。
如果自定义称号处于【开启】状态，那么玩家可以消耗称号币自定义喜欢的称号。
自定义称号支持RGB彩色字，需要使用 &#为开头的十六进制RGB颜色代码表示颜色，例如&#000000表示黑色。可以使用 Minecraft 渐变颜色生成器来生成具有渐变效果的称号。
创建成功后会自动扣除所需的花费。

管理员指南

0. 数据库

如果使用 Postgresql 数据库，需要手动创建数据库。

如果使用 sqlite 数据库，插件会自动在插件目录下创建数据库文件。配置文件内的 Host、Port、User、Pass 字段不会被使用。

1. 创建称号

使用 /mplt create [称号名称] [称号描述] 创建称号，称号支持RGB彩色字，需要使用 &#为开头的十六进制RGB颜色代码表示颜色，例如&#000000表示黑色。可以使用 Minecraft 渐变颜色生成器来生成具有渐变效果的称号。

创建成功后会显示创建称号的 ID 以及称号名。

2. 添加到商店

使用/mplt addshop [称号ID] 添加称号到商店，添加成功后会显示添加的商品ID。

添加到商店的默认销售信息为：0元购买0天、常驻销售、0库存，需要使用相应指令设置称号的销售信息，此默认配置是无法购买的（因为库存和销售天数都是0）。

3. 设置销售信息

首先使用/mplt setprice [商品ID] [价格] [天数] 设置称号的价格信息，例如可以设置成 1 个称号币购买 7 天/mplt setprice [商品ID] 1 7 。如果你希望这是一个永久称号，那么你可以将天数设置为-1。

接着需要使用/mplt setamount [商品ID] [数量] 设置称号出售数量。同理，如果你希望这是一个无限供应的称号，那么可以将数量设置为-1则表示无限量销售。

假如你希望这个称号是一个限时销售的称号可以使用/mplt setendat [商品ID] [结束时间] 设置称号结束销售时间，时间格式为 YYYYMMDD ，在超过这个日期后玩家将无法购买此称号（但是仍然会显示在商店列表里）。

将销售结束时间设置为-1可以将其重新修改为常驻销售。

4. 其他操作

其他操作详见下方的管理员指令说明。

提示：

你可以安全的删除一个称号，此操作会自动删除玩家拥有的此称号记录以及商店的相关数据。
修改称号的名称、描述也会同步变动玩家已经购买的称号信息。
修改商店的购买有效期不会改变玩家已购买的时间。
一个称号可以多次被添加到商店，因此你可以将一个称号以多种不同的销售方式添加到商店，例如：1币购买1天，5币购买7天，100币购买永久。

指令

玩家指令

/mplt 打开 TUI 界面

/mplt use [称号ID] 使用称号

/mplt list [页数(可选)] 查看已拥有的称号

/mplt shop [页数(可选)] 查看商店

/mplt buy [商品ID] 购买称号

/mplt custom [称号名称] 自定义称号

/mplt custominfo 查看自定义称号帮助

管理员指令

/mplt create [称号名称] [称号描述] 创建称号

/mplt delete [称号ID] 删除称号

/mplt setdesc [称号ID] [描述] 设置称号描述

/mplt setname [称号ID] [名称] 设置称号名称

/mplt addshop [称号ID] 添加称号到商店

/mplt removeshop [商品ID] 从商店移除称号

/mplt setprice [商品ID] [价格] [天数(-1为永久)] 设置称号价格

/mplt setamount [商品ID] [数量(-1为无限)] 设置称号出售数量

/mplt setendat [商品ID] [结束时间(格式：YYYYMMDD -1为永久)] 设置称号销售结束时间

/mplt listall [页数(可选)] 查看所有称号

/mplt addcoin [玩家名称] [数量] 给玩家添加称号币

/mplt setcoin [玩家名称] [数量] 设置玩家称号币数量

配置文件参考

# 数据库配置
Database:
  Type: sqlite # pgsql, sqlite
  Host: localhost
  Port: 5432
  Name: miniplayertitle
  User: miniplayertitle
  Pass: miniplayertitle

# 称号前缀后缀
Prefix: "["
Suffix: "]"

# 自定义称号配置
CustomCost:
  Enabled: true
  Cost: 1000
  MaxLength: 8

# 玩家称号币初始值
DefaultCoin: 0

Debug: false

TODO

建议与反馈

Mail: zhangyuheng@lunadeer.cn

QQ: 2751268851

README.md Unescape Escape