This project is read-only.
The first thing you will see when you launch the application is the login screen.


By default, the application is created with an administrator user with the following data:

User Name: Administrator
Password: changeme/123

Once you log in, you will see the application itself, with follows the following layout.


On the top (number 1) there are two very useful buttons:
  • Save: used to save data in the active screen.
  • Refresh: used to refresh the data of the active screen. Sometimes you make changes in one screen, and those changes won't be reflected on other open screens until you refresh them.
This top bar will always contain these two buttons, although in some screens you will see extra options here related to importing, submissions, and notifications.

On the left (number 2) you have the application Menu, where you can see the different screens that compose the application grouped into sections. For example right now you can see the the Administration section, which contains the Roles and Permissions screens. Which sections of the menu you can see depend on the permissions of your role (more on roles and permissions soon).

The central space (number 3) will be occupied by the active screen. Right now we have no one, but as soon as you click one screen on the left, it will open here.

On the lower right (number 4), you can do some administration of your own user. Right now, the only thing you can do is change your Password, feel free to change it.

For the application to be useful, you have to setup the basic roles, permissions and users. Click on the Roles section of the menu and the following screen will appear


As you can see right now, there is one Role right now in the application, called Administrator, with one Permission assigned, called Security Administration. You can also see that there is one user in this Role, Administrator (the user created by default which you used to log in).

Each user of the application will have one role, which in turn has several permissions. This permissions determine which screens the user can interact with. There are three permissions defined in this application.
  • Security Administration: allows the user to see the Administration section. It is also needed to create players using the Players screen.
  • GM Management: allows the user to see the Game Master screens. The Game Master screens allow a user to add, view, and edit all the data in the game.
  • Player Management: allows the user to see the Player screens. The Player screens allow a user to consult public game data (other people playing, general information of other domains,...) and its own private data (his characters, domains,...).
So, lets create the basic Roles needed for the tool. Based on the above permissions, it is recommended that you create three roles (use the green plus symbol to add a new Role or assign Permissions to it).
  • Main Game Master: it will have the Permissions of Security Administration and GM Management.
  • Secondary Game Master: it will have the Permissions of GM Management.
  • Player: it will have the Permissions of Player Management. Important: this role should be called exactly Player (the tool uses that name internally, if you use a different name it will fail to create players later on).
Click Save, and you should have something like this:


Those roles are a recommendation, you could also just have Game Master and Player if you wanted. But it can be useful in some cases that only one person can create and edit Players.

So now the only thing left is to create a user with the role Main Game Master. You can do that on the Users screen, click on it.


Now you can see the users of the Application. As you can see, I have already created a user called Vicente and have assigned it the Main Game Master role. Use the fields that appear inside the blue rectangle in the screenshot to enter the user data.

Important: passwords in the application need to contain at least one letter, one number, and one symbol.

Once the user is created, close the application, start it again, and log in with this new user. You can also have two or more application instances open at the same time if you wish.

Continued on Working with data.

Last edited Feb 2, 2012 at 7:44 PM by Vicente, version 11


No comments yet.