The core sources of XNova:Next-Gen has been forked into an independent project, designed to bring standard high-level functionalities to various projects, such as User management, Backoffice, CMS functionalities or web applications skelettons. For now this development platform will mainly be used to replace the admin panel of XNova:Legacies and will in the end become its core.

This new project is named One.Platform, you will find a public git repository at Github. It includes the Core module, the User module, a native CMS pages manager and an administration site engine on which the future version is based. The reason why I decided to cut the project in 2 is that what have been done until now can be reused by another project.

This project is based upon the Zend Framework and in order to make it work, you will need to install it (version 1.10+ should work fine, I personnaly use the verison 1.11). Installation instructions are availiable in the files INSTALL and INSTALL.textile in the repository. There is a branch named xnova-legacies which contains the development version of XNova:Legacies, it includes a slightly modified 2009.2 version without installer nor admin panel.

The administration panel can be accessed via the file admin.php, it is a One.Platform Backoffice, in time I’m writing this artcile, you will be able to manage users, configuration options, planets and moons. Everything isn’t finished, but the evolution of this admin panel becomes now easy, taking advantage of the XML configuration files that builds the forms and grids.

Le cœur du code source de XNova:Next-Gen a été déplacé dans un nouveau projet indépendant, créé pour apporter des fonctionnalités standards de haut niveau pour différents projets, comme la gestion d’utilisateurs, un panneau d’administration, des fonctions de CMS ou une architecture d’application web. Pour le moment, cette plateforme de développement sera principalement utilisée pour remplacer le panneau d’administration de XNova:Legacies pour au final devenir son cœur.

Ce nouveau projet est nommé One.Platform vous pourrez le retrouver sur Github. Il inclut le module Core, le module User, un gestionnaire de pages CMS et un gestionnaire de panneau d’administration de site web sur lequel la future version se basera. La raison pour laquelle j’ai décidé de découper le projet en 2, c’est que ce qui a été réalisé jusqu’à aujourd’hui peut être réutilisé par un autre projet.

Ce nouveau projet est basé sur le Zend Framework et pour le faire fonctionner, il sera nécessaire de l’installer (la version 1.10+ devrait fonctionner sas problème, j’utilise la version 1.11). Les instructions d’installation sont disponibles en anglais dans les fichiers INSTALL et INSTALL.textile que vous retoruverez dans le dépôt. Vous y trouverez également une branche nommée xnova-legacies qui contient la version de développement de XNova:Legacies, elle inclut une version 2009.2 légèrement modifiée, sans insallateur, ni panneau d’administration.

Le panneau d’administration est maintenant accessible via le fichier admin.php, c’est un panneau d’admin généré par One.Platform, à l’heure où j’écris ce billet, vous serez en mesure de gérer vos utilisateurs, vos options de configuration, vos planètes et vos lunes. Tout n’est pas terminé, mais l’évolution de ce panneau d’administration devient maintenant plus simple grâce qux fichiers XML de configuration qui créent automatiquement les tableaux et les formulaires.

Next to come, the user module, which will be the 2nd part of the XNova:Legacies 2010-alpha0 release.

You can now fetch the core module from the SVN trunk :
svn co svn+ssh://svn.xnova-ng.org/svnroot/xnlegacies/public/branches/modules/core/trunk

Or from the SVN tag :
svn co svn://svn.xnova-ng.org/svnroot/xnlegacies/public/branches/modules/core/tags/release-1.0-alpha0

La prochaine étape se concentrera sur le module user, qui sera la 2nde tranche de développement de XNova:Legacies 2010-alpha0.

Vous pouvez désormais récupérer le trunk SVN du module core de cette manière:
svn co svn+ssh://svn.xnova-ng.org/svnroot/xnlegacies/public/branches/modules/core/trunk

Ou bien depuis son tag :
svn co svn://svn.xnova-ng.org/svnroot/xnlegacies/public/branches/laboratory/gplanchat/modules/core/tags/1.0-alpha0

To return to what we are all here, everything has been redesigned to facilitate simple and rapid modification of the functionnalities of the game without the need of applying neither 1 line of the original source code. Everything is built upon the configuration, if a functionality in the base source code does not work like you wanted : replace it! it is as simple as that.

Accessing to data from the database has never been as simple and safe : get an ID, and load your model, woithout any risk of possible SQL injection. But how do we update, create or delete a database record? Just a line! For the preview 2010-alpha0, the user module will be the first module launched. It is relatively simple and will therefore serve both standard and benchmark for what will follow: 90% of this new source will be shared by an overwhelming majority of functionality or future refactoring.

But all that makes many words and few examples, so here are some previews (may be subject to modification in the final version):

Loading and modifying data of a player from the database:

To load data from a player which, for example, have the ID 8 in the database, the following is enough:
$user = Nova::getModel('user/user')->load(8);

And next? take your newly created variable (here, $user) and use it as like an array, just like you did until now… almost. Yes, because now it is no longer an array, it’s an object. Whath’s the difference? well is that my $ user has now gained virtual accessors and mutators and it even knows how to directly save its data by itself in the database!

$user
->setEmail('player@example.com'); // Updating the field 'email'
->setUsername('Player') // Updating the field 'username'
->save();


Yes, It’s all well and good, but I like it like it was before!

No panic! our $user keeps up appearances and can still be used just like we did before:
echo $user['username'];

But it does not stop with a simple syntax change!

Yes, rather than having functions everywhere, and asking where a particular feature would be, why not combine everything in one place? Well, we do it now! For example: to manage the connection of a player, why not create an automated mechanism?

$user = Nova::getModel('user/user');
if ($user->login($_POST['username'], $_POST['password'])) {
// Our user has submitted the good password, he is now logged in
} else {
// A problem hapened, maybe a passord error?
}


Oh, but how could we retrieve the current user from anywhere now? Simple! Easy! The sessions comes to help us and have also been improved:

$user = Nova::getSingleton('user/session')->getUser();


We now got back our $user, which have logged in in the previous example.

And it goes even further!

Develop and debug your old mods or develop modules for Legacies by enabling debug mode and Deprecation mode and use the source code profiler, simple tools and methods to optimize your code.

In your .htaccess, add the following to enable the two methods mentioned above:

SetEnv DEBUG On
SetEnv DEPRECATION On


The source code profiler is used to count the time taken by a particular treatment, it will return the number of times that it was executed, and various statistics of execution time. It is used with both static methods Nova::profilerStart() and Nova::profilerStop(), respectively, to start a counter and stop t. It both take a single argument that identifies the time counter:

Nova::profilerStart('NOVA.EXAMPLE');
// The treatment to analyze starts from here
for ($i = 0; $i < 200000; $i++) {
echo 'Hello world';
}
// and ends here
Nova::profilerStop('NOVA.EXAMPLE');


Note that the profiler results will only appear in debug mode.

Pour revenir à ce qui nous anime ici, tout a été repensé pour faciliter la modification rapide et simple du fonctionnement du jeu sans toucher 1 seule ligne du code source original. Tout se passe dans la configuration : si une fonctionnalité du code source de base ne nous plait pas : on la remplace, c’est aussi simple que ca.

Accéder à des données provenant de la base de données n’a jamais été aussi simple et aussi sûr : on récupère un ID, et on charge notre modèle, et tout ca sans aucun risque d’injection SQL. Mais comment modifier, créer ou supprimer un enregistrement? une ligne suffit! Pour la sortie du preview 2010-alpha0, seul le module User sera terminé. Il est relativement simple et pourra donc servir à la fois d’étalon et de benchmark pour tout ce qui suivra : 90% de ce nouveau code source sera commun à une très large majorité de fonctionnalités ou de refontes futures.

Mais tout ca fait beaucoup de paroles et peu d’exemples, donc voici quelques avant-goûts (soumis peut-être à modification dans la version finale) :

Chargement et modification des données d’un joueur quelconque depuis la base de données :

Pour charger les données d’un joueur ayant, par exemple, l’ID 8 dans la base de données, le code suivant est suffisant :
$user = Nova::getModel('user/user')->load(8);

La suite? utilisez la variable nouvellement créée (ici, $user) et utilisez la comme un tableau, comme vous le faisiez jusqu’à présent… ou presque. Oui, parce qu’aujourd’hui ce n’est plus un tableau, mais un objet. La différence? et bien c’est qu’aujourd’hui, mon $user a gagné des accesseurs et des mutateurs virtuels et il sait même comment aller enregistrer ses données tout seul dans la base de données !

$user
->setEmail('joueur@example.com'); // modification du champ 'email'
->setUsername('Joueur') // Modification du champ 'username'
->save();


Oui, tout ca, c’est bien beau, mais j’aimais bien avant!

Pas de panique! notre $user garde les apparences et peut toujours être utilisé comme avant :
echo $user['username'];

Mais on ne s’arrête pas à un simple changement de syntaxe!

Oui, plutôt que d’avoir des fonctions un peu partout, de ne plus savoir où se trouvent telle ou telle fonctionnalité, pourquoi ne pas tout regrouper à un seul endroit? eh bien, c’est que nous faisons dès maintenant! Par exemple : pour gérer la connexion d’un joueur, pourquoi ne pas créer un mécanisme automatisé?

$user = Nova::getModel('user/user');
if ($user->login($_POST['username'], $_POST['password'])) {
// Notre utilisateur s'est bien connecté avec le bon mot de passe
} else {
// Un problème est survenu, peut-être une erreur dans le mot de passe?
}


Oh, mais comment récupérer l’utilisateur courant maintenant? Simple! Les sessions nous viennent en aide et ont elles aussi été améliorées :

$user = Nova::getSingleton('user/session')->getUser();

On retrouve maintenant notre $user, celui qui s’est connecté dans l’exemple précédent.

Et on va encore plus loin!

Développez et débugguez vos anciens mods ou développez des modules pour Legacies en activant les modes Debug et Deprecation et utilisez le profileur de code source, des outils simples et pratiques pour optimiser votre code.

Dans votre .htaccess, ajoutez les lignes suivantes pour activer les deux modes cités plus haut :

SetEnv DEBUG On
SetEnv DEPRECATION On


Le profileur de code source, lui sert à calculer le temps que prendra un traitement, il vous retournera le nombre de fois que ce traitement est effectué, et différentes statistiques de temps d’exécution. Il s’utilise avec les deux méthodes statiques Nova::profilerStart() et Nova::profilerStop(), respectivement pour démarrer un compteur et l’arrêter. Elles prennent toutes les deux un seul argument qui identifiera le compteur :

Nova::profilerStart('NOVA.EXAMPLE');
// Le traitement à étudier commence ici
for ($i = 0; $i < 200000; $i++) {
echo 'Hello world';
}
// et se termine là
Nova::profilerStop('NOVA.EXAMPLE');


Notez que le profiler n'apparaîtra qu'en mode debug.

Cette version inclura une API d’accès aux donnés provenqnt de XNova:Next-Gen, rendant la fonction doquery() obsolète – elle sera donc supprimée peu à peu des sources dans les versions futures. Désormais, plusieurs connexions à la base de données peuvent être mises en place, utilisant les moteurs de bases de données différentes, ce sera utile pour une migration future du code source utilisant le connecteur ext/mysql à un des autres connecteurs ext/pdo_mysql ou ext/mysqli.

D’autres changements intéressants pour les administrateurs de jeu es la réécriture complète du fichier “include/vars.php“, qui sera maintenant beaucoup plus lisible pour tous et la possibilité d’afficher simplement, grâce à la configuration, des messages de débogage et de dépréciation.

Pendant longtemps, cette version a été annoncé comme étant la version 2009.3, certains ont fait quelques observations et comme il y aura beaucoup de changements dans le code source, le numéro de version majeur sera changé en 2010.

This version will include an object-oriented data access API coming from XNova:Next-Gen, making the doquery() function deprecated – it will therefore be deleted little by little from the sources in future versions. As a matter of fact, multiple connections to the database can now be set up, using various database engines, this will be useful for a future migration from the deprecated ext/mysql database connector to either ext/pdo_mysql or ext/mysqli connectors.

Some other interesting changes for game administrators are the refactoring of the file “include/vars.php“, which will now be much more human-readable and the ability to easily display debug and deprecation messages.

For a long time, this version has been announced as the version 2009.3, some have made some remarks and as long as there are a lot of core changes, changing the main version number may be a good idea, then.

As like the 2009.1, there will be multiple releases before a “stable” version comes, a debug server will be launched very soon to launch some “Bug Hunt Days” and find more bugs, more bottlenecks to fix in early releases.

Comme vous le savez, les lunes sont très utiles dans le cadre d’attaques ou d’énergie au sein de la NG (comment ça d’énergie… vous voulez dire que l’on pourra construire une centrale sur la lune qui alimentera la planète?… chut! répondit le hamster gourou)

Sur la lune vous trouverez :

Une base lunaire, point de départ de votre expansion (MOON BASE)

Une centrale éléctrique à vent solaire (chutt on a dit ^^) (SOLAR WIND FARM)

Une petite phalange de capteurs, afin d'espionner certains mouvements de flotte ou plus... (mais tu balance tout... arrêtes enfin! ^^) (SENSOR PHALANX)

Et une jolie porte de saut afin de faire... des sauts... (JUMP GATE)

Bon visionnage

PS : désolé, je traine un peu mais

“A vie chargée, temps étendu ” : Lao Tseu, 3eme siècle avant Jean Claude