groups.conf

//      ______  __    __                                 
//     /\  _  \/\ \__/\ \                                
//   __\ \ \_\ \ \  _\ \ \___      __    ___      __     
// / __ \ \  __ \ \ \/\ \  _  \  / __ \/  _  \  / __ \   
///\  __/\ \ \/\ \ \ \_\ \ \ \ \/\  __//\ \/\ \/\ \_\ \_ 
//\ \____\\ \_\ \_\ \__\\ \_\ \_\ \____\ \_\ \_\ \__/ \_\
// \/____/ \/_/\/_/\/__/ \/_/\/_/\/____/\/_/\/_/\/__/\/_/
//  _   _   _   _   _   _   _     _   _   _   _   _   _
// / \ / \ / \ / \ / \ / \ / \   / \ / \ / \ / \ / \ / \ 
//( 9 | 9 | M | a | x | E | a ) ( A | t | h | e | n | a )
// \_/ \_/ \_/ \_/ \_/ \_/ \_/   \_/ \_/ \_/ \_/ \_/ \_/
//
//------------------------------------------------------------------
/*

Player groups configuration file
---------------------------------

This file defines "player groups" and their privileges.

Each group has its id and name, lists of available commands and other 
permissions, and a list of other groups it inherits from.


Group settings
--------------
<id>
Unique group number. The only required field.

<name>
Any string. If empty, defaults to "Group <id>". It is used in several @who 
commands.

<level>
Equivalent of GM level, which was used in revisions before r15572. You can 
set it to any number, but usually it's between 0 (default) and 99. Members of 
groups with lower level can not perform some actions/commands (like @kick) on 
members of groups with higher level. It is what script command getgmlevel() 
returns. Group level can also be used to override trade restrictions 
(db/item_trade.txt).

<commands>
A group of settings
	<command name> : <bool>
or
	<commandname> : [ <bool>, <bool> ]
First boolean value is for atcommand, second one for charcommand. If set to 
true, group can use command. If only atcommand value is provided, false is 
assumed for charcommand. If a command name is not included, false is assumed for 
both atcommand and charcommand.
For a full list of available commands, see: doc/atcommands.txt.
Command names must not be aliases.

<log_commands>
Boolean value. If true then all commands used by the group will be logged to 
atcommandlog. If setting is omitted in a group definition, false is assumed.
Requires 'log_commands' to be enabled in 'conf/log_athena.conf'.

<permissions>
A group of settings
	<permission> : <bool>
If a permission is not included, false is assumed.
For a full list of available permissions, see: doc/permissions.txt

<inherit>
A list of group names that given group will inherit commands and permissions 
from. Group names are case-sensitive.

Inheritance results
-------------------
Both multiple inheritance (Group 2 -> Group 1 and Group 3 -> Group 1) and
recursive inheritance (Group 3 -> Group 2 -> Group 1) are allowed.

Inheritance rules should not create cycles (eg Group 1 inherits from Group 2, 
and Group inherits from Group 1 at the same time). Configuration with cycles is 
considered faulty and can't be processed fully by server.

Command or permission is inherited ONLY if it's not already defined for the 
group.
If group inherits from multiple groups, and the same command or permission is 
defined for more than one of these groups, it's undefined which one will be 
inherited.

Syntax
------
This config file uses libconfig syntax: 
http://www.hyperrealm.com/libconfig/libconfig_manual.html#Configuration-Files


Upgrading from revisions before r15572
-------------------------------------
http://rathena.org/board/index.php?showtopic=58877
*/

groups: (
{
	id: 0		/* 0 = 玩家可以使用的指令 */
	name: "Player"
	level: 0
	inherit: ( /*empty list*/ )
	commands: {
 
	/* 这里设定开放给玩家的指令 , 指令设定要包覆在 commands: {里面}*/

		noks: true				// 抢怪保护
		autoloot: true			// 开启/关闭 自动捡取所有物品
		autoloottype: true		// 开启/关闭 自动捡取物品类型
		alootid: true			// 开启/关闭 自动捡取指定物品
		autotrade: true			// 离线露天商店
		changedress: true		// 删除所有人物角色的时装

		}
	permissions: {
		/* without this basic permissions regular players could not*/ 
		can_trade: true
		can_party: true
		command_enable: true
		attendance: true
	}
},
{
	id: 1
	name: "Super Player"
	inherit: ( "Player" ) /* can do everything Players can and more */
	level: 0
	commands: {
		/*  开放的指令 */
		commands: true			// 显示所有可使用的指令
		charcommands: true		// 显示可用的角色指令
		help: true				// 显示"帮助文件"内容
		rates: true				// 显示伺服器的经验值倍率
		uptime: true			// 显示伺服器已启动时间
		showdelay: true			// 显示/隐藏 "技能使用量不足" 的提示
		exp: false				// 显示当前等级 及 经验值
		mobinfo: true			// 显示魔物资讯 (种族, 素质, 掉落物, MVP道具)
		iteminfo: true			// 显示道具资讯 (种类, 价格, 其他)
		whodrops: true			// 显示何种魔物会掉落的物品 (取最高机率)
		time: true				// 显示伺服器时间
		jailtime: true			// 显示剩余监禁时间
		hominfo: true			// 显示人工生命体素质
		homstats: true			// 显示人工生命体成长统计
		showexp: true			// 显示/隐藏 经验值 
		showzeny: true			// 显示/隐藏 金钱取得资讯
		whereis: true			// 显示魔物在哪张地图 (不会显示魔物数量)
		/* feature commands */
		refresh: true			// 自伺服器取得角色的状态&资料
		noask: true				// 自动拒绝邀请
		request: true			// 送出回覆给所有在线的GM (GM会收到密语通知)
		go: true				// 传送至主要城市
		breakguild: true
		channel: true
		langtype: true
	}
	permissions: {
		attendance: true
	}
},
{
	id: 2
	name: "Support"
	inherit: ( "Super Player" )
	level: 1
	commands: {
		version: true			// 显示伺服器的SVN版本号
		where: true				// 显示角色的位置
		jumpto: true			// 瞬移到某人身边 (3 个相同指令 + /shift)
		who: true				// 显示有哪些玩家在线上
		who2: true				// 显示有哪些玩家在线上(包含职业)
		who3: true				// 显示有哪些玩家在线上(包含 队伍/公会)
		whomap: true			// 显示所在地图的玩家
		whomap2: true			// 显示所在地图的玩家(包含职业)
		whomap3: true			// 显示所在地图的玩家(包含 队伍/公会)
		users: true				// 显示玩家的分布地图 (% 表示密集度)
		broadcast: true			// 全伺服器广播 (/nb, /b).
		localbroadcast: true	// 在使用者所在地图上广播 ( /lb, /nlb).
	}
	log_commands: true
	permissions: {
		receive_requests: true
		view_equipment: true
	}
},
{
	id: 3
	name: "Script Manager"
	inherit: ( "Support" )
	level: 1
	commands: {
		tonpc: true				// 传送至NPC
		hidenpc: true			// 将NPC隐藏起来使玩家不能点选
		shownpc: true			// 解除隐藏NPC
		loadnpc: true			// 载入NPC
		unloadnpc: true			// 解除NPC
		npcmove: true			// 移动NPC
		addwarp: true			// 创造临时的传送点
	}
	log_commands: true
	permissions: {
		any_warp: true
	}
},
{
	id: 4
	name: "Event Manager"
	inherit: ( "Support" )
	level: 1
	commands: {
		monster: true			// 召换魔物(/monster).
		monstersmall: true		// 召换魔物(缩小版)
		monsterbig: true		// 召换魔物(放大版)
		killmonster2: true		// 杀死此张地图上所有魔物 (不会掉落物品)
		cleanarea: true
		cleanmap: true			// 清除视野范围内所有掉落在地上的物品
		item: [true, true]		// 创造物品 
		zeny: [true, true]		// 修改金钱
		disguise: [true, true]	// 变换玩家为魔物的外观.
		undisguise: [true, true]// 恢复外表为原貌
		size: [true, true]		// 改变玩家大小
		raise: true				// 复活所有伺服器的玩家
		raisemap: true			// 复活所有此张地图的玩家
		day: true				// 将伺服器变为白天
		night: true				// 将伺服器变为夜晚
		skillon: true			// 允许在此张地图上使用任何技能
		skilloff: true			// 关闭在此张地图上使用任何技能
		pvpon: true				// 在此张地图上开起PVP
		pvpoff: true			// 在此张地图上关闭PVP
		gvgon: true				// 启动公会战
		gvgoff: true			// 关闭公会战
		allowks: true			// 在这张地图上 启用/取消 防抢保护
		me: true				// 讯息显示格式为 "*名称 讯息*" , 而非 "名称 : 讯息.
		marry: true				// 结婚
		divorce: true			// 离婚
		refreshall: true
	}
	log_commands: true
	permissions: {
		can_trade: false
		any_warp: true
	}
},
{
	id: 5
	name: "VIP"
	inherit: ( "Player" ) /* can do everything Players can */
	level: 0
	commands: {
		rates: true
		who: true
		autoattack: true		// 自动寻怪攻击
		autopots: true			// 自动吃药
	}
	permissions: {
		/* no permissions by default */
	}
},
{
	id: 10
	name: "Law Enforcement"
	inherit: ( "Support" )
	level: 2
	commands: {
		hide: true				// 完全隐藏
		follow: true			// 自动跟随玩家(会自动传送)
		kick: true				// 将某玩家踢下线 (也可点右键选择剔除玩家).
		disguise: true			// 变换玩家为魔物的外观.
		fakename: true			// 暂时变更角色名称
		option: true			// 设定角色的外观显示.
		speed: true				// 设定 行走/攻击 速度 (预设 150)
		warp: true				// 传送至指定的地图 (X,Y)
		kill: true				// 杀死玩家
		recall: true			// 将玩家传送至你身旁
		ban: true				// 封锁玩家一段时间
		block: true				// 冻结玩家
		jail: true				// 将玩家送入监狱
		jailfor: true			// 将玩家监禁一段时间
		mute: true				// 将玩家禁言
		storagelist: true		// 显示玩家的仓库物品
		cartlist: true			// 显示玩家的手推车物品
		itemlist: true			// 显示玩家身上的物品
		stats: true				// 显示玩家的素质

	}
	log_commands: true
	permissions: {
		join_chat: true
		kick_chat: true
		hide_session: true
		who_display_aid: true
		hack_info: true
		any_warp: true
		view_hpmeter: true
	}
},
{
	id: 99
	name: "Admin"
	level: 99
	inherit: ( "Support", "Law Enforcement" )
	commands: {
		/* 无设定必要因为 all_commands: true */
	}
	log_commands: true
	permissions: {
		can_trade: true
		can_party: true
		all_skill: false
		all_equipment: false
		skill_unconditional: false
		use_check: true
		use_changemaptype: true
		all_commands: true
		channel_admin: true
		can_trade_bounded: true
		item_unconditional: false
		bypass_stat_onclone: true
		bypass_max_stat: true
		/* all_permission: true */
	}
}
)