Difference between revisions of "The Test Team Handbook"

From EncyclopAtys

Jump to: navigation, search
m (β†’β€ŽYubo client configuration: add the tip for linux (all here is for windows only))
m
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
βˆ’
{{WIP}}
 
 
{{Trad  
 
{{Trad  
βˆ’
|DE =The Test Team Handbook|DEs=5
+
|DE =Das Test-Team-Handbuch|DEs=4
 
|EN =The Test Team Handbook|ENs=0
 
|EN =The Test Team Handbook|ENs=0
 
|ES =The Test Team Handbook|ESs=5
 
|ES =The Test Team Handbook|ESs=5
βˆ’
|FR =The Test Team Handbook|FRs=5
+
|FR =Manuel de l'Γ©quipe de test|FRs=5
 
|RU =The Test Team Handbook|RUs=5
 
|RU =The Test Team Handbook|RUs=5
 
|H  =
 
|H  =
 
|palette=Grey
 
|palette=Grey
 
}}
 
}}
 +
This document gives you quick overview about necessary steps you must undertake to join the [[Test Team]] and be able to do good work. It is enriched with links to other documents with more details in case such text exists. If you have any questions or suggestions, feel free ask on [https://chat.ryzom.com/group/chat-general #chat-general] (accessible for team members only) or [https://chat.ryzom.com/channel/pub-general #pub-general] (open for everybody).
  
βˆ’
Segmentation:
+
=Step 1: Apply to join=
 +
If you are willing to apply to become a member of the Testing team, please contact Tamarea, directly on [https://chat.ryzom.com/direct/Tamarea Ryzom chat] or by sending an e-mail to [mailto:tamarea@ryzom.com tamarea@ryzom.com]. You need to get access to team tools and private chat rooms. After this step use the [https://chat.ryzom.com/group/t-test #t-test] chat room for any questions related to testing.
  
βˆ’
# - [[The Test Team Handbook/1 - Joining the Test team|Joining the Test team]] :  https://cloud.ryzom.com/f/34474
+
'''More information:''' [[The Test Team Handbook/1 - Get in touch with Ryzom Forge|Get in touch with Ryzom Forge]]
βˆ’
# - [[The Test Team Handbook/2 - External team tools|External team tools]]:<br /> https://cloud.ryzom.com/f/34471
 
βˆ’
# - [[The Test Team Handbook/3 - Setting up connection to non-public Ryzom servers|Setting up connection to non-public Ryzom servers]]: <br />https://cloud.ryzom.com/f/34233
 
βˆ’
# - [[The Test Team Handbook/4 - On a testing server|On a testing server]]: <br />https://cloud.ryzom.com/f/34472
 
βˆ’
# -
 
βˆ’
# -
 
βˆ’
β€”β€” Beta Version β€”β€” {{Last version link}}
 
  
βˆ’
=Joining the Test team <ref>Joining the Test team @ cloud.ryzom.com:  https://cloud.ryzom.com/f/34474</ref>=
+
=Step 2: Get familiar with team tools=
βˆ’
This document gives you quick overview about necessary steps you must undertake to join the Testing team. It is enriched with links to other documents with more details in case such text exists. If you have any questions or suggestions, feel free ask on #chat-general (accessible for team members only) or #pub-general (open for everybody).
+
As next you need to become familiar with tools used by the Ryzom team. For planning we use Kan Board, for collaboration we have a cloud system and internal (team) chat rooms.
  
βˆ’
==Apply to join==
+
'''More information:''' [[The Test Team Handbook/2 - External team tools|External team tools]]
βˆ’
If you are willing to apply to become a member of the Testing team, please contact [[User:Tamarea|Tamarea]], directly on Ryzom chat or by sending an e-mail to tamarea@ryzom.com. You need to get access to team tools and private chat rooms. After this step use the #t-test chat room for any questions related to testing.
 
βˆ’
More information: Get in touch with Ryzom Forge
 
  
βˆ’
==Get familiar with team tools==
+
=Step 3: Configure Ryzom clients=
βˆ’
As next you need to become familiar with tools used by the Ryzom team. For planning we use Kan Board, for collaboration we have a cloud system and internal (team) chat rooms.
+
The most of team work and testing is closely tight to our testing servers. You need to create two separated client installations to have access to Yubo, the developers server, Gingo, the testing server and also to beta updates for Atys server.
βˆ’
More information: External team tools
 
  
βˆ’
==Configure Ryzom clients==
+
'''More information:''' [[The Test Team Handbook/3 - Setting up connection to non-public Ryzom servers|Setting up connection to non-public Ryzom servers]]
βˆ’
The most of team work and testing is closely tight to our testing servers. You need to create two separated client installations to have access to Yubo, the developers server, and Gingo, the testing server.
 
βˆ’
More information: Setting up connection to non-public Ryzom servers
 
  
βˆ’
==Prepare for testing==
+
=Step 4: Prepare for testing=
 
Once you have access to testing servers, you need to prepare some characters to perform tests and become familiar with in-game tools for testers. It will make your life much easier.
 
Once you have access to testing servers, you need to prepare some characters to perform tests and become familiar with in-game tools for testers. It will make your life much easier.
βˆ’
More information: On a testing server
 
βˆ’
 
βˆ’
==Learn some theory of testing==
 
βˆ’
Your work in the Test team is mostly up to you. You are free to join any test and you can use any procedure that fits you. However there are some rules that help cooperation with others, prevents fails. You need to get familiar with some aspects of the testing to make sure your reports and your results will be useful for others.
 
βˆ’
 
βˆ’
<big>'''More information: (to be written)'''</big>
 
βˆ’
 
βˆ’
=External team tools <ref>External team tools @ cloud.ryzom.com: https://cloud.ryzom.com/f/34471</ref>=
 
βˆ’
This document shortly describes external tools that are useful for every team member. These tools are not working in-game or just in a very limited way and you need to use external browser. The goal is not to supply any user manual just give you a basic overview about what do we use, how it could be useful and how to log in. The second part of this document is focused on members of the Testing team.
 
βˆ’
 
βˆ’
==General information==
 
βˆ’
Here is a basic description of all important external tools that you should keep in mind and use.
 
βˆ’
 
βˆ’
===Ryzom chat (RC)===
 
βˆ’
You probably know the Ryzom chat already. It is a tool that allows you to read in-game chats without a need to be actually in game. You will have "~" (tilda) prefix in front of your name in case of every message sent from RC to the game. Some additional details about Ryzom chat are described in the RC FAQ article on the Ryzom Wiki.
 
βˆ’
Another important role of the Ryzom chat is also that each team or project members have own chat room available. By default, every team member supposed to be a member of the following rooms: #announcement, #chat-general, and #chat-ark_dev. Team chat rooms have a "t-" prefix and project chat rooms have "pj-" prefix.
 
βˆ’
Internal chat rooms are not public thus you must become a member of a team/project first to see other private rooms then default ones. In all cases, if you think you have lost or didn't get access to a specific channel (including default ones) you should be presented on please contact [[User:Tamarea|Tamarea]] or [[User:Tykus|Tykus]].
 
βˆ’
*'''URL''': https://chat.ryzom.com
 
βˆ’
*'''Login''': your character name
 
βˆ’
*'''Password''': your account password
 
βˆ’
*'''Permissions by''': [[User:Tamarea|Tamarea]] or [[User:Tykus|Tykus]].
 
βˆ’
 
βˆ’
===KanBoard (KB)===
 
βˆ’
KanBoard is a collaboration tool, a place where all team tasks supposed to be registered. There exists a lot of boards for various teams, projects and use. The general rule about tasks is that they travel from columns on left to columns on right as they progress. In case you miss access to any board you supposed to see please contact [[User:Tamarea|Tamarea]].
 
βˆ’
*'''URL''': https://board.ryzom.com
 
βˆ’
*'''Login''': your account name
 
βˆ’
*'''Password''': your account password
 
βˆ’
*'''Permissions by:''' [[User:Tamarea|Tamarea]]
 
βˆ’
 
βˆ’
===Ryzom cloud (Cloud)===
 
βˆ’
Ryzom cloud is a powerful tool for (not just) collaboration on documents. There are various folders and the visibility depends on your team or project membership as usually. You can work with various file types on the cloud. However, for team cooperation we use mostly Pads, a special type of document that highlights different contributors. In case you miss access to any part of the cloud please contact [[User:Tamarea|Tamarea]]. Some additional details about file formats used on the Ryzom cloud are described on the Ryzom Wiki.
 
βˆ’
There is a "Ryzom-Team" folder on the cloud that you should be able to access. You can find some useful documents for internal needs, sorted to several sub-folders.
 
βˆ’
*'''URL''': https://cloud.ryzom.com
 
βˆ’
*'''Login''': your account name
 
βˆ’
*'''Password''': your account password
 
βˆ’
*'''Permissions by''': [[User:Tamarea|Tamarea]]
 
βˆ’
 
βˆ’
===Ryzom Wiki===
 
βˆ’
Ryzom wiki is the main place for all documentation. It is not a tool you will probably need to use directly in your team. However, it contains a lot of useful information about the game and its world. The Wiki is maintained by the Ryzom Wiki project. Viewing documents does not require any authentication. However, you must have an account in case you wish to contribute.
 
βˆ’
*'''URL''': https://wiki.ryzom.com
 
βˆ’
*'''Login''': your character name
 
βˆ’
*'''Password''': specific for the wiki
 
βˆ’
*'''Permissions by''': [[User:Zorroargh|Zorroargh]]
 
βˆ’
 
βˆ’
===Server status===
 
βˆ’
This small application is used to quickly check the state of all three servers. There is no need to authenticate yourself and it is a passive too that displays what is running and what is not. Please remember that this tool is unable to cover the wrong functionality of a component, it just tells you if it is running or not. In the best case all icons on this page are green (thus everything is running).
 
βˆ’
*'''URL''': https://app.ryzom.com/app_server_status/
 
βˆ’
*'''Login''': not needed
 
βˆ’
*'''Password''': not needed
 
βˆ’
*'''Permissions by''': not needed
 
βˆ’
 
βˆ’
 
βˆ’
==As a member of the Testing team==
 
βˆ’
Here are some additional details for members of the Testing team.
 
βˆ’
 
βˆ’
===Ryzom chat (RC)===
 
βˆ’
You supposed to see #t-test room by default and all discussion about testing supposed to go there, unless you need to interact with members from other teams. Feel free to ask about everything that is not clear, about your work in team, tools, a test details or your questions and issues that appeared during your testing. Feel free to suggest anything that will help run the team or fix any issue you have discovered.
 
βˆ’
 
βˆ’
===KanBoard (KB)===
 
βˆ’
You supposed to see "[Team] Test" board where all current or near-future tests have a place. The board is separated to various columns and tasks travel from left to right. However the most important for you are three of those columns:
 
βˆ’
* '''Test on Yubo''', where a list of tasks to be tested on Yubo server is
 
βˆ’
* '''Test on Gingo''', with a list of tasks that supposed to undertake final testing on Gingo server
 
βˆ’
* '''To test on Atys''', where you can find tasks that need to be tested after it was patched on Atys
 
βˆ’
You can comment on each task as you wish. However, please remember that most of the tests have a pad with instructions (see later) and your testing reports should go there not to the board. The link to a corresponding pad is usually attached to the task.
 
βˆ’
 
βˆ’
===Ryzom cloud (Cloud)===
 
βˆ’
As a member of the Testing team, you supposed to see the "Test-Team" folder. It contains various subfolders however for the testing itself you need mostly "1 - DEV_Yubo",  "2 - TEST_Gingo" and "3 - LIVE_Atys". All three folders are similar, one for each testing server and one for the Live server. All contain several other subfolders:
 
βˆ’
 
βˆ’
:#'''Ongoing''' contains pads related to current testing
 
βˆ’
:#'''Minor''' issues contain pads from the previous testing that contain issues to be discussed and solved
 
βˆ’
:#'''OK''' is a folder for recently finished testing
 
βˆ’
:# '''Archive''' is a place where all documents form testing will end after some time
 
βˆ’
 
βˆ’
Every (testing) pad usually contains instructions about the test itself and is separated into several parts. At the very beginning, you should '''note your name''', client platform and language used during your test. If there is no such section, feel free to create it or remember to mention these details by your report.
 
βˆ’
Test instructions are key for you to what is needed to be tested. However you should not stop there and once you have finished all required testing go for additional testing, whatever that you can imagine related to the matter of the tested change. Try to think about the impact of the change on the game, try to find an unexpected way of use, try to break it. Remember, you are still on a testing server, better break it here than on Atys.
 
βˆ’
During or after your testing, use the pad to make notes and reports. More related information you can provide, more helpful it will be. Every detail might be important and, especially in case of final testing on Gingo, the matter of your testing is not the functionality itself but also missing translations, confusing information given by the game, note every non-standard (debug) message or any other glitches. Also, feel free to make your suggestions about any aspect of the change. And '''most important thing''': remember to '''add date and time''' to every new addition you make to the pad.
 
βˆ’
After your tests are done, your work does not end. Please come back later to check if any new changes were done meanwhile and '''review if your questions were answered and issues fixed'''. If not, re-test your issue again (to be sure it remains), note the situation in the pad and feel free to ask directly on the testing channel about it. If the issue was solved, do the test again and confirm in the pad that the issue was fixed and no new appeared.
 
βˆ’
Another important subfolder is TT-Library where you can find some useful documents related to the Testing Team.
 
βˆ’
 
βˆ’
=Setting up connection to non-public Ryzom servers <ref>Setting up connection to non-public Ryzom servers @cloud.ryzom.com https://cloud.ryzom.com/f/34233</ref>=
 
βˆ’
 
βˆ’
This document describes how to configure a Ryzom client for connection to other Ryzom servers used by Ryzom Teams. It is expected that you are familiar with either using and configuration of the Ryzom Installer and/or capable to do advanced file system management as copying and editing files. The main concern of this document is to describe all necessary steps you need to set up connection to either Yubo or Gingo server.
 
βˆ’
 
βˆ’
==Yubo and Gingo (and Atys)==
 
βˆ’
Yubo and Gingo are names of two not public servers that are used by various teams to review and test the game. Yubo has status of development server and it is the main target where all new changes arrive for the first review. It can easily happen that some parts or the whole server is unstable or broken. Things are under development there. On the other hand, the server Gingo is a clone of Atys server. It is a place where everything supposed to be working and final testing of changes is being made there. We use this server for final testing, to see how will changes in future patch really impact the Live game server and game clients. This document also operates with the term "Live server" or just "Live" which are just other (internal) names of the Atys server. Beta testing on Atys, alias Atys BETA, is a testing on server Atys with beta updates enabled.
 
βˆ’
 
βˆ’
==Combinations==
 
βˆ’
There exist several combinations of your platform and ways of your Ryzom client installation. This document describes as many as possible of them, however the basic is same in all cases. You need to create a copy of your client files for each server and then adjust its configuration a bit for each server.
 
βˆ’
 
βˆ’
===Using Steam===
 
βˆ’
Steam platform is one of ways how to install the Ryzom client. It is possible to configure such client to access Yubo or Gingo server, however updates are distributed via Steam. That means such client will never get frequent updates directly from testing servers and you will not be able to perform any tests, along with possible other issues.
 
βˆ’
It is possible to add clients for Yubo and Gingo directly to Steam and this feature is planned, however it will require time and resources that the Ryzom team does not have at this moment. Your only current option is to install another non-steam client, static or using Ryzom Installer. Please choose one way and then continue with appropriate configuration details described in this document.
 
βˆ’
 
βˆ’
====Running the client with Steam====
 
βˆ’
After you complete configuration of your clients, static or installed with Ryzom Installer, you can use the Steam ability to become a launcher of non-steam games. You need to perform following steps for both clients:
 
βˆ’
 
βˆ’
*Start the Steam platform client if not running already
 
βˆ’
* Find and click "+ ADD A GAME" in bottom-left corner of the window
 
βˆ’
* Choose "Add a Non-Steam Game" from its context menu
 
βˆ’
* Ignore the list of applications and click "BROWSE..." button below
 
βˆ’
*Navigate to folder with desired client files and change the "File type" option on bottom to "All files"
 
βˆ’
*Choose the Ryzom client binary (for example "ryzom_client_r2.exe" on Windows or "ryzom_client" on unix-like systems) and click "OPEN" button
 
βˆ’
* A new line has been added and pre-selected in the list of applications, click "ADD SELECTED PROGRAMS"
 
βˆ’
 
βˆ’
A new record was created in your games Library. Right-click it and select Properities to change its details like name or icon.
 
βˆ’
 
βˆ’
===Using App Store===
 
βˆ’
App Store is one of ways how to install Ryzom client on macOS operating system. It is possible to configure such client to access Yubo or Gingo server, however updates are distributed via App Store. That means such client will never get frequent updates directly from testing servers and you will not be able to perform any tests, along with possible other issues. Your only current option is to install another client in different way, static or using Ryzom Installer. Please choose one way and then continue with appropriate configuration details described in this document.
 
βˆ’
 
βˆ’
===Using Ryzom Installer===
 
βˆ’
If you are not using the Ryzom Installer or you are going to configure testing servers manually, you can skip this chapter. To see your Ryzom Installer version, start the application and select Help > About… from the application main menu. Ryzom Installer version older than 3.5.0.9665 do not include settings for testing servers by default.
 
βˆ’
Before you continue you should update your Ryzom Installer to latest version. You can download its current binary from download.ryzom.com or check if there is any newer version along with your Live client, in the default profile sub-folder, usually at <path_to_ryzom_root>/0/, see default installation paths described in chapter about manual installation. Other option is to combine instructions described in Using Ryzom Installer with GUI and Manual installation with Ryzom Installer or simply follow just instructions for manual installation.
 
βˆ’
 
βˆ’
===Using Ryzom Installer with GUI===
 
βˆ’
Ryzom Installer is a small tool that helps you to install and manage your Ryzom clients. This chapter describes how to setup Yubo and Gingo clients using its user interface. It is expected that you have installed Live client on your system already. Please make sure you are using latest version of the Ryzom installer (>= 3.5.0.9665) that has testing servers configuration included already. Otherwise you need to update your Ryzom Installer version first or define those servers manually in the installer configuration, as described in Manual installation with Ryzom Installer.
 
βˆ’
 
βˆ’
====New profiles and separated clients====
 
βˆ’
It is recommended to have separate clients for each server while mixing patches between more servers might cause troubles. The Ryzom installer will do the most of work automatically for you. Start the Ryzom Installer tool, open Settings from main window menu. There is a list of current profiles on left and selected profile options on right. Click the Add button below the list of profiles to create new and you can start editing its configuration. You will need to create three new profiles, one for Yubo, one for Gingo and one for Atys BETA, along with the normal Atys one you already have there by default. Following list describes each of configuration options.
 
βˆ’
 
βˆ’
====Atys BETA client files====
 
βˆ’
There is no support for beta updates in the current version of Ryzom Installer. You need to create a separated copy manually. Create Yubo and Gingo profiles first, save changes and quit Ryzom Installer. Then go into <code><path_to_ryzom_root></code> and copy "ryzom_live" to "ryzom_beta". Then Start the Ryzom Installer again and create 4th profile for Atys BETA.
 
βˆ’
 
βˆ’
:'''Profile''': This option can't be changed. It is a profile ID and is used as a profile subdirectory name.
 
βˆ’
:'''Name''': Enter any name that will help you identify the profile. This name will be displayed as one of items in the drop-down menu of the main Ryzom Installer window.
 
βˆ’
:'''Server''': Here you will select the server type. This option will cause that the profile will contain all necessary options for specific server. Choose "Atys" for Atys BETA client profile.
 
βˆ’
:'''Executable''': This option points to the client executable file and is optional for those who will use non-default client installation location, otherwise just leave it as it is. For the Atys BETA client locate its binary in the <path_to_ryzom_root>/ryzom_beta/ manually using Browse button.
 
βˆ’
:'''Arguments''': This field can be used to pass arguments to the game client like your login, password and character slot number to use. This is optional and you can leave it blank.
 
βˆ’
:'''Comments''': You can insert any profile comments you wish here.
 
βˆ’
:'''Directory''': Displays the path to specific installer profile settings. It was set and subdirectory created along with new profile and its name is based on Profile ID.
 
βˆ’
:'''Language''': Here you can specify which translation will be used for the client when starting from this profile. If not set, English will be used.
 
βˆ’
:'''Create shortcuts''': These are additional installer profile options that are not important for the client setup itself.
 
βˆ’
 
βˆ’
Once you are done with profiles configuration, click Ok button on bottom right to save changes. It might take some time because the Ryzom Installer will create and configure two new profiles. Those will appear in the drop-down menu on main Ryzom installer window after it is completed.
 
βˆ’
 
βˆ’
====Atys BETA options====
 
βˆ’
Option to adjust Atys BETA client is not available to manage using the Ryzom Installer and you need to edit the profile config file manually. Start Atys BETA client first using the Ryzom installer, this will actually create profile files. Close the Ryzom Installer. Open client.cfg file in <path_to_ryzom_root>/3/ folder to edit and add following code at the end of the file:
 
βˆ’
Application = { "ryzom_beta", "./client_ryzom_r.exe", "./" };
 
βˆ’
Now look for RootConfigFilename optionand replace "ryzom_live" with "ryzom_beta" in the path. Save the file. The 4th profile will now accept beta updates for server Atys.
 
βˆ’
 
βˆ’
====Running the client====
 
βˆ’
Now you should have three clients set up, one for the Yubo server, one for the Gingo server and one for Atys BETA, along the default Atys profile. Start the Ryzom Installer and use the drop-down selection on bottom of the main window to choose which profile (and client) you wish to use.
 
βˆ’
 
βˆ’
===Manual installation with Ryzom Installer===
 
βˆ’
Ryzom Installer is a small tool that helps you to install and manage your Ryzom clients. This document describes how to setup '''Yubo''' and '''Gingo''' clients without user interface. It is expected you have installed Live client on your system already.
 
βˆ’
 
βˆ’
====Client files====
 
βˆ’
First step you need to do is to create a copy of your Live client files. It is recommended to have separate clients for each server while mixing patches between more servers might cause troubles. Close the Ryzom installer and Ryzom client, in case it is running, open the installation folder and copy the sub-folder "ryzom_live" to "ryzom_dev" to use as a client of the Yubo server. Then create another copy called "ryzom_test" to use as a client of the Gingo server. Then create the last copy called "ryzom_beta" to use as a client of the Atys server with beta updates enabled.
 
βˆ’
 
βˆ’
Following list contains default installation paths of all three supported platforms as well as paths where Ryzom Installer profiles are stored. <br />
 
βˆ’
The "~" path prefix is an unix alias for user home directory, for example "<code>/home/user</code>". <br />
 
βˆ’
<code>%AppData%</code> is the variable name for the application data directory under modern Windows systems, for example "<code>C:\Users\%username%\AppData</code>". More detailed information about system paths is described by the [[Ryzom location]] article on the Ryzom Wiki.
 
βˆ’
{| class="wikitable"
 
βˆ’
|-
 
βˆ’
! System !! Default client installation !! Ryzom Installer profiles location
 
βˆ’
|-
 
βˆ’
| Windows XP || <small><code>C:\Documents&nbsp;and&nbsp;Settings\{user}\Local&nbsp;Settings\Application&nbsp;Data\Ryzom\</code></small> || <small><code>C:\Documents&nbsp;and&nbsp;Settings\{user}\Local&nbsp;Settings\Application&nbsp;Data\Ryzom\</code></small>
 
βˆ’
|-
 
βˆ’
| Windows Vista/7/8/10 || <small><code>%AppData%\Local\Ryzom\</code></small> || <small><code>%AppData%\Roaming\Ryzom\</code></small>
 
βˆ’
|-
 
βˆ’
| Linux || <small><code>~/.local/share/Ryzom/</code></small> || <small><code>~/.local/share/Ryzom/</code></small>
 
βˆ’
|-
 
βˆ’
| MacOS || <small><code>~/Library/Application Support/Ryzom/</code></small> || <small><code>~/Library/Application Support/Ryzom/</code></small>
 
βˆ’
|}
 
βˆ’
System                Default client installation                                        Ryzom Installer profiles location
 
βˆ’
Windows XP            C:\Documents and Settings\{user}\Local Settings\Application Data\Ryzom\    C:\Documents and Settings\{user}\Local Settings\Application Data\Ryzom\
 
βˆ’
Windows Vista/7/8/10    %AppData%\Local\Ryzom\                                            %AppData%\Roaming\Ryzom\
 
βˆ’
Linux                ~/.local/share/Ryzom/                                            ~/.local/share/Ryzom/
 
βˆ’
MacOS                ~/Library/Application Support/Ryzom/                                ~/Library/Application Support/Ryzom/
 
βˆ’
 
βˆ’
====Server connection====
 
βˆ’
This step applies only when you are using older version of the Ryzom installer. With version 3.5.0.9692 or newer, both testing servers are already part of installer configuration, however not for Atys with beta updates. In case you want or must use the older installer, you need to define two new servers in the <code>ryzom_installer.ini</code> file which is stored along your client installations. <br />
 
βˆ’
Open the file in a text editor, locate end of section <code>[server_0]</code> and insert following block right after end of the the section, before the <code>[servers]</code> section:
 
βˆ’
[server_1]
 
βˆ’
client_download_filename=ryzom_live_client_$ARCH.7z
 
βˆ’
client_download_url="http://download.ryzom.com/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
 
βˆ’
client_filename_linux=ryzom_client
 
βˆ’
client_filename_old_linux=
 
βˆ’
client_filename_old_windows=client_ryzom_rd.exe
 
βˆ’
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
 
βˆ’
client_filename_windows=ryzom_client_r.exe
 
βˆ’
comments=Dev server
 
βˆ’
configuration_filename_linux=ryzom_configuration_qt
 
βˆ’
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
 
βˆ’
configuration_filename_windows=ryzom_configuration_qt_r.exe
 
βˆ’
data_compressed_size=1500000000
 
βˆ’
data_download_filename=ryzom_live_data.7z
 
βˆ’
data_download_url="http://download.ryzom.com/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
 
βˆ’
data_uncompressed_size=7000000000
 
βˆ’
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
 
βˆ’
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
 
βˆ’
id=ryzom_dev
 
βˆ’
name=Yubo
 
βˆ’
 
βˆ’
[server_2]
 
βˆ’
client_download_filename=ryzom_live_client_$ARCH.7z
 
βˆ’
client_download_url="http://download.ryzom.com/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
 
βˆ’
client_filename_linux=ryzom_client
 
βˆ’
client_filename_old_linux=
 
βˆ’
client_filename_old_windows=client_ryzom_rd.exe
 
βˆ’
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
 
βˆ’
client_filename_windows=ryzom_client_r.exe
 
βˆ’
comments=Test server
 
βˆ’
configuration_filename_linux=ryzom_configuration_qt
 
βˆ’
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
 
βˆ’
configuration_filename_windows=ryzom_configuration_qt_r.exe
 
βˆ’
data_compressed_size=1500000000
 
βˆ’
data_download_filename=ryzom_live_data.7z
 
βˆ’
data_download_url="http://download.ryzom.com/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
 
βˆ’
data_uncompressed_size=7000000000
 
βˆ’
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
 
βˆ’
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
 
βˆ’
id=ryzom_test
 
βˆ’
name=Gingo
 
βˆ’
 
βˆ’
As you see, configuration are almost the same, just one operates with "ryzom_dev" (Yubo) and aother one with "ryzom_test" (Gingo) and the last one with "ryzom_live" (Atys BETA). Also server names differ. Next go to [servers] section and change the value of size to number 3. It will look like this:
 
βˆ’
[servers]
 
βˆ’
default=0
 
βˆ’
size=4
 
βˆ’
 
βˆ’
====Profile configuration====
 
βˆ’
You have two exactly same copies of the ryzom client now, one for each server. You also have new servers defined in installer configuration. Now you need to create two new installer profiles. These steps will lead to same results as when using the GUI, however you will create new profiles, one for Yubo and one for Gingo, manually. <br />
 
βˆ’
Open the folder with Ryzom Installer profiles. You will find a folder called "<code>0</code>" there. Create a copy with name "<code>1</code>" for your Yubo client and another with name "<code>2</code>" for your Gingo client. Then create the last one "<code>3</code>" for the client of Atys with beta updates. The next step is to create configuration for all three new profiles, "1", "2" and "3", so the installer can find them.
 
βˆ’
 
βˆ’
Open <code>ryzom_installer.ini</code> file for editing, it is located in the same folder, and scroll to locate end of section <code>[profile_0]</code> . Then insert following block of text right after it, before the section <code>[profiles]</code>:
 
βˆ’
[profile_1]
 
βˆ’
arguments=
 
βˆ’
comments=Development server
 
βˆ’
desktop_shortcut=false
 
βˆ’
executable=
 
βˆ’
id=1
 
βˆ’
menu_shortcut=false
 
βˆ’
name=Ryzom (Yubo)
 
βˆ’
server=ryzom_dev
 
βˆ’
 
βˆ’
[profile_2]
 
βˆ’
arguments=
 
βˆ’
comments=Testing server
 
βˆ’
desktop_shortcut=false
 
βˆ’
executable=
 
βˆ’
id=2
 
βˆ’
menu_shortcut=false
 
βˆ’
name=Ryzom (Gingo)
 
βˆ’
server=ryzom_test
 
βˆ’
 
βˆ’
[profile_3]
 
βˆ’
arguments=
 
βˆ’
comments=Atys with beta updates
 
βˆ’
desktop_shortcut=false
 
βˆ’
executable=
 
βˆ’
id=3
 
βˆ’
menu_shortcut=false
 
βˆ’
name=Ryzom (Atys BETA)
 
βˆ’
server=ryzom_live
 
βˆ’
 
βˆ’
In case your client files are not saved in default path, you need to insert full path to client binary into the executable option. For Yubo client in <code>[profile_1]</code> section (with client located in ''ryzom_'''dev''' folder''), for Gingo client in <code>[profile_2]</code> (with client located in ''ryzom_'''test''' folder'').
 
βˆ’
 
βˆ’
As next go to [profiles] section and change the value of size to number 3. This says how many profiles is present. It should look like this now:
 
βˆ’
[profiles]
 
βˆ’
default=0
 
βˆ’
size=3
 
βˆ’
 
βˆ’
====Special client option====
 
βˆ’
The last thing you need to do is to edit each client configuration file and add special option so the client knows you wish to connect to a specific non-public server. Configuration of clients using the Ryzom installer is pre-configured to have custom configuration file included. Additional client configuration is stored in Ryzom Installer profiles location.
 
βˆ’
 
βˆ’
=====Yubo client configuration=====
 
βˆ’
For Windows (for '''GNU / linux''', just replace below ./client_ryzom_r.exe by ./ryzom_client)
 
βˆ’
 
βˆ’
Navigate to the Yubo profile folder "<code>1</code>" in Ryzom Installer profiles location and open <code>client.cfg</code> file for editing. Then add following block to the end of the file:
 
βˆ’
Application          = {
 
βˆ’
      <span style="color: red;">"ryzom_dev", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
=====Gingo client configuration=====
 
βˆ’
Navigate to the Gingo profile folder "<code>2</code>" in Ryzom Installer profiles location and open <code>client.cfg</code> file for editing. Then add following block to the end of the file:
 
βˆ’
Application          = {
 
βˆ’
    <span style="color: red;">"ryzom_test", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
=====Atys BETA client configuration=====
 
βˆ’
Navigate to the Atys BETA profile folder "<code>3</code>" in Ryzom Installer profiles location and open <code>client.cfg</code> file for editing. Then add following block to the end of the file:
 
βˆ’
Application          = {
 
βˆ’
    <span style="color: red;">"ryzom_beta", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
====Running the client====
 
βˆ’
Now you should have two client set up, one for the Yubo server, one for the Gingo server. Start the Ryzom Installer and use the drop-down selection on bottom of the main window to choose which profile (and client) you wish to use.
 
βˆ’
 
βˆ’
===Static client===
 
βˆ’
It is not required to use the Ryzom Installer to use the Ryzom client. This document describes how to setup both testing servers manually without any use of the Installer. It is expected that you have a static Live client installed on your system already.
 
βˆ’
 
βˆ’
====Client files====
 
βˆ’
The first step you need to do is to create a copy of your Live client files. It is recommended to have ''separate'' clients for each server while mixing patches between more servers might cause troubles. There is no default installation path for the static client.
 
βˆ’
 
βˆ’
Find the folder where is your Live client installed (for example "<code>C:\Games</code>" or "<code>/opt</code>") and copy the whole game folder (for example "<code>C:\Games\Ryzom</code>" or "<code>/opt/ryzom</code>") to "<code>ryzom_dev</code>" in same folder. This installation will be used to connect to the '''Yubo''' server. Then create another copy in same folder called "ryzom_test", this one will be used fot the '''Gingo''' server.
 
βˆ’
 
βˆ’
====Special client option====
 
βˆ’
The next thing you need to do is to edit each client configuration file and add special option so the client knows you wish to connect to a specific non-public server.
 
βˆ’
 
βˆ’
Yubo client configuration
 
βˆ’
Navigate to the root folder of your Yubo client installation, for example "<code>C:\Games\ryzom_dev</code>" or "<code>/opt/ryzom_dev</code>" and open the <code>client.cfg</code> file for editing. Scroll to the end of the file and add following block of text:
 
βˆ’
Application          = {
 
βˆ’
    <span style="color: red;">"ryzom_dev", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
=====Gingo client configuration=====
 
βˆ’
Navigate to the root folder of your Gingo client installation, for example "<code>C:\Games\ryzom_test</code>" or "<code>/opt/ryzom_test</code>" and open the <code>client.cfg</code> file for editing. Scroll to the end of the file and add following block of text:
 
βˆ’
Application          = {
 
βˆ’
    <span style="color: red;">"ryzom_test", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
=====Atys BETA client configuration=====
 
βˆ’
Navigate to the root folder of your Atys BETA client installation, for example "<code>C:\Games\ryzom_beta</code>" or "<code>/opt/ryzom_test</code>" and open the <code>client.cfg</code> file for editing. Scroll to the end of the file and add following block of text:
 
βˆ’
Application          = {
 
βˆ’
    <span style="color: red;">"ryzom_beta", "./client_ryzom_r.exe", "./" </span>
 
βˆ’
};
 
βˆ’
 
βˆ’
====Running the client====
 
βˆ’
Now you should have two client set up, one for the Yubo server, one for the Gingo server. To start the Yubo client, navigate to your "ryzom_dev" folder and start the client binary, for example "<code>C:\Games\ryzom_dev\ryzom_client_r.exe</code>" or "<code>/opt/ryzom_dev/ryzom_client</code>".
 
βˆ’
To start the Gingo client, navigate to your "<code>ryzom_test</code>" folder and start the client binary, for example "<code>C:\Games\ryzom_test\ryzom_client_r.exe</code>" or "<code>/opt/ryzom_test/ryzom_client</code>".
 
βˆ’
Another option is to create main menu / desktop shortcuts to start the right binary from the right folder for each client.
 
βˆ’
 
βˆ’
==Closing tips==
 
βˆ’
It is recommended to use separate clients for each server. It is possible to configure one client to be able to access all three servers, however different updates for each server might break your client or bring other troubles.
 
βˆ’
 
βˆ’
Yubo and Gingo are getting non-production client updates and things might go wrong time to time. A good practice is to keep one another separated copy with fresh Ryzom Installation (along Atys, Yubo and Gingo server) that you can use to quickly restore a broken client. Just make sure you back-up your configuration and character-related files before you replace the broken copy. The Ryzom installer makes things easier.
 
βˆ’
 
βˆ’
=On a testing server <ref>On a testing server @cloud.ryzom.com:
 
βˆ’
https://cloud.ryzom.com/f/34472</ref>=
 
βˆ’
This document attempt to cover your first steps on one of Ryzom testing servers, with focus on testers. It is expected that you already have access to testing servers and you have successfuly configured your clients to be actually able to connect. Following information applies to both testing servers, it is not important if you are on Yubo or Gingo.
 
βˆ’
 
βˆ’
==Account characters==
 
βˆ’
When you log to a testing server for the very first time, all your account slots are empty. It is recommended to create just one or two universal characters that will be always ready and leave other slots empty. Most of testing requires you to have none or just some specific skills and in most cases it is faster to simply create new character on your empty slot (or replace previous) for a test then develop a tool to reset your character or even wait for cooldowns.
 
βˆ’
 
βˆ’
When you creating your testing characters, avoid using any real Atys character name. Testing and real accounts are separated however it might bring troubles in the future when for example a character debug is be needed. It also prevents you from confusing which server are you on and which character owns what. Same names requires everyone to pay more attention and you won't to delete your character on wrong server by accident. Your character race or gender is not any important.
 
βˆ’
 
βˆ’
==First time on server==
 
βˆ’
Once you are done with creating your avatar and standing on Silan face to Chiang the Strong, it is time to give your new character some skills. The world of a testing server is, more or less, same as Atys you know. To grind necessary levels is however not needed thanks to various tools you are able to use.
 
βˆ’
 
βˆ’
Server accounts have a system of privileges. You will be able to use most of normal testing tools, however some specific applications or commands might require higher privileges than you have. In this case ask on your team/project channel (or on the chat-general channel) so someone else with higher privileges can help you. Following text will tell you how you can adjust various aspects of your character and some basics of your life on a testing server but is not ment to be a manual for tools that you will use.
 
βˆ’
 
βˆ’
==In-game tools==
 
βˆ’
First of all we need to make clear which tools will we use. At this moment we have several, more or less, separated aplications. In case you have any troubles using it, you find an issue or you want to suggest an improvement contact the specific tool creator please.
 
βˆ’
 
βˆ’
===Command Toolbar===
 
βˆ’
It is a toolbar with various links to other testing and administrative tools. By default it is placed on your screen somewhere, unless you made it disappear.
 
βˆ’
Start: /cmdzone show
 
βˆ’
Creator: Riasan
 
βˆ’
 
βˆ’
===Inky's tool===
 
βˆ’
This is a compact interface that contains some basic functions mostly related to character allegiance. The tool has a shortcut on the Command Toolbar.
 
βˆ’
Start: /appzone 2449
 
βˆ’
Creator: Inky
 
βˆ’
 
βˆ’
===Teleport interface===
 
βˆ’
This application is used to quick and free teleportation around the planet. It allows you to use one of fix positions pre-set for everyone, use short range landscape teleportation or save and share your own positions. The interface has a shortcut on the Command Toolbar.
 
βˆ’
Start: /appzone 1356
 
βˆ’
Creator: Riasan
 
βˆ’
 
βˆ’
==GM island==
 
βˆ’
This is a secret area in the forest region. Its position is in the Fix list of the Teleport interface and has a link in the Inky's tool. You can find there several additional objects you can interact with. You can contact Riasan about all GM island related tools.
 
βˆ’
 
βˆ’
===Red Box===
 
βˆ’
This object is used to access to various additional tools, items or interfaces and its options change in time by what is needed.
 
βˆ’
 
βˆ’
===Debug Pumpkin===
 
βˆ’
This pumpkin was introduced during the development of the Ranger rite and gives you access to various related options like setting allegiance, rite state, reset and so.
 
βˆ’
 
βˆ’
===Cult giver NPC===
 
βˆ’
There are also two NPC who can change you civilization and faction allegiance. However we have more advanced tools now accessible from the Command Toolbar or with Inky's tool.
 
βˆ’
 
βˆ’
==Help yourself==
 
βˆ’
Now it is time to really grow your character. Following list will help you so satisfy all your basic needs:
 
βˆ’
 
βˆ’
*To '''get money''', you can use ''Money interface'' from the ''Command Toolbar'' (position ''1'') or the feature on ''Inky's tool'' with icon of dappers.
 
βˆ’
*To '''spawn various or special items''' you can use the ''Spawn Items'' interface from the ''Command Toolbar'' (position ''11'') or the feature on ''Inky's tool'' with icon of generic raw materials.
 
βˆ’
*To '''find a specific item sheet ID''' you can use ''All sheet list items'' interface  from the ''Command Toolbar'' (position ''12'')
 
βˆ’
*To '''find a specific creature sheet ID''' you can use ''All sheet list creature'' interface  from the ''Command Toolbar'' (position ''2'')
 
βˆ’
*To '''rise your skill levels''' and '''learn all actions''' you can use the ''Boost'' interface from the ''Command Toolbar'' (position ''4'')
 
βˆ’
*To '''set your allegiance''' you can use the ''Fame tool'' interface from the ''Command Toolbar'' (position ''13'', allows you to set allegiance and fames) or options on ''Inky's tool'' (will set your allegiance and adjust your fames automatically) or ''Cult giver NPC'' on the ''GM island''.
 
βˆ’
*The ''Red Box'' on ''GM island'' allows you to set your ''Marauder rite'' as done, ''Inky's tool'' will give you ''Marauder teleportation crystal''
 
βˆ’
* The ''Debug Pumpkin'' on the ''GM island'' allows you to set you ''Ranger aspirant'', ''Ranger'' and various additional options, ''Inky's tool'' can spawn you on the ''Ranger Map''
 
βˆ’
*To '''set your fame''' you can use the ''Fame tool'' interface from the ''Command Toolbar'' (position ''13'')
 
βˆ’
*To '''quick heal''' of your life, sap, stamina or focus you can use the ''State tool'' from the ''Command Toolbar'' (position ''3''). This way you can also resurrect yourself.
 
βˆ’
*To '''travel''', besides running, you can use the ''Teleportation'' interface from the ''Command Toolbar'' (position ''8'') or spawn yourself teleportation related items using ''Inky's tool''.
 
βˆ’
 
βˆ’
 
βˆ’
==Game mastering==
 
βˆ’
Sooner or later, depending on how you tester skills develop, you will face the need to use more powerful tools. The power comes from using commands, knowledge of the system and account privileges. Each server has separated user rights
 
βˆ’
 
βˆ’
===Server privileges===
 
βˆ’
User accounts on each server might have various privileges. The following list contains all server ranks, sorted from lowest (Tester) to highest (DEV).
 
βˆ’
 
βˆ’
*?'''Tester'''
 
βˆ’
* '''Event Guide''' (EG)
 
βˆ’
* '''Event Manager''' (EM)
 
βˆ’
* '''Guide''' (G)
 
βˆ’
* '''Senior Guide''' (SG)
 
βˆ’
* '''Veteran Guide''' (VG)
 
βˆ’
* '''Game master''' (GM)
 
βˆ’
* '''Senior Game Master''' (SGM)
 
βˆ’
* '''Developer''' (DEV)
 
βˆ’
 
βˆ’
 
βˆ’
===Useful information and tools===
 
βˆ’
There are some external documents and 3rd party tool links that may be helpful or help you with understanding and use of advanced abilities.
 
βˆ’
 
βˆ’
====[https://dev.ryzom.com/boards/15/topics/832 Shard Commands]====
 
βˆ’
A list of commands that can be used on running server, including privileges. Created by Ryzom Core project. There is another similar [https://raw.githubusercontent.com/osgcc/ryzom/master/ryzom/server/data_shard/client_commands_privileges.txt List of required privileges for client commands]
 
βˆ’
 
βˆ’
====[https://dev.ryzom.com/boards/15/topics/832 Skill decoding]====
 
βˆ’
A post that explains how are skill keys composed, based on first name's letter.
 
βˆ’
 
βˆ’
====[https://dev.ryzom.com/projects/ryzom-api/wiki Ryzom API wiki]====
 
βˆ’
Wiki server with documentation related to public Ryzom APIs.
 
  
βˆ’
====[https://ryzomcore.atlassian.net/wiki/spaces/RC/pages/11763715/Ingame+browser In-game browser]====
+
'''More information:''' [[The Test Team Handbook/4 - On a testing server|On a testing server]]
βˆ’
A simple introduction into capabillities and use of the in-game browser, created by Ryzom Core project.
 
  
βˆ’
====[https://maps.bmsite.net/sample/builder.html Ballistic Mystix map builder]====
+
=Step 5: Choose a test=
βˆ’
A tool to review and export maps of Atys...
+
Your work in the Test team is mostly up to you. You are free to join any test and you can use any procedure that fits you. However there are some rules that help cooperation with others, prevents fails. You need to get familiar with our Test board where we track all existing testing tasks.
  
βˆ’
====[https://ofancytext.firebaseapp.com/ Ryzom message coloring tool]====
+
'''More information:''' [[The Test Team Handbook/5 - Test board organization|Test board organization]]
βˆ’
A simple external tool to generate color codes for coloring in-game messages (MOTD, crafter's message...)
 
  
βˆ’
====[https://atys.wiki.ryzom.com/RyzomNameGenerator/ Ryzom name generator]====
+
=Step 6: Start testing=
βˆ’
A tool to generate random names situable for Ryzom. There exists also small [https://app.ryzom.com/app_name_gernerator_api/?race=fyros&gender=male Name generator] script that returns a random name by given parameters via URL
+
Now you are getting to the core. Your work would be pointless if you could not provide all details from your testing. There are some tips that can help you in case you have no previous experience with a testing.
  
βˆ’
====[http://ryzom.aeness.net/ryzom_word/ Items list]====
+
'''More information:''' [[The Test Team Handbook/6 - Testing report tips|Testing report tips]]
βˆ’
Besides build-in sheet browser, which is a part of the Spawn tool, you can also use external lists of item sheets and names. Another option is to use [http://beta.kdyne.net/rygreg/DEVEL/bagapp/?sekce=itemdb-search search for items in BagApp database] or extract files from your client.
 
  
βˆ’
====[http://beta.kdyne.net/rygreg/DEVEL/langapp/bbtor.php Blablator API]====
 
βˆ’
A small LangApp API to provide translations with data based on original Osquallo's Blablator.
 
βˆ’
<br />
 
βˆ’
<br />
 
βˆ’
<br />
 
βˆ’
β€”β€”β€”β€”β€”β€”β€”β€”
 
βˆ’
<references/>
 
βˆ’
<br />
 
βˆ’
<br />
 
  
 
{{Portal|Forge}}
 
{{Portal|Forge}}

Latest revision as of 10:39, 22 March 2022

de:Das Test-Team-Handbuchβ€’
en:The Test Team Handbookβ€’
es:The Test Team Handbookβ€’
fr:Manuel de l'Γ©quipe de testβ€’
ru:The Test Team Handbookβ€’
 
UnderConstruction.png
Translation to review
Don't blame the contributors, but come and help them 😎

Reference text ( Maintained text, used as reference ) :
Notes: (Ledania, 2022-03-22)

This document gives you quick overview about necessary steps you must undertake to join the Test Team and be able to do good work. It is enriched with links to other documents with more details in case such text exists. If you have any questions or suggestions, feel free ask on #chat-general (accessible for team members only) or #pub-general (open for everybody).

Step 1: Apply to join

If you are willing to apply to become a member of the Testing team, please contact Tamarea, directly on Ryzom chat or by sending an e-mail to tamarea@ryzom.com. You need to get access to team tools and private chat rooms. After this step use the #t-test chat room for any questions related to testing.

More information: Get in touch with Ryzom Forge

Step 2: Get familiar with team tools

As next you need to become familiar with tools used by the Ryzom team. For planning we use Kan Board, for collaboration we have a cloud system and internal (team) chat rooms.

More information: External team tools

Step 3: Configure Ryzom clients

The most of team work and testing is closely tight to our testing servers. You need to create two separated client installations to have access to Yubo, the developers server, Gingo, the testing server and also to beta updates for Atys server.

More information: Setting up connection to non-public Ryzom servers

Step 4: Prepare for testing

Once you have access to testing servers, you need to prepare some characters to perform tests and become familiar with in-game tools for testers. It will make your life much easier.

More information: On a testing server

Step 5: Choose a test

Your work in the Test team is mostly up to you. You are free to join any test and you can use any procedure that fits you. However there are some rules that help cooperation with others, prevents fails. You need to get familiar with our Test board where we track all existing testing tasks.

More information: Test board organization

Step 6: Start testing

Now you are getting to the core. Your work would be pointless if you could not provide all details from your testing. There are some tips that can help you in case you have no previous experience with a testing.

More information: Testing report tips