Coloring Game: Godot 4 Starter Tutorial

Project Overview: Coloring Sandbox (Insect Edition)

Coloring Sandbox is an interactive educational template designed for Godot beginners and aspiring game artists. More than just a simple painting app, this project demonstrates a polished workflow for handling dynamic object interaction in a 2D space. Players can select various insects, zoom into them with smooth cinematic transitions, and apply custom-mixed palettes to individual sections.

Core Learning Objectives

This project serves as a practical solution to common Godot hurdles:

• Precision Coordinate Systems: Master the use of get_canvas_transform().affine_inverse() to ensure mouse clicks remain 100% accurate, even when objects are scaled or the camera is moved.
• Advanced Tweening Logic: Implementation of professional-grade "Focus & Reset" effects. Learn to use the Tween system to handle parallel animations for position, scale, and Z-indexing.
• State-Aware Interaction: A robust logic system that distinguishes between "UI clicking" (palette), "World interaction" (zooming), and "Detail painting" (patch coloring).
• Dynamic Color Theory: A custom script for additive color mixing, allowing players to blend primary pigments into a vast array of secondary tones.

How to Play

• 🔍 Click an Insect: Tap any creature to bring it into "Focus Mode." It will smoothly enlarge and center for detailed work.
• 🎨 Mix Your Palette: Click color buttons to mix them. Use the "Clean" button to reset your brush. Your brush head reflects your current mixture in real-time!
• 🖌️ Paint with Precision: Click on specific segments of the insect to apply your color.
• ♻️ Reset View: Click on any empty background area to return the insect to its original position in the gallery.

Implementation Tips for Beginners

• Global vs. Local: Always use global_position when moving objects between a gallery layout and the screen center to avoid parent-node transform interference.
• Input Handling: Use _unhandled_input to prevent clicks from "bleeding through" your UI buttons into the game world.