Setting up a group file - Revision history

Zehra: added see also

2016-11-29T20:14:24Z

added see also

← Older revision		Revision as of 20:14, 29 November 2016
Line 65:		Line 65:
	If one wants to change the group permissions without restating ones server, ones 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.		If one wants to change the group permissions without restating ones server, ones 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==
			* [[Creating a server]]
			* [[Sample Group File]]

	[[Category:Server]]		[[Category:Server]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Zehra: improved content

2016-11-28T01:40:59Z

improved content

← Older revision		Revision as of 01:40, 28 November 2016
Line 1:		Line 1:
	==Getting started with group files==		==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.		Before one creates a group file, one needs 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 we should ~~probably~~ clear up is, "what is a global group?".		The first thing one should 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, ~~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~~'''.		In order to use global groups, one obviously needs a group to add people to. one 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 one wants a server called "BZFlagserver", and would like 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, ~~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.		To give people permissions, one first needs to know which are available. A list of possible permissions are available on the [[Server Permissions]] page. One should read through that page, and familiarize oneself with the group permissions, as it will come in handy later.

	===How ~~do I~~ add people to my group?===		===How does one add people to ones group?===

	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.		Once one has had ones group created, one needs 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, one must click on "Usergroups" tab, and then click on the side item labeled "Manage groups". This will show all of the groups that one is a leader of. One must click on "Manage users" next to the group one wishes 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. ~~You~~ can remove members by placing clicking the check by their name, then selecting "Remove member from group", and clicking "Submit".		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. One can remove members by placing clicking the check by their name, then selecting "Remove member from group", and clicking "Submit".

	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.		To add members to ones group, one must type their names (one per line) in the box at the bottom of the page and click "Submit". If one is unsure of their exact name, one can use the "Find a member" link.

	==Configuring a server to use ~~your~~ groups==		==Configuring a server to use groups==

	===Giving ~~your~~ groups different permissions===		===Giving ones 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.		Once the group files have been created, and one has 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:		This is done through the use of a group file, which is a text file. A group file lists the groups one can use at ones server, and their [[Server Permissions]]. Here is a sample group file:

	gu.~~league~~: talk spawn clientquery adminmessagesend actionmessage poll vote		EXAMPLE.LEAGUE: talk spawn clientquery adminmessagesend actionmessage poll vote
	gu.~~admin~~: talk spawn clientquery adminmessagesend adminmessagerecieve ban kick antiban antikick actionmessage poll vote		EXAMPLE.ADMIN: talk spawn clientquery adminmessagesend adminmessagerecieve ban kick antiban antikick actionmessage poll vote
	gu-~~league~~.~~admin~~: *gu.~~admin~~		EXAMPLE-LEAGUE.ADMIN: *EXAMPLE.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		EXAMPLE.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 allows everyone in the '''EXAMPLE.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~~		EXAMPLE-LEAGUE.ADMIN: *EXAMPLE.ADMIN

	This gives everyone in '''gu-~~league~~.~~admin~~''' the same permissions as '''gu.~~admin~~'''.		This gives everyone in '''EXAMPLE-LEAGUE.ADMIN''' the same permissions as '''EXAMPLE.ADMIN'''.

	Once ~~you've~~ created ~~your~~ group file, save it. Remember where the group file is located, since ~~we'll~~ need it later.		Once one has created ones group file, save it. Remember where the group file is located, since one will need it later.

	===Making ~~your~~ server use the group file ===		===Making the 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:		One obviously needs to reference to the group file somewhere. This is done through the conf, or configuration file that one uses to run ones 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 ~~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.		The groupfile can have whatever extension one wants, one must just make sure that one has the complete path specified after '''-groupdb'''. If there are spaces in the path, it is best to surround it with quotes.

	===Testing ~~your~~ groups===		===Testing ones 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.		To make sure everything is working properly, one must log into ones server and run the command '''/groupperms'''. It will list all the groups, and their permissions currently in use.

	===Updating group permissions===		===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.		If one wants to change the group permissions without restating ones server, ones 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.


	[[Category:Server]]		[[Category:Server]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Alezakos: /* Request A Group */ oops

2010-12-12T17:56:49Z

Request A Group: oops

← Older revision		Revision as of 17:56, 12 December 2010
Line 11:		Line 11:
	===Request A Group===		===Request A Group===

	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 ~~jradmin~~, admin, and ~~sradmin~~ groups, the names of those groups would be '''bzflagserver.cop''', '''bzflagserver.admin''', and '''bzflagserver.trustedadmin'''.		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===

Alezakos: /* Request A Group */ Friendlier group names

2010-12-12T17:56:10Z

Request A Group: Friendlier group names

← Older revision		Revision as of 17:56, 12 December 2010
Line 11:		Line 11:
	===Request A Group===		===Request A Group===

	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 jradmin, admin, and sradmin groups, the names of those groups would be '''bzflagserver.~~jradmin~~''', '''bzflagserver.admin''', and '''bzflagserver.~~sradmin~~'''.		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 jradmin, admin, and sradmin groups, the names of those groups would be '''bzflagserver.cop''', '''bzflagserver.admin''', and '''bzflagserver.trustedadmin'''.

	===Possible Permissions===		===Possible Permissions===

74.100.170.26: /* Request A Group */

2010-08-20T04:06:51Z

Request A Group

← Older revision		Revision as of 04:06, 20 August 2010
Line 11:		Line 11:
	===Request A Group===		===Request A Group===

	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?t=~~11774~~ 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'''.		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 jradmin, admin, and sradmin groups, the names of those groups would be '''bzflagserver.jradmin''', '''bzflagserver.admin''', and '''bzflagserver.sradmin'''.

	===Possible Permissions===		===Possible Permissions===

Blast: /* How do I add people to my group? */

2009-10-23T14:18:42Z

How do I add people to my group?

← Older revision		Revision as of 14:18, 23 October 2009
Line 19:		Line 19:
	===How do I add people to my group?===		===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 [http://my.bzflag.org/bb/~~groupcp~~.php "~~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~~.		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. 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 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 your groups==		==Configuring a server to use your groups==

Samjetski at 07:18, 13 September 2008

2008-09-13T07:18:37Z

← Older revision		Revision as of 07:18, 13 September 2008
Line 63:		Line 63:

	[[Category:Server]]		[[Category:Server]]
			[[Category:Tutorials]]

99.240.251.108 at 12:55, 19 May 2008

2008-05-19T12:55:10Z

← Older revision		Revision as of 12:55, 19 May 2008
Line 60:		Line 60:

	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.		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.


			[[Category:Server]]

Win Xp at 18:14, 2 March 2008

2008-03-02T18:14:50Z

← Older revision		Revision as of 18:14, 2 March 2008
Line 60:		Line 60:

	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.		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.

	~~[[Category:{Server}]]~~

Win Xp at 18:14, 2 March 2008

2008-03-02T18:14:17Z

← Older revision		Revision as of 18:14, 2 March 2008
Line 1:		Line 1:
	~~[[Category:{Server}]]~~
	==Getting started with group files==		==Getting started with group files==

Line 61:		Line 60:

	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.		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.

			[[Category:{Server}]]