This wiki is archived and useful information is being migrated to the main bzflag.org website
Editing Setting up a group file
Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.
The administrator who locked it offered this explanation: Archived wiki
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
==Getting started with group files== | ==Getting started with group files== | ||
− | Before | + | Before we make a group file, we need to know what a group file is, and how to use it. |
===What is a group file?=== | ===What is a group file?=== | ||
− | The first thing | + | The first thing we should probably clear up is, "what is a global group?". |
Simply put, a global group is a group of people that have special permissions. The owner of the group can add or remove people from the group, and then give them special permissions in a group file. These permissions can range anywhere from being able to speak, to all administrator permissions. | Simply put, a global group is a group of people that have special permissions. The owner of the group can add or remove people from the group, and then give them special permissions in a group file. These permissions can range anywhere from being able to speak, to all administrator permissions. | ||
Line 11: | Line 11: | ||
===Request A Group=== | ===Request A Group=== | ||
− | In order to use global groups, | + | In order to use global groups, you obviously need a group to add people to. You can request them [http://my.bzflag.org/bb/viewtopic.php?f=93&t=16016 here on BZBB]. Please follow the current naming convention when asking for a group, which works like this: '''organization.level'''. For example, if I owned a server called "bzflagserver", and I wanted to have cop, admin, and trustedadmin groups, the names of those groups would be '''bzflagserver.cop''', '''bzflagserver.admin''', and '''bzflagserver.trustedadmin'''. |
===Possible Permissions=== | ===Possible Permissions=== | ||
− | To give people permissions, | + | To give people permissions, you first need to know which are available. A list of possible permissions are available on the [[Server Permissions]] page. Read through that page, and familiarize yourself with the group permissions, it will come in handy later. |
− | ===How | + | ===How do I add people to my group?=== |
− | Once | + | Once you've had your group created, you need to add people to it. This can be done by going to the [http://my.bzflag.org/bb/ucp.php "User Control Panel"] link on BZBB. From there, click on "Usergroups" tab, and then click on the side item labeled "Manage groups". This will show all of the groups that you are a leader of. Click "Manage users" next to the group you wish to manage. |
− | It will then list all of the users that are currently in the group. There may be several pages of users depending on how many members exist. | + | It will then list all of the users that are currently in the group. There may be several pages of users depending on how many members exist. You can remove members by placing clicking the check by their name, then selecting "Remove member from group", and clicking "Submit". |
− | To add members to | + | To add members to your group, type their names (one per line) in the box at the bottom of the page and click "Submit". If you are unsure of their exact name, you can use the "Find a member" link. |
− | ==Configuring a server to use groups== | + | ==Configuring a server to use your groups== |
− | ===Giving | + | ===Giving your groups different permissions=== |
− | Once the group files have been created, and | + | Once the group files have been created, and you've added people to them, they can now be used on a server. |
− | This is done through the use of a group file, which is a text file. A group file lists the groups | + | This is done through the use of a group file, which is a text file. A group file lists the groups you use at your server, and their [[Server Permissions]]. Here is a sample group file: |
− | + | gu.league: talk spawn clientquery adminmessagesend actionmessage poll vote | |
− | + | gu.admin: talk spawn clientquery adminmessagesend adminmessagerecieve ban kick antiban antikick actionmessage poll vote | |
− | + | gu-league.admin: *gu.admin | |
Here's a quick explanation of what these lines do. | Here's a quick explanation of what these lines do. | ||
− | + | gu.league: talk spawn clientquery adminmessagesend actionmessage poll vote | |
− | This allows everyone in the ''' | + | This allows everyone in the '''gu.league''' group to be able to talk, spawn, use the clientquery command, send admin messages, use /me, to poll, and to vote. |
− | + | gu-league.admin: *gu.admin | |
− | This gives everyone in ''' | + | This gives everyone in '''gu-league.admin''' the same permissions as '''gu.admin'''. |
− | Once | + | Once you've created your group file, save it. Remember where the group file is located, since we'll need it later. |
− | ===Making | + | ===Making your server use the group file === |
− | + | You obviously need to reference to the group file somewhere. This is done through the conf, or configuration file that you use to run your server. Open up the conf, and add a line like this, to make the server use the group file: | |
-groupdb /the/path/to/the/groupfile.txt | -groupdb /the/path/to/the/groupfile.txt | ||
− | The groupfile can have whatever extension | + | The groupfile can have whatever extension you want, just make sure that you have the complete path specified after '''-groupdb'''. If there are spaces in the path, it is best to surround it with quotes. |
− | ===Testing | + | ===Testing your groups=== |
− | To make sure everything is working properly, | + | To make sure everything is working properly, log into your server run the command '''/groupperms'''. It will list all the groups, and their permissions currently in use. |
===Updating group permissions=== | ===Updating group permissions=== | ||
− | If | + | If you want to change the group permissions without restating your server, you can simply add the wanted permissions to the group file, save it, and then run a '''/reload''' at the server. All group permissions will be reloaded. |
==See also== | ==See also== |