Residence

Adding more features for Residence.

---

Index:

• Prevent
• SurvivalMechanics
• Vehicles
• Points
• Flag Editor
• Message Editor

---

Prevent

Fixed some bugs and improved the player's gaming experience.

Prevent:
  Enable: true
  Potion-Damage: true
  Zombie-Door-Destruction: true
  Enderman-Pickup-Block: true
  Painting-Destroy: true
  Item-Frame-Destroy: true
  Armor-Stand-Destroy: true
  Ender-Crystal-Destroy: true

• Potion-Damage - Prevent potions to damage animals, monsters, and players in the residence which doesn't have flags(animalkilling, mobkilling, pvp). Support: PvPManager
• Zombie-Door-Destruction - Prevent Zombies from destroying doors in the residence which doesn't have "destroy" flag.
• Enderman-Pickup-Block - Prevent Enderman pickup blocks in the residence which doesn't have "destroy" flag.
• Painting-Destroy - Prevent entities and explosion to destroy the Paintings in the residence which doesn't have "destroy" flag.
• Item-Frame-Destroy - Prevent entities and explosion to destroy the Item Frames in the residence which doesn't have "destroy" flag.
• Armor-Stand-Destroy - Prevent entities and explosion to destroy the Armor Stands in the residence which doesn't have "destroy"
• Ender-Crystal-Destroy - Prevent entities and explosion to destroy the Ender Crystal in the residence which doesn't have "destroy"flag.

---

SurvivalMechanics

Adding custom flags to disabled SurvivalMechanics in residences.
Custom Flags: climb, crawl, mobkick, roofhang, slide, swim, wallkick

/res set Spawn climb false

SurvivalMechanics:
  Enable: true

Adding GUI or Description for custom flags.

File: English.yml, Path: CommandHelp.SubCommands.flags.SubCommands

SubCommands:
  climb:
    Translated: climb
    Description: Allow players climb in residence.
  crawl:
    Translated: crawl
    Description: Allow players crawl in residence.
  mobkick:
    Translated: mobkick
    Description: Allow players mobkick in residence.
  roofhang:
    Translated: roofhang
    Description: Allow players roofhang in residence.
  slide:
    Translated: slide
    Description: Allow players slide in residence.
  swim:
    Translated: swim
    Description: Allow players swim in residence.
  wallkick:
    Translated: wallkick
    Description: Allow players wallkick in residence.

File: flags.yml, Path: Global.FlagPermission

FlagPermission:
  climb: false
  crawl: false
  mobkick: false
  roofhang: false
  slide: false
  swim: false
  wallkick: false

File: flags.yml, Path: Global.FlagGui

FlagGui:
  climb: LADDER
  crawl: GRASS
  mobkick: NETHERITE_BOOTS
  roofhang: CHAIN
  slide: PACKED_ICE
  swim: DIAMOND_HORSE_ARMOR
  wallkick: RABBIT_FOOT

---

Vehicles

Controling the Vehicles in residence.

Vehicles:
  Enable: true

Action	Description	Residence Flag
Pickup	To pickup vehicles in residences. The owner can pickup his vehicle without residence permission.	destroy
Place	To place vehicles in residences.	place
Ride	To ride vehicles in reisidences.	use

---

Points

To limit the total size of player's residences.
This feature will only calculate the main area size. Please set the "MaxAreasPerResidence" to "1" in Residence group.yml to prevent they have multiple areas.

Permission: regionplus.points.number.NUMBER

Points:
  Enable: false
  Settings:
    Select-Info: true
    Limited-Y-Calculate: false
    Prevent:
      Multiple-Areas-Size-Change: true
      Limited-Y-Size-Change: true

  Groups:
    Default:
      Display: "Default"
      Limit: 10000
    VIP:
      Display: "VIP"
      Limit: 25000
    MVP:
      Display: "MVP"
      Limit: 115200
  Level:
    Increase: 1000
    Display: "+%level%"

• Settings
  • Select-Info - Send points message when player is selecting the residence size.
  • Limited-Y-Calculate - To ignore calculation of the residences which "Y" size is limited. Only works when the residence.
  • Prevent
    • Multiple-Areas-Size-Change - Prevent changing the size of residence which has multiple areas.
    • Limited-Y-Size-Change - Prevent changing the size of residence which is limited "Y".
  • Ignore-Y-Size-Change - Prevent the residence with limit Y to change its size.

Groups

Specify the limit for difference players.

Permission: regionplus.points.group.GROUP

• Default - The default group. You shouldn't remove it.
  • Display - The placeholder of "%group%" in message.
  • Limit - The number of block limit.

Level

Players will get more points if they upgraded their residence level. Based on the permission: regionplus.points.level.LEVEL Increase: /regionplus points promote [number] Decrease: /regionplus points demote [number]

• Increase - The addition points when upgraded the level.
• Display - The placeholder of "%level%" in message.

---

Flag Editor

Changing all old residence flag to new one.

Flag-Editor:
  Enable: false
  Settings:
    Auto-Check:
      Enable: false
      Delay: 20
    Max-Edit-Players:
      Limit: 30
      Interval: 1
      Message: true
    Bypass:
      Permission: true
      Missing-Custom-Flags: true
  Default:
    Remove:
      Enable: true
      Only-No-Perms: true
      Ignore-List: []
    Update:
      Enable: true
      Ignore-List: []
  Permissions:
    Remove:
      Enable: true
      Ignore-List: []

• Settings
  • Max-Edit-Players
    • Limit - It will delay few seconds and restart editing flags to prevent the server restart while editing flags. Set "0" to disable this feature.
    • Interval - The delay seconds of restart editing flags.
  • Bypass
    • Permission - Bypass permission: regionplus.bypass.flagsedit
    • Missing-Custom-Flags - Bypass to remove the missing custom flags.
• Auto-Check - Automatic check the flags when the server is starting.
• Default 【Checking the "Flags.Default" in groups.yml.】
  • Remove
    • Enable - Remove the flags that doesn't exist.
    • Only-No-Perms - Only remove the flags that residence owner doesn't have permission to change.
    • Ignore-List - The ignore flags list.
  • Update
    • Enable - Add the flags that does exist but the residence doesn't have.
• Permissions 【Checking the "Flags.Permission" in groups.yml.】
  • Remove-No-Perms
    • Enable - Remove the flags that the residence owner doesn't have permission to change.

---

Message Editor

Resetting all old residences' enter/leave messages to default.
It will be cool to show title bar when players enter residences.

TitleBar Example
Enter: "&e&lEnter &f%residence %subtitle% &6&lOwner &6%owner"
Leave: "&7Left..."

Bypass permission: regionplus.bypass.messageedit

Message-Editor:
  Enable: false
  Settings:
    Bypass
      Permission: true
    Message: true
  Groups:
    default:
      Enter:
        - "Welcome %player to %residence, owned by %owner."
      Leave:
        - "Now leaving %residence."
    vip:
      Enter:
        - "Welcome %player to %residence, owned by %owner."
      Leave:
        - "Now leaving %residence."

• Settings
  • Bypass
    • Permission - Bypass permission: regionplus.bypass.messageedit
  • Message - Showing the editing progress.
• Groups - By default, it will only change the matching messages.
  • default
    • Enter - The old enter messages. Support multiple lines and if you set the message to "[]", it will force to reset every messages in that group.
    • Leave - The old leave messages.
  • default - You can custom messages for difference groups.

---