Config File (config.yml)
📜Config File (config.yml)
# ============================================================
# MANTIC PROTECTOR CONFIGURATION
# ------------------------------------------------------------
# Authors: Jordan & Dejavu
# Support: https://discord.mantic.dev
# Notes:
# - All changes require a plugin reload or restart.
# - Use placeholders (e.g., {player}, {uuid}, {realm}) where specified.
# - Leave fields empty where indicated to use plugin defaults.
# ============================================================
# ############################################################
# # SYSTEM CONFIGURATION #
# ############################################################
# 1. License Key:
# Your unique license key is required for the plugin to work.
# You can obtain or manage your key at: https://discord.mantic.dev
# 2. Debug Mode:
# Enables verbose logging in the console for troubleshooting.
# WARN: Disable in production to reduce console spam.
# 3. Realm Name:
# Represents the name of your server or network in webhooks.
# If using LuckPerms, this value updates automatically.
license: XXXX-XXXX-XXXX-XXXX
debug-mode: false
realm-name: ???
# Plugin Name:
# Display name shown in plugin messages and logs.
# Keep it short and clean (avoid special characters).
# Leave this empty to use the plugin's default internal name.
plugin-name: ''
# ############################################################
# # PROTECTED USERS #
# ############################################################
# Players exempt from operator and permission checks.
# Useful for developers or trusted administrators.
# Format: username, UUID, allowed operator status, optional groups, IP, and geo history.
users:
- username: KingpinJordan
unique: abed4eb2-02ba-4dfd-b33f-bf1e5f9137d0
allowed-op: true
whitelisted-groups:
- Developer
address-history: []
geo-history: []
- username: TheDeejayV1
unique: 1a85be2f-e65b-4a05-a3f4-6f2ffd3696da
allowed-op: true
whitelisted-groups:
- Developer
address-history: []
geo-history: []
# ############################################################
# # OPERATOR PROTECTION #
# ############################################################
# Automatically checks for unauthorized operators.
op-checker-task: false
op-checker-every-x-seconds: 5
# Console OP Protection:
# Prevents the console from opping players not listed in the 'users' list.
# Set to false to allow the console to op anyone.
can-console-op-unauthorized-users: true
# ############################################################
# # COMMAND & CHAT FILTERING #
# ############################################################
# Monitors player commands for blocked words or unauthorized usage.
command-listener: true
# List of forbidden words in command usage. Players using these will trigger punishment commands.
blocked-words:
- hacked
- griefed
# Commands players are entirely not permitted to use.
blocked-commands:
- pl
- plugins
- version
- op
# Permissions that trigger the blocked word scanner.
command-word-watcher-permissions:
- essentials.broadcast
- worldedit.*
# Commands executed when a player uses a blocked word. ({player})
commands-for-blocked-word:
- ban {player} Not Authorized to use this!
# ############################################################
# # IP & GEO SECURITY #
# ############################################################
# Handles IP history and geolocation checks to detect suspicious logins.
ip-history: true
ip-geolocation: true
# API endpoint or key for the IP geolocation service.
api-key: https://app.ipgeolocation.io/dashboard
# Algorithm used to hash and anonymize stored IP addresses (Recommended: SHA-256).
hash-algorithm: SHA-256
# ############################################################
# # ADVANCED SECURITY FEATURES #
# ############################################################
# Extra layers of protection for your server.
block-vpn-and-proxy: true
vpn-kick-message: '&cVPNs and Proxies are not allowed on this server.'
filter-chat-signs-books: true
gamemode-watcher: true
deop-on-quit: true
# ############################################################
# # PERMISSION BLACKLISTS #
# ############################################################
# Permission groups that are forbidden from being assigned.
blacklisted-groups:
- dev
- owner
punishment-for-blacklisted-groups:
- lp user {player} clear
# Permissions that should never be assigned to players.
blacklisted-perms-check-join: true
blacklisted-perms:
- essentials.*
- '*'
- bukkit.*
- minecraft.*
- worldedit.*
- worldguard.*
- luckperms.*
- lp.*
- luckperms.truseditor
- luckperms.editor
- luckperms.user.permission.set
- excellentcrates.*
- minecraft.admin
punishment-has-blacklisted-perms:
- deop {player}
- lp user {player} clear
# ############################################################
# # PUNISHMENT SETTINGS #
# ############################################################
# Defines how staff and players are handled when unauthorized actions occur.
# --- Unauthorized Operator Actions ---
punish-staff-who-gave-op: true
staff-punishment-who-gave-op:
- deop {player}
- ban {player} Not Authorized to give players op!
unauthorized-op-user-punishment-cmds:
- deop {player}
not-in-list-op-checker:
- ban {player} Not Authorized to be opped! -s
# --- Mass Punishment Watcher ---
# Monitors mass punishment actions such as bans or kicks to prevent staff gone rogue.
punishment-listener: false
ignore-punishment-if-silent: false
store-punishment-window-minutes: 5
max-punishment-within-window: 15
watch-punishment-types:
- ban
- kick
punishment-for-mass-punishments:
- tempban {player} 6hr You have punished too many players within 5 minutes! -s
# ############################################################
# # STAFF COMMAND WATCHER #
# ############################################################
# Monitors specific commands executed by staff members and logs them.
# Format: "/command": "required.permission"
staff-commands-watch:
/crate give: starflarecrates.give
/eco: essentials.eco
/crate giveall: starflarecrates.giveall
/acrates: ac.admin
/givevoucher: commandvouchers.*
/silkspawners: silkspawners.*
/gamemode creative: essentials.gamemode.creative
/silkspawner: silkspawners.*
/ss: silkspawners.*
# ############################################################
# # STAFF IP LOCKING #
# ############################################################
# Prevents staff members from joining if their IP doesn't match a whitelist.
# Highly recommended to prevent session hijacking.
strict-staff-ip-lock: false
ip-lock-kick-message: '&c[Security] You are joining from an unauthorized IP address.'
# Map of UUID to allowed IP address (or subnet).
staff-ip-whitelist:
abed4eb2-02ba-4dfd-b33f-bf1e5f9137d0: 192.168.1.50
# ############################################################
# # ALT ACCOUNT LIMITER #
# ############################################################
# Limits how many accounts can be online from the same IP address.
enable-alt-limiter: false
max-accounts-per-ip: 3
alt-limit-kick-message: '&c[Security] Too many accounts online from this IP.'
# ############################################################
# # MALICIOUS NBT BLOCKER #
# ############################################################
# Prevents chunk-ban items, crash books, and illegal enchantments
# from being moved, dropped, or interacted with.
block-illegal-items: true
max-book-pages: 50
max-enchantment-level: 10
nbt-blocker-message-inventory: '&c[Security] Illegal item detected and blocked.'
nbt-blocker-message-interact: '&c[Security] Illegal item detected and removed from
your inventory.'
nbt-blocker-message-drop: '&c[Security] You cannot drop illegal items.'
# ############################################################
# # DISCORD WEBHOOK SETTINGS #
# ############################################################
# Discord webhook configuration for alerts and logging.
# Each webhook can be enabled or disabled individually.
# Use placeholders like {player}, {uuid}, {realm}, {ip}, {reason}.
# --- Operator & Permission Alerts ---
op-task-alert-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**Reason:** `OP (TASK CHECKER)`'
- ''
- '**Realm:** `{realm}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
join-blacklisted-perm-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**Reason:** `Joined with blacklisted Permission {perm}`'
- ''
- '**Realm:** `{realm}`'
- ''
- '**IP:** `{ip}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
blocked-player-command-op-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- Player tried to op another player in-game!
- ''
- '**Opper:** `{player}` (`{uuid}`)'
- '**Victim:** `{victim}` (`{victim_uuid}`)'
- ''
- '**Realm:** `{realm}`'
- '**Opper IP:** `{ip}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
luck-perms-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**Reason:** `{reason}`'
- ''
- '**Realm:** `{realm}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
# --- System Watchers ---
punishment-watcher-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**Punishments:** `{punishments}`'
- ''
- '**Realm:** `{realm}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
ip-mis-match-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**IP Hash:** `{ip-hash}`'
- ''
- '**Realm:** `{realm}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
geo-mis-match-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#1e90ff'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- ''
- '**Geo Hash:** `{geo-hash}`'
- ''
- '**Realm:** `{realm}`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
# --- Advanced Security Alerts ---
vpn-proxy-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff0000'
title: ''
description:
- '**Player:** `{player}`'
- '**IP:** ||`{ip}`||'
- '**Country:** `{country}`'
- '**Org:** `{org}`'
- '**Reason:** `VPN/Proxy Detected`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
chat-filter-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff9900'
title: ''
description:
- '**Player:** `{player}`'
- '**Type:** `{type}`'
- '**Message/Content:**'
- '``` {content} ```'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
gamemode-watcher-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff0000'
title: ''
description:
- '**Player:** `{player}`'
- '**Action:** `Attempted to enter Creative mode`'
- '**Result:** `Forced to Survival`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
staff-command-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff0000'
title: ''
description:
- '**Staff Member:** `{player}`'
- '**Command Executed:**'
- '``` {command} ```'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
staff-ip-lock-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff0000'
title: ''
description:
- '**Staff Member:** `{player}`'
- '**UUID:** `{uuid}`'
- '**Attempted IP:** ||`{ip}`||'
- '**Expected Subnet:** `{expected_ip}`'
- '**Action:** `Blocked (IP Mismatch)`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
alt-limit-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ffaa00'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- '**IP:** ||`{ip}`||'
- '**Action:** `Blocked (Too many accounts on this IP)`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
illegal-item-webhook:
enabled: false
webhook-url: https://discord.com/api/webhooks/XXXX/XXXX
webhook-name: Mantic Protector
webhook-avatar: https://mantic.dev/logo.png
colour: '#ff0000'
title: ''
description:
- '**Player:** `{player}`'
- '**UUID:** `{uuid}`'
- '**Item Type:** `{item_type}`'
- '**Reason:** `{reason}`'
- '**Action:** `Item Destroyed`'
footer: Made with ❤ by Jordan & Dejavu
mention-all: false
Last updated