Skip to content

🎮 KodLab - Documentation Complète

Console de programmation ludique pour apprendre l'algorithmique en créant des jeux 2D

📋 Table des Matières

  1. Introduction
  2. Installation et Utilisation
  3. Langage Kod
  4. Créer des Jeux
  5. Architecture Technique
  6. Référence API
  7. Exemples et Tutoriels
  8. Dépannage

Introduction

Qu'est-ce que KodLab ?

KodLab est un environnement de développement éducatif conçu pour apprendre la programmation en créant des jeux 2D. Il combine :

  • Un langage simplifié (.kod) : Syntaxe intuitive inspirée de Python et Pascal
  • Un compilateur intelligent : Traduit automatiquement le code .kod en JavaScript ES6
  • Un émulateur intégré : Console virtuelle avec rendu Canvas HTML5
  • Une collection d'exemples : Jeux de référence pour apprendre

Pourquoi KodLab ?

✅ Simplicité : Pas de configuration complexe, tout fonctionne dans le navigateur
✅ Apprentissage : Syntaxe accessible aux débutants
✅ Immédiat : Voir le résultat en temps réel
✅ Ludique : Apprendre en créant des jeux
✅ Portable : Fonctionne sur n'importe quel navigateur moderne

Architecture Globale

KodLab/
├── 📄 index.html          # Interface utilisateur
├── 🎨 styles.css          # Design moderne
├── ⚙️ main.js            # Orchestration principale
├── 🔧 kodCompiler.js     # Compilateur .kod → JavaScript
├── 🎮 kodEmulator.js     # Émulateur de console
├── 📁 examples/          # Jeux d'exemple
│   ├── pong.kod
│   ├── snake.kod
│   ├── asteroids.kod
│   └── pandadventures.kod
└── 📚 doc/              # Documentation (vous êtes ici)

Exemples de Code

Hello World animé :

let x = 0

function start()
    clearScreen("#000033")
end

function update()
    clearScreen("#000033")
    x = x + 2
    if x > 400
        x = 0
    end
    drawCircle(x, 150, 20, "#FF6600")
    drawText("Hello KodLab!", 100, 100, "#FFFFFF")
end

🎨 Coloration Kod dans VSCode (Extension officielle)

Pour profiter d'une expérience optimale lors de l'édition de vos fichiers .kod, il est recommandé d'installer l'extension officielle Kod pour Visual Studio Code.

  • Fichier à utiliser : kod-official-0.0.1.vsix (présent à la racine du projet)
  • Installation rapide :
    1. Ouvrez VSCode
    2. Faites Ctrl+Maj+P puis tapez Extensions: Installer depuis un fichier .VSIX
    3. Sélectionnez le fichier kod-official-0.0.1.vsix
    4. Redémarrez VSCode si besoin
  • Résultat : Tous vos fichiers .kod bénéficient d'une coloration syntaxique adaptée, pour un confort de lecture et de développement maximal !

Cette extension est idéale pour apprendre, coder et explorer les exemples KodLab dans les meilleures conditions.

Prochaines Étapes

  1. 📖 Lisez le Guide d'Utilisation
  2. 🧠 Apprenez la Syntaxe Kod
  3. 🎯 Suivez le Guide de Création de Jeux
  4. 🔍 Explorez les Exemples

Bon coding ! 🚀