开源软件名称：

开源软件地址：

开源软件介绍：

VipSystem

简介

VipSystemEx可以帮你自主管理服务器的vip，支持限时，永久，可切换的vip。本插件使用带索引的SQLite或MySQL进行数据存储，支持自定义开启/关闭连接池，保证了兼容性和高效性。

命令

用法介绍

基础用法

准备工作

将插件安装至服务器，重启
如果你需要使用中文版的插件，请找到/plugins/VipSystem/config.yml
将文件中的lang: en改为lang: zh_CN
并在服务器输入命令/vipsys reload以重载
你不需要额外配置默认组，插件会自动根据权限组插件返回默认组
创建好对应的vip组待命，例如创建一个组名为vip的组
如果你之前使用了旧版本的VipSystem 你可以直接将新版本安装进服务器并删除旧版本 插件会自动进行版本间的配置文件更新和数据结构更新

发放Vip

设玩家名为 Test 需要发放给Test 30天的vip权限组
则输入命令/vipsys give Test vip 30d
玩家可以使用/vipsys me来查看自己的vip情况
若需要移除vip，只需管理员输入/vipsys remove Test即可移除

使用占位符

如果你需要使用VipSystem提供的占位符，你需要安装PlaceholderAPI插件
占位符映射如下

进阶用法

语言设置

插件内置了英语和中文，你可以将配置文件中的lang项目的值改为zh_CN或en来使用插件内置的两种语言
你也可以自定义语言，将lang的值改为语言名之后，重载插件，插件会在messages目录下多生成一个以英文为模板的语言文件，你可以自主修改并重载生效语言文件

UUID模式

如果你的服务器是正版服务器
建议你在配置文件中启用UUID模式uuid: true

默认组设置

插件会根据权限组插件来决定vip到期后返回的权限组
如果你需要修改默认组，请在配置文件中设置 defaultGroup: builder
将返回的默认组改为builder或其他

返回开通前的上一个组

如果你想在玩家Vip到期时返回玩家开通Vip前的权限组
你可以设置previousGroup: true来实现这个功能
注意: 本功能和默认组设置不能同时使用

数据库

插件默认使用HikariCP连接池连接SQLite数据库，如果没有特殊需要，你无需改动该部分配置文件
如果你的服务端无法使用默认配置文件启动，并且报错中有hikarcp字样，请修改usePool的值为false
如果你需要使用MySQL，你可以设置useMySQL的值为true并在下方配置数据库地址等信息

全局Vip

如果你使用GroupManager作为权限组插件，无特殊需要，不需要更改此部分配置
如果你使用PermissionsEx作为权限组插件，并且默认配置下vip无法生效到全部世界，请将isGlobal的值设置为false，如果仍无法生效到全部世界，请在worlds下手动添加你所有的世界名，例如

worlds:  - world  - world_nether  - world_the_end

自定义到期时间格式

如果需要更改日期格式，可以参考https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html的占位符进行修改

自定义命令

你可以自定义vip开通/到期时的命令，下面是默认的配置文件

customCommands:  vip:    activate:      - 'say {0} has activated vip!'      - 'give {0} minecraft:diamond'    expire:      - 'say {0} is no longer a vip'  svip:    activate:      - 'say {0} has activated svip!'      - 'give {0} minecraft:diamond'    expire:      - 'say {0} is no longer a svip'

意思是，在vip开通时，执行下方命令，发送消息并给玩家一个钻石

say {0} has activated vip!give {0} minecraft:diamond

在vip到期时，执行下方命令，发送消息

say {0} is no longer a vip

svip组同理，如果你有更多的vip种类，可以按照上方格式自行添加
如果不需要使用该功能，可以直接整项删除

自定义函数

插件支持你自己编辑自定义函数，来完成一些自动的定时操作
比如你可以通过插件实现临时权限的功能

具体编辑的方法可以查看 https://www.zhanshi123.me/?p=320
上图的功能你可以直接前往https://www.mcbbs.net/thread-959456-1-1.html进行下载

插件下载

该插件为免费插件，但是不提供jar的直接下载地址
你可以clone/fork该项目并自行构建，只需安装maven后进入项目目录，输入mvn install即可自动完成构建。目标文件会生成在/target目录下
如果你没有自行构建的能力，你可以联系作者支付￥20作为赞助，并由作者提供构建后的文件所有支付的款项都是对作者开发极大的支持!

API

使用本插件作为前置(以Maven为例)

<repository>  <id>soldier-repo</id>  <url>https://repo.zhanshi123.me/repository/maven-public/</url></repository>

<dependency>  <groupId>me.zhanshi123</groupId>  <artifactId>VipSystem</artifactId>  <version>4.13</version>  <scope>provided</scope></dependency>

你可以通过VipSystemAPI.getInstance()来获取VipSystemAPI的实例
更多内容待补充

鸣谢

感谢下列用户对插件做出的赞助
(按时间排序)

联系作者

如果你想提交bug，你可以发送issue或加群563012939联系群主获取帮助
你同样也可以通过email联系 Email: [email protected]