//===== rAthena Documentation ================================
//= Permissions List
//===== By: ==================================================
//= rAthena Dev Team
//===== Last Updated: ========================================
//= 20240414
//===== Description: =========================================
//= List of available permissions and their functions.
//============================================================

This file describes the functions of player group permissions,
configured in '/conf/groups.conf' under the "permissions" bracket.

The permission name used in '/conf/groups.conf' goes after the asterisk "*",
while the constant name used in scripts and src goes between the parentheses "()"
in the following format:

*permission_name (PC_PERM_CONSTANT_NAME)

To search for a permission, write "*" before its name.
The format of this file is as follows:
	1. Basic Permissions
	2. Extended Permissions
	3. Command-related

========================
| 1. Basic Permissions |
========================
---------------------------------------

*can_trade (PC_PERM_TRADE)

Allows player to distribute items, such as through trades, dropping,
vending, storage, mail, etc.

---------------------------------------

*can_party (PC_PERM_PARTY)

Allows player to create and join parties.

---------------------------------------

*attendance (PC_PERM_ATTENDANCE)

Allows player to use the daily attendance system.

---------------------------------------

===========================
| 2. Extended Permissions |
===========================
---------------------------------------

*all_skill (PC_PERM_ALL_SKILL)

Grants player all available skills in the player's skill tree.

---------------------------------------

*all_equipment (PC_PERM_USE_ALL_EQUIPMENT)

Allows player to equip any item, regardless of requirements (class, level,
etc.). Note that this can cause client errors if a sprite does not exist.

---------------------------------------

*skill_unconditional (PC_PERM_SKILL_UNCONDITIONAL)

Allows player to use any skill, regardless of required conditions (SP,
items, etc.).

---------------------------------------

*join_chat (PC_PERM_JOIN_ALL_CHAT)

Allows player to join password-protected chatrooms.

---------------------------------------

*kick_chat (PC_PERM_NO_CHAT_KICK)

Prevents player from being kicked from a chatroom.

---------------------------------------

*view_hpmeter (PC_PERM_VIEW_HPMETER)

Allows player to see the HP bar of every player.

---------------------------------------

*view_equipment (PC_PERM_VIEW_EQUIPMENT)

Allows player to view the equipment of every player, regardless of that
player's setting.

---------------------------------------

*hack_info (PC_PERM_RECEIVE_HACK_INFO)

Allows player to receive all information about players who try to hack,
spoof a name, etc.

---------------------------------------

*disable_pvm (PC_PERM_DISABLE_PVM)

Prevents player from attacking monsters.

---------------------------------------

*disable_pvp (PC_PERM_DISABLE_PVP)

Prevents player from attacking other players.

---------------------------------------

*can_trade_bounded (PC_PERM_TRADE_BOUNDED)

Allows player to do normal item actions with bounded items (drop, sell,
trade, etc.).

---------------------------------------
 
*item_unconditional (PC_PERM_ITEM_UNCONDITIONAL)

Allows player to consume any consumable item regardless the requirements
(bypass noitemconsumption mapflag, item's class, gender, status changes,
item delay, etc).

---------------------------------------

*trade_unconditional (PC_PERM_TRADE_UNCONDITIONAL)

Allows player to ignore the trade conditions of items (drop, trade, sell, cart, storage/gstorage, mail and auction).

---------------------------------------
 
======================
| 3. Command-related |
======================
---------------------------------------

*all_commands (PC_PERM_USE_ALL_COMMANDS)

Allows usage of all atcommands and charcommands.

---------------------------------------

*disable_commands_when_dead (PC_PERM_DISABLE_CMD_DEAD)

Disables usage of atcommands when player is dead.

---------------------------------------

*hide_session (PC_PERM_HIDE_SESSION)

Hides player session from being displayed by atcommands (@who, @whomap,
etc.).

---------------------------------------

*who_display_aid (PC_PERM_WHO_DISPLAY_AID)

Displays all GMs and character/account IDs in the @who command.

---------------------------------------

*any_warp (PC_PERM_WARP_ANYWHERE)

Allows player to bypass 'nowarp', 'nowarpto', 'noteleport', and 'nomemo'
mapflags in commands which modify a character's map or coordinates (@memo,
@mapmove, @go, @jump, etc.).

---------------------------------------

*receive_requests (PC_PERM_RECEIVE_REQUESTS)

Allows player to receive requests through the @requests command.

---------------------------------------

*show_bossmobs (PC_PERM_SHOW_BOSS)

Displays boss mobs in the @showmobs command.

---------------------------------------

*channel_admin (PC_PERM_CHANNEL_ADMIN)

Allows player to modify #channel settings regardless of ownership and to
join password-protected channels without a password.

---------------------------------------

*use_check (PC_PERM_USE_CHECK)

Allows player to use the client command /check (displays character status).

---------------------------------------

*use_changemaptype (PC_PERM_USE_CHANGEMAPTYPE)

Allows player to use the client command /changemaptype.

---------------------------------------

*command_enable (PC_PERM_ENABLE_COMMAND)

Enable to use atcommand while talking with NPC.

---------------------------------------

*bypass_stat_onclone (PC_PERM_BYPASS_STAT_ONCLONE)

Bypass max parameter limit while using @clonestat

---------------------------------------

*bypass_max_stat (PC_PERM_BYPASS_MAX_STAT)

Allow to bypass the maximum stat parameter (at conf/player.conf) to
maximum value 32,767.

---------------------------------------

*macro_detect (PC_PERM_MACRO_DETECT)

Allows player to use the client command /macro_detector.

---------------------------------------

*macro_register (PC_PERM_MACRO_REGISTER)

Allows player to use the client commands /macro_register (used to add new captcha) and /macro_preview (used to preview captcha by ID).

---------------------------------------
