Glossary

Console, JAR, and plugin

The console is the server process’s text interface in a terminal/panel. Console commands normally omit /. A JAR is a Java application archive; distinguish the Paperclip distribution from a plugin. Plugins add behavior and can keep their own data/dependencies.

Tick, TPS, and MSPT

A tick is a server processing step. The normal target is 20 ticks per second. TPS counts completed ticks per second; MSPT measures milliseconds of work per tick. The 20 TPS interval is about 50 ms. Work duration and waiting until the next tick are different.

A percentile such as p95 places 95% of samples below that value. It is not a mean. Compare matching statistics and sample windows.

Heap, RAM, and GC

Heap is Java-managed object memory. Xms sets its initial size and Xmx its maximum. Host/container RAM also serves native allocations, OS, panel, and other processes. Garbage collection (GC) reclaims unused objects and can introduce pauses.

Main thread, workers, and snapshots

The main thread owns live game state. Workers handle permitted separate work. An immutable detached snapshot does not expose live objects and cannot be changed by its consumer. Results affecting gameplay are applied on main.

I/O means disk/network reads and writes. Async I/O does not make all game logic asynchronous. A queue holds pending work. Backpressure holds admission/delivery when downstream work cannot keep up.

Chunk, region, and NBT

A chunk covers a 16 × 16 horizontal area. Region files group chunks. A codec defines encoding/decoding; Nusa zstd needs a compatible reader. NBT is structured Minecraft data, alongside modern item components and their validation paths.

Preset, diff, apply, and rollback

A preset selects predefined policy. A diff shows before/after values. Apply saves approved changes; Nusa startup settings still need restart. Rollback restores an earlier compatible software/data state, normally from a consistent backup.

Staging, heartbeat, and stale

Staging is a separate test server copy. A heartbeat is a periodic bridge update. Stale means a sample is too old to represent the current server. Diagnose connection state separately from its last displayed TPS.

NMS, reflection, and fallback

NMS refers to Minecraft implementation internals that can change by version. Reflection accesses classes/fields dynamically. Plugins relying on these need matching builds. Fallback selects a safe alternative, such as native target selection when a snapshot is invalid; it is not certification of every plugin feature.