PlayerTimeLimit - 玩家时间限制

💡简介

PlayerTimeLimit 是一款用于管理玩家游戏时长的插件。它允许你为服务器或特定世界设置时间限制，例如每天 2 小时或每周 6 小时。当玩家时间用尽时，将被踢出服务器并无法再次加入，直到时间重置。此插件最初灵感来源于 YouTube 上的 Minecraft 系列，但也适用于其他场景。你甚至可以为服务器上的每个等级设置不同的时间限制。

🎮核心功能

• 时间限制与执行：时间耗尽的玩家会被踢出服务器，并阻止其再次加入。
• 按等级设置限制：可为不同权限组（Rank）设置独立的游戏时长。
• 多种重置模式：支持每日、每周、每月重置，或通过命令手动重置。
• 世界白名单系统：可指定仅在某些世界计算或不计入游戏时间。
• 实时信息显示：通过 Boss 血条或动作栏（Action Bar）向玩家显示剩余时间。
• 玩家通知系统：当时间将尽或耗尽时，可通过消息、居中消息、执行命令、播放音效、显示标题等方式通知玩家。
• 完整的命令集：提供时间查询、添加、扣除、重置等管理命令。
• PlaceholderAPI 支持：可与其他插件联动，显示自定义变量。
• 版本兼容性：支持 1.16.5 及以上版本，仅适用于 Spigot/Paper 服务端（不兼容 CraftBukkit）。

🔧快速开始

安装与准备

• 下载插件并将其放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件。
• 确保已安装权限管理插件（如 LuckPerms），以便为玩家分配命令权限和特定的时间限制。

配置与帮助

插件的完整配置说明与详细教程，请查阅官方 Wiki：

https://ajneb97.gitbook.io/playertimelimit

⭐命令列表

命令别名：/playertimelimit

• /ptl message - 为自己开启或关闭时间限制信息提示。
• /ptl info - 查看距离下次游戏时间重置的剩余时间。
• /ptl check (玩家名) - 查看自己或指定玩家的剩余游戏时间及总时长。
• /ptl resettime <玩家名>/* - 重置指定玩家或所有玩家的游戏时间。
• /ptl addtime <玩家名> <时间> - 为指定玩家增加游戏时间。
• /ptl taketime <玩家名> <时间> - 扣除指定玩家的游戏时间。
• /ptl reload - 重载插件配置文件。

✨权限节点

• playertimelimit.admin - 授予所有插件命令的使用权限。
• playertimelimit.commands.message - 允许使用 /ptl message 命令。（默认开启）
• playertimelimit.commands.info - 允许使用 /ptl info 命令。（默认开启）
• playertimelimit.commands.check - 允许使用 /ptl check 命令。（默认开启）
• playertimelimit.commands.check.others - 允许使用 /ptl check <玩家名> 命令查看他人时间。
• playertimelimit.limit.<组名> - 此权限将为玩家设置配置文件中定义的特定时间限制。

❓注意事项与支持

• 请确保在 Spigot 或 Paper 服务端上运行本插件。
• 在给予差评前，请先尝试联系解决遇到的问题。
• 如遇任何 Bug 或问题，请通过 私信 或在 插件讨论区 发帖联系我，我会尽快查看。
• 欢迎提出新功能建议，让插件变得更好。

💡PlayerTimeLimit

PlayerTimeLimit 是一款用于限制玩家在服务器上游戏时长的插件。它允许管理员为不同玩家或权限组设置每日、每周或每月的游戏时间上限，时间用尽后，玩家将被踢出服务器，直到下一个周期重置。插件支持多种时间单位、自定义消息、时间查看命令，并能与 PlaceholderAPI 集成，方便在菜单或计分板中显示剩余时间。

🎮功能特性

• 灵活的时间限制：可为玩家或权限组设置每日、每周或每月的游戏时间限制。
• 多种时间单位：支持秒、分钟、小时、天、周和月作为时间单位。
• 时间重置：时间限制会在每个周期（每日/每周/每月）自动重置。
• 自定义消息：可配置玩家被踢出、时间警告、时间重置等所有提示消息。
• 时间查看：玩家和管理员可以使用命令查看剩余时间。
• PlaceholderAPI 支持：提供占位符，可在其他插件中显示玩家的剩余时间等信息。
• 数据存储：使用 YAML 或 MySQL 存储玩家时间数据。
• 多语言支持：内置多种语言文件，可轻松切换。
• 时间豁免：可为特定玩家或拥有特定权限的玩家免除时间限制。
• 时间赠送/设置：管理员可以给玩家赠送额外时间或直接设置其剩余时间。

🔧命令与权限

玩家命令

• /tiempo - 查看自己的剩余游戏时间。

- 权限：`playertimelimit.command.tiempo` (默认所有玩家拥有)

管理员命令

• /tiempo <玩家名> - 查看指定玩家的剩余游戏时间。

- 权限：`playertimelimit.command.tiempo.others`

• /tiempoadmin help - 显示管理命令帮助。

- 权限：`playertimelimit.command.tiempo.admin`

• /tiempoadmin reload - 重载插件配置和语言文件。

- 权限：`playertimelimit.command.tiempo.admin`

• /tiempoadmin give <玩家名> <时间数量> [时间单位] - 给予玩家额外的游戏时间。

- 权限：`playertimelimit.command.tiempo.admin`

• /tiempoadmin set <玩家名> <时间数量> [时间单位] - 设置玩家的剩余游戏时间。

- 权限：`playertimelimit.command.tiempo.admin`

• /tiempoadmin reset <玩家名> - 重置指定玩家的计时数据。

- 权限：`playertimelimit.command.tiempo.admin`

• /tiempoadmin resetall - 重置所有玩家的计时数据。

- 权限：`playertimelimit.command.tiempo.admin`

主要权限节点

• playertimelimit.bypass - 拥有此权限的玩家不受时间限制。
• playertimelimit.unlimited - 拥有此权限的玩家拥有无限游戏时间。

✨安装与配置

安装步骤

• 将下载的 PlayerTimeLimit.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹。
• 根据需求编辑 plugins/PlayerTimeLimit/config.yml 文件。
• 如需更改语言，可编辑 plugins/PlayerTimeLimit/messages_语言代码.yml 文件或从官方资源下载语言包。

基本配置

在 config.yml 中，你可以进行以下核心设置：

设置时间限制模式

• limit-type： 设置为 player 对每个玩家单独设置，或 permission 基于权限组设置。
• reset-type： 设置重置周期，可选 daily（每日）、weekly（每周）或 monthly（每月）。

配置时间限制

• 如果 limit-type 设为 player，在 player-limits 部分为每个玩家名设置时间。
• 如果 limit-type 设为 permission，在 permission-limits 部分为每个权限节点设置时间。

示例配置片段

limit-type: permission
reset-type: daily
permission-limits:
  playertimelimit.group.vip: 2 hours
  playertimelimit.group.premium: 4 hours
  default: 1 hour

配置消息

所有提示消息都在对应的语言文件中配置（如 messages_zh.yml），你可以修改消息内容、颜色和格式。

❓常见问题

如何为不同玩家组设置不同时间？

• 使用 permission 模式，并将不同的时间限制关联到不同的权限节点。然后使用权限管理插件（如 LuckPerms）将权限节点分配给不同的组。

玩家时间用尽后会发生什么？

• 玩家会收到可配置的警告消息，随后被踢出服务器。他们可以在下一个重置周期（如第二天）再次加入。

如何让管理员不受时间限制？

• 给管理员权限组授予 playertimelimit.bypass 权限。

支持 MySQL 吗？

• 是的，在 config.yml 中设置 use-mysql: true 并配置数据库连接信息即可。

如何将剩余时间显示在计分板上？

• 安装 PlaceholderAPI 和本插件，然后使用占位符 %playertimelimit_time_remaining% 或 %playertimelimit_time_remaining_formatted%。

⭐重要提示

• 请确保在修改 config.yml 后使用 /tiempoadmin reload 重载配置。
• 时间单位缩写：s（秒）、m（分钟）、h（小时）、d（天）、w（周）、mo（月）。
• 使用 permission 模式时，请确保你的权限插件已正确设置并运行。
• 定期备份 plugins/PlayerTimeLimit/data.yml（如果使用 YAML 存储）或数据库。