Setting up a group file
- 1 Getting started with group files
- 2 Configuring a server to use your groups
Getting started with group files
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?
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.
Request A Group
In order to use global groups, you obviously need a group to add people to. You can request them 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 jradmin, admin, and sradmin groups, the names of those groups would be bzflagserver.jradmin, bzflagserver.admin, and bzflagserver.sradmin.
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 do I add people to my group?
Once you've had your group created, you need to add people to it. This can be done by going to the "Usergroups" link on BZBB. From here, you can select which group you want to add people to by clicking on the drop-down menu and then clicking "View Information". Once in the control panel for your group, you can add people by typing their names in the box next to the "Add Member" button at the bottom of the page. Then click "Add Member", and the user will be added to the group. Repeat this until you have added all the members that you want. Remember, you can always come back later and add more.
Configuring a server to use your groups
Giving your groups different permissions
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 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.
gu.league: talk spawn clientquery adminmessagesend actionmessage poll vote
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.
This gives everyone in gu-league.admin the same permissions as gu.admin.
Once you've created your group file, save it. Remember where the group file is located, since we'll need it later.
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:
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 your groups
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
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.