Create a first command list categorization

[AerunDev]

As a member of the dev team
I would like to know what is the command list implementation prioritization
So that I can create the relevent issues and start to work on them

[AerunDev]

Ce commentaire fourni une vue d'ensemble de toutes les commandes d'événement qui seront disponibles sur Pokémon Studio, organisés par Catégorie.

L'objectif de ce commentaire est de faciliter l'implémentation technique des commandes d'événement de RPG Maker XP en commandes Pokémon Studio.

Pour rappel, le MVP consiste à intégrer les commandes existantes de RPG Maker XP afin d'assurer la compatibilité des projets, tandis que les commandes PSDK seront ajoutées selon la priorité (basée sur des critères d'utilisation, de pertinence et de coût en développement), les disponibilités de l'équipe de développement et la fréquence des mises à jour.

Catégories de commandes

Les commandes sont classées selon des catégories logiques, permettant aux utilisateurs de plus simplement s'y retrouver dans la liste des commandes.

1. Messages - Commandes liées à l'affichage du texte, de choix et d'interactions avec le joueur
2. Interactions - Commandes liées à des interactions avec le joueur
3. Contrôle des flux - Commandes qui contrôlent le flux logique des événements, y compris les conditions, boucles et exécution de scripts
4. Paramètres d'événements - Commandes qui modifient les propriétés des événements, y compris l'apparence, le mouvement et le comportement
5. Déroulement du jeu - Commandes qui contrôlent la progression du jeu, y compris la téléportation du joueur, le Game Over ou l'écran titre
6. Combats - Commandes relatives à l'initiation et la gestion des combats
7. Base de données - Commandes qui manipulent les entités de la base de données du jeu comme les objets, l'argent et les créatures
8. Environnement sonore - Commandes liées à la musique, aux effets sonores et à la gestion audio
9. Environnement visuel - Commandes qui modifient les éléments visuels du jeu comme les effets de l'écran, la météo ou les images
10. Interfaces - Commandes qui permettent d'ouvrir et contrôler les interfaces du jeu et les menus
11. Inventaire - Commandes qui permettent de gérer l'inventaire du joueur
12. Sauvegardes - Commandes qui permettent de gérer la sauvegarde de la partie du joueur
13. Quêtes ⏩ - Commandes qui permettent de gérer les quêtes via le système de PSDK
14. Développement - Commandes de scripting# Liste des commandes par catégorie

⏩= arrivée avec PSDK, sera sûrement reporté post Version 3.0
❓= question ou doute à traiter

Messages

1. Afficher un message - Affiche un texte dans une boîte de message paramétrable
2. Gestion du narrateur ⏩ - Configure le narrateur lors de l'affichage d'un message
3. Options additionnelles - Options additionnelles d'affichage des messages
4. Afficher un choix - Affiche une liste déroulante de choix pour le joueur, avec en optionnel un message pour donner du contexte
5. Demander un nombre au joueur - Demande au joueur de préciser un nombre

Interactions

1. Attendre l'appuie d'une touche - Attend que le joueur appuie sur une touche spécifique
2. Enregistrer l'appuie d'une touche - Enregistre le touche appuyée par le joueur
3. Changer le nom d'une créature ⏩ - Demande au joueur de préciser un nom pour une créature donnée
4. Changer le nom d'un personnage - Demander au joueur de préciser un nom pour un personnage donné (y compris le joueur)

Contrôle des flux

1. Créer une boucle - Permet de créer des sections qui permettent de rejouer une partie d'un événement
2. Quitter une boucle - Permet de sortir d'une boucle
3. Gérer les conditions - Créé des branches conditionnels qui vont être exécutées selon les conditions remplies
4. Aller à (Go to) - Permet de se déplacer à un autre point dans cet événement
5. Attendre un certain temps - Met l'exécution de l'événement en pause pendant un certain temps (en secondes)
6. Arrêter l'exécution d'un événement - Arrête l'exécution d'un événement et l'empêche ainsi de se terminer
7. Appeler un événement - Appelle un autre événement

Paramètres d'événements

1. Modifier l'opacité d'un événement - Change la transparence d'un événement
2. Modifier les paramètres d'un événement ⏩ - AJOUTER ICI TOUS LES PARAMETRES listés dans la page [[Paramètres des événements]] (actuellement gérés dans le code)
3. Déplacer un événement - Permet de contrôler les déplacements d'un événement
4. Attendre la fin des déplacements - Met en pause l'exécution de l'événement jusqu'à ce que le déplacement des autres événements soient complets
5. Effacer l'événement - Permet de gérer la réapparition d'un événement après son exécution

Déroulement du jeu

1. Gérer les variables - Configure les différentes variables disponibles (booléens, numériques, textes, etc.)
2. Gérer les variables locales - Configure les différentes variables locales disponibles (booléens, numériques, textes, etc.)
3. Téléporter un événement ou le joueur - Déplace le joueur ou un événement à un autre endroit
4. Lancer le Game Over - Lance la scène du Game Over, ramenant ensuite le joueur à l'écran titre
5. Retourner à l'écran titre - Ramène le joueur sur l'écran titre
6. Gérer le chronomètre - Permet de gérer le chronomètre du jeu
7. Gérer le Pokédex ⏩ - Permet d'activer ou désactiver le Pokédex
8. Définir le Pokédex utilisé ⏩ - Permet de choisir le mode du Pokédex
9. Donner un badge ⏩ - Permet de donner un ou plusieurs badges au joueur

Combats

1. Démarrer un combat contre un Dresseur ⏩ - Démarre un combat contre un dresseur donné, selon différents paramètres
2. Démarrer un combat contre une créature sauvage ⏩ - Démarre un combat contre une créature donnée, selon différents paramètres (peut provenir d'un groupe, aléatoire ou non, ou être généré)
3. Démarrer un combat scénarisé ⏩ - Permet de démarrer un combat dont certains événements sont scriptés
4. Gérer l'activation des rencontres aléatoires - Permet de gérer l'activation des rencontres aléatoires avec les créatures sur la carte concernée
5. Gérer le fond de combat - Permet de modifier le fond affiché lors des combats

Environnement sonore

1. Changer la musique de combat - Modifie la musique jouée durant les combats
2. Changer la musique de victoire - Modifie la musique jouée lors de la victoire du joueur à un combat
3. Changer le fond musical - Modifie la musique de fond jouée lorsque le joueur se déplace sur la carte
4. Modifier le fond sonore - Modifie le fond sonore joué en continue sur la carte
5. Jouer un effet musical - Joue un effet musical (ME) comme un jingle
6. Jouer un effet sonore - Joue un effet sonore (SE)
7. Arrêter le fond musical - Arrête la musique de fond jouée avec un fade possible
8. Arrêter le fond sonore - Arrête le fond sonore joué
9. Arrêter les effets musicaux - Arrête tous les effets musicaux joués
10. Arrêter les effets sonores - Arrête tous les effets sonores joués, y compris les cris des créatures
11. Mémoriser les fonds sonores - Permet de mémoriser les sons joués pour les restaurer plus tard
12. Restaurer les fonds sonores - Permet de restaurer les sons mémorisés au préalable
13. Jouer le cri d'une créature ⏩ - Joue le cri d'une créature spécifiée

Environnement visuel

1. Modifier le ton de l'écran - Permet de modifier le ton de l'écran selon plusieurs paramètres
2. Flasher l'écran - Affiche un flash lumineux à l'écran selon plusieurs paramètres
3. Secouer l'écran - Secoue l'écran selon plusieurs paramètres
4. Changer la météo - Démarre une météo ou celle en cours d'exécution
5. Gérer le brouillard de la carte - Permet de modifier le brouillard affiché sur la carte
6. Gérer le panorama de la carte - Permet de modifier le panorama affiché en fond de carte
7. Déplacer la caméra - Permet de faire défiler la caméra dans une autre direction
8. Afficher une animation - Joue une animation sur la carte ou un événement donné
9. Afficher une émotion ⏩ - Affiche une émotion sur le joueur ou un événement donné
10. Afficher une image - Affiche une image sur l'écran
11. Animer une image - Anime une image existante
12. Effacer une image - Efface une image existante sur l'écran

Interfaces

1. Ouvrir une scène - Permet de lancer une scène spécifique du jeu ou un menu
2. Ouvrir le magasin - Ouvre l'interface du magasin afin d'acheter ou vendre des objets (à conserver ou à intégrer à 1. Ouvrir une scène ?)
3. Ouvrir une scène personnalisée ⏩ - Permet de lancer une scène spécifique et qui n'est pas native à PSDK
4. Gérer l'accès au menu principal - Permet de contrôler l'accès du joueur au menu principal

Inventaire

1. Gérer les objets - Modifie l'inventaire du joueur en ajoutant ou retirant des objets via des méthodes spécifiques (classique + add / give / pick_item)
2. Gérer la monnaie - Modifie la monnaie du joueur en ajoutant ou retirant de l'argent

Sauvegarde

1. Gérer l'accès au menu de sauvegarde - Permet de contrôler l'accès du joueur au menu de sauvegarde
2. Activer la sauvegarde automatique ⏩ - Permet de gérer l'activation de la sauvegarde automatique

Quêtes

1. Démarrer une quête ⏩ - Permet de démarrer une quête (intégrer la commande check_up_signal en sortie)
2. Afficher un objectif caché ⏩ - Permet l'affichage au joueur d'un objectif caché pour une quête donnée
3. Valider les objectifs d'une quête ⏩ - Permet de valider un ou plusieurs objectifs d'une quête
4. Vérifier la fin d'une quête ⏩ - Permet de valider la fin d'une quête
5. Distribuer les gains d'une quête (vérifier la fin + annoncer la fin) ⏩ - Permet de valider la fin d'une quête, de distribuer les gains et annoncer la fin de cette quête

Développement

1. Insérer un script - Permet d'insérer un script personnalisé en Ruby

[AerunDev]

Also see the Wiki update if needed: https://github.com/PokemonWorkshop/PokemonStudio/wiki/V3-Doc-Event-List-Event-Commands-in-Studio