Documentation - KOF Ultimate Online

🎓 Guide Débutant Total

Cette section est pour ceux qui n'ont jamais utilisé de ligne de commande. Pas de panique, c'est plus simple qu'il n'y paraît !

💡 Qu'est-ce qu'une ligne de commande ?
C'est une fenêtre noire (ou bleue) où on tape des instructions texte au lieu de cliquer. Windows en propose deux : CMD (classique) et PowerShell (moderne).

📂 Comment ouvrir CMD ou PowerShell

Méthode 1 : Menu Démarrer (la plus simple)

Appuyez sur la touche Windows de votre clavier (le logo Windows)
Tapez cmd ou powershell
Appuyez sur Entrée ou cliquez sur le résultat

Méthode 2 : Clic droit sur le menu Démarrer

Faites un clic droit sur le bouton Démarrer (en bas à gauche)
Choisissez "Windows PowerShell" ou "Terminal Windows"

Méthode 3 : Depuis un dossier (très pratique !)

Ouvrez l'explorateur de fichiers et allez dans le dossier KOF Ultimate Online
Cliquez dans la barre d'adresse (là où il y a le chemin du dossier)
Tapez cmd ou powershell et appuyez sur Entrée
La fenêtre s'ouvre directement dans le bon dossier !

✅ Astuce Pro : Maintenez Shift et faites un clic droit dans un dossier vide, puis choisissez "Ouvrir la fenêtre PowerShell ici".

🐍 Qu'est-ce que Python ?

Python est un langage de programmation gratuit. Le jeu l'utilise pour le mode en ligne. Vous n'avez pas besoin de savoir programmer, juste de l'installer !

Installer Python :

Allez sur python.org/downloads
Cliquez sur le gros bouton jaune "Download Python"
Lancez le fichier téléchargé
IMPORTANT : Cochez la case Add Python to PATH en bas de la fenêtre !
Cliquez sur "Install Now"

⚠️ CRUCIAL : Si vous oubliez de cocher "Add Python to PATH", les commandes Python ne fonctionneront pas. Vous devrez désinstaller et réinstaller Python.

Vérifier que Python est bien installé :

Ouvrez CMD ou PowerShell (voir ci-dessus)
Tapez python --version et appuyez sur Entrée
Si vous voyez Python 3.x.x, c'est bon !
Si vous voyez une erreur, Python n'est pas installé correctement

📁 Naviguer dans les dossiers avec CMD/PowerShell

Voici les commandes de base :

Commande	Description	Exemple
`cd`	Changer de dossier	`cd Documents`
`cd ..`	Remonter d'un dossier	`cd ..`
`dir`	Lister les fichiers	`dir`
`D:`	Changer de disque	`D:` puis Entrée

Exemple : Aller dans le dossier KOF

D:
cd "KOF Ultimate Online kofuo"
dir

Ces 3 commandes : changent vers le disque D, vont dans le dossier du jeu, puis affichent son contenu.

🔧 Installer les dépendances manuellement

Si le fichier .bat ne fonctionne pas, vous pouvez le faire à la main :

Ouvrez CMD ou PowerShell
Tapez ces commandes une par une :

pip install websockets
pip install psutil

Attendez que chaque installation se termine avant de taper la suivante.

💡 C'est quoi "pip" ?
pip est le gestionnaire de paquets de Python. Il permet d'installer des modules supplémentaires. Il s'installe automatiquement avec Python.

❓ Glossaire des termes techniques

Terme	Explication simple
CMD	Invite de commandes Windows (fenêtre noire)
PowerShell	Version améliorée de CMD (fenêtre bleue)
Terminal	Autre nom pour CMD/PowerShell
PATH	Liste des dossiers où Windows cherche les programmes
Serveur	Ordinateur qui centralise les connexions (comme un standard téléphonique)
Client	Programme qui se connecte au serveur (votre jeu)
IP	Adresse numérique de votre ordinateur sur le réseau
Port	Numéro de "porte" pour une connexion (ex: 8765)
ELO	Score qui mesure votre niveau de jeu
Matchmaking	Système qui trouve des adversaires de votre niveau

🎉 Bravo ! Vous avez maintenant les bases pour utiliser KOF Ultimate Online. Continuez avec la section "Démarrage Rapide" ci-dessous !

🚀 Démarrage Rapide

Bienvenue sur KOF Ultimate Online ! Ce guide vous aidera à installer et utiliser tous les composants du système.

⏱️ Temps estimé : 10 minutes

Étape 1 : Installer les Dépendances

Double-cliquez sur le fichier :

INSTALL_DEPENDENCIES.bat

Ce script installera automatiquement :

websockets (communication serveur)
psutil (gestion des processus)

Étape 2 : Lancer le Launcher

Double-cliquez sur :

LAUNCH_ULTIMATE.bat

Le launcher vous permet de gérer tous les services en un clic.

Étape 3 : Commencer à Jouer

Solo : Cliquez sur "🎮 Lancer le Jeu (Solo)"
En ligne : Cliquez sur "⚔️ Jouer en Ligne (Battle.net)"

💾 Installation Détaillée

Prérequis

Windows 10 ou supérieur
Python 3.8 ou supérieur
Node.js 14+ (pour le site web)
4 GB RAM minimum

Installation de Python

Téléchargez Python sur python.org
Lors de l'installation, cochez "Add Python to PATH"
Vérifiez l'installation : python --version

Installation de Node.js (optionnel)

Requis uniquement pour le site web.

Téléchargez Node.js sur nodejs.org
Installez avec les options par défaut
Vérifiez : node --version

💡 Astuce : Le site web n'est pas obligatoire pour jouer. Il permet de consulter les stats en ligne.

⚔️ Jouer en Ligne

Configuration LAN

Pour jouer en réseau local :

Sur l'ordinateur serveur :

Lancer le launcher (LAUNCH_ULTIMATE.bat)
Cliquer sur "🖥️ Lancer Serveur Battle.net"
Noter votre adresse IP : ipconfig

Sur chaque ordinateur client :

Ouvrir BATTLENET_CLIENT.py
Modifier la ligne 265 avec l'IP du serveur
Lancer le client depuis le launcher

Workflow de Jeu

Se connecter avec un pseudo
Cliquer sur "Rechercher un Adversaire"
Attendre le matchmaking (5-10 secondes)
Jouer la partie dans le jeu
Votre ELO est mis à jour automatiquement

⚠️ Important : Le serveur Battle.net doit être lancé en premier.

📊 Système ELO

Comment fonctionne l'ELO ?

Le système ELO calcule votre niveau de jeu et vous associe à des adversaires de niveau similaire.

Calcul des Points

Victoire contre adversaire plus fort : +30 à +40 points
Victoire contre adversaire similaire : +15 à +20 points
Victoire contre adversaire plus faible : +5 à +10 points
Défaite : Points perdus selon la même logique

Rangs ELO

Rang	ELO	Badge
Diamond	2500+	💎
Platinum	2000-2499	💿
Gold	1500-1999	🥇
Silver	1000-1499	🥈
Bronze	0-999	🥉

💡 Astuce : Le matchmaking cherche des adversaires avec ±200 points ELO pour des parties équilibrées.

🔍 Détecteur de Bugs

Pourquoi l'utiliser ?

Certains personnages Mugen peuvent causer des crashes ou des lags. Le détecteur identifie automatiquement ces problèmes.

Utilisation

Lancer le launcher
Cliquer sur "🔍 Détecter les Bugs"
Attendre la fin du scan (15-30 minutes)
Consulter bug_report.json
Cliquer sur "📝 Optimiser Select.def"

Types de Bugs Détectés

LOAD_FAILED : Personnage ne se charge pas
FILE_MISSING : Fichiers manquants (.air, .sff, .snd)
SLOW_LOAD : Chargement >5 secondes
TOO_COMPLEX : Trop d'expressions (>20000)

✅ Résultat : Un roster stable avec uniquement les personnages qui fonctionnent !

🛠️ Dépannage

Le jeu crash au lancement d'un match

Solution :

Lancer le détecteur de bugs
Optimiser le select.def
Relancer le jeu

Le serveur Battle.net ne démarre pas

Causes possibles :

Module websockets non installé
Port 8765 déjà utilisé

Solutions :

pip install websockets
netstat -ano | findstr 8765

Le client ne se connecte pas

Vérifications :

Le serveur est-il lancé ?
L'adresse IP est-elle correcte ?
Le pare-feu bloque-t-il la connexion ?

Le site web ne s'affiche pas