LogiScope

LogiScope — an oscilloscope for item logistics and NBT data

LogiScope is a client-side measurement utility for modded item logistics. It samples container contents or NBT data once per game tick and renders them as a time-series waveform: one trace per item type, calibrated axes, and a computed net change over any selected interval. The mod registers no items, blocks, machines or packets; its scope is measurement only.

Operation

1. Open any container screen.
2. Press F9. A floating panel is drawn above the container, which remains visible and interactive.
3. Define a probe; select slots by direct click or by list.
4. Recording begins immediately. Dragging inside the chart freezes the viewport and reports the net change of the selected interval.
5. A probe may be archived, reopened, renamed and re-measured.

Five screens: probe list, slot selection, live chart, archive replay, raw probe data (NBT paths and observed values).

Aggregation semantics

For a probe spanning n slots:

• identical item in every slot — a single trace of the summed count;
• heterogeneous contents — one trace per item type;
• empty — zero, rendered as a muted trace;
• item substitution, read failure or pause — the trace is broken, never bridged.

Data provenance

• Single-player. Block entities of the integrated server are read in-process. One sample per world tick; /tick rate alters tick frequency, not the semantics of a sample.
• Multiplayer. No custom packets are sent. Sampling falls back to menu data already synchronised by the server. Unreadable ticks are recorded as gaps; no interpolation or imputation is applied.
• Deltas computed across a gap remain valid.

Known limitations

• Per-slot stock only. A slot that receives and drains within the same tick shows unchanged stock and a zero net flow; upstream or downstream containers should be observed instead.
• A probe requires an open container screen or a slot list. Devices without a GUI are selectable from the list only.
• Keybinding matching ignores modifier keys.

Installation

• Client-side only; not required on a server, with dependencies declared client-side.
• Configuration: config/logiscope-client.toml, also editable in-game under Mods → LogiScope → Config.

Compatibility

Standard slot-exposing containers are supported; the slot list is derived from the menu. Validated against AE2, Refined Storage, Mekanism and Sophisticated Storage networks. The exact loader and Minecraft version of each build are listed under Files.

Scope and disclosure

The mod reads only data already available to the client, modifies no world state, and sends no custom packets. It does observe container contents belonging to other mods; on multiplayer servers, server rules should be checked before use. Significant amount of code is AI generated.

中文说明

LogiScope —— 物流示波器

LogiScope 是一个客户端侧物品物流或NBT数据测量工具。它以世界刻为单位采样容器内容，将物品数量绘制为时间序列波形：每种物品一条迹线，坐标轴按量程标定，任意选定区间给出净变化。模组不注册物品、方块、机器或网络包，仅承担测量功能。

操作：打开容器界面后按 F9，浮层面板绘制于容器之上且不夺取交互；建立探针并选择槽位（直接点选或列表勾选）后即开始记录；在图表内拖动可冻结视口并读出所选区间的净变化；探针可存档、重开、重命名与复测。界面共五页：探针列表、选格、实时图表、存档回放、原始数据。

聚合语义：多槽探针中，同种物品按数量和合并为单条迹线；异种物品各成一条；全空记为 0；物品替换、读取失败或暂停处，迹线断开，不做连接。

数据来源：单人模式下于同进程读取集成服务端的方块实体，每个世界刻一个采样；/tick rate 改变刻频，不改变采样语义。多人模式不发送自定义包，退化为读取服务端已同步的菜单数据；不可读刻记为断档，不插值、不补值；跨断档差值仍然有效。

已知限制：仅观测每槽存量，同刻内进出相抵时存量不变、净流量为 0，应改观测上下游容器；探针需容器界面或槽位列表，无 GUI 设备只能列表选择；键位匹配不区分修饰键。

安装：仅客户端，服务端无需安装，依赖声明于客户端侧。配置位于 config/logiscope-client.toml，亦可在游戏内修改。

多人使用：仅读取客户端已有数据，不修改世界状态、不发送自定义包；但会观测其他模组容器的内容，多人服务器使用前应确认服务器规则允许。