summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHaru <haru@dotalux.com>2018-10-07 19:06:21 +0200
committerGitHub <noreply@github.com>2018-10-07 19:06:21 +0200
commitbaeb7a1742b0fd7ac5d3a4cecd90f74d461895fe (patch)
tree0a0e15355881cba6510ac6a22bc039c9182b829e
parentcbcc972537cb45efc965afc6a9ed628a9775864e (diff)
parentf561a2e5d0e93d170c2a1e1c9202ba42ac490b8a (diff)
downloadhercules-baeb7a1742b0fd7ac5d3a4cecd90f74d461895fe.tar.gz
hercules-baeb7a1742b0fd7ac5d3a4cecd90f74d461895fe.tar.bz2
hercules-baeb7a1742b0fd7ac5d3a4cecd90f74d461895fe.tar.xz
hercules-baeb7a1742b0fd7ac5d3a4cecd90f74d461895fe.zip
Merge pull request #2253 from Emistry/doc_permission
Update Permission Documents
-rw-r--r--README.md2
-rw-r--r--conf/groups.conf2
-rw-r--r--doc/permissions.md51
-rw-r--r--doc/permissions.txt39
-rw-r--r--doc/script_commands.txt2
5 files changed, 54 insertions, 42 deletions
diff --git a/README.md b/README.md
index 6a543cea6..e780389b6 100644
--- a/README.md
+++ b/README.md
@@ -218,7 +218,7 @@ the weather. For an in-depth explanation, please see /doc/atcommands.txt
The Hercules emulator has a permission system that enables certain groups of
players to perform certain actions, or have access to certain visual
enhancements or in-game activity. To see what permissions are available, they
-are detailed in /doc/permissions.txt
+are detailed in /doc/permissions.md
### Others
There are more files in the /doc/ directory that will help you to create scripts
diff --git a/conf/groups.conf b/conf/groups.conf
index 16eca6e96..5756a3412 100644
--- a/conf/groups.conf
+++ b/conf/groups.conf
@@ -47,7 +47,7 @@ Requires 'log_commands' to be enabled in 'conf/logs.conf'.
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
+For a full list of available permissions, see: doc/permissions.md
<inherit>
A list of group names that given group will inherit commands and permissions
diff --git a/doc/permissions.md b/doc/permissions.md
new file mode 100644
index 000000000..7d29b59fd
--- /dev/null
+++ b/doc/permissions.md
@@ -0,0 +1,51 @@
+# Group Permission List
+A list of player group permission, configured in `conf/groups.conf`.
+
+## Copyright
+> This file is part of Hercules.
+> http://herc.ws - http://github.com/HerculesWS/Hercules
+>
+> Copyright (C) 2012-2018 Hercules Dev Team
+> Copyright (C) Athena Dev Teams
+>
+> Hercules is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+>
+> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+> See the GNU General Public License for more details.
+>
+> You should have received a copy of the GNU General Public License along with this program.
+> If not, see <http://www.gnu.org/licenses/>.
+
+## Description
+The Hercules emulator has a permission system that enables certain groups of players to perform certain actions, or have access to certain visual enhancements or in-game activity.
+
+Permission | Description
+:------------------------ | :---------------------------------------------
+can_trade | Ability to trade or otherwise distribute items (drop, storage, vending etc).
+can_party | Ability to join parties.
+all_skill | Ability to use all skills.
+all_equipment | Ability to equip anything (can cause client errors).
+skill_unconditional | Ability to use skills without meeting the required conditions (SP, items, etc).
+join_chat | Ability to join a password protected chatrooms.
+kick_chat | Protection from being kicked from a chat.
+hide_session | Hides player session from being displayed by `@commands`.
+who_display_aid | Ability to see GMs and Account/Char IDs in the `@who` command.
+hack_info | Ability to receive all informations about any player that try to hack, spoof a name, etc.
+any_warp | Ability to bypass nowarp, nowarpto, noteleport and nomemo mapflags. This option is mainly used in commands which modify a character's map/coordinates (like `@memo`, `@mapmove`, `@go`, `@jump`, etc).
+view_hpmeter | Ability to see HP bar of every player.
+view_equipment | Ability to view players equipment regardless of their setting.
+use_check | Ability to use client command `/check` (display character status).
+use_changemaptype | Ability to use client command `/changemaptype`.
+all_commands | Ability to use all atcommands and charcommands.
+receive_requests | Ability to receive `@requests`.
+show_bossmobs | Ability to see boss mobs with `@showmobs`.
+disable_pvm | Ability to disable Player vs. Monster (PvM).
+disable_pvp | Ability to disable Player vs. Player (PvP).
+disable_commands_when_dead | Ability to disable atcommands usage when dead.
+can_trade_bound | Ability to trade or otherwise distribute bound items (drop, storage, vending etc).
+hchsys_admin | Hercules Chat System Admin (Ability to modify channel settings regardless of ownership and join password-protected channels without requiring a password.)
+disable_pickup | Ability to disable the player from picking up any item from ground, they can still receive items picked up by others means like party share píck.
+disable_exp | Ability to disable the player from gaining any experience point.
+disable_store | Ability to disable the player from using/openning npc and player stores.
+disable_skill_usage | Ability to disable the player from using any skill.
+
diff --git a/doc/permissions.txt b/doc/permissions.txt
deleted file mode 100644
index bc84f86b6..000000000
--- a/doc/permissions.txt
+++ /dev/null
@@ -1,39 +0,0 @@
-//===== Hercules Documentation ===============================
-//= Permission List
-//===== By: ==================================================
-//= Hercules Dev Team
-//===== Current Version: =====================================
-//= 20131031
-//===== Description: =========================================
-//= Player group permissions, configured in conf/groups.conf.
-//============================================================
-
-can_trade : Ability to trade or otherwise distribute items (drop, storage, vending etc...).
-can_party : Ability to join parties.
-all_skill : Ability to use all skills.
-all_equipment : Ability to equip anything (can cause client errors).
-skill_unconditional : Ability to use skills without meeting the required conditions (SP, items, etc...).
-join_chat : Ability to join a password protected chatrooms.
-kick_chat : Protection from being kicked from a chat.
-hide_session : Hides player session from being displayed by @commands.
-who_display_aid : Ability to see GMs and Account/Char IDs in the @who command.
-hack_info : Ability to receive all informations about any player that try to hack, spoof a name, etc.
-any_warp : Ability to bypass nowarp, nowarpto, noteleport and nomemo mapflags.
- This option is mainly used in commands which modify a character's
- map/coordinates (like @memo, @mapmove, @go, @jump, etc...).
-view_hpmeter : Ability to see HP bar of every player.
-view_equipment : Ability to view players equipment regardless of their setting.
-use_check : Ability to use client command /check (display character status).
-use_changemaptype : Ability to use client command /changemaptype.
-all_commands : Ability to use all atcommands and charcommands.
-receive_requests : Ability to receive @requests.
-show_bossmobs : Ability to see boss mobs with @showmobs.
-disable_pvm : Ability to disable Player vs. Monster.
-disable_pvp : Ability to disable Player vs. Player.
-disable_commands_when_dead : Ability to disable @command usage when dead.
-can_trade_bound: Ability to trade or otherwise distribute bound items (drop, storage, vending etc...).
-hchsys_admin : Hercules Chat System Admin (Ability to modify channel settings regardless of ownership and join password-protected channels without requiring a password.)
-disable_pickup: Ability to disable the player from picking up any item from ground, they can still receive items picked up by others means like party share píck.
-disable_exp: Ability to disable the player from gaining any experience point.
-disable_store: Ability to disable the player from using/openning npc and player stores.
-disable_skill_usage: Ability to disable the player from using any skill.
diff --git a/doc/script_commands.txt b/doc/script_commands.txt
index 6cb7eb135..64468ed49 100644
--- a/doc/script_commands.txt
+++ b/doc/script_commands.txt
@@ -8125,7 +8125,7 @@ built-in atcommands and custom atcommands.
*has_permission("<permission>"{, <account id>})
Check if the attached or specified player has the specified permission
-and returns true or false accordingly. See doc/permissions.txt for
+and returns true or false accordingly. See doc/permissions.md for
details about permissions.
Valid <permission> are: