vMaiOpt

vMaiopt (vMobAIOptimizer) by vProLabs

<b>Intelligent AI optimization plugin that dynamically adapts to TPS.</b>
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 | |----------|--------|---------| | Memory | < 0.05ms | Minimal overhead per 100 mobs | | Memory | +2-3 TPS | Saves 2-3 TPS in mob-heavy areas | | Memory | +5+ TPS | Can recover 5+ TPS in extreme scenarios | | Memory | < 5MB | Overhead for caching |

---

🔧 Technical Details

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

---

🌐 Links

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

---

Made with ⚡ by <b>vProLabs Team</b>