Bukkit

In this page we will explain AntiRelog's config. AntiRelog has many features, one in particular. This is our custom NPC Aggressive mode which can be toggled on and off in the config. Also, unlike all other Combat Plugins, our NPCs work with ModifyWorld.

Lets start:
<Here would be basically what i am going to explain but in shorter detail>

MOTD

MOTD stands for Message of the Day. This can be set to anything example:

MOTD:
  Enabled: true / false
  Message: <yellow>Welcome to CursePVP

You can change <yellow> to any color that works with BUKKIT! It could be Welcome to CursePVP A full list of colors can be found here.

Mobs

This is if a player is doing PVE (Player VS Enemy) and when an Mob attacks the player, they will get tagged in combat. Just like if they were fighting a player.

Example:
I am fighting a creeper, zombie, and 3 skeletons. I kill the creeper, but I am at 2 hearts so I log out. I will either die instantly or my NPC will be there to be killed by the mobs depending on what is set in the config.

DEFAULT : FALSE
Mobs:
  Logger-Enabled: false
  Passive-Logger-Enabled: false

PVP

PvP is pretty simple if u think about it:
Player VS Player.

Tag: This will show up upon a PVP fight starting. Once a player hits/gets hit, a message will appear in the player's chat saying the text that you told it to say.

Example:
If it is <red>, it will be You have been tagged and are now in combat. Logging off will result in penalty. The message is fully editable to any color just like the MOTD.

This is also the same for the Un-Tag category, but the message will only show upon once they are out of combat.

PvP:
  Tag-Message:
    Enabled: true
    Tag: <red>You have been tagged and are now in combat. Logging off will result in penalty.
    Un-Tag: <green>You are not in combat anymore.

Combat Ban

This is used for servers that want to use an in-game automatic banning system upon combat logging. It is just like DeathBan but built into AntiRelog.

The Duration is done in minutes. So if you set it to 10, it will ban the player for 10 minutes and then automatically ban them after the duration is over.

  Ban:
    Duration: 5
    Message: <red>You have been banned for 5 minutes due to PVP logging. < This message is sent to the combat logger if they try to log on.
    Broadcast-Enabled: true
    Broadcast-Message: <green>Cowards will not be tolerated on this server. < This is what will be broadcasted upon combat logging.

Unban

This section is for anything that occurs once a player is unbanned from PVP logging and logs back on.
If you wanna send them a message, set enabled to true and it will send it once they join the server.

Run-Commands are run when the player logs back once they are unbanned.
This feature allows server owners to integrate economy penalization and other types of plugins into AntiRelog to create a diverse variety of punishments to select from. Commands are run through the console so they cannot require the sender to be a player. The <player> replaces the name of the combat logger. Set the first line of this to null to disable this feature.

  Unban:
    Message-Enabled: true
    Message: <darkaqua>You logged off during PVP and as a result you have lost your items.
    Run-Commands:
    - say <player> has logged on after being banned (edit the config to change this default runnable command).

CombatLog Options

This section sets what you want AntiRelog to do when a player logs off while in combat. If NPC is turned on, an NPC will spawn which the attacker can kill. Once killed, the NPC will drop the combat logger's inventory according to what is set to drop. Regular NPCs will just stand there and take hits until they die. However, NPCs can be toggled to aggressive mode, although this is a function to be taken seriously. Aggressive NPCs have AI will attack the attacker, continuing the battle. They are very powerful and might even kill the attacker. This function can be enabled by toggling Default-Aggressive to true. It can also be given individually by giving players the 'antirelog.aggressivenpc' permissions node. NPCs can be enabled by setting Enabled to true. The Despawn-Delay is the number of seconds an NPC has before they are despawned. If an NPC is not killed, the combat logger's inventory will not drop. If NPCs are set to false, the combat logger will drop whichever items are turned on (see Drops below).

  CombatLog:
    NPC:
      Enabled: true    < NPCs will be spawned if a player logs out.
      Despawn-Delay: 120    < Number of seconds before NPCs despawn to avoid dupes.
      Default-Aggressive: false    < Makes the NPC fight back in aggressive mode. Can be allowed using permission node found above. (Note This NPC turns into Bruce Lee combined with Chuck Norris.)

Item Drop

This is pretty self-explanatory.

    Drop:
      Items: true
      Armor: true
      Exp: true

Commands

This section handles all commands and controls which ones are allowed/disallowed in combat.
Turning Disallow-All to true will disable ALL commands in combat. No commands will be allowed whatsoever.
Freeze-Duration defines the time in seconds a player will be tagged in combat.
Freeze-Message is displayed to the player when they are tagged in combat.
The disallowed list is a list of commands that are not allowed in combat. Set the first command to null to allow all commands in combat.

  Command:
    Disallow-All: false
    Freeze-Duration: 7
    Freeze-Message: <red>There's no running away from a battle!
    Disallowed-List:
    - tp
    - warp
    - home
    - tpa
    - creative