Documentation
Configuration Guide
1. Language Settings
Code (YAML):
# Language Options
language
: TR
# TR (Turkish), EN (English)
2. Captcha Settings
Code (YAML):
# Captcha Trigger Mode
captcha-trigger-mode
: BOTH
# CHANCE, TIMER, BOTH
# Chance-based settings
captcha-chance
: 0.1
# 10% chance
captcha-chance-interval
: 300
# Check every 5 minutes
# ⏰ Timer-based settings
captcha-timer-interval
: 600
# Trigger every 10 minutes
3. AFK Push Settings
Code (YAML):
# AFK Push System
afk-push-enabled
: true
# Enable/disable AFK push
afk-push-interval
: 36000
# Push after 10 hours (seconds)
afk-push-strength
: 0.5
# Push strength (0.1 - 2.0)
afk-push-direction
: RANDOM
# RANDOM, NORTH, SOUTH, EAST, WEST
afk-push-cooldown
: 300
# Push cooldown (seconds)
4. Protection Settings
Code (YAML):
# Control Options
block-break-check
: true
# Block break control
fishing-check
: true
# Fishing control
mob-attack-check
: true
# Mob attack control
# Event Chances
block-break-check-chance
: 0.2
# 20% chance
fishing-check-chance
: 3
# 300% chance (always)
mob-attack-check-chance
: 0.5
# 50% chance
5. Menu Settings
Code (YAML):
# Menu Title
menu-title
: '&6&lNİTANTİ &7Bot Kontrolü &8| &a
{item
} &7eşyasına tıkla'
# Menu Items (MAX 9 ITEMS)
menu-items:
COAL_ORE
: '&a&lKömür Cevheri'
DIRT
: '&a&lToprak'
SAND
: '&a&lKum'
IRON_ORE
: '&a&lDemir Cevheri'
GOLD_BLOCK
: '&a&lAltın Bloğu'
GRASS_BLOCK
: '&a&lÇimen'
BEACON
: '&a&lİşaret'
MINECART
: '&a&lMaden Arabası'
BUCKET
: '&a&lKova'
6. Kick Settings
Code (YAML):
# Kick Options
kick-mode
: true
# Enable kick system
kick-interval
: 10
# Kick after 10 seconds
anti-rejoin
: true
# Anti-rejoin protection
wrong-item-click-kick
: false
# Kick on wrong item click
Commands & Permissions
Commands:
-
- Reload plugin configuration
Permissions:
-
- Allows reloading plugin configuration (Default: OP)
-
- Bypass all captcha and AFK checks (Default: None)
Language System
Supported Languages:
- Turkish (TR): Full Turkish language support
- English (EN): Complete English language support
Language Files:
-
- Main configuration with language setting
-
Code (Text):
messages.yml
- All language messages (TR/EN)
Changing Language:
1. Edit
and set
Code (Text):
language: TR
or
Code (Text):
language: EN
2. Use
to apply changes
3. All messages will automatically update
Advanced Configuration
Blacklisted Worlds:
Code (YAML):
# Blacklisted Worlds (No checks in these worlds)
blacklisted-worlds
:
- no_check_world
- creative_world
- lobby_world
Block Break Control List:
Code (YAML):
# ⛏️ Blocks to monitor for captcha
block-break-event-check-list
:
- COAL_ORE
- IRON_ORE
- GOLD_ORE
- DIAMOND_ORE
- REDSTONE_ORE
- EMERALD_ORE
- LAPIS_ORE
- ANCIENT_DEBRIS
- NETHER_GOLD_ORE
Performance Tips
Optimization Settings:
- Set
Code (Text):
captcha-chance
to 0.05-0.1 for balanced performance
- Use
Code (Text):
captcha-timer-interval: 1200
for less frequent checks
- Disable
Code (Text):
afk-push-particles
on high-population servers
- Add frequently used worlds to
Code (Text):
blacklisted-worlds
Memory Usage:
- Base memory usage: ~2MB
- Per active session: ~0.1MB
- Recommended for servers with 100+ players
Troubleshooting
Common Issues:
1. Plugin not working:
- Check if you have the correct permissions
- Verify that the plugin is enabled in
folder
- Check console for error messages
2. Captcha not triggering:
- Verify
Code (Text):
captcha-trigger-mode
setting
- Check if player is in blacklisted world
- Ensure player doesn't have
permission
3. AFK Push not working:
- Check if
Code (Text):
afk-push-enabled
is true
- Verify
Code (Text):
afk-push-interval
setting
- Ensure player is not in blacklisted world
4. Language not changing:
- Use
after changing language
- Check
Code (Text):
messages.yml
file exists
- Verify language code is correct (TR/EN)
Before Asking for Help:
- Check this documentation
- Verify your configuration
- Check console logs for errors
- Try with default settings first