ConfigOverride interface
Per-player configuration that lives for one session: tolerance presets, latency rules and feature filters.
Reach it from a user: user.configOverride(). Overrides are mutable and exist only for the duration of the player's session — nothing is written to disk, and a reconnect starts fresh. Players with no overrides share ConfigOverride.none(), a no-op instance; call ConfigOverride.create() when you want an independent mutable object of your own.
Tolerance
| Signature | Description |
|---|---|
ToleranceLevel movementTolerance() / (ToleranceLevel) | How strict movement checks are for this player. |
ToleranceLevel blinkPreventionTolerance() / (ToleranceLevel) | Strictness of blink/packet-flood prevention. |
boolean enforceLatency() / (boolean) | Whether the player’s measured latency is enforced against them. |
long unstableConnectionLimit() / (int) | Ping above which the player counts as unstable. |
long timedOutLimit() / (int) | Transaction timeout before the player counts as timed out. |
boolean detectAndPreventBacktrack() / (boolean) | Backtrack detection and prevention for this player. |
Feature filters
Each of these switches one class of validation for the session. They pair with the global configuration — the override wins for that player.
| Signature | Description |
|---|---|
boolean preventAirPlace() / (boolean) | Block placement while airborne. |
boolean preventBreakingSurrounded() / (boolean) | Breaking blocks that surround a target. |
boolean preventPhase() / (boolean) | Moving through solid geometry. |
boolean preventNoSlowdown() / (boolean) | Item-use slowdown bypass. |
boolean healthFilter() / (boolean) | Ignore health values the client could not legitimately have. |
boolean absorptionFilter() / (boolean) | Same for absorption hearts. |
boolean playerGroundFilter() / (boolean) | Ground-state contradictions in client packets. |
ToleranceLevel
| Signature | Description |
|---|---|
SEVERE | Tightest — flags the smallest deviations. |
MODERATE | Strict. |
BALANCED | The default posture for unknown players. |
PERMISSIVE | Roomy; good for minigame lobbies with lots of teleporting. |
LENIENT | Only clear violations are flagged. |
DISABLED | Tolerance-based checks do not run at all. |
api.users().queryUserByUuid(uuid).ifPresent(user -> {
ConfigOverride config = user.configOverride();
config.movementTolerance(ToleranceLevel.LENIENT);
config.preventPhase(false);
getLogger().info("Tuned Venus for " + user.username());
});