
玩家时间限制
为你的Minecraft服务器上的玩家设置每日游戏时间限制。
🇬🇧 English
⏱ 玩家时间限制模组
PlayerTimeLimit 是一个服务端(非客户端)的 Minecraft Fabric 模组,允许为每位玩家设置每日游戏时长限制、每日重置,并通过命令和公共 API 管理这些时间。非常适合教育、家庭或受控游玩服务器。
📌 功能
- ⏳ 可为每位玩家配置每日时间。
- ⚠️ 可在时间耗尽前自定义警告。
- 📤 时间结束时自动踢出。
- 🔁 基于时区的每日自动重置。
- 💬 可自定义消息。
- 🧠 支持离线玩家(缓存 UUID)。
- 📊 屏幕上显示信息丰富的 BossBar。
- 🔒 支持 LuckPerms 权限。
- 📦 面向其他模组的公共 API。
🧪 命令
所有命令都以 /plt 开头,并支持玩家自动补全,即使玩家离线也可使用。
/plt check <player> # 显示剩余时间
/plt info <player> # 显示详细状态(时间、暂停、耗尽)
/plt addtime <player> <sec> # 为玩家增加时间
/plt removetime <player> <sec> # 从玩家处移除时间
/plt resettime <player> # 将时间重置为默认值
/plt pause <player> # 暂停玩家的时间计数器
/plt resume <player> # 恢复时间计数器
/plt reload # 重新加载 YAML 配置文件
🔐 LuckPerms 权限
每条命令都需要特定权限,你可以使用 LuckPerms 等插件进行分配:
| 权限 | 描述 |
|---|---|
PLimitTime.admin |
访问所有命令 |
PLimitTime.command.check |
查看玩家时间和信息 |
PLimitTime.command.addtime |
为玩家增加时间 |
PLimitTime.command.removetime |
从玩家处移除时间 |
PLimitTime.command.resettime |
重置玩家时间 |
PLimitTime.command.pause |
暂停玩家的时间 |
PLimitTime.command.resume |
恢复玩家的时间 |
PLimitTime.command.reload |
重新加载 YAML 配置 |
✅ 如果 LuckPerms 不可用,将使用
hasPermissionLevel(4)(操作员)作为回退方案。
⚙️ YAML 配置
路径:config/playertimelimit.yaml
defaultTime: 18000
reset:
time: "00:00"
timezone: "America/Mexico_City"
warnings:
- time: 1800
message: "⏳ 剩余 30 分钟游玩时间。"
- time: 900
message: "⏳ 剩余 15 分钟游玩时间。"
- time: 120
message: "⏳ 还剩 2 分钟。做好准备!"
messages:
timeExpired: " 你今天的游玩时间已结束。明天见!"
welcome: " 欢迎!你还有 %time% 秒的游玩时间。"
timeAdded: " 已为你的会话增加 %time% 秒!"
timeRemoved: " 已从你的会话中移除 %time% 秒。"
timeReset: " 你的时间已重置为 %time% 秒。"
paused: "✨ 你的时间当前已暂停。"
bossbar:
message: "剩余时间:%hours%h %minutes%m %seconds%s"
color: WHITE
🧩 公共 API
该模组公开了一个公共 API,用于与其他模组集成。你可以通过以下方式访问:
import com.TNTStudios.playertimelimit.Playertimelimit;
import com.TNTStudios.playertimelimit.api.PlayerTimeLimitAPI;
PlayerTimeLimitAPI api = Playertimelimit.getAPI();
// 使用示例
api.addTime(uuid, 300); // 增加 5 分钟
api.removeTime(uuid, 60); // 减少 1 分钟
api.pause(uuid); // 暂停时间
api.resume(uuid); // 恢复时间
int time = api.getTime(uuid); // 获取剩余时间
boolean paused = api.isPaused(uuid); // 检查是否已暂停
🧩 要求
- Fabric API
- Java 17+
- LuckPerms 用于高级权限管理。
📄 许可证
PlayerTimeLimit 是一个采用 All Rights Reserved 许可的项目。
允许在私人、教育和个人服务器中使用。
未经事先授权,不允许公开再分发或修改。
🙌 鸣谢
由 TNTStudios 开发。
旨在促进 Minecraft 社区中负责任、受控且可自定义的游戏体验。
感谢使用 PlayerTimeLimit!🎮
🇪🇸 Español
⏱ 玩家时间限制模组
PlayerTimeLimit 是一个服务端(非客户端)的 Minecraft Fabric 模组,允许为每位玩家设置游戏时间限制、每日重置,并通过命令和公共 API 管理这些时间。非常适合教育、家庭或受控游玩服务器。
📌 功能
- ⏳ 可为每位玩家配置每日时间。
- ⚠️ 可在时间耗尽前自定义警告。
- 📤 时间结束时自动踢出。
- 🔁 基于时区的每日自动重置。
- 💬 可自定义消息。
- 🧠 支持离线玩家(缓存 UUID)。
- 📊 屏幕上显示信息丰富的 BossBar。
- 🔒 支持 LuckPerms 权限。
- 📦 面向其他模组的公共 API。
🧪 命令
所有命令都以 /plt 开头,并支持玩家自动补全,即使玩家离线也可使用。
/plt check <jugador> # 显示剩余时间
/plt info <jugador> # 显示详细状态(时间、暂停、耗尽)
/plt addtime <jugador> <seg> # 为玩家增加时间
/plt removetime <jugador> <seg> # 从玩家处移除时间
/plt resettime <jugador> # 将时间重置为默认值
/plt pausar <jugador> # 暂停玩家的时间计数器
/plt reanudar <jugador> # 恢复时间计数器
/plt reload # 重新加载 YAML 配置文件
🔐 LuckPerms 权限
每条命令都需要特定权限,你可以使用 LuckPerms 等插件进行分配:
| 权限 | 描述 |
|---|---|
PLimitTime.admin |
访问所有命令 |
PLimitTime.command.check |
查看玩家时间和信息 |
PLimitTime.command.addtime |
为玩家增加时间 |
PLimitTime.command.removetime |
从玩家处移除时间 |
PLimitTime.command.resettime |
重置玩家时间 |
PLimitTime.command.pausar |
暂停玩家的时间 |
PLimitTime.command.reanudar |
恢复玩家的时间 |
PLimitTime.command.reload |
重新加载 YAML 配置 |
✅ 如果 LuckPerms 不可用,将使用
hasPermissionLevel(4)(操作员)作为回退机制。
⚙️ YAML 配置
路径:config/playertimelimit.yaml
tiempoPorDefecto: 18000
reinicio:
hora: "00:00"
zonaHoraria: "America/Mexico_City"
advertencias:
- tiempo: 1800
mensaje: "⏳ 剩余 30 分钟游玩时间。"
- tiempo: 900
mensaje: "⏳ 剩余 15 分钟游玩时间。"
- tiempo: 120
mensaje: "⏳ 还剩 2 分钟。做好准备!"
mensajes:
tiempoAgotado: " 你今天的游玩时间已结束。明天见!"
bienvenida: " 欢迎!你还有 %tiempo% 秒的游玩时间。"
tiempoAgregado: " 已为你的会话增加 %tiempo% 秒!"
tiempoRemovido: " 已从你的会话中移除 %tiempo% 秒。"
tiempoRestablecido: " 你的时间已重置为 %tiempo% 秒。"
pausado: "✨ 你的时间当前已暂停。"
bossbar:
message: "剩余时间:%horas%h %minutos%m %segundos%s"
color: WHITE
🧩 公共 API
该模组公开了一个公共 API,用于与其他模组集成。你可以通过以下方式访问:
import com.TNTStudios.playertimelimit.Playertimelimit;
import com.TNTStudios.playertimelimit.api.PlayerTimeLimitAPI;
PlayerTimeLimitAPI api = Playertimelimit.getAPI();
// 使用示例
api.addTime(uuid, 300); // 增加 5 分钟
api.removeTime(uuid, 60); // 减少 1 分钟
api.pause(uuid); // 暂停时间
api.resume(uuid); // 恢复时间
int tiempo = api.getTime(uuid); // 查询剩余时间
boolean pausado = api.isPaused(uuid); // 检查是否已暂停
🧩 要求
- Fabric API
- Java 17+
- LuckPerms 用于高级权限管理。
📄 许可证
PlayerTimeLimit 是一个采用 All Rights Reserved 许可的项目。
允许在私人、教育和个人服务器中使用。
未经事先授权,不允许公开再分发或修改。
🙌 鸣谢
由 TNTStudios 开发。
旨在促进 Minecraft 社区中负责任、受控且可自定义的游戏体验。
感谢使用 PlayerTimeLimit!🎮
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。