From f561a2e5d0e93d170c2a1e1c9202ba42ac490b8a Mon Sep 17 00:00:00 2001 From: Emistry Haoyan Date: Wed, 3 Oct 2018 22:48:21 +0800 Subject: Update Permission Documents - Changed into markdown format. --- README.md | 2 +- conf/groups.conf | 2 +- doc/permissions.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/permissions.txt | 39 ------------------------------------- doc/script_commands.txt | 2 +- 5 files changed, 54 insertions(+), 42 deletions(-) create mode 100644 doc/permissions.md delete mode 100644 doc/permissions.txt 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 3f0c34ffb..3afa38fb8 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 : 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 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 . + +## 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 343eb02cb..16571f9ea 100644 --- a/doc/script_commands.txt +++ b/doc/script_commands.txt @@ -8114,7 +8114,7 @@ built-in atcommands and custom atcommands. *has_permission(""{, }) 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 are: -- cgit v1.2.3-70-g09d2