MapBan

MapBan is a security and moderation tool for Minecraft server networks. It allows administrators to inspect, ban, and automatically purge illegal, offensive, or lag-inducing custom map arts across player inventories, containers, and item frames.

Supported Platforms

• Minecraft Version: 1.16 through 1.21+
• Server Engines: Spigot, Paper, Purpur, Folia

Core Features

• Instant Map Banning: Hold any filled map in your main hand and type /mapban ban to blacklist that map ID across the entire server.
• Automated Inventory Scans: Automatically detects banned maps on player join, inventory clicks, item pickups, and chest interactions.
• Configurable Enforcement Actions:
  • REMOVE: Silently deletes the banned map from the player's possession.
  • WARN_ONLY: Alerts the player and staff without deleting the item.
  • REMOVE_AND_PUNISH: Deletes the map and executes punishment commands (e.g. automatic kick or temp-ban).
• Audit File Logging: Keeps a timestamped mapban-audit.log file tracking who possessed or created banned maps.

Commands and Permissions

Command	Purpose	Permission
/mapban ban [reason]	Ban the Map ID of the item held in your main hand	mapban.admin
/mapban unban <id>	Unban a previously blacklisted map ID	mapban.admin
/mapban scan	Force an immediate scan across all online player inventories	mapban.admin
/mapban list	View all currently blacklisted map IDs and reasons	mapban.admin
/mapban reload	Reload configuration and blacklist database	mapban.admin

Key Permissions

• mapban.admin: Full permission to ban, unban, and scan maps.
• mapban.notify: Receive administrative alerts when banned maps are confiscated.
• mapban.bypass: Allows staff members to hold and inspect banned maps without deletion.

Configuration Reference

The configuration file is located at plugins/YowsefMapBan/config.yml:

# =====================================================
#               MapBan Configuration
# =====================================================

# Enforcement action: REMOVE, WARN_ONLY, or REMOVE_AND_PUNISH
action:
  type: REMOVE
  punishment-commands:
    - "kick {player} Possessing blacklisted map art (ID: {map_id})"

# Broadcast settings when a map is banned
on-ban:
  broadcast: false
  broadcast-message: "<gold>[MapBan]</gold> <yellow>Map ID {map_id} was blacklisted by {player}.</yellow>"

# Admin notification alerts
notifications:
  notify-player: true
  notify-admins: true
  sound:
    enabled: true
    name: ENTITY_ITEM_BREAK

# Logging options
logging:
  console: true
  file:
    enabled: true
    filename: "mapban-audit.log"