KainForgeCalculator

Calculatrice de la forge de Kain.
Cette calculatrice permet de calculer le coût de modification d'un objet épique de l'univers du jeu BW sur un serveur de type Ultima Thule / Nercopolis.
Essayer

Description

Ce projet a pour objectif de modéliser les données de la page "source des données" liée afin de réaliser une calculatrice des coûts de modification d'un item épique de l'univers du jeu BW d'un état donné à un autre état.
Cette calculatrice vise à faciliter les décisions des joueurs en leur fournissant des informations précises et directes, très rapidement, sur les coûts associés aux différentes combinaisons de modification des items ainsi qu'à leur description.

Technologies Open Source utilisées

Ce projet est développé en utilisant uniquement des technologies de base ("full vanilla") sans frameworks ou bibliothèques supplémentaires.
Cela permet de garantir une compréhension claire et directe du code source et de ses fonctionnalités.
Les langages utilisés incluent HTML, CSS, JavaScript et Batch Script. De plus, Git est utilisé pour le contrôle de version et la gestion des contributions, GIMP a été utilisé pour créer une image ainsi que le favicon et SonarQube (édition communautaire) est utilisé pour l'analyse de code et l'amélioration de la qualité.

Fonctionnalités

• Modélisation des données de la page "source des données".
• Prise en charge des différents états et items de l'univers du jeu BW.
• Calcul des coûts de modification d'un item d'un état à un autre.
• Prise en charge de l'amélioration aussi bien que de la diminution d'un item.
• Possibilité de copier le résultat dans le presse-papiers selon l'un des deux formats disponibles.
• Possibilité de traduire la page en plusieurs langues (Français et Anglais implémentés).
• Possibilité de lancer la page directement dans la langue demandée.
• Interface utilisateur intuitive et ludique pour faciliter l'utilisation de la calculatrice.
• Affichage entièrement responsive et animé.
• Utilisation d'effets sonores réglables.
• Conservation des préférences de l'utilisateur pour la prochaine utilisation.
• Possibilité d'afficher directement la description d'un item et son lien d'origine.
• Possibilité de régler le niveau du joueur pour la requête de récupération de la description avec un nouveau paramètre querystring nommé playerLvl
  (avec une valeur numérique comprise entre 1 et 1000 et ayant la valeur 100 par défaut).

Installation

Pour installer et exécuter ce projet localement, suivez les étapes ci-dessous :

1. Clonez le dépôt :

   git clone https://github.com/DeepSideEffect/KainForgeCalculator.git

2. Ouvrez la page index.html sur votre navigateur.

📝¹ Depuis la v1.4.0 avec la fonctionnalité d'internationalisation, la page pourrait ne plus s'afficher correctement en local, par défaut.
Des méthodes possibles pour éviter les problèmes de CORS lors du développement local sont détaillées dans ce fichier.

📝² Vous pouvez aussi ajouter le choix de la langue en paramètre queryString pour traduire directement à l'affichage, ex : http://localhost:5500/index.html?lang=en.

📝³ Depuis la v1.5.0 avec la fonctionnalité d'affichage de la description, vous pouvez choisir le niveau en l'ajoutant en paramètre queryString pour la récupération des descriptions,
ex : http://localhost:5500?lang=en&playerLvl=457 ou http://localhost:5500?playerLvl=754.

Utilisation

Sélectionnez un item avec ses caractéristiques de départ et d'arrivée.
La calculatrice affichera les coûts associés à la modification de l'item après avoir cliqué sur le bouton Calculer.
On peut accèder à la description d'un item en cliquant sur son nom dans les résultats affichés.

Exemples d'utilisation

Calculer le coût de modification d'une Epique Casquette Chic De La Miss vers un Epique Bandana Cornu De La Précognition.
Dans la partie Caractéristiques Souhaitées (= état d'arrivée) :

• Sélectionnez "Bandana" dans le menu déroulant du Support voulu.
• Sélectionnez "Cornu" dans le menu déroulant du Préfixe voulu.
• Sélectionnez "De La Précognition" dans le menu déroulant du Suffixe voulu.
• Cliquez sur "Calculer" pour obtenir le coût.
• La copie du résultat formaté, via le bouton Copier donnera ce récapitulatif :

Epique Casquette Chic De La Miss
==>
Epique Bandana Cornu De La Précognition 

Coût total :
1155 points d'évolution
465 pièces épiques
31 runes Verte Niveau 2

• Vous pouvez aussi afficher la description de l'un des items en cliquant sur son nom.

Contribuer

Les contributions sont les bienvenues ! Si vous souhaitez contribuer à ce projet, veuillez suivre les étapes ci-dessous :

• Forkez le dépôt.
• Créez une branche pour votre fonctionnalité (git checkout -b fonctionnalite/ma-fonctionnalite).
• Commitez vos modifications (git commit -m 'Ajout de ma fonctionnalité').
• Poussez votre branche (git push origin fonctionnalite/ma-fonctionnalite).
• Ouvrez une Pull Request.

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Rejoindre la partie sur Bloodwars

• sur le server créé le 12.09.2007 : Ultima Thule
• sur le server créé le 31.03.2008 : Ultima Thule II
• sur le server créé le 18.01.2010 : Ultima Thule III

Remerciements

• Merci à la communauté BW pour leur soutien et leurs retours.
• Merci à tous ceux qui ont contribué à ce projet tels que VashTheStampede, Burns et Minuit.

Auteurs

Deep - Développeur principal - GitHub profil

Autres langues du fichier README

• Fichier README anglais

Problèmes connus

Problème avec la propriété .lang de SpeechSynthesisUtterance sous Opera

La propriété .lang de SpeechSynthesisUtterance ne fonctionne pas correctement sous Opera, ce qui entraîne une mauvaise prononciation des textes en anglais avec un accent français.
Ce problème n'est pas présent sous Chrome, Edge et Firefox.

Suggestions

• Contacter le support d'Opera pour signaler le problème.
• Vérifier les forums pour des solutions ou des mises à jour.

Pour plus d'informations sur la compatibilité des navigateurs, consultez la documentation MDN.
Vous pouvez également suivre l'évolution de ce problème sur notre issue GitHub.

Nous espérons qu'une mise à jour future d'Opera corrigera ce problème.