TUTORIEL RunUO

SCRIPTIZ
Hyel Le Renouveau
TUTORIEL RunUO
Ajout de l'Intellisense à Visual C# 2008 Express Edition
Pour une solution RunUO
v2.00 – vendredi 5 juin 2008
Ce document est libre, vous pouvez le distribuer tant que cela n'a pas pour but des fins lucratives.
Bonjour à tous, je rédige ce petit document afin de faciliter le dévelopement sous RunUO pour les
débutants, ceci en ajoutant la fonctionnalité d'Intellisense à votre projet sous Visual C# 2008
Express Edition (fonctionne aussi pour la 2005 ainsi que pour Visual Studio). Pour tout
commentaire ou suggestion voici mon email : [email protected]
C'est partit !
Premièrement, procurez-vous la dernière version de RunUO en date, aujourd'hui il s'agit de
RunUO-2.0-RC2. Pour ce faire, rendez-vous sur le site http://www.runuo.com/ ensuite dans la
rubrique Downloads puis connectez-vous à l'aide de votre nom d'utilisateur (ah oui, vous devez être
inscrit sur le forum, je vous laisse le soin de faire cela) pour accéder aux différentes catégories de
téléchargement. Choisissez bien entendu la catégorie RunUO puis télécharger RunUO-2.0-RC2
(ou une version plus récente) au format zip et qui à une taille d'environ 7,5 Mo.
Cela fait, il faut maintenant extraire le fichier zip acquis :
Cliquez donc avec le bouton droit de la souris sur l'archive télécharger, puis sur Extraire Tout... (ou
utilisez un autre programme de votre choix bien plus performant). Ensuite cliquez sur Suivant
plusieurs fois jusqu'à arriver au bouton Terminer qui ouvre alors le dossier nouvellement créer sur
votre Bureau et nommé RunUO-2.0-RC2.
Ceci étant fait vous pouvez maintenant lancer Microsoft Visual C# 2008 Express Edition puis
dans celui ci cliquez sur Créer Projet.
Jusque là tout va bien, une petite (grande) boîte de dialogue s'affiche vous demandant quelques
informations concernant la création de votre projet destiné à votre Shard. Remplissez là comme suit.
Laissez ensuite votre souris glisser vers le bouton OK sur lequel vous pouvez appuyer. Vous voici
maintenant avec l'ébauche de votre projet RunUO dans Visual C#.
Commencons par ajouter les scripts à cette solution. Pour ce faire, allez dans le dossier
RunUO-2.0-RC2 tout juste décompresser sur votre Bureau et cliquez sur le dossier Scripts à
l'intérieur de celui-ci à l'aide du bouton droit de la souris afin de séléctionner l'option Copier. Cela
étant fait, allez vite dans Visual C#, puis cliquez sur MonShard dans l'explorateur de documents
sur la droite avec le bouton droit de la souris toujours, pour ensuite sélectionner l'option Coller.
Un important tas de fichiers est copiés assez rapidement, patientez jusqu'à la fin de la copie puis
ouvrez le menu Fichier et cliquez sur Enregistrer Tout, une boîte de dialogue s'ouvre, vous pouvez
confirmer, par défaut la solution s'enregistre dans : « Mes Documents\Visual Studio
2008\Projects\MonShard\MonShard ».
Retournez maintenant dans le dossier RunUO-2.0-RC2, et sélectionnez y tout les fichiers et
répertoires sauf le répertoire Scripts (car on l'a déjà copié), cliquez avec le bouton droit de la souris,
et comme d'habitude, Copier. Puis ouvrez vos Mes Documents, et allez dans les sous dossiers
suivants par ordre : Visual Studio 2008 > Projects > MonShard > MonShard.
Si tous ce passe bien vous devriez voir quelques dossier (dont le dossier Scripts). Cliquez droit
dans cette fenêtre (pas sur une icône), afin d'afficher le menu contextuel, et cliquez sur Coller.
Ceci étant fait je vous conseille de vous concentrez pour la prochaine étape qui est de loin la plus
difficile pour certains (qui ne manipulent jamais les extensions)... c'est un peu ironique mais
beaucoup rencontrent des problèmes avec cette étape.
Vous vous trouvez donc toujours dans le répertoire de votre solution où vous venez de copier les
autres fichiers de RunUO. Ouvrez alors le menu Outils, puis Options. Une boîte de dialogue
apparaît. Allez directement dans le deuxième onglet nommé Affichage pour ensuite descendre un
peu dans les options et décocher « Masquer les extensions des fichiers dont le type ... ».
Ceci étant fait, vous remarquerez que tout vos fichier possèdes (la plupart du temps) 4 caractères
supplémentaires, généralement sous la forme d'un point, suivi de 3 lettres.
Bref, vous êtes toujours dans le dossier de votre solution où l'on vient de copier les autres fichier de
RunUO. Cliquez alors sur le fichier RunUO.exe (avec la jolie petite icône) à l'aide du bouton droit
de votre souris, et sélectionner Copier, pour ensuite, cliquer de nouveau avec le bouton droit de la
souris dans ce même dossier un peu plus bas afin de choisir Coller. Un fichier apparaît, nommé
Copie de RunUO.exe, c'est ici que l'extension nous sera pratique !
Il va vous falloir renommer cette copie afin que son nom complet (extension y compris) soit
Server.dll. Lorsque vous confirmer le renommage, Windows vous demande si vous êtes sur de
vouloir changer l'extension du fichier car il pourrait ne plus être lisible, répondez par OUI.
L'icône de la copie change, vous voila avec un fichier supplémentaire très utile (nous allons voir
tout de suite). L'image ci-dessous ne montre qu'une partie des fichiers de votre répertoire rassurezvous c'est normal que vous ayez quelques dossiers et fichiers supplémentaire, le but est de bien
montrer le fichier Server.dll.
Retournons maintenant sur Visual C# toujours dans notre solution (si vous l'avez fermez vous
trouverez bien vite en lancant Visual C# un petit lien vers MonShard sur lequel il vous suffit de
cliquer afin d'ouvrir votre solution sauvegardée qui contient pour l'instant, je vous le rappelle,
uniquement les Scripts (dans un dossier à côté d'un autre dossier gris nommé Références auquel
nous allons maintenant nous intéresser).
Cliquez donc à l'aide du bouton droit de la souris sur ce dossier Références puis sur Ajouter une
référence... du menu contextuel.
Une nouvelle boîte de dialogue apparaît, et dans le premier onglet nommé .NET, parcourez la liste
afin de trouver l'élément System (seul).
Vous pouvez ensuite (après l'avoir sélectionner), cliquez sur OK pour l'ajouter. Si tout ce passe bien,
vous avez désormais un seul et unique élément dans votre dossier Références qui est System.
Récapitulons, nous avons maintenant les Scripts de RunUO dans notre solution, nous avons les
fichiers supplémentaires pour lancer RunUO dans le répertoire de notre solution, et nous venons
d'ajouter la référence System qui est fort utilisée dans les Scripts de RunUO. Voilà ce que ça
devrait donner.
J'espère que c'est le cas chez vous sans quoi vous avez du faire une erreur quelque part (pourtant
j'essaye de rendre ce tutoriel aussi complet que possible afin qu'il soit destiné à tout public, bien que
ça doit en emmerder certains de ce taper toutes ces screenshots alors qu'ils savent très bien
comment copier un fichier, extraire une archive, ajouter une référence, ... ;-) ). Sur ce continuons
donc vers le dernier point de notre configuration de notre solution.
Vous vous souvenez que nous avions copier le fichier RunUO.exe dans le répertoire de notre
solution puis renommer en Server.dll ? Et bien ce sera notre deuxième référence, et surement la
plus importante !
Refaite la petite manipulation pour ajouter une référence (clic droit sur Références puis Ajouter
une référence...). Et cette fois ci, allez dans le quatrième onglet nommé Parcourir, et vous devriez
être directement dans le répertoire de votre solution (si ce n'est pas le cas rendez-vous y) où vous
avez créer le fichier Server.dll, sélectionnez le alors, et cliquez sur OK. Cela étant fait vous aurez
maintenant une deuxième référence en dessous de System nommée Server. Vous pouvez doublecliquer dessus pour l'ouvrir dans l'explorateur d'objet, c'est assez pratique pour en connaître plus sur
telle ou telle méthode du coeur, son nombre de paramètres, ses champs, ... Mais surtout cela vous
servira pour l'intellisense lorsque vous coderez vos Scripts. Voici une screenshot illustrant cette
étape finale.
Vous obtenez donc ceci au final :
Voyons si l'intellisense fonctionne bien (j'ouvre le premier script qui me passe sous la main et je
tape quelques lettres et je retrouve bien toutes les classes, méthodes, champs, ... de mes autres
Scripts, ainsi que du core RunUO (pour peux que vous ayez mit les bonnes directives using dans
l'en-tête du fichier ;-)).
Pour lancer RunUO, enregistrez toute la solution (Fichier > Enregistrer Tout dans Visual C#) puis
dans le répertoire de votre solution double-cliquez sur RunUO.exe (un conseil, faites en un
raccourcis sur votre Bureau ^^). Ce qui lancera RunUO et compilera vos scripts codés dans Visual
C#. Au fait, éviter d'enregistrer votre solution ou un script de votre solution lors de la compilation
par RunUO de ceux-ci ;-)
Allez une dernière Screenshot pour montrer le fichier sur lequel cliquer :-P
Voilà j'espère que ces 11 pages vous auront aidée et permettront à votre projet d'être encore plus
productif qu'il l'est déjà. Bonne continuation à vous, n'abandonnez pas, on vit tous des hauts et des
bas, le principal c'est l'apprentissage ainsi que la satisfaction personnelle et celle de vos joueurs.
Cordialement,
Scriptiz, pour Hyel Le Renouveau.
Remerciements :
–
La communauté RunUO-fr qui bien qu'elle ait fermée m'a grandement aidée.
–
Spam pour m'avoir un jour proposer de rentrer dans une équipe de développement d'un shard, ce
qui m'a fait apprendre le C# ainsi que les modalités de RunUO (encore le bon vieux 1 à
l'époque).
–
Plume pour ses remarques intelligentes, ses remarques pessimistes, et son talent à tout
contredire ^^ (c'est quand même toi qui nous ponds les meilleures idées rassure toi), ainsi que
Castouni pour son mouchoir dans son micro et son Hyperactivité chronique buildeuse (quand tu
commence ça ne s'arrête jamais :O). En tout cas depuis le début on travaille ensemble à 3, et
j'espère que cela continuera encore bien longtemps !
–
RunUO pour nous offrir un émulateur d'une qualité exceptionnelle, et en constante évolution.
Vraiment merci pour le travail que vous faites, qui plus est gratuitement, c'est vraiment
impressionnant et je vous en remercie.
–
Tout ce que j'ai oubliés car il est 2h00 du matin et que je commence à fatiguer.
–
Et enfin, toute personne s'intéressant de près ou de loin à Ultima Online et qui continue de faire
vivre ce grand jeux qui ne s'épuisera jamais à mes yeux. Continuez comme ça, ce n'est pas un
WoW avec des /f*** /brasdhonn*** « pu*** vazi kjvai te Dchir* toi grau Noooob » qui va
détrôner un jeux aussi raffiné q'Ultima (j'exagère sans doute un peu (a)).