玩家时间限制

玩家时间限制

为你的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); // 检查是否已暂停

🧩 要求


📄 许可证

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); // 检查是否已暂停

🧩 要求


📄 许可证

PlayerTimeLimit 是一个采用 All Rights Reserved 许可的项目。
允许在私人、教育和个人服务器中使用。
未经事先授权,不允许公开再分发或修改。


🙌 鸣谢

由 TNTStudios 开发。
旨在促进 Minecraft 社区中负责任、受控且可自定义的游戏体验。

感谢使用 PlayerTimeLimit!🎮