Wikilaran cartes

Cartes de gildes

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Cartes de gildes

Les gildes qui veulent créer leur carte doivent toujours partir du fichier carte standard des cartes de gildes. Il est disponible sur le SVN, c’est le fichier generic_guild_map.elm.

De manière plus détaillée, voici ce qu’il faut toujours préciser aux joueurs :

Globalement :

Les règles de validation des cartes classiques doivent être respectées lors de la création d’une carte de gilde.
La cohérence entre les différentes pièces doit être maintenue.
Ne doivent en aucun cas être modifiées les limites des salles.
Des cases marchables n’ont en aucun cas droit d’être rajoutées.
Les portes ne doivent pas être modifiées ou supprimées. Si une porte est supprimée par erreur, n’en remettez pas une, même identique. Vous n’avez pas d’autre choix que de recharger votre dernière sauvegarde de la carte. Faites y attention c’est très important.
Les cloisons des salles doivent être conservées aux mêmes endroits, ce qui signifie que les dimensions de la salle doivent être conservées. Un décor est permis dépassant au maximum 1 tile (6 cases) les cloisons. Ces cloisons peuvent être changées, mais doivent rester au même endroit et demeurer une coupure très claire. Les objets plus loin que cette distance sont interdits.

Spécifiquement :

Ne doivent en aucun cas, dans la salle de magie (dont le sol a une forme de Y), être déplacées ou supprimées les boules et les étoiles. Rappel: dans cette même salle, aucune case marchable ne doit être rajoutée.
Toujours concernant la salle d’invocation, le seuil permettant le passage d’un côté à l’autre ne doit pas être modifié.

cartes:ftp

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Un espace FTP a été créé pour l’équipe de validation des cartes.

Il est accessible à tous mais mais son rôle est uniquement de stocker des images (afin de pouvoir facilement afficher des images dans des posts sur le forum) ou de stockers des fichiers divers à faire partager.

Attention, à ne pas confondre avec le SVN : tout fichier carte doit, lui, aller sur le SVN et non pas sur le ftp.

Voici les données de connexion pour cet espace FTP :

Pour le ftp il est aussi prêt. Pseudo : carte et mot de passe : landescarte - Ils ont donc aussi accès par http sur l’adresse : http://jeu.landes-eternelles.com/~carte/ (même login et mot de passe que le ftp)

serveur : jeu.landes-eternelles.com
login : carte
mot de passe : landescarte

Il faut placer les fichiers dans le répertoire public_html.

Pour les liens, ils seront du genre : http://jeu.landes-eternelles.com/~carte/

Notez que le wiki a son propre système d’upload d’images.

Note de Torino: Pour les nuls comme moi, il faut pour accéder au ftp télécharger en premier lieu un programme sur son ordinateur. FileZila version client fait l’affaire me concernant.

Principes généraux

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Principes généraux

Projets de joueurs

L’équipe de validation des cartes a comme rôle premier la validation des cartes qui sont proposées par des joueurs dans le cadre de projets d’animation.

Quand un joueur veut proposer une nouvelle carte ou la modification d’une carte existante, il doit en premier lieu contacter les animateurs et leur proposer un projet rp d’intégration de cette carte.

Si le projet reçoit l’aval des animateurs, le joueur doit, avec eux, détailler ce projet rp mais il peut surtout commencer à réaliser la carte ou le changement de carte qui a été accepté.

C’est là qu’intervient l’équipe de validation des cartes, qui teste ce qu’a réalisé le joueur et valide techniquement la carte. Le but est que la carte en question soit jouable au sens des valideurs.

Les valideurs peuvent en outre émettre des critiques concernant l’esthétique de la carte et sa cohérence avec les cartes existantes. Sur ce sujet là, cependant, les animateurs participeront aussi.

En pratique

L’équipe d’animation reçoit un projet de la part d’un joueur. Elle l’étudie, recontacte le joueur au besoin et émet un premier avis.
Si cet avis est favorable, un animateur se charge de créer un sujet sur le forum de l’équipe de validation des cartes, y résume le projet tout en donnant le nom du joueur.
Le premier valideur qui peut prendre ce sujet en charge, le signale dans le sujet et devient son responsable en terme de suivi. C’est lui qui sera en contact avec le joueur et devra s’assurer que le travail de validation de la carte incluse dans le projet suit bien son cours.
Dès réception d’un premier fichier carte par le joueur, le valideur responsable a pour charge de placer ce fichier sur le SVN. Il doit le placer sur le SVN sous un nom qui n’existe pas encore, et cela même si la carte proposée par le joueur existe déjà. Ceci afin de ne pas remplacer une carte existante tant que sa nouvelle version n’est pas jugée acceptable.
A partir de ce instant, toutes les nouvelles version de la carte proposée fournie par le joueur seront à mettre sur le SVN et pourront être testées par l’ensemble des valideurs, qui indiqueront toutes leurs remarques dans le sujet forum créé pour ce projet.
Tous les valideurs se doivent d’intervenir sur un projet et d’effectuer leurs propres tests.
Le sujet forum doit être le seul utilisé pour un projet particulier, c’est l’outil de coordination principal.
C’est aussi via ce sujet que les valideurs demanderont aux administrateurs de redémarrer le serveur de test pour prendre en compte les derniers ajouts sur le SVN, et que les administrateurs informeront de quand c’est fait.

Rôles futurs

Dans un avenir non encore défini, deux rôles s’ajouteront probablement au rôle précédemment expliqué :

La réalisation de cartes demandées par l’équipe d’animation ou l’équipe de projet.
La correction des bugs signalés par les joueurs sur les cartes du jeu (forum Cartes).

Ce n’est cependant pas encore d’actualité.

cartes:serveur_test

anonymous@undisclosed.example.com (Anonymous) — Tue, 16 Aug 2011 19:59:07 +0000

Pour redémarrer le serveur 3001 (après un commit de modifications de cartes, par exemple), il faut :

- Créer un fichier vide, nommé “serveur” (sans les guillemets et sans extension) - L’uploader à la racine du FTP Cartes (cfr. l’article sur le FTP) - Attendre une minute

…et hop, le serveur démarre.

Il peut être bon de prévenir les personnes connectés au moment du redémarrage.

A noter que sur ce serveur, vous avez aussi quelques commandes privilégiées en tant que mappeurs. Si ce n’est pas le cas, contactez un des méchants admins.

Introduction

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Introduction

SVN est un outil de gestion de versions de fichiers. Plus clairement dit, il permet de stocker de manière organisée un ensemble de fichiers, de mettre à jour ces fichiers et de récupérer les différentes versions de ces fichiers. Il gère les accès de manière sécurisée, donnant à chaque utilisateur défini des droits précis.

Dans le cadre de l’équipe de validation des cartes, son plus grand avantage est d’offrir la possibilité aux responsables de l’équipe de faire partager des fichiers de cartes et de travailler dessus à plusieurs.

Il permet en outre aux administrateurs de rapidement mettre en place la dernière version des cartes sur le serveur de test, d’une traite.

Principes et application à Windows

Ci-dessous, sont présentés les principes et concepts véhiculés par le SVN, mais dans le cadre d’utilisateurs Windows. Je conseille aux utilisateurs Linux de lire ce passage malgré tout pour comprendre le SVN. Les commandes Linux sont donnés par la suite.

Pour pouvoir utiliser le SVN, le plus aisé, en particulier pour ceux qui utilisent Windows, est d’employer un client SVN, c’est à dire un petit programme que vous installez sur votre machine, qui vous permettra de gérer le SVN.

L’outil que je recommande pour Windows, que j’utilise et que je vais expliquer, est Tortoise.

Vous pouvez le télécharger à cette adresse (le premier lien suffit). Installez-le ensuite en suivant les instructions, qui n’ont rien de très particulier. Redémarrez ensuite la bête. Vous remarquerez que c’est bien installez, si en cliquant droit sur un fichier au hasard, vous avez, dans le menu qui apparaît, “Tortoise SVN” indiqué.

Checkout

La première chose à faire, c’est un “checkout”. Cette opération permet d’obtenir le SVN Cartes en local sur votre machine : obtenir en fait la dernière version de tous les fichiers cartes existant.

Pour ce faire, cliquez droit n’importe où, sur votre bureau par exemple, et dans le menu déroulant, choisissez “SVN Checkout”.

Une fenêtre s’ouvre et vous demande d’indiquer deux choses :

Le SVN que vous voulez obtenir et son adresse (“URL of repository”). Dans le cas des cartes il s’agit du SVN dit du client. Indiquez svn://jeu.landes-eternelles.com:/NouveauClient/trunk/donnees/maps

L’endroit où vous voulez que ça se trouve (“Checkout directory”)

Je vous conseille de créer un dossier particulier pour ça, car l’opération va créer, à l’endroit que vous choisissez, plusieurs dossiers.

Après avoir précisé ces deux choses, cliquez sur “Ok”. On va alors vous demander d’introduire votre login et mot de passe, ce que vous faites docilement (distribués par les administrateurs). L’opération se déroule alors tranquillement.

SVN local

Le SVN, sur votre machine, quel qu’il soit, est toujours découpé en trois dossiers : trunk, branches, tags.

Le dossier Trunk contient la version officielle des fichiers, c’est à dire, dans notre cas, la version des fichiers utilisés pour le serveur et client officiels : ce sur quoi les joueurs jouent. C’est dans ce dossier que vous travaillez, normalement.

Le dossier Branches, contient des versions parallèles à la version officielle, principale. Actuellement, il n’y en a pas.

Le dossier Tags contient des versions particulières du passé, correspondant à des moments particuliers. Vous n’avez pas besoin d’utiliser ce dossier.

Update

La fonctionnalité du SVN que vous utiliserez le plus souvent (et que vous devez utiliser le plus souvent) est l’update. Cette opération permet d’actualiser la version du SVN que vous avez sur votre machine, avec la dernière version qui est sur le serveur.

Par exemple, si vous venez de faire un checkout et que deux jours après, l’un des membres de l’équipe change un fichier, la seule façon que vous avez de récupérer ce fichier changer, est d’effectuer un update. Ce que vous avez sur votre machine est synchronisé avec la dernière version. Cette opération correspond en fait à un download de fichiers à partir du serveur.

Pour ce faire, cliquez droit sur un fichier ou un dossier (je vous recommande de cliquer droit sur le dossier Trunk ou Branches, selon le cas, comme ça vous mettez tout à jour), et choisissez dans le menu “SVN update”. On vous demande alors votre login et mot de passe, vous l’indiquez et l’opération se fera toute seule, listant les fichiers qui ont changé ou vous disant que rien n’a été modifié.

A chaque fois que vous comptez modifier un fichier du SVN, je vous recommande de faire un update, pour être sûr que vous travaillez sur la dernière version.

Commit

Grâce à l’opération précédente, vous êtes capables d’obtenir la dernière version des fichiers. En outre, comme ces fichiers sont sur votre machine, vous avez tout le loisir de modifier ces fichiers, dans le répertoire du SVN : le faire n’impacte pas du tout les autres utilisateurs du SVN, le changement n’est effectué que sur votre machine.

Si maintenant vous désirez “officialiser” le fichier que vous avez modifier, c’est à dire faire en sorte qu’il entre sur le SVN serveur, et que tout utilisateur qui fasse un update, obtienne votre fichier modifié, il y a une opération particulière, qui correspond à un upload sur le serveur : c’est l’opération de “commit”.

Ici je me dois d’attirer votre attention sur l’importance de cette opération, il s’agit bien d’officialiser un changement. Assurez-vous donc dans la mesure du possible, que votre changement est sérieux. Mais ne soyez pas trop effrayés, si vous faites un commit d’un fichier, il est toujours possible de récupérer une version précédente dudit fichier. C’est là l’essence du SVN.

Pour effectuer un commit, cliquez droit sur le fichier que vous avez modifié (vous le reconnaîtrez toujours car le petit icone habituellement vert, sur l’icône du fichier, est devenu rouge), et choisissez dans le menu “SVN Commit”.

Une fenêtre s’ouvre, dans laquelle nous vous demandons d’indiquer un message indiquant la nature du changement, pour une question de propreté. Par exemple : “Correction des problèmes de scintillement”.

En bas de la fenêtre, se trouve la liste des fichiers qui vont être concernés par l’opération de commit (en effet, vous pouvez faire un commit sur un dossier, ce qui aura pour effet de faire le commit de tous les fichiers modifiés contenus dans ce dossier), vérifiez-y que le ou les fichiers qui vont être concernés par le commit sont ceux que vous voulez.

Cliquez alors ok, introduisez login et mot de passe et on y est.

Avant de faire un commit d’un changement, assurez-vous toujours d’avoir travaillé sur la dernière version du fichier (via l’update), sinon le commit échouera.

En pratique en fait, je vous conseille, si vous voulez modifier un fichier, d’opérer comme suit :

Update du fichier
Copie du fichier hors de votre dossier SVN
Modification de votre fichier
Reupdate du fichier dans le SVN et vérification que le fichier n’a pas été modifié par quelqu’un d’autre
Si non, copie de votre fichier modifier dans votre dossier SVN
Commit

Si jamais quelqu’un d’autre a fait un changement dans le fichier que vous avez vous même modifié, il va falloir fusionner les deux changements (ce qui consiste dans le cas de fichiers complexes comme ceux des cartes, de refaire l’une des deux versions, donc ne travaillez pas sur un même fichier sur une longue période de temps sans faire de commit).

Ajouter un fichier

Si vous voulez ajouter un fichier dans le SVN, copiez le d’abord dans le bon dossier de votre SVN local. Ensuite, cliquez droit dessus et dans le menu, choisissez “Tortoise SVN” puis “Add”. Préciez votre login et mot de passe et “ok”.

Cette opération n’a pas encore ajouté complètement le fichier, elle n’a fait que signaler au SVN que vous désirez ajouter ce fichier. Vous devez maintenant cliquer droit sur ce fichier et faire un commit. Tout le monde y aura alors accès à condition de faire un update.

Supprimer un fichier

Tout d’abord, ne faites cette opération que quand vous êtes bien sûr de l’inutilité du fichier. Nous pouvons toujours récupérer un fichier supprimé mais mieux vaut faire attention.

Cliquez droit sur le fichier, “Tortoise SVN”, et “Delete”. Faites “ok” avec login et mot de passe. Vous devez ensuite suivre l’opération par un commit du fichier supprimé, qui disparaîtra alors complètement.

Autres fonctionnalités

Le SVN permet toute une autre série de fonctionnalités, qu’il n’est pas utile de mettre par écrit. Je les ajouterai si jamais elles ont du succès et de l’utilité. Le SVN permet de récupérer des fichiers d’une ancienne version, de voir l’histoire des versions avec vos messages de commit,…

Signalez vos questions ou suggestions d’ajout à la suite de ce post it, je le modifierai en conséquence si nécessaire.

Clients SVN sous Linux

Alternatives

En ligne de commande, c’est donc subversion : aussi simple à utiliser que cvs.

Pour KDE : C’est eSVN Il existe 2 autres projets KDE : kdesvn et ksvn, ce dernier étant conçu comme tortoise (intégration). J’ai noté que ces 2 programmes ne font pas partie des paquets gentoo, et ksvn de la debian stable …

Pour Gnome : Rapidsvn, c’est le seul que j’ai trouvé. Il n’y a pas de module d’intégration pour nautilus, pour faire comme tortoise. A noter que les commentaires sur ce programme (sur le net) ne sont pas engageants.

Tutoriel

Voici un tutoriel rapide pour la ligne de commande pour la partie “Client”. Pour débuter voici 2 petites liens qui expliquent pas mal les choses :

Checkout

Pour faire le checkout obligatoire pour le début :

svn co svn://jeu.landes-eternelles.com:/NouveauClient/trunk/donnees/maps

Cela va créer un répertoire NouveauClient avec une copie du SVN sur votre PC. Dans ce répertoire, vous aller avoir 3 sous-répertoires : trunk (le client actuel), branches (non utilisé) et tags (non utilisé).

Commit

Lorsque vous avez fait des modifications sur votre copie locale et que vous désirez la mettre sur le SVN, il faut taper:

svn commit

Cela ouvre votre éditeur de texte ou vous allez pouvoir sur la première ligne, renseignés en résumé les modifications apportées.

Update

Si vous désirez mettre à jour votre copie locale, il faut taper :

svn update

Les fichiers modifiés vont être copiés sur votre PC et vous aurez donc la dernière version.

Ajout

Pour ajouter un fichier, placez-le dans le répertoire où il doit être installés et taper la commande :

svn add fichier

Ensuite il suffira, de faire un commit pour vraiment que cela officialisé.

Suppression

Pour supprimer un fichier, il suffit de taper :

svn rm fichier

Il faut ensuite faire le commit comme d’habitude :)

Mises à jour nécessaire pour le prochain reboot server port 3000

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Mises à jour nécessaire pour le prochain reboot server port 3000

TODO liste

Proposition initiale des rubriques à modifier et compléter suivant les besoins.

PNJ

Cartes (elm, def)

Post-reboot (&desactive, &tp_pnj...)

Mode d'emploi

Ce fil wiki est ouvert afin que chacun puisse inscrire ce dont il aurait besoin pour le reboot qui suivra du server 3000.
C’est la TODO list du prochain reboot, pas la liste des souhaits à long terme.

Ce qui figure ici, les administrateurs doivent déjà en disposer. N’hésitez pas à préciser par quel moyen ils en disposent (exemple: mail, MP forum, svn…) Pour le svn, si vous avez besoin d’une mise à jour spécifique, précisez le n° de la révision, voire le md5sum…

Par exemple: Rol a besoin d’une modif sur PNJ, il a déjà le code du pnj, qu’il a transmis aux admins par mail. Il pourrait écrire:

modification de Angdar, cf mail envoyé à Nati

Yorwan a besoin de mettre en ligne ses barrages sur 3 cartes + d’une modif de def:

mettre à jour map10.elm, cf svn
mettre à jour map3.elm, cf svn
mettre à jour map6nf.elm, cf svn rev n°xxx
modification du def de mapxx.elm, cf forum cartes: lien url.

Lorsqu’un reboot server pointe le bout de son nez, les administrateurs peuvent se référer à ces pages wiki, ce afin de ne rien oublier dans le reboot qui suivra. Les administrateurs pourront aussi se référer à ces pages pour regarder si un reboot est nécessaire pour l’animation par exemple, et disposeront dans le même temps du travail des mappeurs pour ce même reboot.

Une fois le reboot passé, l’administrateur supprime tous les points qu’il a pris en compte et laisse ceux qu’il n’a pas pu traiter.
Dans le meilleur des cas, la section TOTO liste se retrouve vierge (en conservant les rubriques?)

Éléments à vérifier en général

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:58 +0000

Éléments à vérifier en général

Lors de la validation d’une carte, il faut regarder la carte dans son ensemble, mais je suggère de vérifier ces quelques éléments de façon plus attentive. Ce sont de petits éléments qui se remarquent assez facilement et qui sont bons à dire à l’auteur de la carte.

Éléments spécifiques

Nivelage
Éléments dans lesquels on peut marcher
Fonctionnement des différentes marches
Éléments scintillants
Éléments flottants (attention aux objets 2D, c’est parfois subtile)
Murs mal joints
“Trous” (par ceci, nous entendons des endroits où on voit l’infini de la carte. Une tile est généralement manquante. C’est le cas entre autre sur les bords d’une tile d’eau ou sur le bord de montagnes)
Objets non-existants (Bloc noir avec “Erreur” en rouge ou quelque chose comme cela)
Chaque intérieur doit être séparé du suivant par 6 tiles

Éléments généraux

Je résumerais cette section par “tout doit pouvoir être expliqué”. Nous sommes dans un monde médiéval-fantastique, ce qui peut expliquer certaines dérives, mais toujours faut-il pouvoir les expliquer par des phénomènes quelconques ou par “c’est telle magie de téléportation”.

Cohérence des milieux
Cohérence du climat (ce qui inclus les végétaux. Un cactus n’a pas besoin des mêmes attentions qu’un nénuphar)
Cohérence réaliste (Est-il possible qu’une délicate fleur pousse dans le roc? Ajoutons un léger élément 2D)
Cohérence des dégradés (Que ce ne soit pas trop sec dans les changements de tile… les éléments 2D sont là pour cela)
Absence d’éléments IRL qui choquent le RP (Dernièrement, j’ai lu une série qui commençait très bien… mais quand on commence à y insérer des éléments actuels alors que ça se veut médiéval… le musé et le couple homosexuel qui s’assume entre autres… ça casse le charme médiéval)
Éviter les surplus d’eau ou de lave (Celle animée). En effet, ces deux tiles ralentissent la carte.
Tout fait du sens?

Note de l'auteur

J’ai certainement oublié une tonne de détails, je me fie à vous pour me les rappeler et actualiser cette liste lorsqu’il sera nécessaire de le faire.

Wikilaran cartes

Cartes de gildes

Cartes de gildes

cartes:ftp

Principes généraux

Principes généraux

Projets de joueurs

En pratique

Rôles futurs

cartes:serveur_test

Introduction

Introduction

Principes et application à Windows

Checkout

SVN local

Update

Commit

Ajouter un fichier

Supprimer un fichier

Autres fonctionnalités

Clients SVN sous Linux

Alternatives

Tutoriel

Checkout

Commit

Update

Ajout

Suppression

Mises à jour nécessaire pour le prochain reboot server port 3000

Mises à jour nécessaire pour le prochain reboot server port 3000

À lire

TODO liste

PNJ

Cartes (elm, def)

Post-reboot (&desactive, &tp_pnj...)

Mode d'emploi

Éléments à vérifier en général

Éléments à vérifier en général

Éléments spécifiques

Éléments généraux

Note de l'auteur