ThePit Ultimate

[HEADING=1]✪ 基础使用指南[/HEADING]
[HEADING=2]核心指令格式[/HEADING]
插件支持两种指令前缀：
[LIST]
[*]/thepitultimate:<指令> - 完整前缀版
[*]/pit <子指令> - 快捷版（适用于部分常用功能）
[/LIST]
[HEADING=2]通用语法规则[/HEADING]
[LIST]
[*]<参数> - 必填参数
[*][参数] - 可选参数
[*](权限等级) - 所需最低权限等级
[/LIST]
[HR][/HR]
[HEADING=1]✪ 指令详细教程[/HEADING]
[HEADING=2]一、基础功能指令[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]说明[/LEFT][/TH]
[TH][LEFT]权限建议[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:back[/LEFT][/TD]
[TD][LEFT]返回上一个位置（死亡点/传送前）[/LEFT][/TD]
[TD][LEFT]pit.user.back[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:home[/LEFT][/TD]
[TD][LEFT]传送回主城或默认重生点[/LEFT][/TD]
[TD][LEFT]pit.user.home[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:spawn[/LEFT][/TD]
[TD][LEFT]传送到服务器出生点[/LEFT][/TD]
[TD][LEFT]pit.user.spawn[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:respawn[/LEFT][/TD]
[TD][LEFT]强制重生（卡死自救）[/LEFT][/TD]
[TD][LEFT]pit.user.respawn[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:version[/LEFT][/TD]
[TD][LEFT]查看插件版本[/LEFT][/TD]
[TD][LEFT]pit.user.version[/LEFT][/TD]
[/TR]
[/TABLE]
[B]使用示例[/B]：

/thepitultimate:back # 返回死亡点
/pit home # 快捷回城

[HR][/HR]
[HEADING=2]二、地图与点位管理（管理员专用）[/HEADING]
[HEADING=3]2.1 生物生成点设置[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]说明[/LEFT][/TH]
[TH][LEFT]权限节点[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:addangelspawns[/LEFT][/TD]
[TD][LEFT]添加天使生成点[/LEFT][/TD]
[TD][LEFT]pit.admin.spawn.angel[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:adddemonspawns[/LEFT][/TD]
[TD][LEFT]添加恶魔生成点[/LEFT][/TD]
[TD][LEFT]pit.admin.spawn.demon[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit addSpawn[/LEFT][/TD]
[TD][LEFT]添加通用生物生成点[/LEFT][/TD]
[TD][LEFT]pit.admin.spawn.generic[/LEFT][/TD]
[/TR]
[/TABLE]
[HEADING=3]2.2 NPC 与特殊点位[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]说明[/LEFT][/TH]
[TH][LEFT]配置要点[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:setportalposa[/LEFT][/TD]
[TD][LEFT]设置传送门位置A[/LEFT][/TD]
[TD][LEFT]需配合 posb 使用[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:setportalposb[/LEFT][/TD]
[TD][LEFT]设置传送门位置B[/LEFT][/TD]
[TD][LEFT]形成双向传送[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:addbhloc[/LEFT][/TD]
[TD][LEFT]添加赏金猎人生成点[/LEFT][/TD]
[TD][LEFT]建议设置在PVP区域[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:addpackagepoint[/LEFT][/TD]
[TD][LEFT]添加包裹投递点[/LEFT][/TD]
[TD][LEFT]用于物流系统[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:addsewerspoint[/LEFT][/TD]
[TD][LEFT]添加下水道点位[/LEFT][/TD]
[TD][LEFT]用于副本或隐藏区域[/LEFT][/TD]
[/TR]
[/TABLE]
[HEADING=3]2.3 全息公告设置[/HEADING]

/pit hologramLoc <文本> # 创建全息文字
/pit leaderHologram # 排行榜全息图
/pit helperHolo # 助手提示全息图

[B]权限[/B]：pit.admin.hologram.*
[HR][/HR]
[HEADING=2]三、物品与经济系统[/HEADING]
[HEADING=3]3.1 物品给予指令[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]语法[/LEFT][/TH]
[TH][LEFT]高级用法[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:give[/LEFT][/TD]
[TD][LEFT]/pit give <nbtName> <amount>[/LEFT][/TD]
[TD][LEFT]支持NBT标签精确匹配[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:giveall[/LEFT][/TD]
[TD][LEFT]/pit giveAll [pvp][/LEFT][/TD]
[TD][LEFT]pvp参数: true=仅PVP玩家[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit giveItemInHand <target>[/LEFT][/TD]
[TD][LEFT]复制手持物品[/LEFT][/TD]
[TD][LEFT]快速分发装备[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit listitems[/LEFT][/TD]
[TD][LEFT]查看可获取物品列表[/LEFT][/TD]
[TD][LEFT]配合Tab键自动补全[/LEFT][/TD]
[/TR]
[/TABLE]
[HEADING=3]3.2 交易系统[/HEADING]

/pit trade <玩家名> # 发起交易
/thepitultimate:forcetrade # 强制交易（管理员）
/thepitultimate:auctiongui # 打开拍卖行
/pit edit # 编辑交易内容

[B]权限节点[/B]：
[LIST]
[*]pit.user.trade - 基础交易权限
[*]pit.admin.trade.force - 强制交易
[*]pit.user.auction - 使用拍卖行
[/LIST]
[HEADING=3]3.3 物品管理[/HEADING]

/pit takeitems <玩家> <物品> [数量] # 移除物品
/pit itemNbtDump # 输出NBT数据（调试）
/pit enchantments # 管理附魔

[HR][/HR]
[HEADING=2]四、事件与活动管理[/HEADING]
[HEADING=3]4.1 事件控制[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]功能[/LEFT][/TH]
[TH][LEFT]注意事项[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:event[/LEFT][/TD]
[TD][LEFT]手动触发事件[/LEFT][/TD]
[TD][LEFT]需事件ID参数[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:events[/LEFT][/TD]
[TD][LEFT]查看活动列表[/LEFT][/TD]
[TD][LEFT]显示进行中事件[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit skipNormalEvent[/LEFT][/TD]
[TD][LEFT]跳过普通事件[/LEFT][/TD]
[TD][LEFT]立即结束当前事件[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit skipEpicEvent[/LEFT][/TD]
[TD][LEFT]跳过史诗事件[/LEFT][/TD]
[TD][LEFT]慎用，可能导致数据异常[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit readyEpic[/LEFT][/TD]
[TD][LEFT]标记史诗事件就绪[/LEFT][/TD]
[TD][LEFT]用于团队协作活动[/LEFT][/TD]
[/TR]
[/TABLE]
[HEADING=3]4.2 特殊活动[/HEADING]

/thepitultimate:startcustomauction # 启动自定义拍卖
/thepitultimate:startdate # 设置活动日期
/pit spire spawn # 生成尖塔副本
/pit spire floor <层数> # 设置起始楼层

[B]权限[/B]：pit.admin.event.*
[HR][/HR]
[HEADING=2]五、玩家数据管理[/HEADING]
[HEADING=3]5.1 数据修改[/HEADING]

/pit change <玩家> <类型> <值> [save] # 修改玩家属性
# 类型支持: gold, level, prestige, xp 等
# save参数: true=立即写入数据库

[B]示例[/B]：

/pit change Steve gold 1000 true # 给Steve 1000金币
/pit change Alex prestige 1 # 提升Alex转生等级

[HEADING=3]5.2 数据重置与回滚[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]功能[/LEFT][/TH]
[TH][LEFT]风险等级[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:wipe[/LEFT][/TD]
[TD][LEFT]重置玩家数据[/LEFT][/TD]
[TD][LEFT]★★★★★[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:unwipe[/LEFT][/TD]
[TD][LEFT]恢复重置的数据[/LEFT][/TD]
[TD][LEFT]★★★★☆[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:rollback[/LEFT][/TD]
[TD][LEFT]回滚到上一个存档点[/LEFT][/TD]
[TD][LEFT]★★★☆☆[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/thepitultimate:iknowigotwiped[/LEFT][/TD]
[TD][LEFT]确认重置操作[/LEFT][/TD]
[TD][LEFT]防误触保护[/LEFT][/TD]
[/TR]
[/TABLE]
[B]权限[/B]：pit.admin.data.wipe / pit.admin.data.rollback
[HR][/HR]
[HEADING=2]六、调试与服务器管理[/HEADING]
[HEADING=3]6.1 调试模式[/HEADING]

/thepitultimate:debug # 开关调试模式
/pit debug <类型> # 指定调试类型
# 类型: item, event, npc, trade 等
/pit nocache # 禁用缓存（实时调试）
/pit itemNbtDump # 查看物品完整NBT

[HEADING=3]6.2 服务器控制[/HEADING]

/thepitultimate:reboot # 重启服务器
/thepitultimate:cancelreboot # 取消计划重启
/pit saveAll [announce] # 保存数据
/pit reload # 重载插件配置
/pit flushMythicItems <玩家> # 清理MythicMobs物品

[B]警告[/B]：/thepitultimate:disableplugin 会立即禁用插件，慎用！
[HR][/HR]
[HEADING=2]七、特殊功能与彩蛋[/HEADING]
[HEADING=3]7.1 娱乐指令[/HEADING]

/thepitultimate:kaboom # 爆炸特效（范围内玩家）
/pit kaboom # 同上
/pit ham # 彩蛋（可能触发特殊效果）
/pit ham clear # 清除火腿效果？
/pit cool # 未知彩蛋
/pit testSound <音效名> # 测试音效

[HEADING=3]7.2 神秘功能[/HEADING]


/thepitultimate:python # 执行Python脚本（需配置）
/thepitultimate:天坑 # 中文指令，快速传送
/pit mail # 邮件系统
/pit rareplus # 稀有物品增强（VIP）

[B]权限示例[/B]：

pit.fun.kaboom # 爆炸特效
pit.fun.easter_egg # 彩蛋指令

[HR][/HR]
[HEADING=2]八、创建与管理任务[/HEADING]
[HEADING=3]8.1 数学题任务（特色功能）[/HEADING]
/pit createEquation <题目> <答案> # 创建数学题

[B]示例[/B]：
/pit createEquation "10+20*2" "50" # 注意运算优先级

[HEADING=3]8.2 任务系统

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]用途[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/pit quest[/LEFT][/TD]
[TD][LEFT]查看/管理任务[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit sewers[/LEFT][/TD]
[TD][LEFT]下水道任务/传送[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit sewersFishLoc[/LEFT][/TD]
[TD][LEFT]设置钓鱼点位[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]

[HR][/HR]

[HR][/HR]
[HEADING=1]✪ 使用建议与注意事项[/HEADING]
[HEADING=2]✅ 最佳实践[/HEADING]
[LIST=1]
[*][B]点位设置[/B]：设置NPC点位时，建议先使用 /pit debug npc 进入调试模式
[*][B]物品分发[/B]：大型服务器建议使用 /pit giveAll 而非循环执行 /give
[*][B]数据备份[/B]：执行 /thepitultimate:wipe 前务必 /pit saveAll true
[*][B]事件管理[/B]：跳过史诗事件前通知玩家，避免体验割裂
[/LIST]
[HEADING=2]⚠️ 危险操作[/HEADING]

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]风险[/LEFT][/TH]
[TH][LEFT]建议[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/wipe[/LEFT][/TD]
[TD][LEFT]永久删除数据[/LEFT][/TD]
[TD][LEFT]仅限控制台或最高管理员[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/disableplugin[/LEFT][/TD]
[TD][LEFT]导致功能立即失效[/LEFT][/TD]
[TD][LEFT]仅在维护窗口使用[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/reboot[/LEFT][/TD]
[TD][LEFT]强制重启[/LEFT][/TD]
[TD][LEFT]提前5分钟广播通知[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/pit nocache[/LEFT][/TD]
[TD][LEFT]性能下降[/LEFT][/TD]
[TD][LEFT]仅调试时使用[/LEFT][/TD]
[/TR]
[/TABLE]
[HEADING=2]🔍 调试技巧[/HEADING]
[LIST=1]
[*]物品NBT问题：/pit itemNbtDump + /pit debug item
[*]事件不触发：/pit debug event + /thepitultimate:refreshevents
[*]权限测试：使用 /pit options 查看当前权限状态
[/LIST]