SentinelRK Anti-Cheat 1.0.0-beta

About SentinelRK

SentinelRK is a modular anti-cheat developed for modern Paper servers. It analyzes movement, combat, inventory and world interactions while prioritizing low false-positive rates, useful evidence and server performance.

Instead of immediately punishing a player after a single suspicious action, SentinelRK uses buffers, confidence, decay and cross-category correlation. Impossible actions can be mitigated while evidence is collected for administrators.

This release is a public beta. Automatic punishment is disabled by default and should remain disabled during initial testing.


Detection Modules

Movement

• Speed
• Fly
• Invalid Movement
• NoFall
• Timer
• Velocity / AntiKnockback
• Blink
• NoSlow

Combat

• Reach
• HitBox
• Invalid Hit
• Line of Sight
• Aim analysis
• Rotation spoofing
• Target switching
• KillAura correlation
• AutoClicker
• CrystalAura

Inventory and Interaction

• AutoTotem
• InventoryMove
• Scaffold
• FastUse
• FastPlace
• FastBreak
• Remote interaction protection
• Villager trade protection

Some checks remain marked as EXPERIMENTAL while public testing and calibration continue.


Main Features

• Mitigation-first detection model
• Confidence, buffers and automatic decay
• Cross-category incident correlation
• Ping and jitter awareness
• TPS and MSPT health protection
• Experimental checks automatically suspend when server health is degraded
• Historical combat positions and ping-adjusted HitBox reconstruction
• Evidence IDs and snapshots
• Evidence review as valid or false positive
• Alert aggregation to reduce chat spam
• SQLite storage by default
• Optional MySQL storage
• Bounded asynchronous evidence queue
• Circuit breakers and fail-safe behavior
• LENIENT, BALANCED and STRICT profiles
• SHADOW, ALERT_ONLY, MITIGATION and ENFORCEMENT modes
• Conservative Bedrock/Geyser handling
• ViaVersion and ViaBackwards protocol information
• API for exemptions and legal movement modifiers
• No GUI or proxy/network synchronization in this release

Requirements

• Java 21
• Paper 1.21.x
• PacketEvents 2.12.0 installed separately

Installation

1. Stop your server completely.
2. Install PacketEvents 2.12.0.
3. Place SentinelRK in the server's plugins folder.
4. Remove any older SentinelRK JAR.
5. Start the server normally.
6. Run /sentinel validate.
7. Run /sentinel performance.

Do not use /reload when installing or updating SentinelRK.

The plugin automatically creates its configuration and SQLite database. Configuration migrations create a backup of the previous file.


Recommended Beta Configuration

Do not enable automatic kicks or punishment commands until SentinelRK has been tested with legitimate players on your server.


Commands

Example evidence review:


Permissions

The bypass permission is not granted to operators automatically by default.


Performance and Scalability

Beta 1 contains several performance protections:

• Rotation-only Bukkit movement events do not execute all physical checks.
• Player histories have strict size limits.
• Combat rewind copies only ping-relevant samples.
• Ping is sampled twice per second.
• Evidence is written outside the main server thread.
• The evidence queue is bounded to prevent unlimited memory growth.
• Experimental checks are suspended when TPS or MSPT becomes degraded.
• Storage failures cannot crash the complete anti-cheat.

A synthetic core test executed:

• 150 simulated players
• 1,200 ticks
• 12 checks per player and tick
• Approximately 52.2 ms total core processing time on the development machine

This synthetic result does not guarantee identical performance on every server. Hardware, worlds, chunks, player activity and other plugins affect real performance.

Use /sentinel performance and monitor:

• TPS close to 20
• MSPT preferably below 40–45
• MSPT not sustained above 50
• evidencePending close to 0
• evidenceDropped equal to 0
• No circuit breaker reporting true

Storage

SQLite is enabled by default and requires no manual setup.

MySQL can be enabled in config.yml:

Never publish your real database password when requesting support.


Compatibility

• Compiled against Paper 1.21.8
• Java 21
• PacketEvents 2.12.0
• Floodgate/Geyser compatibility hooks
  [*