<div align="center">

🎨 2DPIXELMCP

The Official Antigravity-to-LibreSprite Bridge

An exclusive Model Context Protocol (MCP) server designed specifically to give Antigravity (AI) the power to draw, animate, and manipulate 2D pixel art directly inside LibreSprite.

</div>

---

🚀 Overview

2DPIXELMCP is a highly specialized bridge built exclusively for Antigravity. It allows the AI to send natural language commands and structural data which is then translated into real-time pixel art operations inside LibreSprite.

Whether you want to generate a 20-frame highly detailed knight animation or just draw a simple tree swinging in the wind, 2DPIXELMCP handles the complex math, batch rendering, and real-time syncing seamlessly.

✨ Key Features

• 🤖 Antigravity Exclusive: Purpose-built for Antigravity's advanced reasoning capabilities.
• ⚡ Real-Time AI Cursor: Watch the AI draw in real-time with a visual Magenta (+) indicator on the canvas.
• 🧱 Batch Rendering Engine: High-performance pixel grouping to prevent canvas freezes during heavy AI drawing operations.
• 🎬 Advanced Animation Engine: Built-in timeline, keyframing, and 20+ easing functions (Elastic, Bounce, Cubic, etc.).
• 🧠 Self-Healing & Auto-Evaluation: Automatically grades the AI's drawings (A-F) and prompts self-correction if the quality doesn't meet the standard.

---

🛠️ Installation

Setting up the bridge between Antigravity and LibreSprite takes less than two minutes.

1. Prerequisites

• Python 3.8+ (Ensure Python is added to your PATH).
• LibreSprite (Download Latest Release).

2. Download the Project

Clone this repository or download it as a ZIP file:

git clone https://github.com/alikayalll43-sudo/2DPIXELMCP.git
cd 2DPIXELMCP

3. Install Dependencies

Install the required lightweight python packages:

pip install -r requirements.txt

---

🔗 Connecting to Antigravity (Skill Setup)

⚠️ IMPORTANT: 2DPIXELMCP is built strictly and exclusively for Antigravity. It cannot be used with any other AI assistant or agent.

To give Antigravity the ability to control LibreSprite, you need to add the 2DPIXELMCP "Skill" to Antigravity's brain.

1. Navigate to your Antigravity configuration directory (usually ~/.gemini/config/skills/).
2. Create a new folder named 2dpixelmcp.
3. Copy the SKILL.md (if provided, or copy the legacy one) into this folder.
4. Restart Antigravity.

Once configured, just tell Antigravity "Draw a tree in LibreSprite" and it will automatically use this bridge!

---

🎮 Manual Usage & Testing

If you want to run the server manually without Antigravity to test the connection:

1. Start the Server:

python main.py serve

(This will automatically launch LibreSprite and establish a bidirectional WebSocket connection).

2. Send a Drawing Command (in a new terminal):

python main.py draw "a medieval knight attacking" --size 64 --frames 10

🏗️ Architecture

• main.py: The main entry point (serve / draw / status).
• core/: TCP/HTTP Server & LibreSprite API Client.
• bridge/: The JavaScript (Duktape) payload injected into LibreSprite for real-time control.
• drawing/: Core rendering logic (Primitives, Palettes, Batching).
• ai/: Memory, Evaluation, and Auto-Correction logic.