\n
\n
# vMaiopt (vMobAIOptimizer) by vProLabs<\/p>\n
\n
\n
\n \n<\/p>\n
\n Intelligent AI optimization plugin that dynamically adapts to TPS.<\/b>
\n Eliminates lag from mobs while maintaining gameplay quality.\n<\/p>\n
\n Discord \u2022
\n Website \u2022
\n Support\n<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \u2705 Adaptive Optimization (Implemented)
\n| Feature | Status | Details |
\n|———|——–|———|
\n| 4-Tier TPS System | \u2705 | Normal (19+)\/Light (16-18)\/Moderate (13-15)\/Severe (<12) |\n| Dynamic AI Distance | \u2705 | 48-128 blocks adaptive based on TPS |\n| Hysteresis Prevention | \u2705 | Prevents flickering between levels |\n| Colored Console Loading | \u2705 | Visual loading sequence with checkmarks |\n\n### \u2705 Thread-Safe Async Processing (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Async Entity Scanning | \u2705 | Three-phase architecture (sync\u2192async\u2192sync) |\n| EntitySnapshot System | \u2705 | Immutable data transfer objects |\n| Distance Calculation | \u2705 | Squared distance for performance |\n| AI Toggle Queue | \u2705 | Batched sync entity modifications |\n\n### \u2705 Smart Mob AI (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Passive Mob Pathfinding | \u2705 | 5 blocks \/ 15 seconds movement |\n| Hostile State Machine | \u2705 | IDLE\u2192SEARCH\u2192CHASE\u2192ATTACK states |\n| Player-Only Targeting | \u2705 | Hostiles ignore other hostiles |\n| Armor-Based Priority | \u2705 | Targets lower armor players first |\n| Target Retention | \u2705 | Reduced target switching |\n\n### \u2705 Village Optimization (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Trading AI Toggle | \u2705 | Disabled beyond 32 blocks |\n| POI Search Throttling | \u2705 | 10t \u2192 50t when distant |\n| Gossip Sampling | \u2705 | 20% processing rate |\n| Iron Golem Limiting | \u2705 | Spawn check 10t \u2192 100t |\n\n### \u2705 Enderman End Optimization (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Population Control | \u2705 | 50% AI disable at 50+ endermen |\n| Teleport Throttling | \u2705 | 40 tick checks for non-targeted |\n| Optimized Stare Detection | \u2705 | Vector dot product pre-check |\n| End-Specific Ranges | \u2705 | 16 block follow range |\n\n### \u2705 Redstone Integration (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Vehicle Detection | \u2705 | Minecarts, boats, striders |\n| Piston Chamber Detection | \u2705 | 2x2x2 enclosed redstone spaces |\n| Water Stream Detection | \u2705 | Flowing water + solid blocks |\n| 1x1 Hole Detection | \u2705 | 4-sided solid confinement |\n| Mob Farm Mode | \u2705 | AI disable for confined mobs |\n\n### \u2705 Logging & Monitoring (Implemented)\n| Feature | Status | Details |\n|---------|--------|---------|\n| Error Logger | \u2705 | Lazy init, daily rotation (error-log-YYYY-MM-dd.log) |\n| Actions Folder | \u2705 | logs\/actions\/actions-YYYY-MM-dd.log |\n| Admin Notifications | \u2705 | Discord link on error, join notifications |\n| TPS Monitoring | \u2705 | Rolling 20-second average |\n| Debug Mode | \u2705 | Detailed optimization logging |\n\n### \u23f3 Coming Soon\n| Feature | Status | ETA |\n|---------|--------|-----|\n| Discord Webhook Reports | \u23f3 | Hourly performance reports |\n\n---\n\n## \ud83d\ude80 Commands\n\n| Command | Permission | Description |\n|---------|------------|-------------|\n| `\/vmaiopt` | `vmaiopt.admin` | Main command with help |\n| `\/vmaiopt status` | `vmaiopt.admin` | Shows TPS, lag level, active optimizations |\n| `\/vmaiopt reload` | `vmaiopt.admin` | Reloads configuration with validation |\n| `\/vmaiopt debug toggle` | `vmaiopt.admin` | Toggle debug mode |\n| `\/vmaiopt debug stats` | `vmaiopt.admin` | Show debug statistics |\n| `\/vmaiopt version` | `vmaiopt.admin` | Show plugin version |\n\n---\n\n## \ud83d\udd12 Permissions\n\n| Permission | Default | Description |\n|------------|---------|-------------|\n| `vmaiopt.admin` | op | All commands and update notifications |\n| `vmaiopt.bypass` | false | Exempt from AI optimizations |\n| `vmaiopt.update.notify` | op | Receive update notifications |\n\n---\n\n## \u2699\ufe0f Configuration\n\n```yaml\n# config.yml - Main configuration\nadaptive-optimization:\n enabled: true\n tps-thresholds:\n normal: 19.0 # 19+ TPS\n light: 16.0 # 16-18 TPS\n moderate: 13.0 # 13-15 TPS\n severe: 10.0 # <12 TPS\n\ndistance-optimization:\n enabled: true\n disable-ai-distance: 48 # 48-128 blocks adaptive\n \nvillage:\n enabled: true\n trading-disable-distance: 32\n poi-search-interval: 50\n gossip-sampling-rate: 0.2\n\nenderman:\n enabled: true\n population-threshold: 50\n disable-percentage: 50\n \nconfinement:\n enabled: true\n methods: [vehicle, redstone, water-stream, one-by-one]\n \nupdater:\n enabled: true\n interval-hours: 2\n project-id: \"Bx3ffxDi\" # Modrinth\n```\n\n---\n\n## \ud83d\udcca Background Tasks\n\n| Task | Interval | Purpose |\n|------|----------|---------|\n| AdaptiveTask | 1 second | Monitor TPS, trigger level changes |\n| AsyncMobScanner | 1 second | Distance calculations (thread-safe) |\n| VillagerBrainTask | 10 ticks | Villager optimization processing |\n| EndermanCleanupTask | 30 seconds | End population control |\n| HostileLogicTask | 10 ticks | Hostile mob state machine |\n\n---\n\n## \ud83d\udcc8 Performance Impact\n\n| Scenario | Impact | Details |\n|----------|--------|---------|\n| **Normal TPS** | < 0.05ms | Minimal overhead per 100 mobs |\n| **Moderate Lag** | +2-3 TPS | Saves 2-3 TPS in mob-heavy areas |\n| **Severe Lag** | +5+ TPS | Can recover 5+ TPS in extreme scenarios |\n| **Memory** | < 5MB | Overhead for caching |\n\n---\n\n## \ud83d\udd27 Technical Details\n\n- **NMS Bridge**: Reflection-based for 1.21-1.21.11 compatibility\n- **Thread Safety**: EntitySnapshot system for async safety\n- **Auto-Updater**: Modrinth API (Project ID: Bx3ffxDi, 2-hour checks)\n- **Logging**: Lazy initialization with daily rotation\n- **Error Handling**: Async error logging to dedicated files\n\n---\n\n## \ud83c\udf10 Links\n\n- **Website**: https:\/\/vprolabs.xyz\n- **Discord**: https:\/\/discord.gg\/SNzUYWbc5Q\n- **Support**: https:\/\/ko-fi.com\/v4bi\n\n---\n\n\n\n
Made with \u26a1 by vProLabs Team<\/b><\/p>\n","protected":false},"excerpt":{"rendered":"
Advanced adaptive mob AI optimizer that dynamically reduces entity lag based on server TPS while maintaining smooth gameplay.<\/p>\n","protected":false},"featured_media":167281,"template":"","meta":{"_minecraft_slug":"vmaiopt","_minecraft_project_id":"Bx3ffxDi","_minecraft_author":"v4bi","_minecraft_license":"MIT","_minecraft_downloads":31,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vmaiopt.zip","_minecraft_size_bytes":249540,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:04:57.923980Z","_minecraft_date_created":"2026-03-04T20:41:37.800908Z","_minecraft_date_modified":"2026-02-26T18:13:06.817453Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vmaiopt","_minecraft_icon_attachment_id":167281,"_minecraft_imported_at":"2026-06-09T18:53:09+00:00","_minecraft_import_hash":"27d03d9fad0b2a5e0a310bb35b4b4978","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,137,90,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-167280","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n