Skip to content

Basic Handler

Jump to bottom
Mike Liu edited this page Nov 13, 2016 · 11 revisions

The Basic handler is a standalone handler for protection zones. It is a good starting point for most configurations. It has its own groups, and allows you to specify separate flags for them, as well as non-members. All groups are passthrough by default. This handler is also capable of passive event resolution.

Basic handler has a click-to-edit interface. Use

/foxguard detail handler <name>

and hover over the colored text to see what you can do. Some buttons run commands immediately. Others suggest commands ask you to fill out the last parameter. Still others will suggest a command that is ready to run, but still needs confirmation.

Creation

/foxguard create handler <name> basic <template>

Basic handlers require a single parameter for their creation. This parameter is the template that will be used to create the handler. There are a few handler templates to choose from:

  • bare: A completely blank handler.
  • skeleton: A handler with just an owners and members group.
  • default: Everything from the skeleton template, with owners given all permissions explicitly. The creator is also added to the owners group, if they are a player. The passive setting is set to the default group.
  • passive: A handler that has a single passive group, with the passive setting set to that group.
  • easy: Everything from default and passive. Passive setting is set to passive group.
  • plugandplay: Everything from easy, with a handful of the most common flag configurations thrown in as an example.

Modification

Basic handlers have four modification sub-commands.

Format:

/foxguard modify handler <handlername> <arguments...> where arguments is as below. For example:

/foxguard modify handler ArgyleSock users members add vladimirX stan0008 cuddles0ck

Groups

groups <add | remove | modify | rename | move> [groupnames]...

Modifies the handler's groups.

Users

users [groupname] <add | remove | set> [usernames]...

Modifies the handler's groups. All members of another group can be targeted using #[groupname] in place of [usernames].

Flags

flags [groupname] <add | remove | set | move> [flags]... =<allow | deny | pass>

Sets one or more flags for a specific group. Don't forget the = prefix on the tristate value.

Passive

passive <allow | deny | pass | (group <groupname>) | default>

Controls how events not caused by players are handled. The last 2 options tell the Basic Handler to handle the event as if it was caused by a player from that group. For example, if it was set to "member", and snow formed on the ground, the Basic handler would treat the snow formation as if a member had placed it.

Notes

  • The creator of the Basic handler is automatically added to the owners list.
  • Multiple Basic handlers can be used in conjunction with each other, if desired.
  • A low priority Basic handler can be used to block all actions in an area by default, with other handlers of higher priority over-riding to allow specific actions.
  • There is no FLARD handler.

Clone this wiki locally