iKoth FREE Schedule PlaceHolders Factions support - iKoth - 免费领地占领插件

如果您有任何建议或发现了错误，请通过 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 信息。