sModBlock

━━━━━━━━━━━━━━━━━━━━
OVERVIEW
━━━━━━━━━━━━━━━━━━━━

sModBlock is a high-performance anti-cheat plugin that detects and blocks disallowed client modifications on Minecraft servers. It works silently in the background — no entities are spawned, no blocks are modified, and players never notice it's there.

The plugin uses multiple detection layers to catch mods the moment a player joins. Detection is fast (2-4 seconds), accurate, and completely invisible to clients.

━━━━━━━━━━━━━━━━━━━━
KEY FEATURES
━━━━━━━━━━━━━━━━━━━━

• Instant Detection — Full mod scan completes in 2-4 seconds on first join
• Pre-World Detection — Detects mods before the player even enters the world
• Scan Suppression — Temporary Blindness + Slowness during scan (restored automatically)
• Chat Suppression — Chat blocked during scan to prevent information leakage
• Player Whitelist — Bypass detection for trusted players (online + offline support)
• Configurable Actions — Kick, Message, or Console Command on detection
• MiniMessage + Hex Colors — Modern color formatting in kick messages
• Hot Reload — Apply changes instantly via
  Code (Text):

  /smodblock reload
• Cross-Platform — Paper, Spigot, Purpur, BungeeCord, Velocity
• Bedrock Support — Floodgate / Geyser players automatically bypass detection
• Debug Mode — Detailed logging for troubleshooting

━━━━━━━━━━━━━━━━━━━━
DETECTED MODIFICATIONS
━━━━━━━━━━━━━━━━━━━━

• Meteor Client
• Freecam
• Litematica
• WorldTools
• Item Scroller
• Accurate Block Placement

Want more mods?
The detection system is extensible. New mods can be added by updating the internal registry — no configuration changes needed.

━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━

Command	Description	Permission
Code (Text): /smodblock reload	Reload plugin configuration and whitelist data	Code (Text): smodblock.admin
Code (Text): /smodblock whitelist add <player>	Add player to detection whitelist (online or offline)	Code (Text): smodblock.admin
Code (Text): /smodblock whitelist remove <player>	Remove player from detection whitelist	Code (Text): smodblock.admin
Code (Text): /smodblock whitelist list	Display all whitelisted players with online/offline status	Code (Text): smodblock.admin

Aliases: ━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━

Permission	Default	Description
Code (Text): smodblock.admin	Code (Text): op	Allows use of all sModBlock commands (reload, whitelist management)

━━━━━━━━━━━━━━━━━━━━
CONFIGURATION
━━━━━━━━━━━━━━━━━━━━

config.yml
whitelist.yml (auto-generated)
━━━━━━━━━━━━━━━━━━━━
PLACEHOLDERS
━━━━━━━━━━━━━━━━━━━━

Action Content Placeholders:

Placeholder	Description
Code (Text): %mod%	Comma-separated list of detected mod names (e.g., "Meteor, Litematica")
Code (Text): %player%	Player name

━━━━━━━━━━━━━━━━━━━━
COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━

Server Software:

• Paper — Full support (primary development platform)
• Spigot — Full support
• Purpur — Full support
• BungeeCord — Proxy-side compatible
• Velocity — Proxy-side compatible

Dependencies:

• PacketEvents (required) — Core packet interception library
• Floodgate (optional) — Bedrock player detection (auto-skip)

Requirements:

• Java 21 or higher
• Minecraft 26+

━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━

1. Download and install PacketEvents (required)
2. Download sModBlock.jar and place it in your
   Code (Text):

   plugins/
   folder
3. Start or restart your server
4. Edit
   Code (Text):

   plugins/sModBlock/config.yml
   to configure blocked mods and actions
5. Use
   Code (Text):

   /smodblock reload
   to apply changes without restart
6. Use
   Code (Text):

   /smodblock whitelist add <player>
   to bypass trusted players

━━━━━━━━━━━━━━━━━━━━
TROUBLESHOOTING
━━━━━━━━━━━━━━━━━━━━

Debug Mode:
Set in config.yml to enable detailed logging. All detection events are logged to console.

Common Issues:

• Detection not working: Verify PacketEvents is installed and running.
• False positives: Review the
  Code (Text):

  disallowed-mods
  list. Remove mods that should be allowed.
• Bedrock players being scanned: Ensure Floodgate plugin is installed.

━━━━━━━━━━━━━━━━━━━━
SUPPORT
━━━━━━━━━━━━━━━━━━━━

• Author: DedEnd
• Discord: mr.dedend

If you find a bug or need custom changes, contact on Discord with:

• Server version (e.g., 26.2)
• Plugin version (e.g., 1.0)
• Error log (if applicable)