Controller FAQs

Question 1

How do I install Controller?

Accepted Answer

The recommended installation method is using uv package manager (`uv sync`). Alternatively, you can use pip (`pip install -r requirements.txt`). For hardware mode, you also need to install the ViGEmBus driver.

Question 2

What is the difference between hardware and simulation mode?

Accepted Answer

Hardware mode uses the ViGEmBus driver to create a virtual Xbox controller, sending inputs to your system. Simulation mode tracks controller state internally but doesn't send actual input, useful for testing without affecting other applications.

Question 3

What is Controller?

Accepted Answer

Controller is a tool that emulates an Xbox controller, allowing you to control buttons, analog sticks, and triggers programmatically using MCP (Model Context Protocol) commands. It's ideal for game development, testing, and automation.

Question 4

What are the key features of Controller?

Accepted Answer

Key features include control over Xbox controller buttons, analog sticks, and triggers; support for both hardware (ViGEmBus) and simulation modes; state management functions like reset and get controller state; and cross-platform compatibility (primarily Windows).

Question 5

What programming languages and tools are used?

Accepted Answer

The tool is written in Python and leverages FastMCP, vgamepad, and Pydantic. It uses uv and pip for dependency management. Configuration is available via json and utilizes the Model Context Protocol.

Controller

About

Key Features

Use Cases