Moderation, Staff & Jail

BharatCore provides an integrated moderation infrastructure replacing multiple legacy plugins (Essentials Protect, OpenInv, AdvancedVanish, and Jail).

Core Moderation Capabilities

Packet-Level Vanish (/vanish or /v):
- Completely removes the player entity from server packet broadcasts.
- Suppresses join/quit messages, opening chest animations, and footstep sounds.
- Automatically hides vanished staff from tablists and dynmap/bluemap.
Player Freeze (/freeze <player>):
- Completely locks client movement, jump, and interact packets.
- Renders an informative title and chat message instructing the player to join Discord for screenshare/inspection.
- Automatically issues combat tag cancellation and alerts staff if the player disconnects while frozen.
Live Inventory & Ender Chest Inspection (/invsee, /endersee):
- Synchronous real-time inventory editing. Items moved by staff reflect immediately in the suspect's inventory.
- Supports armor slots, off-hand, and active potion effects.
Staff Jail System (/jail, /unjail):
- Teleports offenders to a defined jail cell and revokes command access.
- Prevents teleportation, block breaking, and messaging until the jail sentence timer expires.

Commands & Permissions

Command	Permission	Description
`/v`, `/vanish`	`bharatcore.staff.vanish`	Toggle complete packet invisibility.
`/freeze <player>`	`bharatcore.staff.freeze`	Lock player in place for inspection.
`/unfreeze <player>`	`bharatcore.staff.freeze`	Release frozen player.
`/invsee <player>`	`bharatcore.staff.invsee`	Live inventory viewer and modifier.
`/endersee <player>`	`bharatcore.staff.endersee`	Live ender chest viewer and modifier.
`/jail <player> <cell> [time]`	`bharatcore.staff.jail`	Send offender to jail cell.
`/unjail <player>`	`bharatcore.staff.jail`	Release player from jail.
`/report <player> <reason>`	None (Player)	Dispatches a violation ticket to online staff.
`/helpop <message>`	None (Player)	Priority SOS notification line to moderators.
`/socialspy`	`bharatcore.staff.socialspy`	Real-time monitoring of private `/msg` communication.

title: "BharatCore: Core Engine & Security Configurations" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."

Detailed line-by-line configuration and option reference for BharatCore: Core Engine & Security Configurations.

📄 `config.yml`

The main configuration file governing Redis connections, MySQL/H2 database parameters, Combat Tag timers, Lands hooks, and global feature toggles.

Full YAML Source (`config.yml`)

# ==========================================
# Module Toggles
# Enable (true) or Disable (false) core features here.
# Disabling a module entirely halts its logic and commands.
# ==========================================
modules:
  # Staff Jail System
  jail: true

  # Combat Logger: Prevents players from running away from PvP.
  combat: true

  # Master Chat System: Enables all chat-related features (Format, Mentions, Emojis, Filters).
  chat: true

  # Enables player-to-player teleportation systems.
  # Commands: /tpa, /tpahere, /tpaccept, /tpdeny, /tpatoggle
  tpa: true

  # Enables the home system, letting players save personal locations.
  # Commands: /home, /sethome, /delhome, /homes (Opens GUI)
  homes: true

  # Enables a centralized safe location for players to return to.
  # Commands: /spawn, /setspawn
  spawn: true

  # Enables server-wide public teleport locations.
  # Commands: /warp, /setwarp, /delwarp, /warps (Opens GUI)
  warps: true

  # Enables the custom lightweight world manager (replaces Multiverse-Core).
  # Commands: /world tp, /world create, /world delete, /world list
  # If you disable this, you can safely install Multiverse-Core instead.
  worlds: true

  # Enables chat and tab tags that players can display next to their name.
  # Commands: /tags (Opens GUI)
  tags: true

  # Enables custom name colorization for chat and tablist.
  # Commands: /namecolor (Opens GUI)
  namecolor: true

  # Enables gradient and custom text color selection for typing in chat.
  # Commands: /chatcolor (Opens GUI)
  chatcolor: true

  # Enables moderation filters blocking spam, flood, caps, and swears.
  chat-filters: true

  # Should Bharat-core control the chat layout (MiniMessage tags, LuckPerms prefixes, Tags)?
  # WARNING: Set to FALSE if you use an external plugin like ChatControl or VentureChat.
  chat-format: true

  # Enables server events like Join/Quit messages, Welcome Titles, & ActionBars.
  # Also handles downloading player heads asynchronously on join.
  announcements: true

  # Enables moderation and admin utilities.
  # Commands: /vanish, /flyspeed, /walkspeed, /gm (and gamemode aliases)
  staff: true

  # Enables the unified flight module (time-based temp-fly and unlimited staff fly)
  # Commands: /fly, /fly addtime, /fly settime
  flight: true

  # Enables the Lands claim plugin soft-dependency integration.
  # Integrates territory permissions, wilderness/claim isolation, custom store/rank flags,
  # combat safezone sync, and Lands-aware flight (tempfly/own/others land checks).
  lands: false

  # Enables "pinging" players in chat when typing their name, playing a sound.
  # Commands: /togglementions
  mentions: true

  # Enables the social system (Private Messaging, Ignoring, SocialSpy).
  # Commands: /msg, /r, /socialspy, /ignore
  social: true

  # Enables the system for players to submit tickets against rule breakers.
  # Commands: /report <player> <reason>
  reports: true

  # Enables the helpop system for contacting staff.
  # Commands: /helpop <message>
  helpop: true

  # Enables the cosmetic glow system.
  # Commands: /glow (Staff/Donors)
  # Disabling this saves substantial performance on large tablists.
  glow: true

  # Enables the economy module (Vault compatible).
  # Commands: /bal, /pay, /eco
  economy: true

  # Enables the shards currency and shard shop.
  # Commands: /shards, /shardsadmin, /shardshop, /afkzone
  shards: true
  
  # Enables the smooth anti-flicker night vision module.
  # Commands: /nv
  nightvision: true

  # Enables the ping command.
  # Commands: /ping
  ping: true

  # Enables the playtime tracking system.
  # Commands: /playtime
  playtime: true

  # Enables the custom-command system, hooking into custom_commands.yml
  # Disabling this saves memory if you don't use dynamic alias commands.
  custom-commands: true

  # Enables automatic teleportation to spawn when falling into the void.
  # Useful for hub worlds or skyblock-style maps.
  void-spawn: true

# ... [Subsequent repetitive milestone/item tiers follow identical YAML structure] ...

  messages:
    elytra-disabled: "<error>You cannot use an Elytra while in combat!"
    elytra-fireworks-disabled: "<error>You cannot use fireworks while gliding in combat!"
    ender-pearl-disabled: "<error>You cannot use Ender Pearls while in combat!"
    trident-disabled: "<error>You cannot use a Trident while in combat!"
    wind-charge-disabled: "<error>You cannot use Wind Charges while in combat!"
    chorus-fruit-disabled: "<error>You cannot eat Chorus Fruit while in combat!"
    item-blocked: "<error>You cannot use this item while in combat!"

# ==========================================
# Security Settings
# ==========================================
security:
  # List of exact usernames that are allowed to receive the "owner" rank or the "*" permission.
  # If any player not on this list is given the owner rank (even by console),
  # BharatCore will instantly remove the rank and log the security exploit.
  allowed-owners:
    - "brdshado"
    - "roizplayz"


  # -----------------
  # Vote Reminder Settings
  # -----------------
  vote-reminder:
    enabled: true
    delay-seconds: 15
    # The message supports MiniMessage formatting and PlaceholderAPI placeholders.
    message:
      - ""
      - "<#00d2ff><bold>? VOTE REMINDER</bold>"
      - "<white>You have voted <#00d2ff>%VotingPlugin_Daily_Total%<white> times today!"
      - "<white>Bonus Claimed: <#00d2ff>%VotingPlugin_Daily_Bonus%"
      - "<white>Type <#00d2ff>/vote <white>to vote and get rewards!"
      - ""

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`modules`	`Object`	Root configuration section managing `modules` subsystem.
`modules.jail`	`true`	Adjusts `jail` parameter for the `modules` handler.
`modules.combat`	`true`	Adjusts `combat` parameter for the `modules` handler.
`modules.chat`	`true`	Adjusts `chat` parameter for the `modules` handler.
`modules.tpa`	`true`	Adjusts `tpa` parameter for the `modules` handler.
`modules.homes`	`true`	Adjusts `homes` parameter for the `modules` handler.
`modules.spawn`	`true`	Adjusts `spawn` parameter for the `modules` handler.
`modules.warps`	`true`	Adjusts `warps` parameter for the `modules` handler.
`modules.worlds`	`true`	Adjusts `worlds` parameter for the `modules` handler.
`modules.tags`	`true`	Adjusts `tags` parameter for the `modules` handler.
`modules.namecolor`	`true`	Adjusts `namecolor` parameter for the `modules` handler.
`modules.chatcolor`	`true`	Adjusts `chatcolor` parameter for the `modules` handler.
`modules.chat-filters`	`true`	Adjusts `chat-filters` parameter for the `modules` handler.
`modules.chat-format`	`true`	Adjusts `chat-format` parameter for the `modules` handler.
`modules.announcements`	`true`	Adjusts `announcements` parameter for the `modules` handler.
`modules.staff`	`true`	Adjusts `staff` parameter for the `modules` handler.
`modules.flight`	`true`	Adjusts `flight` parameter for the `modules` handler.
`modules.lands`	`false`	Adjusts `lands` parameter for the `modules` handler.
`modules.mentions`	`true`	Adjusts `mentions` parameter for the `modules` handler.
`modules.social`	`true`	Adjusts `social` parameter for the `modules` handler.
`modules.reports`	`true`	Adjusts `reports` parameter for the `modules` handler.
`modules.helpop`	`true`	Adjusts `helpop` parameter for the `modules` handler.
`modules.glow`	`true`	Adjusts `glow` parameter for the `modules` handler.
`modules.economy`	`true`	Adjusts `economy` parameter for the `modules` handler.
`modules.shards`	`true`	Adjusts `shards` parameter for the `modules` handler.
`modules.nightvision`	`true`	Adjusts `nightvision` parameter for the `modules` handler.
`modules.ping`	`true`	Adjusts `ping` parameter for the `modules` handler.
`modules.playtime`	`true`	Adjusts `playtime` parameter for the `modules` handler.
`modules.custom-commands`	`true`	Adjusts `custom-commands` parameter for the `modules` handler.
`modules.void-spawn`	`true`	Adjusts `void-spawn` parameter for the `modules` handler.
`modules.perks`	`true`	Adjusts `perks` parameter for the `modules` handler.
`modules.audit`	`true`	Adjusts `audit` parameter for the `modules` handler.
`modules.coinshop`	`true`	Adjusts `coinshop` parameter for the `modules` handler.
`modules.anti-exploit`	`true`	Adjusts `anti-exploit` parameter for the `modules` handler.
`modules.teams`	`true`	Adjusts `teams` parameter for the `modules` handler.
`modules.store`	`List/Object`	Adjusts `store` parameter for the `modules` handler.
`modules.vote`	`List/Object`	Adjusts `vote` parameter for the `modules` handler.
`storage`	`Object`	Root configuration section managing `storage` subsystem.
`storage.type`	`"H2"`	Adjusts `type` parameter for the `storage` handler.
`storage.host`	`"localhost"`	Adjusts `host` parameter for the `storage` handler.
`storage.port`	`"5432"`	Adjusts `port` parameter for the `storage` handler.
`storage.name`	`"bharatmc"`	Adjusts `name` parameter for the `storage` handler.
`storage.user`	`"postgres"`	Adjusts `user` parameter for the `storage` handler.
`storage.password`	`""`	Adjusts `password` parameter for the `storage` handler.
`storage.pool-size`	`15`	Adjusts `pool-size` parameter for the `storage` handler.
`storage.connection-timeout-ms`	`15000`	Adjusts `connection-timeout-ms` parameter for the `storage` handler.
`storage.join-load-delay-ms`	`300`	Adjusts `join-load-delay-ms` parameter for the `storage` handler.
`redis`	`Object`	Root configuration section managing `redis` subsystem.
`redis.enabled`	`false`	Adjusts `enabled` parameter for the `redis` handler.
`redis.host`	`"localhost"`	Adjusts `host` parameter for the `redis` handler.
`server-name`	`"survival"`	Root configuration section managing `server-name` subsystem.
`chat-settings`	`Object`	Root configuration section managing `chat-settings` subsystem.
`announcement-settings`	`Object`	Root configuration section managing `announcement-settings` subsystem.
`home-settings`	`Object`	Root configuration section managing `home-settings` subsystem.
`spawn-settings`	`Object`	Root configuration section managing `spawn-settings` subsystem.
`team-settings`	`Object`	Root configuration section managing `team-settings` subsystem.
`teleport-settings`	`Object`	Root configuration section managing `teleport-settings` subsystem.
`staff-settings`	`Object`	Root configuration section managing `staff-settings` subsystem.
`report-settings`	`Object`	Root configuration section managing `report-settings` subsystem.
`helpop-settings`	`Object`	Root configuration section managing `helpop-settings` subsystem.
`glow-settings`	`Object`	Root configuration section managing `glow-settings` subsystem.
`economy-settings`	`Object`	Root configuration section managing `economy-settings` subsystem.
`afk-zone-settings`	`Object`	Root configuration section managing `afk-zone-settings` subsystem.
`shards-settings`	`Object`	Root configuration section managing `shards-settings` subsystem.
`void-spawn-settings`	`Object`	Root configuration section managing `void-spawn-settings` subsystem.
`combat`	`Object`	Root configuration section managing `combat` subsystem.
`security`	`Object`	Root configuration section managing `security` subsystem.

📄 `antiexploit.yml`

Anti-duplication, crash-book prevention, Nether roof glitch suppression, and illegal projectile rate limits.

Full YAML Source (`antiexploit.yml`)

# ==========================================
# Anti-Exploit Configuration
# Enable/Disable specific checks and configure punishments
# ==========================================

# Master toggle for the entire anti-exploit system
# If false, NONE of the checks below will run.
enabled: true

# -----------------
# Punishment Actions:
# warn: Cancels the action and sends the warning message to the player.
# kick: Kicks the player from the server with the warning message.
# ban: Permanently bans the player's name via the server's native ban list and kicks them.
# command: Runs a custom console command (e.g. for LiteBans). Use %player% and %message%.
# cancel_only: Cancels the action silently (no warning).
# none: Does nothing (allows the action).
# -----------------

checks:
  # Prevents clients like Baritone from instantly placing blocks to glitch through blocks or lag the server.
  # Also blocks excessive End Crystal and Respawn Anchor interaction.
  interaction_rate_limit:
    enabled: true
    # Time in milliseconds between interact actions allowed
    limit_ms: 250
    # Send a warning if they are clicking faster than this (ms)
    warn_threshold_ms: 50
    action: "warn"
    message: "&c&lWARNING: &7Please disable AutoClicker/Aura. Your hack client is highly detected and may result in an automatic ban if you continue."

  # Detects packet criticals (dealing critical hits without jumping).
  packet_criticals:
    enabled: true
    action: "warn"
    message: "&c&lWARNING: &7Please disable Packet Criticals. Your hack client is highly detected and may result in an automatic ban if you continue."

  # Prevents players from shooting arrows impossibly fast (BowAimbot / FastBow)
  bow_spam:
    enabled: true
    limit_ms: 200
    action: "kick"
    command: "tempban %player% 1d BowSpam -s"
    message: "&c&lWARNING: &7Please disable BowSpam/FastBow."

  # Detects highly suspicious mining patterns commonly used by Baritone or X-Ray.
  baritone_mining:
    enabled: true
    # Maximum valuable ores (diamonds/debris) mined within 60 seconds
    alert_threshold: 15
    kick_threshold: 25
    action: "kick" # When kick threshold is reached
    kick_message: "&c&lANTI-EXPLOIT &8| &7You were kicked for suspicious mining activity (Baritone/X-Ray)."

  # Blocks known exploit channels used by clients like ParadiseClient-X or modified Purpur clients
  channel_exploits:
    enabled: true
    action: "kick"
    message: "&c&lANTI-EXPLOIT &8| &7Malicious payload detected. Disconnect."

  # Blocks Meteor Client OffhandCrash attempts
  offhand_crash:
    enabled: true
    # Maximum swaps per second
    max_swaps_per_second: 30
    action: "kick"
    message: "&c&lANTI-EXPLOIT &8| &7OffhandCrash Exploit Detected."

  # Prevents players from creating books that crash the server (BookDrop exploit)
  book_exploit:
    enabled: true
    action: "cancel_only"

  # Prevents players from creating signs with insanely long text that lag clients (SignCrash)
  sign_exploit:
    enabled: true
    action: "cancel_only"

  # Blocks Log4Shell (Log4j / JNDI) attempts in chat
  log4j_exploit:
    enabled: true
    action: "kick"
    message: "&c&lANTI-EXPLOIT &8| &7Log4Shell attempt blocked."

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`enabled`	`true`	Root configuration section managing `enabled` subsystem.
`checks`	`Object`	Root configuration section managing `checks` subsystem.
`checks.interaction_rate_limit`	`List/Object`	Adjusts `interaction_rate_limit` parameter for the `checks` handler.
`checks.packet_criticals`	`List/Object`	Adjusts `packet_criticals` parameter for the `checks` handler.
`checks.bow_spam`	`List/Object`	Adjusts `bow_spam` parameter for the `checks` handler.
`checks.baritone_mining`	`List/Object`	Adjusts `baritone_mining` parameter for the `checks` handler.
`checks.channel_exploits`	`List/Object`	Adjusts `channel_exploits` parameter for the `checks` handler.
`checks.offhand_crash`	`List/Object`	Adjusts `offhand_crash` parameter for the `checks` handler.
`checks.book_exploit`	`List/Object`	Adjusts `book_exploit` parameter for the `checks` handler.
`checks.sign_exploit`	`List/Object`	Adjusts `sign_exploit` parameter for the `checks` handler.
`checks.log4j_exploit`	`List/Object`	Adjusts `log4j_exploit` parameter for the `checks` handler.

📄 `command-guard.yml`

Hides internal plugin lists, intercepts tab-completion, and enforces cooldowns on critical user commands.

Full YAML Source (`command-guard.yml`)

# BharatCore Command Guard Configuration
# Effectively secure your server by blocking sensitive commands and tab-completion.

settings:
  # Automatically block all commands containing a colon (e.g., bukkit:ver)
  block-colon-commands: true
  
  # List of plugin prefixes that ARE allowed to use colons (e.g., strikepractice:kiteditor)
  # This allows you to block bukkit/minecraft/spigot while allowing specific plugin commands.
  whitelisted-colon-prefixes:
    - "strikepractice"
    - "litebans"
    - "essentials"
  
  # Permission to bypass all command restrictions.
  # Note: This is now the ONLY way to bypass. If you use op-permission-level: 0
  # in server.properties, OPs will be restricted unless they have this permission.
  bypass-permission: "bharatcore.admin"
  
  blocked-message: "&c&lBHARATCORE &8» &cThat command is currently restricted or disabled!%nl%&7Command: &f/{command}"

# List of exact commands to block (without the slash)
blocked-commands:
  - "?"
  - "about"
  - "ver"
  - "version"
  - "pl"
  - "plugins"
  - "help"
  - "icanhasbukkit"
  - "me"
  - "buy"
  - "tebex"
  - "buycraft"
  - "lp"
  - "luckperms"
  - "perm"
  - "permission"
  - "permissions"
  - "perms"
  - "geyser"
  - "tab"
  - "fawe"
  - "worldedit"
  - "we"
  - "fastasyncworldedit"
  - "rg"
  - "region"
  - "regions"
  - "worldguard"
  - "server"
  - "minehut"

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`settings`	`Object`	Root configuration section managing `settings` subsystem.
`settings.block-colon-commands`	`true`	Adjusts `block-colon-commands` parameter for the `settings` handler.
`settings.whitelisted-colon-prefixes`	`List/Object`	Adjusts `whitelisted-colon-prefixes` parameter for the `settings` handler.
`settings.bypass-permission`	`"bharatcore.admin"`	Adjusts `bypass-permission` parameter for the `settings` handler.
`settings.blocked-message`	`"&c&lBHARATCORE &8» &cThat command is currently restricted or disabled!%nl%&7Command: &f/{command}"`	Adjusts `blocked-message` parameter for the `settings` handler.
`blocked-commands`	`Object`	Root configuration section managing `blocked-commands` subsystem.

📄 `custom_commands.yml`

Server-wide aliases (/discord, /store, /vote) with formatted interactive messages and clickable URLs.

Full YAML Source (`custom_commands.yml`)

# BharatCore Custom Commands Configuration
# Create your own custom commands here!
# Supports MiniMessage (colors, hover, click, fonts, etc.)
# Reference: https://docs.advntr.dev/minimessage/format.html

commands:
  discord:
    aliases:
      - "dc"
      - "disc"
    permission: "" # Leave empty for no permission
    messages:
      - ""
      - "<#7289da><bold>✉ Join Our Discord"
      - ""
      - "<white>Connect, chat, trade & enjoy with our <#a3b4ff>community<white>."
      - "<white>Stay updated with <#a3b4ff>events<white>, giveaways & support."
      - ""
      - "<click:open_url:\"https://discord.gg/bharatmc\"><hover:show_text:\"<gray>Click to join our Discord!\"><#7289da>♦ <white>discord.gg/bharatmc</hover></click>"
      - ""

  store:
    aliases:
      - "shop"
      - "buy"
    permission: ""
    messages:
      - ""
      - "<#ffaa00><bold>🛒 Visit Our Store"
      - ""
      - "<white>Purchase <#ffd580>ranks<white>, coins, keys, and crate bundles."
      - "<white>Support the server and unlock <#ffd580>premium rewards<white>."
      - ""
      - "<click:open_url:\"https://store.bharatmc.com\"><hover:show_text:\"<gray>Click to visit our store!\"><#ffaa00>♦ <white>store.bharatmc.com</hover></click>"
      - ""

  rules:
    aliases:
      - "rule"
    permission: ""
    messages:
      - ""
      - "<red><bold>⚖ SERVER RULES"
      - ""
      - "<gray>1. <white>Be respectful to all players."
      - "<gray>2. <white>No cheating or exploits."
      - "<gray>3. <white>No spamming or advertising."
      - ""
      - "<gray>Read more at: <yellow>rules.bharatmc.com"
      - ""

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`commands`	`Object`	Root configuration section managing `commands` subsystem.
`commands.discord`	`List/Object`	Adjusts `discord` parameter for the `commands` handler.
`commands.store`	`List/Object`	Adjusts `store` parameter for the `commands` handler.
`commands.rules`	`List/Object`	Adjusts `rules` parameter for the `commands` handler.

Core Moderation Capabilities​

Commands & Permissions​

title: "BharatCore: Core Engine & Security Configurations" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."​

📄 config.yml​

Full YAML Source (config.yml)​

Key Options & Behavior Breakdown​

📄 antiexploit.yml​

Full YAML Source (antiexploit.yml)​

Key Options & Behavior Breakdown​

📄 command-guard.yml​

Full YAML Source (command-guard.yml)​

Key Options & Behavior Breakdown​

📄 custom_commands.yml​

Full YAML Source (custom_commands.yml)​

Key Options & Behavior Breakdown​

Core Moderation Capabilities

Commands & Permissions

title: "BharatCore: Core Engine & Security Configurations" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."

📄 `config.yml`

Full YAML Source (`config.yml`)

Key Options & Behavior Breakdown

📄 `antiexploit.yml`

Full YAML Source (`antiexploit.yml`)

Key Options & Behavior Breakdown

📄 `command-guard.yml`

Full YAML Source (`command-guard.yml`)

Key Options & Behavior Breakdown

📄 `custom_commands.yml`

Full YAML Source (`custom_commands.yml`)

Key Options & Behavior Breakdown