Fake Player Plugin (FPP)

v1.6.2 (2026-04-12)

AI Conversations

• New AI DM system — bots respond to /msg, /tell, /whisper with AI-generated replies
• 7 provider support: OpenAI, Anthropic, Groq, Google Gemini, Ollama, Copilot/Azure, Custom OpenAI-compatible
• API keys stored in plugins/FakePlayerPlugin/secrets.yml (never in config.yml)
• Per-bot personality assignment via /fpp personality <bot> set <name>; personalities stored as .txt files in personalities/ folder
• Bundled sample personalities: friendly, grumpy, noob
• BotConversationManager — per-player conversation history, rate limiting, typing delay simulation

New Commands

• /fpp place <bot> [once|stop] — continuous or one-shot block placing with supply-container restocking. Permission: fpp.place
• /fpp storage <bot> [name|--list|--remove|--clear] — register supply containers for mine/place jobs. Permission: fpp.storage
• /fpp use <bot> — bot right-clicks / activates the block it's looking at. Permission: fpp.useitem
• /fpp waypoint <name> [add|remove|list|clear] — manage named patrol routes; bots walk them via /fpp move --wp. Permission: fpp.waypoint
• /fpp personality [list|reload|<bot> set <name>|reset|show] — assign AI personalities to bots. Permission: fpp.personality
• /fpp badword add|remove|list|reload — manage the runtime badword filter list. Permission: fpp.badword
• /fpp rename <old> <new> — rename any bot with full state preservation (inventory, XP, LP group, tasks). Permission: fpp.rename (any bot), fpp.rename.own (own bots only)
• /fpp mine --pos1/--pos2/--start/--stop — area-selection cuboid mining mode

Per-Bot Settings GUI

• Shift+right-click any bot to open a 6-row settings chest — no command needed
• Categories: ⚙ General · 💬 Chat · ⚔ PvP · 📋 Cmds · ⚠ Danger
• Toggle freeze, head-AI, chat tier, AI personality, stored commands, and bot deletion
• Controlled by bot-interaction.shift-right-click-settings config key

Area Mining Mode

• /fpp mine <bot> --pos1 / --pos2 — select a cuboid mining region
• /fpp mine <bot> --start — begin mining the selected area continuously
• Auto-restocks from nearest registered StorageStore container when inventory fills
• Selections persisted to data/mine-selections.yml — survive restarts and auto-resume

Task Persistence (DB Schema v13)

• Active tasks (mine/use/place/patrol) now saved to fpp_bot_tasks DB table on shutdown
• YAML fallback: data/bot-tasks.yml when database is disabled
• Bots automatically resume their job after server restart

Navigation & Interaction Engine

• PathfindingService — centralised shared navigation service
• NavigationRequest with lockOnArrival for atomic nav→action lock handoff
• BotNavUtil — static utilities: findStandLocation, faceToward, isAtActionLocation, useStorageBlock
• StorageInteractionHelper — shared lock→open-container→transfer→unlock lifecycle

Per-Bot Item & XP Pickup Toggles

• body.pick-up-items and body.pick-up-xp global defaults
• Per-bot overrides in BotSettingGui — toggling off immediately drops current inventory / XP to ground
• BotXpPickupListener gates both pickup events per-bot

Config v47 → v53

• Added bot-interaction, ai-conversations, badword-filter sections
• Added body.drop-items-on-despawn key
• Config reorganized into 10 clearly numbered sections with better flow and organization
• pathfinding moved into section 4 (AI & Navigation)