Spoofy

Spoofy is a Minecraft Paper plugin (1.21) that brings your server to life with intelligent fake players. These entities can interact with the world, chat with players using LLMs, and exhibit dynamic behaviors like fleeing from threats or approaching friends.

Features

🤖 Intelligent Fake Players

• AI Behaviors: Fake players aren't just statues. They react to their environment:
  • Head Tracking: They look at nearby players and interesting targets.
  • Friendly Approach: They will notice you and come say hi (sneaking to show they are friendly!).
  • Self-Preservation: If attacked or threatened by mobs (Zombies, Creepers, Skeletons), they will sprint to safety.
  • Combat: They can fight back if attacked.
• Persistent: Configure fake players to spawn automatically when the server starts.

💬 AI Chat Integration

• Conversational: Powered by Groq (Llama 3), you can have real conversations with the server bot.
• Context Aware: The AI aims to generate unique names and responses.

🛠️ Management Tools

• Full Control: Spawn, teleport, and manage fake players directly in-game.
• Customization: Change skins, toggle body visibility, and equip them with items.

Installation

1. Download: Get the latest JAR file from the Releases page.
2. Install: Drop the file into your server's plugins folder.
3. Restart: Restart your server to generate the configuration files.
4. Configure: Open plugins/Spoofy/config.yml and add your Groq API key to enable chat features.

Configuration

Edit plugins/Spoofy/config.yml to set up your API key and define default fake players.

# plugins/Spoofy/config.yml

groq-api-key: "your_groq_api_key_here"
groq-model: "llama3-70b-8192"

fake-players:
  - name: "Steve"
    skin-uuid: "uuid-here"

Commands

Command	Usage	Description
/spoofy	/spoofy <message>	Chat with the server bot.
/spoof	/spoof <number>	Spawn a specific number of fake players.
/list	/list	Lists all players, including fake ones.
/stp	/stp <name> <target>	Teleport a fake player to another player or location.
/sskin	/sskin <name> <skin>	Change a fake player's skin.
/sbody	/sbody <name>	Toggle a fake player's body visibility.
/sequip	/sequip <name>	Manage a fake player's inventory.

Requirements

• Server: Paper (or fork) for Minecraft 1.21.
• Java: Java 21 or higher.