vMaiopt (vMobAIOptimizer) by vProLabs

Intelligent AI optimization plugin that dynamically adapts to TPS.
Eliminates lag from mobs while maintaining gameplay quality.

Discord • Website • Support

---

✨ Features

✅ Adaptive Optimization (Implemented)

Feature	Status	Details
4-Tier TPS System	✅	Normal (19+)/Light (16-18)/Moderate (13-15)/Severe (<12)
Dynamic AI Distance	✅	48-128 blocks adaptive based on TPS
Hysteresis Prevention	✅	Prevents flickering between levels
Colored Console Loading	✅	Visual loading sequence with checkmarks

✅ Thread-Safe Async Processing (Implemented)

Feature	Status	Details
Async Entity Scanning	✅	Three-phase architecture (sync→async→sync)
EntitySnapshot System	✅	Immutable data transfer objects
Distance Calculation	✅	Squared distance for performance
AI Toggle Queue	✅	Batched sync entity modifications

✅ Smart Mob AI (Implemented)

Feature	Status	Details
Passive Mob Pathfinding	✅	5 blocks / 15 seconds movement
Hostile State Machine	✅	IDLE→SEARCH→CHASE→ATTACK states
Player-Only Targeting	✅	Hostiles ignore other hostiles
Armor-Based Priority	✅	Targets lower armor players first
Target Retention	✅	Reduced target switching

✅ Village Optimization (Implemented)

Feature	Status	Details
Trading AI Toggle	✅	Disabled beyond 32 blocks
POI Search Throttling	✅	10t → 50t when distant
Gossip Sampling	✅	20% processing rate
Iron Golem Limiting	✅	Spawn check 10t → 100t

✅ Enderman End Optimization (Implemented)

Feature	Status	Details
Population Control	✅	50% AI disable at 50+ endermen
Teleport Throttling	✅	40 tick checks for non-targeted
Optimized Stare Detection	✅	Vector dot product pre-check
End-Specific Ranges	✅	16 block follow range

✅ Redstone Integration (Implemented)

Feature	Status	Details
Vehicle Detection	✅	Minecarts, boats, striders
Piston Chamber Detection	✅	2x2x2 enclosed redstone spaces
Water Stream Detection	✅	Flowing water + solid blocks
1x1 Hole Detection	✅	4-sided solid confinement
Mob Farm Mode	✅	AI disable for confined mobs

✅ Logging & Monitoring (Implemented)

Feature	Status	Details
Error Logger	✅	Lazy init, daily rotation (error-log-YYYY-MM-dd.log)
Actions Folder	✅	logs/actions/actions-YYYY-MM-dd.log
Admin Notifications	✅	Discord link on error, join notifications
TPS Monitoring	✅	Rolling 20-second average
Debug Mode	✅	Detailed optimization logging

⏳ Coming Soon

Feature	Status	ETA
Discord Webhook Reports	⏳	Hourly performance reports

---

🚀 Commands

Command	Permission	Description
/vmaiopt	vmaiopt.admin	Main command with help
/vmaiopt status	vmaiopt.admin	Shows TPS, lag level, active optimizations
/vmaiopt reload	vmaiopt.admin	Reloads configuration with validation
/vmaiopt debug toggle	vmaiopt.admin	Toggle debug mode
/vmaiopt debug stats	vmaiopt.admin	Show debug statistics
/vmaiopt version	vmaiopt.admin	Show plugin version

---

🔒 Permissions

Permission	Default	Description
vmaiopt.admin	op	All commands and update notifications
vmaiopt.bypass	false	Exempt from AI optimizations
vmaiopt.update.notify	op	Receive update notifications

---

⚙️ Configuration

# config.yml - Main configuration
adaptive-optimization:
  enabled: true
  tps-thresholds:
    normal: 19.0    # 19+ TPS
    light: 16.0     # 16-18 TPS
    moderate: 13.0  # 13-15 TPS
    severe: 10.0    # <12 TPS

distance-optimization:
  enabled: true
  disable-ai-distance: 48  # 48-128 blocks adaptive
  
village:
  enabled: true
  trading-disable-distance: 32
  poi-search-interval: 50
  gossip-sampling-rate: 0.2

enderman:
  enabled: true
  population-threshold: 50
  disable-percentage: 50
  
confinement:
  enabled: true
  methods: [vehicle, redstone, water-stream, one-by-one]
  
updater:
  enabled: true
  interval-hours: 2
  project-id: "Bx3ffxDi"  # Modrinth

---

📊 Background Tasks

Task	Interval	Purpose
AdaptiveTask	1 second	Monitor TPS, trigger level changes
AsyncMobScanner	1 second	Distance calculations (thread-safe)
VillagerBrainTask	10 ticks	Villager optimization processing
EndermanCleanupTask	30 seconds	End population control
HostileLogicTask	10 ticks	Hostile mob state machine

---

📈 Performance Impact

Scenario	Impact	Details
Normal TPS	< 0.05ms	Minimal overhead per 100 mobs
Moderate Lag	+2-3 TPS	Saves 2-3 TPS in mob-heavy areas
Severe Lag	+5+ TPS	Can recover 5+ TPS in extreme scenarios
Memory	< 5MB	Overhead for caching

---

🔧 Technical Details

• NMS Bridge: Reflection-based for 1.21-1.21.11 compatibility
• Thread Safety: EntitySnapshot system for async safety
• Auto-Updater: Modrinth API (Project ID: Bx3ffxDi, 2-hour checks)
• Logging: Lazy initialization with daily rotation
• Error Handling: Async error logging to dedicated files

---

🌐 Links

• Website: https://vprolabs.xyz
• Discord: https://discord.gg/SNzUYWbc5Q
• Support: https://ko-fi.com/v4bi

---

Made with ⚡ by vProLabs Team