Rowuni Leaderboard First

Un système de classement interactif et en temps réel pour suivre les "firsts" sur le stream de Rowuni

À propos

Ce classement des firsts est un système de classement développé pour le stream de Rowuni. Il permet de suivre en temps réel qui obtient le "first" sur le stream, et ainsi l'afficher sur le stream starting.

🛠️ Technologies

• Frontend :

  • HTML5
  • CSS3 (avec animations)
  • JavaScript (Vanilla JS)

• Backend :

  • Python 3.11+
  • Module http.server (serveur HTTP)
  • Module requests (pour les scripts)

• Stockage :

  • JSON (fichier local)

📦 Installation

1. Cloner le projet (si vous avez la permission de l'auteur)

   git clone https://github.com/Rowuni/Rowuni_Leaderboard_First.git
   cd Rowuni_Leaderboard_First

2. Installer les dépendances Python

   pip install requests

3. Lancer le serveur

   python server.py

4. Accéder à l'interface web

   • Le serveur démarre automatiquement sur http://localhost:8080
   • Votre navigateur devrait s'ouvrir automatiquement

Ce projet étant destiné au stream de Rowuni, le fichier leaderboard_data.json contient les données du classement des firsts de Rowuni. Si vous avez le droit et souhaitez utiliser ce projet pour votre propre stream, vous devrez réinitialiser ou modifier ce fichier en conséquence.

Utilisation

Lancer le serveur

python server.py

Le serveur démarre sur le port 8080 et ouvre automatiquement l'interface dans votre navigateur.

Ajouter un "first"

Méthode 1 : Via le script batch (Windows)

add_first.bat <username> 

Méthode 2 : Via le script Python

python add_first.py <username>

Méthode 3 : Via l'API

curl "http://localhost:8080/add-first-simple?username=NomUtilisateur"

📁 Structure du projet

Rowuni_Leaderboard_First/
├── index.html              # Interface web principale
├── styles.css              # Styles et animations
├── main.js                 # Logique frontend et communication API
├── server.py               # Serveur HTTP et API REST
├── leaderboard_data.json   # Base de données (génération automatique)
├── add_first.py            # Script Python pour ajouter des firsts
├── add_first.bat           # Script batch (Windows) pour ajouter des firsts
├── commandes.md            # Documentation des commandes
└── README.md               # Ce fichier

🔌 API

Le serveur expose plusieurs endpoints :

GET /leaderboard

Récupère les données du classement complet.

Réponse :

{
  "leaderboard": [...],
  "metadata": {
    "lastUpdated": "2025-09-13T12:00:00.000Z",
    "totalUsers": 10,
    "totalFirsts": 50
  }
}

GET /add-first-simple

Ajoute un ou plusieurs "firsts" à un utilisateur.

Paramètres :

• username (string, requis) : Nom d'utilisateur
• count (int, optionnel, défaut: 1) : Nombre de firsts à ajouter (Mettre une valeur supérieure à 1 uniquement dans le cas d'ajustements)

Exemple :

GET /add-first-simple?username=<username>&count=1

POST /remove-first

Retire un ou plusieurs "firsts" d'un utilisateur.

POST /reset-user

Réinitialise le compteur d'un utilisateur à zéro.

👥 Contributeurs

• Rowuni - Créateur et développeur principal

📄 Licence

Copyright © 2026 Rowuni. Tous droits réservés.

Ce projet et son code source sont la propriété exclusive de Rowuni. Bien que le code soit accessible publiquement à des fins de consultation et d'apprentissage, toute utilisation, reproduction, modification, distribution ou exploitation commerciale est strictement interdite sans l'autorisation écrite préalable de l'auteur.

Toute infraction à ces termes peut entraîner des poursuites légales.

Restrictions

❌ INTERDIT :

• Copier, modifier ou distribuer le code
• Utiliser le code dans vos propres projets
• Créer des œuvres dérivées
• Utiliser le code à des fins commerciales
• Retirer ou modifier les mentions de copyright

✅ AUTORISÉ (uniquement à des fins éducatives personnelles) :

• Consulter le code source
• Étudier l'implémentation
• S'inspirer des concepts (sans copier le code)

---

Twitch · GitHub

Pour toute question ou demande d'autorisation, n'hésitez pas à me contacter à contactrowuni@gmail.com