vMaiOpt

# vMaiopt (vMobAIOptimizer) by vProLabs <p align="center"> <img src="https://img.shields.io/badge/Minecraft-1.21--1.21.11-blue?style=for-the-badge" alt="Minecraft"> <img src="https://img.shields.io/badge/Platform-Bukkit%2FSpigot%2FPaper-green?style=for-the-badge" alt="Platform"> <img src="https://img.shields.io/badge/Java-21-orange?style=for-the-badge" alt="Java 21"> </p> <p align="center"> <b>Intelligent AI optimization plugin that dynamically adapts to TPS.</b><br> Eliminates lag from mobs while maintaining gameplay quality. </p> <p align="center"> <a href="https://discord.gg/SNzUYWbc5Q">Discord</a> • <a href="https://vprolabs.xyz">Website</a> • <a href="https://ko-fi.com/v4bi">Support</a> </p> --- ## ✨ 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: updater: enabled: true interval