By default this is disabled and will not have any impact on current plugin work if you will keep it that way. But when you enable it, then things change.

Basic Raid Rules

  • You can start raid on a residence whose owner is online and who is not in raid cooldown period.
  • The defender will have pre-raid period where he can prepare his defenses (or at least go back home) and invite people to the raid defense. Players can offer defense too, but the owner should confirm them.
  • Every player (except defender) will be kicked from the residence when the raid is announced for this residence
  • An attacker can invite more people to the raid. People can join the attack forces which doesn’t require a confirmation from the original attacker.
  • Defenders will not have access to the containers during raid, this is to prevent item transfer to another residence.
  • Attackers will get move access, but no tp, so attackers who dies will have to come back from outside.
  • Defenders can teleport into residence if this was allowed in config file. By default they will be on the same boat as attackers, only owner of residence will have teleport access to the residence, extra defenders will have to come back on foot from outside residence bounds.
  • Attackers will have option to build and break blocks (will be limited in future what they can do and when just to balance things up)
  • During actual raid attackers can open any container and get any items from them (will be limited in future in how many chests they can open or/and how many items they can take out over raid period)
  • After raid ends, everyone except residence owner gets kicked out from residence and everything goes back to normal.
  • After raid player gets cooldown timer, which means that he cant be attacked for a defined time which will not allow to attack another residences this player might have.
  • After raid residence gets cooldown period in same way as player, which can be different. So residence can get for example 7 day cooldown period while player only 24 hours, which would mean that another residence belonging to this same player could be attacked next day while residence which was attacked right now will be safe for next week

Commands

/res attack [residenceName] which will start raid on residence of conditions are correct to start one. Secondary players performing this command on same residence will join raid as attackers.
/res defend [residenceName] you will join residence defence forces. This will send request to defend residence to residence owner and he needs to accept it before you can participate in residence defence. If residence owner performs command like /res defend Zrips then invitation will be sent to Zrips player to join defence of residence which will have to be accepted by the player
/res leaveraid will remove you from raid attack or defence. This cant be used by residence owner which one being attacked
/res raid [start/stop/kick/immunity] main command for server staff to control raids. You can start or stop raid by force, you can kick players from raid. Immunity will simply make residence immune to attacks for defined time. Which by itself have multiple subcommands like add/take/clear/set which can manipulate remaining immunity time. 
/res raidstatus (playername/residence) will print out basic information about current raid which will include list of attackers and defenders

Config file

Raid:
  # Determines if you want to enable raid feature for your server
  # When residence is under raid, attackers can move inside residence even if residence has move false flag
  Enabled: false
  # Time in seconds before raid starts
  # This will allow defenders to get back to residence and prepare for attack
  PreTimer: 120
  # Time in seconds raid should be
  # During this time attackers can steal and kill defenders
  Timer: 120
  # Time in seconds residence is immune for next raid
  # Default is 79200 seconds which results into 22 hours, this might reset if you have server restart
  Cooldown: 120
  # Time in seconds player is immune for next raid
  # In case player has more than one residence, this can prevent player from being attacked again
  # Default is 79200 seconds which results into 22 hours, this might reset if you have server restart
  PlayerCooldown: 120
  Allow:
    Attacker:
      # Allows to break blocks inside raided residence even if it has destroy false
      # This only applies for attackers and for raid time
      blockBreak: true
      # Allows to place blocks inside raided residence even if it has place false
      # This only applies for attackers and for raid time
      blockPlace: true
    Defender:
      # Allows to break blocks inside raided residence even if it has destroy false
      # This only applies for defenders and for raid time
      blockBreak: true
      # Allows to place blocks inside raided residence even if it has place false
      # This only applies for defenders and for raid time
      blockPlace: true
      # Allows to teleport into raided residence, includes /res tp and other 3rd party teleport commands
      # This only applies for defenders and for raid time
      # keep in mind that attackers will not have this option and will be prevented from teleporting inside raided residence
      Teleport: false
      # Allows to use containers, such as chests, during raid time
      # This only applies for defenders and for raid time
      # Keeping this at false might prevent from players moving their items to another residence which is not in raid
      # Attackers will have access to any container in your residence during raid
      containerUsage: false
  # When set to false players in same teams (attackers or defenders) will not cause each other damage
  FriendlyFire: true