如果您有任何建议或发现了错误，请通过 Discord 联系我。
Discord 联系方式：Drz#6374
教程
（点击展开查看教程）
iKoth 是一款功能强大的 Minecraft 插件，用于在服务器上创建和管理“山丘之王”（King of the Hill）类型的 PvP 活动。它提供了完整的命令、定时任务、丰富的占位符以及对主流领地插件的支持，帮助你轻松举办激动人心的占领竞赛。
基本命令
使用以下命令来创建、配置和管理 Koth 活动。所有命令均以 /koth 开头。
/koth create <koth>- 创建一个新的 Koth。（权限：ikoth.create）/koth setpoints <koth>- 设置 Koth 的占领区域点。（权限：ikoth.setpoints）/koth rewards <koth>- 设置 Koth 的奖励。（权限：ikoth.rewards）/koth options <flag> <value>- 设置 Koth 的选项。（权限：ikoth.options）/koth remove <koth>- 移除一个 Koth。（权限：ikoth.remove）/koth exitinspector- 退出检查模式。（权限：ikoth.exitinspector）/koth start <koth> <time> [maxTime]- 启动一个 Koth。time为占领所需时间（秒），maxTime（可选）为活动最大持续时间。（权限：ikoth.start）/koth stop <koth>- 停止一个正在进行的 Koth。（权限：ikoth.stop）/koth list- 查看所有 Koth 的列表。（权限：ikoth.list）/koth schedule- 管理定时任务。（权限：ikoth.schedule）/koth settime <koth/id> <time>- 设置特定 Koth 的剩余时间。（权限：ikoth.settime）/koth enable <koth>- 启用一个 Koth。（权限：ikoth.enable）/koth giveitem <player> <koth> <time> <maxtime>- 给予玩家一个用于启动 Koth 的物品。使用物品需要ikoth.usegiveitem权限。（权限：ikoth.giveitem）/koth reload- 重载插件配置文件。（权限：ikoth.reload）
> 注意：命令中的 [] 表示可选参数。
定时任务命令
使用以下命令来安排 Koth 活动自动开始。
/koth schedule create <koth> <capturetime> <maxruntime> <day> <hour:min> <repetitionWeeks>- 为特定 Koth 创建定时计划。（权限：ikoth.schedule.create）/koth schedule list- 查看所有定时计划的列表。（权限：ikoth.schedule.list）/koth schedule remove <id>- 通过 ID 移除一个定时计划。（权限：ikoth.schedule.remove）/koth schedule info <id>- 通过 ID 查看特定定时计划的详细信息。（权限：ikoth.schedule.info）/koth schedule next- 查看下一个即将开始的 Koth 及其时间。（权限：ikoth.schedule.next）
参数说明
<koth>: Koth 的名称。<capturetime>: Koth 的持续时间（秒）。<maxruntime>: Koth 的最大运行时间，设为-1可禁用。<day>: 星期几（例如：sunday）。<hour:min>: 执行时间（例如：10:00）。<repetitionWeeks>: 重复执行的周期间隔（周数）。
使用示例
/koth schedule create koth 30 5 sunday 10:00 1
> 重要提示：定时任务使用服务器主机的时区。你可以使用 /koth schedule next 命令查看具体日期和时间。
占位符 (PlaceholderAPI)
要使用这些占位符，你需要安装 PlaceholderAPI 插件。以下占位符默认指向第一个 Koth 的信息。
%ikoth_x%,%ikoth_y%,%ikoth_z%- 第一个 Koth 区域的坐标。%ikoth_player%- 正在占领第一个 Koth 的玩家。%ikoth_name%- 第一个 Koth 的名称。%ikoth_time%- 第一个 Koth 的剩余时间。%ikoth_coords%- 第一个 Koth 的坐标（格式化显示）。%ikoth_uptime%- 第一个 Koth 已进行的时间。%ikoth_world%- 第一个 Koth 所在的世界。%ikoth_id%- 第一个 Koth 的 ID。%ikoth_p1%,%ikoth_p2%- Koth 区域点 1 和点 2 的坐标。%ikoth_percentage%- Koth 占领完成百分比。%ikoth_percentage_r%- Koth 占领完成百分比（反向，即剩余百分比）。%ikoth_next%- 下一个 Koth 的开始时间。%ikoth_next_name%- 下一个 Koth 的名称。%ikoth_faction%- 正在占领的派系（需要领地插件支持）。
坐标点占位符
你可以获取区域两个点的独立坐标
%ikoth_p1_x%, %ikoth_p1_y%, %ikoth_p1_z%
%ikoth_p2_x%, %ikoth_p2_y%, %ikoth_p2_z%
进度条占位符
你可以创建自定义进度条来直观显示占领进度。
%ikoth_progressbar%- 使用默认设置的进度条。%ikoth_progressbar_50%- 指定长度为 50 的进度条。%ikoth_progressbar_15_&a-_&r-%- 完全自定义的进度条。
- `15`: 进度条总长度。- `&a-`: 已完成部分的符号和颜色。- `&r-`: 未完成部分的符号和颜色。领地插件支持
iKoth 与主流领地插件兼容，可以为整个派系提供奖励和支持。
- 奖励分配：可以设置奖励发放给派系的所有成员。
- 命令执行：可以为每个派系成员执行命令。
- 配置变量：在配置文件中可以使用
%faction%变量。 - 占位符：使用
%ikoth_faction%获取占领中的派系名称。
兼容的插件
- SaberFactions
- SimpleClans
- FactionsUUID
> 你可以在讨论页面提议任何新功能。
配置选项
使用 /koth options <flag> <value> 命令来设置 Koth 的选项。
可用选项
reset:true/false
- 当占领玩家离开 Koth 区域时，占领进度是否重置。其他功能
十六进制颜色
在配置文件中，你可以使用十六进制颜色代码，格式为 #<hex>。
例如：#FFAA00
Discord Webhook
目前支持在 Koth 开始时通过 Discord Webhook 发送公告。
启动物品
- 使用命令
/koth giveitem <player> <koth>给予玩家启动物品。 - 执行此命令需要
ikoth.giveitem权限。 - 玩家使用该物品需要
ikoth.usegiveitem权限。 - 物品的外观和行为可以在配置文件中自定义。
排行榜 (Top Koth)
当 Koth 活动结束时，会显示一个占领时间排行榜。
- 你可以在配置文件中通过
size-players选项设置排行榜上显示的玩家数量。
定时任务时区
定时功能使用服务器主机的时区。你可以通过相关链接获取时区 ID 信息。
