D'abord, vous devez lancer une copie locale du client et du serveur du jeu, connectée à un compte AWS. Ainsi, lorsque vous utilisez Kiro pour modifier la base de code, vous pouvez vous assurer que vos changements fonctionnent réellement.
Cloner le dépôt
Clonez le dépôt de code source ouvert et basculez vers la branche challenge :
git clone git@github.com:kirodotdev/spirit-of-kiro.git cd spirit-of-kiro/ git checkout challenge
Après avoir cloné le dépôt, consultez quelques fichiers clés pour comprendre le projet :
architecture.md- Un aperçu de l'architectureappsec-overview.md- Détails sur la façon dont les composants spécifiques du jeu s'assemblent.
Dépendances préalables
Vous aurez besoin des dépendances suivantes installées :
- Docker Desktop ou Podman (recommandé).
- Configuration AWS :
- Accès aux modèles AWS Bedrock à un ou plusieurs des modèles suivants :
- Anthropic Claude Sonnet 5
- Amazon Nova Pro
Vérifier les dépendances
Exécutez le script de vérification des dépendances pour vous assurer que tout est configuré correctement :
./scripts/check-dependencies.sh
Afficher la transcription : Output of the dependency check script
Déployer le pool d'utilisateurs Cognito
Déployez un pool d'utilisateurs Amazon Cognito pour l'authentification (disponible dans le niveau gratuit AWS) :
./scripts/deploy-cognito.sh game-auth
Afficher la transcription : Output of the Cognito deployment script
Construire et lancer
Construisez et lancez la pile du jeu en utilisant Docker ou Podman :
podman compose build && podman compose up \ --watch \ --remove-orphans \ --timeout 0 \ --force-recreate
La première fois que vous exécutez cette commande, cela peut prendre quelques minutes. Les exécutions suivantes devraient se terminer en quelques secondes.
Afficher la transcription : Building and launching the game stack
Après l'achèvement, vous devriez voir les conteneurs du jeu s'exécuter dans votre interface de conteneurs.
L'exemple suivant montre l'interface Podman :
Chargement de l'image...
Vous pouvez utiliser Control + C ou Command + C pour arrêter toute la pile.
Amorcer la base de données
Lorsque votre pile se lance localement, elle lance également DynamoDB local, un conteneur spécial qui imite le service AWS DynamoDB, mais qui s'exécute localement sur votre propre machine. Le jeu s'attend à ce que plusieurs tables soient créées dans ce conteneur DynamoDB.
Pendant que la pile du jeu est toujours en cours d'exécution, ouvrez un nouveau terminal et utilisez les commandes suivantes pour créer automatiquement les tables nécessaires :
podman exec server mkdir -p /app/server/iac && podman cp scripts/bootstrap-local-dynamodb.js server:/app/ && podman cp server/iac/dynamodb.yml server:/app/server/iac/ && podman exec server bun run /app/bootstrap-local-dynamodb.js
Afficher la transcription : Bootstrapping the local DynamoDB tables
Faire un essai
Il est temps de vérifier que tout fonctionne correctement. Essayez d'abord la commande suivante pour vous assurer que le serveur du jeu s'exécute localement :
curl localhost:8080
Vous devriez voir la réponse OK
Ensuite, ouvrez votre navigateur Web et saisissez l'adresse suivante dans la barre d'adresse :
localhost:5173
Vous devriez voir la page d'accueil du client du jeu. Créez un compte et commencez à jouer.
Voici quelques éléments de base à essayer dans le jeu :
WASDpour se déplacer,Epour interagir- Tirez des objets aléatoires en utilisant le levier rouge « PULL »
- Ramassez des objets et transportez-les avec E. Lancez un objet tenu en main avec T. Astuce : les objets peuvent être lancés hors de la porte en bas.
- Transportez un objet jusqu'à l'établi et utilisez E pour le poser sur l'établi. Faites glisser les objets pour les déplacer vers le mur à outils à l'arrière, ou vers la zone de travail en bas. Cliquez sur un objet sur le mur à outils pour lancer une de ses « bizarreries », puis sélectionnez une ou plusieurs cibles pour la « bizarrerie ». L'outil et les cibles se transformeront tous deux en fonction de la bizarrerie. Soyez créatif avec cela, il y a des possibilités presque infinies, et vous pouvez créer des choses vraiment bizarres.
- Si vous fracassez des objets ou les coupez ou les cassez d'une autre façon en morceaux, et qu'il y a beaucoup d'objets dans la zone de travail de l'établi, ils déborderont et tomberont sur le sol autour de l'établi. Essayez de ne pas laisser le sol devenir trop encombré !
- Le coffre sert au rangement lorsque vous avez trop d'objets.
- Lorsqu'un objet est lancé hors de la porte en bas, le commerçant l'évaluera et vous obtiendrez de l'argent pour celui-ci. Il aime les objets amusants, inhabituels, en bon état, ou qui semblent être des objets de collection rares.
- L'ordinateur affiche les objets qui ont été jetés ou donnés à l'évaluateur, à la fois par vous-même et par d'autres joueurs. Cela sert de « boutique » aléatoire où vous pouvez acheter indirectement auprès d'autres joueurs, ou racheter des objets que vous avez perdus.
Avez-vous fini de jouer avec votre copie du jeu? Passons à la première tâche :
Piloter Kiro avec le Steering, et améliorer la page d'accueil du jeu
Configuration pour le développement sur spirit of Kiro