# 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 ```yaml # 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 --- ## 🌐 Quick Socials - https://www.vprolabs.xyz/qs/iamthealfaandtheomega ---

Made with ⚡ by vProLabs Team

vMaiOpt

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details