pkmn-heardle

ENG

A clone of Heardle, and K-Pop Heardle but for Pokémon musics. Based on Pokémon Heardle by SgtAngel777 and NickWrightData and modified to add more musics and features. The original Pokémon Heardle is down now. If you are the original creators of Pokémon Heardle and want me to stop this website and rehost Pokémon Heardle by yourself you can contact me anywhere (see the About popup on the website).

Each music is randomly chosen from Pokémon's soundtrack to appear only once. If every music is used once, the game automatically resets and every music appears once again in a different order. The code for daily seeded RNG come from Pokémon Mystery Dungeon Heardle. The code for the volume bar come from Video Games Infinite Heardle.

HOW TO RUN HEARDLE LOCALLY: Open index.html with your browser (Firefox, Chromium)

HOW TO MAKE YOUR OWN HEARDLE (UDPATED on 25/07/12) (If you want an heardle that does not includes translations you can check the readme of Etrian Heardle)

1. Fork this project to create your own copy of the code
2. Rename the project with the URL that you'd like to Heardle to live at, by going to Settings > Repository name
3. Use Github as host by going to Settings > Pages. In Source, choose "Deploy from a branch" and in branch choose "master".
4. Open the index.html file & replace "Pokémon" with the artist/genre/game of your heardle.
5. In the index.html file, you can update the image that gets shared with your link by updating lines 35-37.
6. You can update the icon in your browser's tab by updating the favicon.png image.
7. On line 2 of main.js, update the startDate to the current date in the format YEAR-MONTH-DAY (YYYY-MM-DD) - This will start the counter for your Heardle.
8. On line 1 of translation.js file and update languages with the list of languages of your Heardle.
9. On line 3 of music-list.js, "var musicNameList" is initialized. Replace it with a list of music titles you'd like to appear as suggestions in your Heardle. The list should follow the format: { id : music id, codeLanguage : "Music title" }. Each music must have a different id, and there must be one entry per language. For each language, music titles should follow the format "Music - Artist/Genre/Game". Make sure each music is in quotes and has a comma after it.
10. On line 1 of music-links.js, "var musicListWithLinks" is initialized. Here you'll have to replace the links with links to your musics. Only Soundcloud links at the moment. Each link will have to follow the following format: { url: "<link>", answer: id of the music },. Make sure to have at least 10 musics in your lists otherwise you'll run into issues with the search bar!
11. If you don't want your heardle link to show up whenever someone shares their results, around line 4933 add "//".
12. If you want to modify the interface text, edit constans in translation.js. Don't forget to add the new language flags to the "flags" folder if necessary. In particular, if you want to edit the text in the info button (About) on the top left, around line 80 you can update the text that shows up there. Search for "aboutPopupT" to find the line easier. Similarly, if you want to edit the text in the heart button (Support) next to the info button, around line 54, you can update the text that shows up there. Search for "supportPopupT" to find the line easier.
13. Replace https://nterrien.github.io/pkmn-heardle/ by the link to your heardle in main.js, index.html and translation.js.

KNOWN ISSUES

• If someone has stats in their local storage about music played before the music list loops, the "Current Streak" and "Max Streak" stats will be broken. To be more precise, the current streak and max streak will count every music with the same id as the same music. For example if I find the music with id 0 before a loop, and didn't found this music again in the next loop, it will probably be counted as found in current streak and max streak.

• Sometimes when you share your link to twitter, the image you added doesnt show up, even if you've updated the image link. The original creator thinks its a twitter issue and not a code issue.

• This code is specific to Soundcloud links.

  • There is a youtube [NOTE: this link doesn't work anymore] version, but its very basic and may have bugs; youtube links can be weird depending on your location, so it messes things up.

  • If you want to use a Spotify playlist, visit https://audial.mogdan.xyz/custom. You'll be able to add a link to your playlist and it seems to work similarly to Heardle.

FRA

Un clone de Heardle, et de K-Pop Heardle mais pour les musiques de Pokémon. Basé sur Pokémon Heardle par SgtAngel777 et NickWrightData et modifié pour ajouter plus de musiques et de fonctionnalités. Le Pokémon Heardle original n'existe plus. Si vous êtes les créateurs originaux de Pokémon Heardle et que vous voulez que j'arrête ce site web et que héberger Pokémon Heardle vous-même, vous pouvez me contacter n'importe où (voir le popup "À propos" sur le site).

Chaque musique est choisie au hasard dans la bande-son de Pokémon pour n'apparaître qu'une seule fois. Si chaque musique est utilisée une fois, le jeu se réinitialise automatiquement et chaque musique apparaît à nouveau dans un ordre différent. Le code pour la RNG seedée provient de Pokémon Donjon Mystère Heardle. Le code pour la bar de volume viens du Video Games Infinite Heardle.

COMMENT EXECUTER HEARDLE LOCALEMENT : Ouvrez index.html avec votre navigateur (Firefox, Chromium)

COMMENT FAIRE VOTRE PROPRE HEARDLE (MISE À JOUR LE 25/07/12) (Si vous voulez un heardle qui n'inclut pas de traductions, vous pouvez consulter le readme de Etrian Heardle)

1. Forkez ce projet pour créer votre propre copie du code.
2. Renommez le projet avec l'URL que vous souhaitez utiliser pour le Heardle, en allant dans Settings > Repository name
3. Utilisez Github comme hôte en allant dans Paramètres > Pages. Dans Source, choisissez "Deploy from a branch" et dans branch choisissez "master".
4. Ouvrez le fichier index.html et remplacez "Pokémon" par l'artiste/genre de votre Heardle. Assurez-vous de faire cela en premier, si vous mettez d'abord à jour le fichier main.js, il se peut que votre lien affiche toujours Joywave même après avoir tout mis à jour.
5. Dans le fichier index.html, vous pouvez mettre à jour l'image qui est partagée avec votre lien en mettant à jour les lignes 35-37.
6. Vous pouvez mettre à jour l'icône de l'onglet de votre navigateur en mettant à jour l'image favicon.png.
7. À la ligne 2 du main.js, mettez à jour le startDate avec la date actuelle au format ANNÉE-MOIS-JOUR (AAAA-MM-JJ) - Cela démarrera le compteur de votre Heardle.
8. À la ligne 1 du fichier translation.js, mettez à jour languages avec la liste des langues de votre Heardle.
9. À la ligne 3 du music-list.js, "var musicNameList" est initialisée. Remplacez la par une liste de titres de musiques que vous souhaitez voir apparaître comme suggestions dans votre Heardle. La liste dois suivre le format: { id : id de la musique, codeLanguage : "Titre de la musique" }. Chaque musique doit avoir un id différent, et il faut une entrée par langue. Pour chaque langue, le nom de la musique doit suivre le format "Nom de la musique - Artiste/Genre/Jeu". Assurez-vous que chaque musique est entre guillemets et qu'elle est suivie d'une virgule.
10. A la ligne 1 de music-links.js, "var musicListWithLinks" est initialisée. Ici, vous devrez remplacer les liens par des liens vers vos musiques. Seulement des liens Soundcloud. Chaque ligne devra suivre le format suivant : { url : "<link>", answer : id de la musique },. Assurez-vous d'avoir au moins 10 musiques dans votre liste sinon vous rencontrerez des problèmes avec la barre de recherche !
11. Si vous ne voulza pas que le lien de votre heardle soit affiché quand un utilisateur partage ses résulats, ajouter "//" autour de la ligne 4933.
12. Si vous voulez modifier le texte de l'interface, éditez les constantes dans translation.js. N'oubliez pas d'ajouter les nouveaux drapeaux de langue au dossier "flags" si nécessaire. En particulier, si vous voulez éditer le texte dans le bouton info (À propos) en haut à gauche, autour de la ligne 80, vous pouvez mettre à jour le texte qui s'y affiche. Cherchez "aboutPopupT" pour trouver la ligne plus facilement. De même, si vous souhaitez modifier le texte du bouton cœur (Support) à côté du bouton info, autour de la ligne 54, vous pouvez mettre à jour le texte qui s'affiche à cet endroit. Cherchez "supportPopupT" pour trouver la ligne plus facilement.
13. Remplacez https://nterrien.github.io/pkmn-heardle/ par le lien de votre Heardle dans main.js, index.html et translation.js.

PROBLÈMES CONNUS

• Si quelqu'un a joué et gardé ses cookies avant que la liste de musiques ait bouclée, les statistiques "Série actuelle" et "Série maximum" seront faux. Pour être plus précis, les statistiques "Série actuelle" et "Série maximum" compteront toutes les musiques ayant le même id comme étant la même musique. Par exemple, si je trouve la musique avec l'id 0 avant que la liste de musique se reset, et que je ne retrouve pas cette musique dans la boucle suivante, elle sera probablement comptée comme trouvée dans les statistiques "Série actuelle" et "Série maximum".

• Parfois, lorsque vous partagez votre lien sur Twitter, l'image que vous avez ajoutée n'apparaît pas, même si vous avez mis à jour le lien de l'image. Le créateur original pense qu'il s'agit d'un problème lié à Twitter et non d'un problème de code.

• Ce code est spécifique aux liens Soundcloud.

  • Il y a une version youtube [NOTE : ce lien ne fonctionne plus], mais elle est très basique et peut avoir des bugs ; les liens youtube peuvent être bizarres en fonction de votre localisation, ce qui peut perturber les choses.

  • Si vous voulez utiliser une liste de lecture Spotify, rendez-vous sur https://audial.mogdan.xyz/custom. Vous pourrez ajouter un lien à votre liste de lecture et cela à l'air de fonctionner de manière similaire à Heardle.