Instructions

FEATURES
----------------------------
- PermissionsEx prefixes with respecting groups weights.
- Set recipients for chat, ignore players, chat channels, tell shortcut.
- mcMMO party chat is recognized and logged.
- Annoucements with Commands or shortcut ! (channel wide) or !! (global).
    Possible from of mcMMO party chat
- Tell-style comamnd + shortcut (@ ...).
- Fully asynchronous chat (tell and announce are scheduled as commands).
- Region finder
- ChestShop finder.

UNDER REVIEW / ISSUES
----------------------------

Currently ContextManager is being restructured slightly.

- mcMMO party chat is only logged, the configuration has no effect,
    except for use-event. Announcements should work.
- Soon/later: Vault support for prefixes.
- Soon/later: Support for not having any plugin for prefixes.
- mcMMO admin chat is not yet treated in any way.

COMMANDS
----------------------------

Normal chat:
* @ <player> ....<message>... | @<player> ...<message>...
    Like tell.
    Can be disabled in the shortcuts section,
    maps to the command /tellplayer (tellp, tell).
    NEEDS: contextmanager.cmd.tellplayer

Administrative chat:
* !...
    Channel wide announcement.
    Can be disabled in the shortcuts section,
    maps to the command /tellchannel (tellchan, tellch, tellc).
    NEEDS: contextmanager.chat.announce
* !!....
    Global announcement
    Can be disabled in the shortcuts section,
    maps to the command /tellall (tella).
    NEEDS: contextmanager.chat.announce

Normal Context commands:
* context ...
    aliases: cx
    Various sub commands for managing or setting contexts.
    For most sub commands there are shorter verions,
    like rec or even r for recipients.

* cx ignore ...
    Aliases: cxign
    Ignore players chat.
    Add the player names, to remove a single player add a "-",
    like: /cxign -Notch

* cx recipients ...
    Aliases: cxr
    Add recipients of chat, only these people can hear you,
    you can only hear them, they might hear others.
    If you have permission for /cx greedy , then you can use that
     to still here the normal chat.
    Add names of players, or -<name> to remove one single player,
    like: /cxr -Notch

* cx channel
    Show available chat channels.
* cx channel <channle name>
    Aliases: cxc
    Switch to the chat chanel.
    You can only hear others inside of the channel, and vice versa.
    You can still hear other channels if you have /cx greedy !

* cx greedy | cx greedy channel
    Still get chat of other channels even if in /cxr mode or
     in another channel.
    contextmanager.cmd.greedy
    contextmanager.greedy.default
    contextmanager.greedy.channel
    contextmanager.greedy.party
    contextmanager.greedy.private

* cx reset
    Aliases: cx clear | cx cl | cxcl
    Reset contexts such as channels and recipients
* cx reset all
    Aliases: see cx reset
    Reset contexts and ignored players.
* cx reset recipients
    Aliases: see cx reset
    Reset recipients.
* cx reset channel
    Reset channel to default.
* cx reset ignore
    Reset ignored players

* cx find ...
    Aliases: cx f ...
    Find stuff, this is the general shortcut which will delegate
     to all available services.
    it will work for regions and for items (ChestShop).
    However there is permission setup necessary, or configuration to make these work!

Region service:
* cx region find <region name>
You can always use this to find regions youre owner or member of.
    regions.find.w.<world>.r.<region>
    Abbreviate for a world: regions.find.w.<world>.*
    Use lower case world and region names for permissions!

ChestShop service:
This only works if filters are set (filter.yml)!
The filters contain lists of regions for each world section.
Any region that is inside of such a filter region will
be added to the shop finder when shops are used on it.
So shops do need extra regions inside of the filter regins.
* cx shop <region name or item name>
    Show items and prices of recently bought or sold stuff.
    Or show which shops sell  or buy it.
* cx shopp info <region name>
    Show items (...).
* cx shop find <item>
    Show regions that sell the items
* cx shop find <region name>
    Show distance to shop, should work for all shops that match the fiters.

Administrative context commands:
* cx history | cx history <number>
    Shortcut: cx h ...
    Show chat history (last 50 or number ... number + 50).
    contextmanager.admin.cmd.history
    contextmanager.history.display.channel
    contextmanager.history.display.default
    contextmanager.history.display.private
    contextmanager.history.display.party
* cx services
    Show available mix-in in services (ChestShop, region finding).

Administrative commands:
* cmreload
    Reload configuration (s).
    contextmanager.admin.cmd.reload
* mute <player> | mute <player> <minutes>
    contextmanager.admin.cmd.mute
* unmute <player>
    contextmanager.admin.cmd.unmute
* muted
    List of muted players.
    contextmanager.admin.cmd.muted

OTHER PERMISSIONS
----------------------------

CONFIGURATION
----------------------------

CONFIGURATION FOR ChestShop HOOK
-----------------------------------
under hooks/ChestShop

settings.yml:
* add-unowned
    If false it will not add shops from unowned regions.
* use-filter
    If to use the WorldGuard region filter, i.e. that shops only get
    added if they are inside of a filter region (usually the town region).
* expiration-duration
    Expiration time in days, for when to invalidate shop entries.
* reverse buttons
    Used for sell/buy if you reversed the buttons in the
    ChestShop configuration.
    Not sure this is still used, have to check it ....

filter.yml:

This file contains the filter setup (see above: use-filter).
In the section allow-regions you can enter a list of regions in
a section for each world, example:

allow-regions:
  mainworld:
  - maintown