GamesAI Extra for MCDReforged

English | 简体中文 | 繁體中文

Report an Issue | Share an Idea

Note

GamesAI Extra is a functional extension for GamesAI. It provides Carpet fake player (bot) control tools and waypoint (location) management tools, allowing the AI to spawn/control fake players and manage waypoints on your Minecraft server.

Important

This plugin requires GamesAI >= 0.6.1 to be installed and loaded first. GamesAI Extra follows the Extension Plugin System — tools registered this way are identical to built-in tools.

Table of Contents (click to expand)

• GamesAI Extra for MCDReforged
  • Installation
  • Configuration
  • Tools & Skills
    • Carpet Bot Control
      • Spawn & Kill
      • Behavior Control
      • Movement Control
      • Camera Control
      • Hotbar
      • Timed Actions
      • Custom Commands
    • Waypoint Management
    • Skills
  • Dependencies
  • What's New
    • Version 0.1.2
    • Version 0.1.1
  • License

Installation

Run the following command in the MCDR console to install the plugin:

!!MCDR plugin install games_ai_extra

---

Alternatively, get it from the MCDR Plugin Repository and place it in your plugin directory.

No additional Python packages are required — this plugin only depends on games_ai.

Configuration

The default configuration file (config/games_ai_extra/config.json) structure is as follows:

{
    "carpet": true,
    "location_plguin": false,
    "where2go_plugin": true
}

• carpet: Set to true to enable the Carpet fake player tools. Set to false to disable them.
• location_plguin: Set to true to enable waypoint management via the Location Marker MCDR plugin. Set to false to disable.
• where2go_plugin: Set to true to enable waypoint management via the Where2Go MCDR plugin. Set to false to disable.

Tip

location_plguin and where2go_plugin manage the same set of waypoint tools (add_pos_pos, add_pos_here, remove_pos, search_pos, get_all_pos). It is recommended to enable only one of them to avoid duplicate tool registrations. where2go_plugin is enabled by default.

After modifying the configuration, use !!gamesai reload to apply the changes.

Tools & Skills

Once enabled, the following tools are automatically registered with GamesAI and can be called by the AI through !!ask.

Carpet Bot Control

🤖 Skill: Read carpet.md before operating fake players. Call read_skills("carpet.md") to get complete instructions.

Fake player tools provided by the carpet module. Requires fabric-carpet mod installed on the server. spawn_bot and kill_bot additionally have @register_bot_tool(), making them available to the Mineflayer autonomous Bot controller.

Spawn & Kill

Tool	Parameters	Description
spawn_bot	name, pos?, player?, dim?	Spawn a fake player on the server. Specify pos (coordinates [x, y, z]) to spawn at a location, or player (username) to spawn next to a player. pos and player are mutually exclusive. Optionally specify dim (e.g. minecraft:the_nether) to spawn in a different dimension. If no location is given, spawns at world spawn.
kill_bot	name	Remove (kill) a fake player. This operation is irreversible — use spawn_bot to recreate if needed.

Behavior Control

Tool	Parameters	Description
bot_action	name, action, interval?	Make a fake player perform an action. Supported actions: attack (requires weapon), use (right-click target), mine (break block in front), stop (cancel all actions), drop (drop held item), dropStack (drop entire stack), jump, sneak (toggle), swapHands, mount (ride nearby entity), dismount. Optional interval in game ticks (default: 1).

Movement Control

Tool	Parameters	Description
bot_move	name, direction	Make a fake player move continuously in a direction: forward, backward, left, or right. The bot keeps moving until you send a stop action or change direction.

Camera Control

Tool	Parameters	Description
bot_look	name, target	Make a fake player look at a direction or coordinates. target can be a direction word (north, south, east, west, up, down) or coordinates ("x y z", e.g. "100 64 200").

Hotbar

Tool	Parameters	Description
bot_hotbar	name, slot	Switch the fake player's selected hotbar slot (1–9). After switching, actions like attack/use/mine will use the item in that slot.

Timed Actions

Tool	Parameters	Description
bot_timed_action	name, action, duration	Make a fake player perform an action for a specified duration (in seconds), then automatically stop. Supports: attack, use, mine, forward, backward, left, right. Best suited for short operations (≤ 60s). Note: blocks the current AI conversation until time is up.

Custom Commands

Tool	Parameters	Description
bot_command	name, command	Send a raw custom /player command for advanced operations not covered by the above tools. The command is automatically prefixed with player <name>. Requires familiarity with Carpet bot commands.

Waypoint Management

Waypoint tools are provided by either location_plguin (Location Marker) or where2go_plugin (Where2Go). Only one should be enabled at a time.

Tool	Parameters	Description
add_pos_pos	name, pos, dimension	Add a waypoint at the specified coordinates. pos is [x, y, z], dimension is the dimension (e.g. overworld, the_nether, the_end).
add_pos_here	name	Add a waypoint at the player's current location. Only works when called by a player (not console).
remove_pos	name	Delete a waypoint by name. The Where2Go version supports fuzzy name matching.
search_pos	name	Search for a waypoint by name and return its details.
get_all_pos	(none)	Get a list of all registered waypoints.

Skills

GamesAI Extra provides the following built-in skill, registered via register_skills():

Skill File	Description
carpet.md	Guides the AI on how to properly spawn, control, and kill Carpet fake players (bots). Read this skill before any fake player operation.

Tip

Skills are like SOPs (Standard Operating Procedures) for the AI — they ensure the AI follows the correct workflow every time. The AI can read skill files using the read_skills tool.

Dependencies

Each tool module requires its own server-side dependency to function:

Module	Required Dependency
carpet	Server-side mod fabric-carpet
location_plguin	MCDR plugin Location Marker
where2go_plugin	MCDR plugin Where2Go

If a required dependency is not installed, the corresponding tools will return an error message when called.

What's New

Version 0.1.2

• Added @register_bot_tool() decorator to spawn_bot and kill_bot for Mineflayer Bot support
• Registered carpet.md skill via register_skills() API (GamesAI 0.6.1+)
• Added register_self() support for automatic reload on !!gamesai reload
• Supports both extracted directory (dev) and packed .mcdr zip (distribution)

Version 0.1.1

• Added waypoint management tools via location_plguin (Location Marker) and where2go_plugin (Where2Go) modules
• Added @register_bot_tool() decorator to spawn_bot and kill_bot for Mineflayer Bot support
• Each tool module can now be independently enabled/disabled via config.json
• Initial release with Carpet fake player control tools

License

MIT License, Copyright (c) 2026 yello

---

Back to Top