LSantiSpoof Free

[HR][/HR]

✨ Overview
LSantiSpoof Free is an ultra-lightweight, high-performance security plugin designed to
eliminate Meteor Client and modified client spoofing on modern Minecraft servers (1.20+ /
1.21+).

Unlike traditional anti-cheats that rely on expensive tick calculations and cause server lag,
LSantiSpoof operates asynchronously at the packet layer, exposing and blocking unauthorized client
modifications instantly upon login or command execution.
[HR][/HR]
Key Features

1. ️ Client Brand Verification

• Brand Inspection: Analyzes incoming client brand handshake packets during the
  configuration and login phases.
  
• Meteor Fingerprinting: Immediately flags clients identifying as Meteor or suspicious
  unofficial variants.
  

2. Plugin Channel Verification

• Channel Registration Tracking: Scans registered client-side plugin messaging channels
  for unauthorized Meteor communication pipes.
  
• Channel Whitelisting/Blacklisting: Blocks clients listening to prohibited mod channels.
  

3. Invisible Sign Translation Probing (MC-265322)

• Deep Translatable Trap: Sends an invisible 2-tick background translation probe under
  the player's feet (at Y offset -4).
• I18n Force Evaluation: Forces the client's internal dictionary to evaluate Meteor
  translation keys (key.meteor-client.open-gui), instantly catching users with zero false
  positives.

4. Command & Tab-Complete Leak Interception

• Hacked Command Trap: Intercepts and blocks leaked Meteor commands and auto-completions
  (.meteor, .bind, .vclip, .panic, .damage, .nbt, etc.).
  
• Chat Prefix Filter: Catches hidden dot-prefixed syntax before it reaches server chat.
  

5. Full Folia & PaperMC Thread-Safety

• 100% Asynchronous: Utilizes Folia Regional Schedulers and PacketEvents packet
  listeners with zero main-thread impact.
  
• Modern Adventure / MiniMessage: Supports Hex colours, gradients
  (<gradient:#ff0000:#ff7f00>), and bold text styling.
  

[HR][/HR]

What LSantiSpoof Can & Cannot Do

What LSantiSpoof CAN Do:

• Detect 95%+ of Meteor Client Users: Most cheaters use default Meteor installations
  without custom bytecode obfuscation. LSantiSpoof catches them immediately.
  
• Protect Without Server Lag: Operates purely on packet listeners without running tick-
  based physics calculations.
• Zero False Positives for Clean Fabric: Vanilla and clean Fabric/OptiFine/Sodium users
  pass through smoothly without any disruptions.
  

What LSantiSpoof CANNOT Do:

• Replace a Combat/Movement Anti-Cheat: LSantiSpoof focuses on client identification and
  spoof detection; it is designed to work alongside movement anti-cheats (like GrimAC/Vulcan).
  
• Detect Custom Private Self-Coded Injections: Highly sophisticated custom-compiled
  private mods with stripped translation dictionaries require behavioral heuristics.
  

[HR][/HR]

⚙️ Commands & Permissions

Command	Description	Permission
/lsantispoof alerts	Toggle in-game detection alert notifications	lsantispoof.notify
/lsantispoof check <player>	Trigger active manual verification probe on a player	lsantispoof.admin
/lsantispoof inspect <player>	View detailed client brand & violation info	lsantispoof.admin
/lsantispoof reload	Reload configuration without restarting the server	lsantispoof.admin

* Aliases: /antispoof, /lsas

[HR][/HR]

Installation

1. Download and install PacketEvents 2.7.0+ into your server's
   /plugins folder.
   
2. Download LSantiSpoof-Free.jar and place it in your /plugins directory.
   
3. Restart your server.
4. Customize config.yml to match your server's punishment policy!
   

[HR][/HR]

Configuration Preview (config.yml)
[HR][/HR]