查看“︁管理员指令”︁的源代码

__NOTOC__

''整理日期：2026-05-29''

涵盖模组：Open Parties and Claims / GriefLogger / Simple Tomb / FTB Teams / Observable / Spark / 车万女仆 / 自定义指令

== 一、领地管理 — Open Parties and Claims ==

=== 基本操作 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/openpac-claims claim</code> || 声明自身所在区块
|-
| <code>/openpac-claims claim &lt;x&gt; &lt;z&gt;</code> || 声明坐标 (x,z) 所在区块
|-
| <code>/openpac-claims unclaim</code> || 取消自身所在区块声明
|-
| <code>/openpac-claims unclaim &lt;x&gt; &lt;z&gt;</code> || 取消坐标 (x,z) 所在区块声明
|-
| <code>/openpac-claims forceload</code> || 强制加载自身所在区块
|-
| <code>/openpac-claims forceload &lt;x&gt; &lt;z&gt;</code> || 强制加载坐标 (x,z) 所在区块
|-
| <code>/openpac-claims about</code> || 查看当前区块声明信息
|}

=== 管理员指令 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/openpac-claims admin-mode</code> || 切换管理员模式（可操作他人领地）
|-
| <code>/openpac-claims claim anyway [x] [z]</code> || 管理员强制声明区块
|-
| <code>/openpac-claims server-claim</code> || 以服务器名义声明当前区块
|-
| <code>/openpac-claims server-unclaim</code> || 取消服务器声明的区块
|-
| <code>/openpac-claims server-forceload</code> || 服务器区块强制加载
|-
| <code>/openpac-claims server-unforceload</code> || 取消服务器区块强制加载
|-
| <code>/openpac-claims server-mode</code> || 切换服务器声明模式
|-
| <code>/openpac-claims non-ally-mode</code> || 切换非盟友模式
|}

=== 队伍指令 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/openpac-parties ...</code> || 队伍相关操作
|-
| <code>/opm &lt;消息&gt;</code> || 队伍聊天快捷方式
|}

按 <code>'</code> 键可打开 GUI；

== 二、操作记录 — GriefLogger ==

=== 基本指令 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/grieflogger inspect</code> || 启用或禁用检查模式
|-
| <code>/grieflogger lookup &lt;filters&gt;</code> || 根据过滤条件显示所有可用数据
|-
| <code>/grieflogger page &lt;页码&gt;</code> || 显示特定页码（也可点击聊天栏箭头翻页）
|}

=== 检查模式操作 ===
{| class="wikitable"
|-
! 操作 !! 说明
|-
| 右键方块 || 查看相邻方块的互动历史
|-
| 左键方块 || 查看被点击方块的互动历史
|-
| 右键容器 || 查看容器的互动（添加/移除物品）
|-
| 左键容器 || 查看容器被破坏或放置的记录
|}

=== 过滤器语法 ===
{| class="wikitable"
|-
! 过滤器 !! 语法示例 !! 说明
|-
| <code>action</code> || <code>action.place_block,break_block</code> || 仅显示放置/破坏方块（多项用逗号连接）
|-
| <code>exclude</code> || <code>exclude.sand</code> || 从结果中排除沙子
|-
| <code>include</code> || <code>include.sand,dirt</code> || 仅显示沙子和泥土相关日志
|-
| <code>radius</code> || <code>radius.100</code> || 显示玩家周围 100 格内所有日志
|-
| <code>time</code> || <code>time.1d</code> || 显示最后一天的所有日志
|-
| <code>user</code> || <code>user.Player1</code> || 显示与 Player1 相关的所有行为日志
|}

'''注意：''' <code>include</code> 和 <code>exclude</code> 不能同时使用；<code>radius</code> 是必填过滤器。<br/>
/grieflogger lookup 过滤条件查找指令有问题，并不能理想的运行。

=== 常用查询 ===
<pre>
/gl lookup radius.100                                       # 100格内全部操作
/gl lookup radius.50 user.Steve                             # 指定玩家
/gl lookup radius.100 action.place_block,break_block        # 只看放置/破坏
/gl lookup radius.100 time.1d                               # 最近一天
/gl lookup radius.100 include.diamond_ore                   # 只看钻石矿
</pre>

== 三、简单墓碑 — Simple Tomb ==

{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/simpletomb list &lt;玩家名&gt;</code> || 显示玩家墓碑位置记录和物品数
|-
| <code>/simpletomb restore &lt;玩家名&gt; &lt;记录编号&gt;</code> || 再次生成选中的墓碑
|-
| <code>/simpletomb key &lt;玩家名&gt; &lt;记录编号&gt;</code> || 获得选中墓碑的钥匙
|-
| <code>/simpletomb delete &lt;玩家名&gt;</code> || 删除玩家的墓碑
|}

=== 使用流程 ===
<pre>
# 1. 列出墓碑
/simpletomb list Steve
# → 输出：编号 0、1、2... 以及位置和物品数

# 2. 恢复指定墓碑
/simpletomb restore Steve 0

# 3. 如需钥匙（方便玩家自己找回）
/simpletomb key Steve 0
</pre>

== 四、FTB 队伍 — FTB Teams ==

=== 玩家指令 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/ftbteams party create &lt;队伍名&gt;</code> || 创建队伍
|-
| <code>/ftbteams party invite &lt;玩家名&gt;</code> || 邀请玩家进入队伍
|-
| <code>/ftbteams party kick &lt;玩家名&gt;</code> || 将玩家踢出队伍
|-
| <code>/ftbteams list [team-type]</code> || 列出所有队伍
|-
| <code>/ftbteams msg &lt;内容&gt;</code> || 向队伍发送消息
|-
| <code>/ftbteams info [team]</code> || 显示队伍信息
|-
| <code>/ftbteams settings &lt;key&gt; &lt;value&gt;</code> || 更改队伍设置
|}

=== 管理员指令（需 OP） ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/ftbteams server &lt;create/delete/settings&gt;</code> || 服务器团队管理
|-
| <code>/ftbteams force-disband &lt;队伍名&gt;</code> || 强制解散某队伍
|}

== 五、性能检测 — Observable ==

{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/observable run [秒数]</code> || 运行性能检测（默认 30 秒）
|-
| <code>/observable</code> || 打开 GUI 面板（默认快捷键 <code>R</code>）
|}

=== 管理员权限 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/observable set allPlayersAllowed true</code> || 允许所有玩家使用
|-
| <code>/observable allow &lt;玩家&gt;</code> || 允许指定玩家使用
|}

=== 结果解读 ===
* 检测完成后聊天栏会发一个网页链接
* '''Individual Results''' — 按实体/方块个体排序，找出单个卡顿大户
* '''Aggregate Results''' — 同类聚合，找出数量堆出来的卡顿源
* '''Chunks''' — 按区块排序，点击 '''Visit''' 复制 tp 指令直飞现场

'''使用场景：''' 找「哪个掉落物多/机器实体在卡」；搭配 Spark 找「哪段代码在卡」

== 六、性能分析 — Spark ==

=== CPU 性能分析 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/spark profiler start</code> || 开始采样
|-
| <code>/spark profiler start --timeout 30</code> || 采样 30 秒后自动停止
|-
| <code>/spark profiler start --thread *</code> || 追踪所有线程
|-
| <code>/spark profiler start --only-ticks-over 100ms</code> || 仅记录超过 100ms 的 tick
|-
| <code>/spark profiler start --alloc</code> || 内存分配分析模式
|-
| <code>/spark profiler stop</code> || 停止并上传结果（获取分享链接）
|-
| <code>/spark profiler stop --comment "备注"</code> || 带备注停止
|-
| <code>/spark profiler stop --save-to-file</code> || 保存到本地文件（不上传）
|-
| <code>/spark profiler cancel</code> || 取消（不上传）
|-
| <code>/spark profiler info</code> || 查看采样状态
|-
| <code>/spark profiler open</code> || 打开查看页面（不停采样）
|}

=== 服务器健康 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/spark healthreport</code> || 健康报告（TPS / CPU / 内存 / 磁盘）
|-
| <code>/spark tps</code> || TPS 与 CPU 使用率
|-
| <code>/spark ping</code> || 全服平均延迟
|-
| <code>/spark ping --player Steve</code> || 指定玩家延迟
|-
| <code>/spark tickmonitor</code> || 开启/关闭 Tick 监控
|-
| <code>/spark tickmonitor --threshold-tick 50</code> || 超过 50ms 的 tick 报警
|}

=== 内存分析 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/spark gc</code> || 查看 GC 历史
|-
| <code>/spark gcmonitor</code> || 开启/关闭 GC 监控
|-
| <code>/spark heapsummary</code> || 堆内存摘要
|-
| <code>/spark heapdump</code> || 导出完整堆快照 (.hprof)
|-
| <code>/spark heapdump --compress gzip</code> || 压缩导出
|}

=== 杂项 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/spark activity</code> || 最近活动记录
|-
| <code>/spark activity --page 2</code> || 翻页查看
|}

=== 常用组合 ===
<pre>
# 快速诊断：采样 30 秒
/spark profiler start --timeout 30
30秒后点击报告链接

# 深入分析：追踪所有线程 + 只看慢 tick
/spark profiler start --thread * --only-ticks-over 50ms
</pre>

权限节点：<code>spark</code> / <code>spark.profiler</code> / <code>spark.healthreport</code> / <code>spark.tps</code> / <code>spark.gc</code> / <code>spark.heapdump</code> 等

== 七、车万女仆 — Touhou Little Maid ==

=== 女仆备份恢复 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/tlm backup get &lt;玩家名&gt;</code> || 获取某玩家的女仆备份记录
|}

目前该指令在服务器中因为未知原因管理员执行无效，暂未测试成功

'''恢复流程：'''
<pre>
# 1. 在主世界执行（其他维度可能找不到备份）
/tlm backup get Steve

# 2. 聊天栏会列出女仆列表，点击女仆名字
#    → 点击备份记录 → 获得该女仆的相片（胶片）

# 3. 右键神龛使用胶片 → 再次右键神龛 → 女仆复活
#    注意：执行者生命值会降到 1 点，生命过低无法操作
</pre>

=== 女仆控制 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/tlm maid &lt;maid_uuid&gt; no_ai true/false</code> || 开关女仆 AI
|}

=== 实体生成 ===
<pre>
# 随机模型女仆
/summon touhou_little_maid:maid ~ ~1 ~

# 指定模型女仆
/summon touhou_little_maid:maid ~ ~1 ~ {ModelId:"模型id"}
</pre>

=== 管理员工具 ===
{| class="wikitable"
|-
! 工具 !! 用途
|-
| 创造模式好感度工具 || 快速调整女仆好感度
|-
| 主人转让工具 || 手持时可破坏他人女仆的墓碑
|}

'''注意：''' 用胶片复活后女仆 UUID 改变，备份中算作两个女仆；<code>/kill</code> 指令可清除墓碑但不会掉落任何物品。

== 八、自定义/辅助指令 ==

=== /looking — 观察者模式切换 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/looking</code> || 切换自身观察者模式（在观察者与生存模式间切换）
|}

=== /atall — 全服提醒 ===
{| class="wikitable"
|-
! 指令 !! 说明
|-
| <code>/atall </code> || 向全服发送醒目提醒
|}

非原版指令，通常来自聊天管理类插件

== 附录：快速参考卡 ==
<pre>
┌──────────────┬──────────────────────────────────────┐
│ 场景          │ 一键指令                              │
├──────────────┼──────────────────────────────────────┤
│ 查附近100格范围发生了什么  │ /grieflogger lookup radius.100 action.join │
│ 恢复墓碑      │ /simpletomb restore Steve 0          │
│ 找回女仆      │ /tlm backup get Steve                │
│ 强制接管领地  │ /openpac-claims admin-mode           │
│ 解散队伍      │ /ftbteams force-disband &lt;队名&gt;        │
│ 找卡顿方块    │ /observable run 30                   │
│ 全局性能采样  │ /spark profiler start --timeout 30   │
│ 全服通知      │ /atall                               │
│ 隐身查房      │ /looking                             │
└──────────────┴──────────────────────────────────────┘
</pre>

[[Category:服务器信息]]
[[Category:管理员]]