Ok...

HOME page

By this I mean your character home page, in client accessible with Shift+W.

Anonymous user

Anonymous is every application user whos character name is not known. This user is limited to use default application settings, his guild activity is not tracked and can see any public data.

Authenticated user

Some features requires to know a character name you currently act with. Typically adjustment of your application settings. In that case you are prompted to log in, which will redirect you apps.ryzom.com from where you should start the application. When using IG browser, you may experience a session expiration, in that case you are asked to click HOME button to restart the session.

Ryzom server works as dummy proxy here. It will "start" the app for you and (important) will provide a way the application can use to confirm it is really you (authentication). Then returns some basic data about your character. All is realized using PHP Ryzom API via ryzomapi_lite. Install and run RyApp Example application from App Zone to see what all application knows about you in this case.

If member of a guild, your character activity is logged every time your last activity is older than ~60 minutes. The trigger to run the check is starting one of my applications as authenticated.

Dynamic icons

This is new feature in Ryzom App Zone. In case you allow dynamic icon for any of my apps, the application icon on App bar and on HOME page (Shift+W in game) will be reloaded every time you reload that bar (typically comming on-line) or HOME page (logging into apps.ryzom.com, opening in client). This will be same as running the app authenticated and will trigger activity check.

API key and modules

API key gives access to selected character data. You can get (create) your character API key using Ryzom API. Different applications may require different key modules based on purpose as I highlighted on following image.

See application About (click on application name/icon in top left corner) to view which module is required and why. Book of guilds has no user interface but language change and do not require any API keys. The following image shows modules requirement for Fame tracker.

If authenticated user wants to use a feature based on character API key, he is prompted to insert a valid key which includes required modules.

Data cache

The trigger for updates is same as for activity (see above). In case your API key contains module P01, system monitors changes of your fame. In case there is P02 module presented, system monitors changes of your master skill levels. If any of C04, C05, C06 or A03 modules are present and your inventory cache is expired, system will cache items in your inventory.

You can remove all your personal data in your settings. To clean everything up delete your full name, set Publish policy to Exclude from guild members list, remove your API key and check all in Clear cached data. Then click Save. In guild activity log you will be referred as Unidentified member.

Since the next release you will be able to lock every specific update / activity in Customization settings. Level tracking is realized for Level tracker application which will be released along. Bag App and Letter app will be released later, probably with next major update.



Finally, I have created a simplified diagram how it is, generally, done. Will this give you your answers?

RyGReg 0.9

General changes

Guild relationships management was fixed as well as many other minor issues. There were made some improvements in guild database updates and Statistics displays graph of guilds on Atys. Graphs of activity include current month along 12 month history.

Guild profile

Set of scripts related to guild profile has been cleaned-up. Guild profile contains auto-generated guild description based on known guild data, this feature originally comes from Book of Guilds. Your guild profile contains link to guild inventory accessible using Bag App.

Outpost incidents

RyGReg newly keeps history of incidents between guilds. This is mainly useful to monitor by active outposts. Based on changes of the owner it is also possible to track possession time of each place. I did try to reconstruct incidents history from guild activity log however some battles might be missing, most of locations is unknown and it is not possible to monitor unsuccessful attempts. Table of known incidents in last 12 months is available in Recent updates section as well as graph of amount in time.

Role-play options

One of important news is to allow users to enable more role-play options. With use of Blablatys database, users are allowed to select role-play language. This will create another translation layer and your application will be primarily localized into preferred atys language with fallback to your preferred language with fallback to default language (english).
Another option is live conversion of all dates into Atys timeline along with two new Date and time formates by Atys conventions. And when you feel far from Atys, enable use of your national font. There is one specific font for each Atys race. Unfortunately, in-game browser will ignore this setting.

User interface clean-up

Application UI has been cleaned up. Some additional changes were made for better use in UG browser and customization options were separated for each application. One of new key features is support for scaling. While regular browsers have this feature built-in, this option targets on use with in-game browser and allows you to scale application interface between 90% and 200%.

Color management was replaced with database backend as well as operations log has new database backend. Users can browse log history and let new messages to aggregate into one summary to save space on screen. Cache updates were moved into separate thread to improve performance. Changelog and version system has new database backend.

Usage and installation

You can run the application IG using command /appzone 1947 from any chat window or install RyGReg from App zone. All suggestions are welcome.

RyGReg 0.9.1

Maintenance release

This version is mostly a maintenance release. It profits from new system features and also brings various fixes. The most important one is that the interface of the Book of Guilds was reworked and should work fine in-game again.

Changes shared by all applications

The cache update mechanism, especially inventory cache in case of (multiple) guild halls, might take some serious time to complete. While you can still customize cache lifetime for each storage and affect the length between automatic updates, all general update locks are now also accessible from user settings. In case you lock any type of update, the system still checks for new changes and offers a way how to run the update manually. This allows you to have updates always locked and run it on your request.

There were also made some fixes and improvements on the update process itself and the system of localization is now using temporary translation cache to reduce number of database queries. The system tracks if your character has a profile on Ryzom Armory server and offers a link for such Homin. All applications except DeepList also contain basic user documentation.

The set of application icons was updated to better fit with the Ryzom client theme. This change is followed by update of license details in About section. System font database was reworked and the colour palette database now supports colour opacity.

Usage and installation

You can run the application IG using command /appzone 1947 from any chat window or install RyGReg from App zone. All suggestions are welcome.