VanillaMobAI

Vanilla Bedrock–style mob AI for PocketMine-MP.

About

VanillaMobAI gives PMMP mobs vanilla-like behavior: wandering, combat, breeding, natural spawning, and interactions such as milking and shearing. Balance values (damage, speed, breeding timers) follow vanilla references in code and are not exposed in config.

The plugin is stable and ready for production use on PocketMine-MP servers. Development is ongoing — new mobs and behaviors will continue to be added, but the current feature set is fully usable today.

Features

• Goal-based AI (wander, panic, tempt, attack, creeper explosion)
• Line of sight — no seeing through walls
• Creative players are not targeted by hostiles
• Natural spawning (caps, light, distance, world filters)
• Spawn eggs + monster spawner support (set spawner type with an egg)
• Breeding, milking, shearing, dyeing, chicken eggs
• Performance: activation range, tick budget, async pathfinding

Mobs

Installation

1. Place the VanillaMobAI folder in plugins/.
2. Start the server.
3. Edit plugin_data/VanillaMobAI/config.yml.

Requirements: PocketMine-MP 5.0.0+, PHP 8.1+

Configuration

Server settings live in config.yml. Example:

features:
  natural-spawn: true
  mob-ai: true
  monster-spawners: true

worlds:
  natural-spawn-mode: whitelist
  natural-spawn-whitelist:
    - world

natural-spawn:
  passive-cap: 12
  hostile-cap: 24
  mobs:
    creeper: false

Whitelist: Natural spawn only in listed world folder names.
Blacklist: Spawn everywhere except listed worlds (default: nether, end).

Performance tuning is under the performance section. Gameplay balance (damage, speed, etc.) is intentionally not configurable.

Commands

Permission: vanillaMobAI.command (default: op)

Roadmap

• More vanilla mobs
• Biome-based spawn weights
• Additional vanilla interactions

Use GitHub Issues for bugs and suggestions.

License

MIT — see LICENSE for details.

Author: grinn34