✪ 基础使用指南

核心指令格式

插件支持两种指令前缀：

• /thepitultimate:<指令> - 完整前缀版
• /pit <子指令> - 快捷版（适用于部分常用功能）

通用语法规则

• <参数> - 必填参数
• [参数] - 可选参数
• (权限等级) - 所需最低权限等级

[HR][/HR]

✪ 指令详细教程

一、基础功能指令

[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]
使用示例：

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

[HR][/HR]

二、地图与点位管理（管理员专用）

2.1 生物生成点设置

[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]

2.2 NPC 与特殊点位

[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]

2.3 全息公告设置

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

权限：pit.admin.hologram.
[HR][/HR]

三、物品与经济系统

3.1 物品给予指令

[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]

3.2 交易系统

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

权限节点：

• pit.user.trade - 基础交易权限
• pit.admin.trade.force - 强制交易
• pit.user.auction - 使用拍卖行

3.3 物品管理

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

[HR][/HR]

四、事件与活动管理

4.1 事件控制

[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]

4.2 特殊活动

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

权限：pit.admin.event.
[HR][/HR]

五、玩家数据管理

5.1 数据修改

/pit change <玩家> <类型> <值> [save] # 修改玩家属性

类型支持: gold, level, prestige, xp 等

save参数: true=立即写入数据库

示例：

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

5.2 数据重置与回滚

[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]
权限：pit.admin.data.wipe / pit.admin.data.rollback
[HR][/HR]

六、调试与服务器管理

6.1 调试模式

/thepitultimate:debug # 开关调试模式
/pit debug <类型> # 指定调试类型

类型: item, event, npc, trade 等

/pit nocache # 禁用缓存（实时调试）
/pit itemNbtDump # 查看物品完整NBT

6.2 服务器控制

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

警告：/thepitultimate:disableplugin 会立即禁用插件，慎用！
[HR][/HR]

七、特殊功能与彩蛋

7.1 娱乐指令

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

7.2 神秘功能

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

权限示例：

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

[HR][/HR]

八、创建与管理任务

8.1 数学题任务（特色功能）

/pit createEquation <题目> <答案> # 创建数学题

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

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]

[HR][/HR]

[HR][/HR]

✪ 使用建议与注意事项

✅ 最佳实践

• 点位设置：设置NPC点位时，建议先使用 /pit debug npc 进入调试模式
• 物品分发：大型服务器建议使用 /pit giveAll 而非循环执行 /give
• 数据备份：执行 /thepitultimate:wipe 前务必 /pit saveAll true
• 事件管理：跳过史诗事件前通知玩家，避免体验割裂

⚠️ 危险操作

[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]

🔍 调试技巧

• 物品NBT问题：/pit itemNbtDump + /pit debug item
• 事件不触发：/pit debug event + /thepitultimate:refreshevents
• 权限测试：使用 /pit options 查看当前权限状态