Différences entre les versions de « Creation Kit : Scripter »

De Wiwiki
Aller à la navigation Aller à la recherche
(Fin de la traduction)
 
(Une version intermédiaire par un autre utilisateur non affichée)
Ligne 8 : Ligne 8 :


=Résumé=
=Résumé=
Ce tutoriel va vous montrer comment utiliser les scripts pour faire avancer la quête suivant les actions du joueur. On a déjà vu comment scripter un dialogue, mais ici, nous allons voir comment attacher n'importe quel script a un acteur ou a un objet.
Ce tutoriel va vous montrer comment utiliser les scripts pour faire avancer la quête suivant les actions du joueur. On a déjà vu comment scripter un dialogue, mais ici, nous allons voir comment attacher n'importe quel script à un acteur ou à un objet.
<br><br>Vous allez apprendre:
<br><br>Vous allez apprendre:
* Les généralités sur le fonctionnement des scripts et comment ils s'attachent aux objets dans le Creation Engine.
* Les généralités sur le fonctionnement des scripts et comment ils s'attachent aux objets dans le Creation Engine.
* Comment répondre a un évènement dans le nouveau langage de scripts.
* Comment répondre à un évènement dans le nouveau langage de scripts.


<!--(Pour une introduction encore plus simple aux scripts, voir le tutoriel Hello World-->
<!--(Pour une introduction encore plus simple aux scripts, voir le tutoriel Hello World-->


=Papyrus=
=Papyrus=
Le langage de scripts utilisé par le Creation Kit est appelé Papyrus (d'après ce qui compose les parchemins). Les scripts Papyrus sont de simple fichier texte qui sont compilés en bytecode que le jeu exécute au runtime.
Le langage de scripts utilisé par le Creation Kit est appelé Papyrus (d'après ce qui compose les parchemins). Les scripts Papyrus sont de simples fichiers textes qui sont compilés en bytecode que le jeu exécute au runtime.


::{|style="border-collapse: separate; border-spacing: 0; border-width: 1px; border-style: solid; border-color: #000; padding: 0"
::{|style="border-collapse: separate; border-spacing: 0; border-width: 1px; border-style: solid; border-color: #000; padding: 0"
|-
|-
|style="border-style: solid; border-width: 0"|[[Image:CKNewFeature.jpg|48px]]
|style="border-style: solid; border-width: 0"|[[Image:CKNewFeature.jpg|48px]]
|style="border-style: solid; border-width: 0"|Le nouveau système est similaire au TESScript, mais requière une manière de penser légèrement différente. Vous ne pouvez plus directement manipuler les objets dans le mode; il y a maintenant des thread, votre script peut alors être interrompus en fonctionnement; il est beaucoup plus script en ce qui concerne la syntaxe (e.g. parenthèses). Pour faire court, il est beaucoup plus proche de "vrais" langages de programmation comme le [http://lua.org Lua] ou [http://python.org Python]. Si vous êtes familier avec le TESScript, vous devriez jeter un œil a notre [[Construction Kit : Différences avec le TESScript| guide de transition]].
|style="border-style: solid; border-width: 0"|Le nouveau système est similaire au TESScript, mais requière une manière de penser légèrement différente. Vous ne pouvez plus directement manipuler les objets dans le mode; il y a maintenant des thread, votre script peut alors être interrompu en fonctionnement; il est beaucoup plus script en ce qui concerne la syntaxe (e.g. parenthèses). Pour faire court, il est beaucoup plus proche de "vrais" langages de programmation comme le [http://lua.org Lua] ou [http://python.org Python]. Si vous êtes familier avec le TESScript, vous devriez jeter un œil a notre [[Construction Kit : Différences avec le TESScript| guide de transition]].
|}
|}


La première chose que nous allons faire est ajouter un script sur notre voleur afin que lorsqu'il est tuée, la quête progresse.
La première chose que nous allons faire est ajouter un script sur notre voleur afin que lorsqu'il est tué, la quête progresse.


=Ajouter des Scripts=
=Ajouter des Scripts=
Ouvrez l'acteur GSQThief que nous avons créé. Nous allons nous intéresser a la section "Papyrus Scripts" de la fenêtre.
Ouvrez l'acteur GSQThief que nous avons créé. Nous allons nous intéresser à la section "Papyrus Scripts" de la fenêtre.


[[Image:CKActorWindowScriptsArea.png|600px]]
[[Image:CKActorWindowScriptsArea.png|600px]]


Cliquez sur le bouton "Add". Cela va ouvrir une liste de scripts que nous pouvons potentiellement ajouter a cet acteur. Mais nous sommes en trains d'en créer en nouveau, double-cliquez donc sur "[New Script]" en haut de la liste.
Cliquez sur le bouton "Add". Cela va ouvrir une liste de scripts que nous pouvons potentiellement ajouter à cet acteur. Mais nous sommes en train d'en créer un nouveau, double-cliquez donc sur "[New Script]" en haut de la liste.


[[Image:CKAddScriptWindow.png]]
[[Image:CKAddScriptWindow.png]]
Ligne 39 : Ligne 39 :
[[Image:CKAddNewScriptWindow.png]]
[[Image:CKAddNewScriptWindow.png]]


Votre script est maintenant ajouté a l'acteur. Mais, comme on peut s'y attendre, il ne fait encore rien.
Votre script est maintenant ajouté à l'acteur. Mais, comme on peut s'y attendre, il ne fait encore rien.


[[Image:CKScriptAdded.png]]
[[Image:CKScriptAdded.png]]


=Propriétés=
=Propriétés=
Double cliquez sur le script pour ouvrir la fenêtre des propriétés de ce script. De base, les scripts ne savent rien a propos des objets du jeu autre que celui auquel ils sont attachés. Nous utilisons les propriétés afin d'attaches des objets ensemble pour qu'ils puissent s'affecter les un les autres. Dans notre exemple, nous voulons passer GSQ01 à l'étape 20 lorsque le voleur est tué, il faut donc que le script sache quelle quête nous intéresse.
Double-cliquez sur le script pour ouvrir la fenêtre des propriétés de ce script. De base, les scripts ne savent rien à propos des objets du jeu autre que celui auquel ils sont attachés. Nous utilisons les propriétés afin d'attacher des objets ensemble pour qu'ils puissent s'affecter les uns les autres. Dans notre exemple, nous voulons passer GSQ01 à l'étape 20 lorsque le voleur est tué, il faut donc que le script sache quelle quête nous intéresse.


[[File:CKEmptyPropertiesWindow.png]]
[[File:CKEmptyPropertiesWindow.png]]


Appuyez sur "Add Property" en bas à gauche de la fenêtre. C'est ici que nous allons créer la propriété. Dans le champ Type, sois choisissez "Quest" dans le menu, sois tapez le mot "Quest". Mettez "TutorialQuest" dans le champ Name, et laissez le reste vide.
Appuyez sur "Add Property" en bas à gauche de la fenêtre. C'est ici que nous allons créer la propriété. Dans le champ Type, soit choisissez "Quest" dans le menu, soit tapez le mot "Quest". Mettez "TutorialQuest" dans le champ Name, et laissez le reste vide.


[[File:CKAddScriptPropertyWindow.png]]
[[File:CKAddScriptPropertyWindow.png]]


Nous avons maintenant dit au script que il doit utiliser quelque chose qui s’appelle "TutorialQuest", mais il ne sait pas de quelle quête il s'agit. Cliquez sur la propriété que nous venons de créer dans la liste, et cliquez sur "Edit Value" a droit de la fenêtre. Un nouveau menu va apparaitre, listant toute les quêtes du jeu. Choisissez "GSQ01" dans le menu, et appuyez sur OK.
Nous avons maintenant dit au script qu'il doit utiliser quelque chose qui s’appelle "TutorialQuest", mais il ne sait pas de quelle quête il s'agit. Cliquez sur la propriété que nous venons de créer dans la liste, et cliquez sur "Edit Value" à droite de la fenêtre. Un nouveau menu va apparaitre, listant toutes les quêtes du jeu. Choisissez "GSQ01" dans le menu, et appuyez sur OK.


[[File:CKPropertyWindowFilled.png]]
[[File:CKPropertyWindowFilled.png]]
Ligne 61 : Ligne 61 :
[[File:CKScriptWindowWithPropertyAdded.png]]
[[File:CKScriptWindowWithPropertyAdded.png]]


La première ligne (<code>Scriptname GSQThiefScript extends ObjectReference</code>) est la base que l'éditeur a fait pour nous quand nous avons crée le script. Quelque lignes en dessous se trouve la version textuelle de la propriété que nous avons fait.
La première ligne (<code>Scriptname GSQThiefScript extends ObjectReference</code>) est la base que l'éditeur a fait pour nous quand nous avons créés le script. Quelques lignes en dessous se trouve la version textuelle de la propriété que nous avons fait.


À la fin du texte, copiez et collez ce morceau de code:
À la fin du texte, copiez et collez ce morceau de code:
Ligne 70 : Ligne 70 :
EndEvent</nowiki>
EndEvent</nowiki>


SI vous êtes suffisamment connaisseur en programmation ou en scripting pour comprendre ce que vous venez de coller, vous pouvez directement aller à la section "Scripter l'Amulette". Pour tous les autre, nous allons voir ça lige par ligne.
SI vous êtes suffisamment connaisseur en programmation ou en scripting pour comprendre ce que vous venez de coller, vous pouvez directement aller à la section "Scripter l'Amulette". Pour tous les autres, nous allons voir ça ligne par ligne.


* <code>Event OnDeath(Actor killer)</code>
* <code>Event OnDeath(Actor killer)</code>
** This ligne déclare que le script va répondre a la mort de l'acteur. Quand l'acteur meurt, le jeu va commencer a exécuter le code a partir de ce point. Le jeu va placer celui qui a tué l'acteur dans la variable "killer", mais nous n'en avons pas besoins ici.
** Cette ligne déclare que le script va répondre à la mort de l'acteur. Quand l'acteur meurt, le jeu va commencer à exécuter le code à partir de ce point. Le jeu va placer celui qui a tué l'acteur dans la variable "killer", mais nous n'en avons pas besoin ici.
* <code> TutorialQuest.SetStage(20)</code>
* <code> TutorialQuest.SetStage(20)</code>
** Tout comme nous avons appelé <code>SetStage</code> sur la quête possédant le dialogue auparavant, nous mettons ici la quête que nous avons mit dans la propriété TutoriaQuest à l'étape 20.
** Tout comme nous avons appelé <code>SetStage</code> sur la quête possédant le dialogue auparavant, nous mettons ici la quête que nous avons mis dans la propriété TutoriaQuest à l'étape 20.
** Nous indentons pour une question de lidibilité.
** Nous indentons pour une question de lisibilité.
* <code>EndEvent</code>
* <code>EndEvent</code>
** Cela marque la fin de notre réaction a l’événement de mort.
** Cela marque la fin de notre réaction à l’événement de mort.


Sélectionnez "Save" dans le menu "File" (ou faites Ctrl-S) et l'éditeur va tenter de compiler votre script. Une fenêtre de sortie vas apparaitre -- si votre script est syntaxiquement correct, elle ressemblera a ça:
Sélectionnez "Save" dans le menu "File" (ou faites Ctrl-S) et l'éditeur va tenter de compiler votre script. Une fenêtre de sortie va apparaitre -- si votre script est syntaxiquement correct, elle ressemblera à ça:


[[File:CKCompilerOutputGood.png]]
[[File:CKCompilerOutputGood.png]]
Ligne 86 : Ligne 86 :
Si vous voyez autre chose, vous avez fait une erreur en copiant. Réessayez!
Si vous voyez autre chose, vous avez fait une erreur en copiant. Réessayez!


Une fois finis, fermez la fenêtre de script et la fenêtre d'acteur, et sauvez votre plugin. Maintenant, nous allons scripter l'amulette elle même.
Une fois fini, fermez la fenêtre de script et la fenêtre d'acteur, et sauvegardez votre plugin. Maintenant, nous allons scripter l'amulette elle même.


==Scripter l'Amulette==
==Scripter l'Amulette==
Ouvrez l'objet GSQAmulet que nous avons crée dans le tutoriel précedent. Dans la fenêtre d armure, la zone de script est toute a droite.
Ouvrez l'objet GSQAmulet que nous avons créés dans le tutoriel précédent. Dans la fenêtre d'armure, la zone de script est toute à droite.


[[Image:CKArmorWindowScriptArea.png|600px]]
[[Image:CKArmorWindowScriptArea.png|600px]]


Créez un nouveau script comme nous l'avons fait auparavant, et appelez le GSQAmuletScript. Ajoutez lui une propriété de Quête. Pour simplifier les choses, appelez la directement "GSQ01" au lieux de TutorialQuest.
Créez un nouveau script comme nous l'avons fait auparavant, et appelez-le GSQAmuletScript. Ajoutez-lui une propriété de Quête. Pour simplifier les choses, appelez-la directement "GSQ01" au lieu de TutorialQuest.


[[File:CKAutofilledProperty.png]]
[[File:CKAutofilledProperty.png]]


Il va remplir automatiquement la propriété pour vous, puisque la propriété a un nom qui correspond a un ID existant. Si vous utilisez beaucoup de propriétés, cela permet de gagner du temps.
Il va remplir automatiquement la propriété pour vous, puisque la propriété a un nom qui correspond à un ID existant. Si vous utilisez beaucoup de propriétés, cela permet de gagner du temps.


Ouvrez le script, nous allons y ajouter quelques évènement. L'amulette ne peut évidemment pas mourir, mais nous voulons savoir quand est-ce que le joueur la prend. Notre évènement devrais ressembler a ceci:
Ouvrez le script, nous allons y ajouter quelques évènements. L'amulette ne peut évidemment pas mourir, mais nous voulons savoir quand est-ce que le joueur la prend. Notre évènement devrait ressembler à ceci :


  <nowiki>
  <nowiki>
Ligne 108 : Ligne 108 :
EndEvent</nowiki>
EndEvent</nowiki>


Il y a certaines choses a noter dans ce script:
Il y a certaines choses à noter dans ce script:
* Les paramètres dans la déclaration (<code>newContainer</code> and <code>oldContainer</code>) seront automatiquement remplis par le jeu quant il demandera au script de gérer l'évènement.
* Les paramètres dans la déclaration (<code>newContainer</code> and <code>oldContainer</code>) seront automatiquement remplis par le jeu quand il demandera au script de gérer l'évènement.
* Comme l'évènement OnContainerChanged est lancé a chaque fois que l'objet change de main, nous devons être sur de ne changer le stage que quand le joueur le prend, d'où le block <code>if</code>/<code>endif</code>.
* Comme l'évènement OnContainerChanged est lancé à chaque fois que l'objet change de main, nous devons être sûr de ne changer le stage que quand le joueur le prend, d'où le block <code>if</code>/<code>endif</code>.
* <code>Game.GetPlayer()</code> est un moyen simple d'avoir la référence du joueur sans avoir besoins de créer une propriété, et <code>newContainer</code> est remplis par le moteur lorsque l'évènement est lancé. On peut donc facilement comparer pour voir si l'objet est bien pris par le joueur.
* <code>Game.GetPlayer()</code> est un moyen simple d'avoir la référence du joueur sans avoir besoin de créer une propriété, et <code>newContainer</code> est rempli par le moteur lorsque l'évènement est lancé. On peut donc facilement comparer pour voir si l'objet est bien pris par le joueur.
* Comme le script est actuellement, SetStage est appelé a chaque fois que le joueur prend l'amulette. Ce n'est pas un problème, car chaque étape de quête ne peut se passer que une seule fois --- Appeler SetStage(30) n'a aucun effet après la première fois.
* Comme le script est actuellement, SetStage est appelé à chaque fois que le joueur prend l'amulette. Ce n'est pas un problème, car chaque étape de quête ne peut se passer qu'une seule fois --- Appeler SetStage(30) n'a aucun effet après la première fois.


Le script est maintenant près. Fermez le script est la fenêtre de l'amulette, et sauvegardez votre plugin.
Le script est maintenant prêt. Fermez le script et la fenêtre de l'amulette, et sauvegardez votre plugin.


Vous pouvez maintenant tester votre quête du début a la fin, en utilisant la console et SQV (<code>SQV GSQ001</code>) pour voir l'étape changer.
Vous pouvez maintenant tester votre quête du début à la fin, en utilisant la console et SQV (<code>SQV GSQ001</code>) pour voir l'étape changer.


Mais les joueurs ne vont pas utiliser la console, nous allons donc apprendre a leur donner de meilleurs indications de leur progrès dans le prochain chapitre.
Mais les joueurs ne vont pas utiliser la console, nous allons donc apprendre à leur donner de meilleures indications de leurs progrès dans le prochain chapitre.


::{|style="border-collapse: separate; border-spacing: 0; border-width: 1px; border-style: solid; border-color: #000; padding: 0"
::{|style="border-collapse: separate; border-spacing: 0; border-width: 1px; border-style: solid; border-color: #000; padding: 0"
|-
|-
|style="border-style: solid; border-width: 0"|[[Image:CKProtip.jpg|48px]]
|style="border-style: solid; border-width: 0"|[[Image:CKProtip.jpg|48px]]
|style="border-style: solid; border-width: 0"|Les scripts dans Skyrim sont de simple fichier texte dans votre dossier Data avant d'être compilés en bytecode. Cela signifie que si vous avez un éditeur de texte favoris, vous pouvez l'utiliser pour scripter. Le wiki officiel possède quelques exemples de configuration qui permet la coloration syntaxique, une autocompletion basique et des raccourcis de compilation. Si vous allez scripter intensément, ces outils peuvent vraiment vous simplifier la vie.
|style="border-style: solid; border-width: 0"|Les scripts dans Skyrim sont de simples fichiers textes dans votre dossier Data avant d'être compilés en bytecode. Cela signifie que si vous avez un éditeur de texte favori, vous pouvez l'utiliser pour scripter. Le wiki officiel possède quelques exemples de configuration qui permettent la coloration syntaxique, une autocomplétion basique et des raccourcis de compilation. Si vous allez scripter intensément, ces outils peuvent vraiment vous simplifier la vie.
|}
|}


{{Navigation|tag=Creation Kit|parent=Tutoriels|actuel=Scripter|précédent=Créer un objet|suivant=Scripter }}
{{Navigation|tag=Creation Kit|parent=Tutoriels|actuel=Scripter|précédent=Créer un objet|suivant=Objectifs}}

Version actuelle datée du 2 août 2013 à 11:38



Tutoriel traduit du wiki officiel: Original

Résumé

Ce tutoriel va vous montrer comment utiliser les scripts pour faire avancer la quête suivant les actions du joueur. On a déjà vu comment scripter un dialogue, mais ici, nous allons voir comment attacher n'importe quel script à un acteur ou à un objet.

Vous allez apprendre:

  • Les généralités sur le fonctionnement des scripts et comment ils s'attachent aux objets dans le Creation Engine.
  • Comment répondre à un évènement dans le nouveau langage de scripts.


Papyrus

Le langage de scripts utilisé par le Creation Kit est appelé Papyrus (d'après ce qui compose les parchemins). Les scripts Papyrus sont de simples fichiers textes qui sont compilés en bytecode que le jeu exécute au runtime.

CKNewFeature.jpg Le nouveau système est similaire au TESScript, mais requière une manière de penser légèrement différente. Vous ne pouvez plus directement manipuler les objets dans le mode; il y a maintenant des thread, votre script peut alors être interrompu en fonctionnement; il est beaucoup plus script en ce qui concerne la syntaxe (e.g. parenthèses). Pour faire court, il est beaucoup plus proche de "vrais" langages de programmation comme le Lua ou Python. Si vous êtes familier avec le TESScript, vous devriez jeter un œil a notre guide de transition.

La première chose que nous allons faire est ajouter un script sur notre voleur afin que lorsqu'il est tué, la quête progresse.

Ajouter des Scripts

Ouvrez l'acteur GSQThief que nous avons créé. Nous allons nous intéresser à la section "Papyrus Scripts" de la fenêtre.

CKActorWindowScriptsArea.png

Cliquez sur le bouton "Add". Cela va ouvrir une liste de scripts que nous pouvons potentiellement ajouter à cet acteur. Mais nous sommes en train d'en créer un nouveau, double-cliquez donc sur "[New Script]" en haut de la liste.

CKAddScriptWindow.png

Cela ouvrira encore une fenêtre, où nous pouvons nommer notre script. Mettez donc "GSQThiefScript" puis appuyez sur OK.

CKAddNewScriptWindow.png

Votre script est maintenant ajouté à l'acteur. Mais, comme on peut s'y attendre, il ne fait encore rien.

CKScriptAdded.png

Propriétés

Double-cliquez sur le script pour ouvrir la fenêtre des propriétés de ce script. De base, les scripts ne savent rien à propos des objets du jeu autre que celui auquel ils sont attachés. Nous utilisons les propriétés afin d'attacher des objets ensemble pour qu'ils puissent s'affecter les uns les autres. Dans notre exemple, nous voulons passer GSQ01 à l'étape 20 lorsque le voleur est tué, il faut donc que le script sache quelle quête nous intéresse.

CKEmptyPropertiesWindow.png

Appuyez sur "Add Property" en bas à gauche de la fenêtre. C'est ici que nous allons créer la propriété. Dans le champ Type, soit choisissez "Quest" dans le menu, soit tapez le mot "Quest". Mettez "TutorialQuest" dans le champ Name, et laissez le reste vide.

CKAddScriptPropertyWindow.png

Nous avons maintenant dit au script qu'il doit utiliser quelque chose qui s’appelle "TutorialQuest", mais il ne sait pas de quelle quête il s'agit. Cliquez sur la propriété que nous venons de créer dans la liste, et cliquez sur "Edit Value" à droite de la fenêtre. Un nouveau menu va apparaitre, listant toutes les quêtes du jeu. Choisissez "GSQ01" dans le menu, et appuyez sur OK.

CKPropertyWindowFilled.png

Écrire le script

Maintenant que nous avons ajouté cette propriété, nous devons ajouter le script en lui même pour en faire quelque chose!, Faites un clic droit sur le nom du script et sélectionnez "Edit source" pour ouvrir l'éditeur de script.

CKScriptWindowWithPropertyAdded.png

La première ligne (Scriptname GSQThiefScript extends ObjectReference) est la base que l'éditeur a fait pour nous quand nous avons créés le script. Quelques lignes en dessous se trouve la version textuelle de la propriété que nous avons fait.

À la fin du texte, copiez et collez ce morceau de code:

Event OnDeath(Actor killer)
	TutorialQuest.SetStage(20)
EndEvent

SI vous êtes suffisamment connaisseur en programmation ou en scripting pour comprendre ce que vous venez de coller, vous pouvez directement aller à la section "Scripter l'Amulette". Pour tous les autres, nous allons voir ça ligne par ligne.

  • Event OnDeath(Actor killer)
    • Cette ligne déclare que le script va répondre à la mort de l'acteur. Quand l'acteur meurt, le jeu va commencer à exécuter le code à partir de ce point. Le jeu va placer celui qui a tué l'acteur dans la variable "killer", mais nous n'en avons pas besoin ici.
  • TutorialQuest.SetStage(20)
    • Tout comme nous avons appelé SetStage sur la quête possédant le dialogue auparavant, nous mettons ici la quête que nous avons mis dans la propriété TutoriaQuest à l'étape 20.
    • Nous indentons pour une question de lisibilité.
  • EndEvent
    • Cela marque la fin de notre réaction à l’événement de mort.

Sélectionnez "Save" dans le menu "File" (ou faites Ctrl-S) et l'éditeur va tenter de compiler votre script. Une fenêtre de sortie va apparaitre -- si votre script est syntaxiquement correct, elle ressemblera à ça:

CKCompilerOutputGood.png

Si vous voyez autre chose, vous avez fait une erreur en copiant. Réessayez!

Une fois fini, fermez la fenêtre de script et la fenêtre d'acteur, et sauvegardez votre plugin. Maintenant, nous allons scripter l'amulette elle même.

Scripter l'Amulette

Ouvrez l'objet GSQAmulet que nous avons créés dans le tutoriel précédent. Dans la fenêtre d'armure, la zone de script est toute à droite.

CKArmorWindowScriptArea.png

Créez un nouveau script comme nous l'avons fait auparavant, et appelez-le GSQAmuletScript. Ajoutez-lui une propriété de Quête. Pour simplifier les choses, appelez-la directement "GSQ01" au lieu de TutorialQuest.

CKAutofilledProperty.png

Il va remplir automatiquement la propriété pour vous, puisque la propriété a un nom qui correspond à un ID existant. Si vous utilisez beaucoup de propriétés, cela permet de gagner du temps.

Ouvrez le script, nous allons y ajouter quelques évènements. L'amulette ne peut évidemment pas mourir, mais nous voulons savoir quand est-ce que le joueur la prend. Notre évènement devrait ressembler à ceci :

Event OnContainerChanged(ObjectReference newContainer, ObjectReference oldContainer)
	if (newContainer == Game.GetPlayer())
		GSQ01.SetStage(30)
	endif
EndEvent

Il y a certaines choses à noter dans ce script:

  • Les paramètres dans la déclaration (newContainer and oldContainer) seront automatiquement remplis par le jeu quand il demandera au script de gérer l'évènement.
  • Comme l'évènement OnContainerChanged est lancé à chaque fois que l'objet change de main, nous devons être sûr de ne changer le stage que quand le joueur le prend, d'où le block if/endif.
  • Game.GetPlayer() est un moyen simple d'avoir la référence du joueur sans avoir besoin de créer une propriété, et newContainer est rempli par le moteur lorsque l'évènement est lancé. On peut donc facilement comparer pour voir si l'objet est bien pris par le joueur.
  • Comme le script est actuellement, SetStage est appelé à chaque fois que le joueur prend l'amulette. Ce n'est pas un problème, car chaque étape de quête ne peut se passer qu'une seule fois --- Appeler SetStage(30) n'a aucun effet après la première fois.

Le script est maintenant prêt. Fermez le script et la fenêtre de l'amulette, et sauvegardez votre plugin.

Vous pouvez maintenant tester votre quête du début à la fin, en utilisant la console et SQV (SQV GSQ001) pour voir l'étape changer.

Mais les joueurs ne vont pas utiliser la console, nous allons donc apprendre à leur donner de meilleures indications de leurs progrès dans le prochain chapitre.

CKProtip.jpg Les scripts dans Skyrim sont de simples fichiers textes dans votre dossier Data avant d'être compilés en bytecode. Cela signifie que si vous avez un éditeur de texte favori, vous pouvez l'utiliser pour scripter. Le wiki officiel possède quelques exemples de configuration qui permettent la coloration syntaxique, une autocomplétion basique et des raccourcis de compilation. Si vous allez scripter intensément, ces outils peuvent vraiment vous simplifier la vie.