# LiteSignIn

**Repository Path**: theredcreative/litesignin

## Basic Information

- **Project Name**: LiteSignIn
- **Description**: Bukkit/Spigot 简易签到插件 LiteSignIn
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 0
- **Created**: 2024-02-20
- **Last Updated**: 2024-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 插件简介
这个插件本来是我服务器的私人插件，由我专门编写出来给自己服务器用的, 但由于一些特殊原因，我在这里将这个插件发布出来给广大服主们使用, 希望你们能喜欢这个插件。

如有问题，欢迎加入【红色创意｜MC插件综合交流群】群号714363113

# 什么是 LiteSignIn ？
这是一个使用门槛低、不需要编辑一堆花里胡哨选项才能使用的签到插件，虽然叫做简易签到，但它的功能也不少，麻雀虽小五脏俱全。它能保存玩家的签到记录，并且在玩家进行签到的同时给予玩家特定的奖励。 奖励的内容可自定义，并且拥有多种模式，例如连续签到时的奖励、签到总次数达到一定数值时的奖励、指定日期签到时的奖励等。插件拥有一个长得像日历一样的箱子GUI作为签到菜单，所有的权限节点、消息提示、以及GUI内的按钮和功能等**均可自定义**。

# 插件前置
- **Java8以上运行环境**（必须）
- PlaceholderAPI插件（可选）

# 插件功能
- 每日签到，支持在进入游戏时提醒签到
- 拥有一个箱子GUI作为签到菜单
- 支持查看历史记录，以及菜单的翻页（像日历一样）
- 多语言支持（目前支持简体中文、繁体中文、英语、日语）
- 配置文件自动修复（有点难解释，就算你把Config.yml里的东西全删了，插件也能正常运作）
- 支持多种签到奖励形式，例如连续签到的奖励，签到达到一定次数的奖励，指定日期签到的奖励等（看下边）
- 支持PlaceholderAPI，并提供一部分占位符变量
- 支持MySQL数据库储存模式
- 支持SQLite数据库储存模式
- 支持补签，玩家可以使用补签卡对指定遗漏日期进行签到
- 支持使用收藏品相关命令管理特殊nbt的物品（命令/signin itemcollection，详见下方图片）
- 签到排行榜查看
- 使用命令直接给予玩家签到奖励（可以不通过签到直接获得签到奖励）
- 数据库备份
- 数据库回档（需要配合备份功能使用）
- 提供开发者API（包名studio.trc.bukkit.litesignin.api和studio.trc.bukkit.litesignin.event.custom）
- 签到奖励任务顺序编辑
- 自动签到，有特殊权限的玩家进服自动签到
- 多组奖励模式（可开关）同时拥有多个奖励组的权限的玩家可以同时获得这些组的奖励
- 补签卡可以是虚拟道具或者是游戏内特殊nbt的物品
- 支持多权限组，不一样的权限组拥有不一样的签到奖励
- 签到排名功能，你今天是全服第几个玩家签到的呢？
- 告示牌脚本功能，你可以设置玩家在点击木牌时签到（完全自定义，你甚至可以用这个功能来干其他的事情 :D）
- 所有权限节点、消息提示、以及GUI内的一切设置均可自定义（但你要记住这个不是一个自定义菜单插件）
- 还有其他的功能，请自己在使用中探索吧！

## 支持的签到奖励模式
- 默认奖励，每一次签到时所获得的奖励（可以被更高级的奖励覆盖）
- 补签奖励，每一次补签时所获得的奖励
- 连续签到奖励，当玩家连续签到数达到一定次数时触发
- 特别周签到奖励，当玩家在指定星期里签到可触发（例如周日）
- 总计签到奖励，当玩家总计签到数达到一定次数时触发
- 特殊日期签到奖励，当玩家在一年之内某个特殊时期签到（例如12月25号圣诞节，6月1号儿童节等）时获得特定奖励
- 特殊时间段签到奖励，当玩家在某一个时间段进行签到（例如19:30-23:00）时获得特定奖励
- 签到排名奖励，当玩家今日全服签到排名第几位（例如今日全服第一个签到的玩家）时获得特殊奖励
- 每月连续签到奖励，当玩家在每个月连续签到数达到一定次数时触发
- 每月累计签到奖励，当玩家在每个月累计签到数达到一定次数时触发
- 周期性连续签到奖励，当玩家每连续签到数达到一定次数时触发
- 周期性累计签到奖励，当玩家每累计签到数达到一定次数时触发

以上签到奖励均可自定义提示信息、执行多行命令（服务器执行、玩家执行、OP执行）、获得特殊的物品，每一个权限组都可以拥有属于自身的以上奖励类型设置、除了默认奖励和补签奖励以外，其他奖励均可创建无数个子节点，例如连续签到奖励，可以设置连续签到3次、5次、10次等更多次数的奖励，并且它们的奖励都是独立的。

## 命令功能：
按Tab自动补全
|命令 （主命令:/signin 或 /litesignin）|功能
|:- |:- 
|/signin help|查看帮助
|/signin reload|重载配置文件与数据库连接
|/signin gui [月份] [年份]|打开签到菜单
|/signin click [日期/玩家] [玩家]|直接签到，或者对某一日期进行补签
|/signin info [玩家]|查看某个玩家的个人信息
|/signin save|保存当前玩家数据
|/signin itemcollection|管理收藏品
|/signin database|管理数据库（备份、回档等）
|/signin reward|直接给予玩家签到奖励
|/signin leaderboard [日期]|查看签到排行榜
更多命令敬请期待....

## PlaceholderAPI占位符&变量
|占位符/变量名 |作用
|:- |:- 
|%litesignin_signed-in%|该玩家是否已签到
|%litesignin_group%|获取该玩家所在签到权限组
|%litesignin_cards_amount%|获取玩家的补签卡数量
|%litesignin_statistics%|获取玩家的签到总次数
|%litesignin_continuous%|获取玩家当前连续签到的次数
|%litesignin_statistics_of_month%|获取玩家当月签到的总次数
|%litesignin_continuous_of_month%|获取玩家当月连续签到的次数
|%litesignin_queue%|获取玩家今日签到排名
|%litesignin_last_year%|获取上一次签到时的年份
|%litesignin_last_month%|获取上一次签到时的月份
|%litesignin_last_day%|获取上一次签到时的日期
|%litesignin_last_hour%|获取上一次签到时的小时
|%litesignin_last_minute%|获取上一次签到时的分钟
|%litesignin_last_second%|获取上一次签到时的秒

其他占位符&变量:
%litesignin_random_[最小值]_[最大值]% 获取一个随机数 (这只是个小工具，可以用在签到奖励中的命令功能和物品奖励数量)

# 图片展示

---

## 命令使用

![Image](./演示图片/命令使用.png)

---

## 签到功能

![Image](./演示图片/签到功能1.png)
![Image](./演示图片/签到功能2.png)
![Image](./演示图片/签到功能3.png)

---

## 签到排行榜

![Image](./演示图片/签到排行榜.png)

---

## 签到木牌

![Image](./演示图片/签到木牌.png)

---

## 默认配置文件
插件将检测服务器系统语言生成对应语言的配置文件
**注意**，如果你是面板服务器，或者是境外的VPS、独立机，你很有可能得到的是英文版配置文件
- Config.yml
- CustomItems.yml
- GUISettings.yml 1.13+新版
- GUISettings.yml 1.12.2旧版
- Messages.yml
- RewardSettings.yml 1.9+新版
- RewardSettings.yml 1.8.9旧版
- WoodSignSettings.yml

# 插件下载
[**点击跳转**](https://www.spigotmc.org/resources/79584/)

# 结束语
喜欢这个插件且有条件的话，请在SpigotMC上给本插件五星好评，
或者在[**爱发电**](https://afdian.net/a/TRCStudio)支持我，你们的支持就是我更新的动力！
但请注意，你不可以在未授权的前提下转载、借用本插件的源代码，违者必究。

---

**使用统计**
[![BigImage](https://bstats.org/signatures/bukkit/LiteSignIn.svg)](https://bstats.org/plugin/bukkit/LiteSignIn/11849)