Scrawl is a Python game engine and IDE designed to offer a Scratch-like visual development experience for creating 2D games. It targets beginners and educators looking for an intuitive way to build games using Python, with the added benefit of an integrated AI programming assistant that simplifies code generation and modification.

How It Works

Scrawl leverages Pygame to provide a visual IDE featuring a scene editor, code editor, and property inspector, aiming for the intuitive ease of use found in Scratch. Its core approach utilizes Python decorators (@as_main, @as_clones, @on_key, etc.) to define game logic, event handling, and sprite behaviors, abstracting away much of the underlying Python complexity. A key differentiator is the integrated AI programming assistant, which can generate and modify game code based on natural language prompts, further streamlining the development process.

Quick Start & Requirements

• Primary Install: pip install scrawl-engine
• IDE Setup: Clone the repository (git clone https://github.com/streetartist/scrawl), navigate to the directory, install IDE dependencies (pip install -r scrawl_ide/requirements.txt), and run the IDE (python scrawl_ide/main.py).
• Prerequisites: Pygame (installed via pip), Python. The IDE offers a free AI API trial with daily limits for Gemini, GLM, Kimi, and MiniMax models, requiring no API key configuration for initial use.
• Links:
  • GitHub Repo: https://github.com/streetartist/scrawl
  • QQ Group: 1001578435

Highlighted Details

• Interactive visual IDE with drag-and-drop scene editing, a built-in code editor with syntax highlighting, and a property inspector.
• AI programming assistant capable of generating code, modifying sprite/scene properties, and responding to natural language requests.
• Scratch-like development paradigm using decorators for coroutines, event handling, and sprite cloning.
• Built-in game object system (sprites, scenes, particle systems), physics engine integration, and a broadcasting system for component communication.
• Debugging tools for real-time FPS display, sprite counts, and performance monitoring.

Maintenance & Community

The project encourages community interaction via a QQ group (1001578435) for discussions and feedback. Contributions are welcomed through GitHub issues and pull requests.

Licensing & Compatibility

The README does not explicitly state a software license. This lack of explicit licensing may pose compatibility concerns for commercial use or integration into proprietary projects.

Limitations & Caveats

The Scrawl IDE is noted as being in "preliminary development," with ongoing feature refinement and a call for feedback. The free AI API trial is shared among all users and has daily call limits per model, which may affect continuous usage.