/* 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 -------------- Unique group number. The only required field. Any string. If empty, defaults to "Group ". It is used in several @who commands. 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). A group of settings : or : [ , ] 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. 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'. A group of settings : If a permission is not included, false is assumed. For a full list of available permissions, see: doc/permissions.txt 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 /* group 0 is the default group for every new account */ name: "User" level: 0 inherit: ( /*empty list*/ ) commands: { commands: true mobinfo: true iteminfo: true whodrops: true autoloot: true alootid: true autoloottype: true go: true channel: true who: true me: true save: true storage: true } permissions: { /* without this basic permissions regular players could not trade or party */ can_trade: true can_party: true } }, { id: 5 name: "VIP" inherit: ( "User" ) /* can do everything Players can */ level: 0 commands: { rates: true who: true } permissions: { /* no permissions by default */ } }, { id: 99 name: "Admin" inherit: ( "User" ) level: 99 commands: { /* not necessary due to all_commands: true */ } log_commands: true permissions: { can_trade: true can_party: true all_skill: false all_equipment: false skill_unconditional: true item_unconditional: true all_commands: true channel_admin: true can_trade_bounded: true join_chat: true kick_chat: true view_hpmeter: true view_equipment: true any_warp: true receive_requests: true show_bossmobs: true } } )