采样参数

调整一次采集的长度与采样间隔的两条指令。

基本信息

指令 实现类 权限等级 设定对象
/opis_delay CommandFrequency 3 modOpis.profilerDelay
/opis_ticks CommandTicks 3 modOpis.profilerMaxTicks

注册位置:modOpis.java:214(/opis_delay)、modOpis.java:218(/opis_ticks)。CommandHelp 不会列出这两条 —— CommandHelp.processCommand(CommandHelp.java:25-28)硬编码的 13 条里没有它们。

功能

两条指令的 processCommand 结构完全相同(CommandFrequency.java:31-39、CommandTicks.java:29-37):

  1. if (astring.length < 1) return; —— 缺参数时静默退出,不回任何提示
  2. Integer.valueOf(astring[0]) 解析
  3. 写入对应的静态字段
  4. 回复一条 §o 斜体提示
指令 成功回复 赋值目标
/opis_delay <n> Opis delay set to %s ticks. modOpis.profilerDelay
/opis_ticks <n> Opis ticks set to %s ticks. modOpis.profilerMaxTicks

解析失败被空 catch 吞掉(catch (Exception e) {}),因此非数字参数同样静默无响应。

两条指令都只改内存字段,不写回配置文件。preInit 中 config.save() 已在 modOpis.java:164 于启动时调用过一次,运行期的改动不会落盘,重启后回到配置文件的值。

数值

数值名 值 证据
profilerDelay 字段初值 1 modOpis.java:86
profilerMaxTicks 字段初值 250 modOpis.java:89
运行时可设置范围 无校验(Integer.valueOf 直接赋值) CommandFrequency.java:34、CommandTicks.java:32
每次 /opis_start 广播的采集长度 modOpis.profilerMaxTicks CommandStart.java:45

交互

触发 行为
/opis_delay 5 采样间隔改为 5 tick,后续 /opis_start 的提示会显示新值
/opis_ticks 1000 采集点数改为 1000
/opis_delay(无参) 无任何输出
/opis_delay abc 无任何输出
玩家执行(已授权) 正常执行,与控制台行为一致

相关条目

  • run-control - 用这两个值启动一次采集
  • config - 同名配置键 profiler.delay / profiler.maxpts 的默认值与落盘行为
  • access-control - 权限等级 3 与已授权玩家的区别