Loot Protection 1.0.33

Yet another player loot protection plugin for Rust

• Uses ZoneManager, Friends, Clans, Rust teams, and DynamicPVP
• Player boxes, workbenches, switches, buttons, planters, etc. are protected from accessing or opening and pickup by others. With Friends/Clans/Teams support, a player's friends will maintain access.
• Server-owned storage should be unaffected.
• A list of zones can be set to only protect boxes in those zones.
• A schedule can be set to disable/enable the plugin throughout the actual or in-game time and day.
• Note that this is not damage control, only access to contents and pickup of entities.

Commands

• /share (Requires lootprotect.share)
  • /share ? - Show sharing status of object in front of you.  You can also hit the item with a hammer to check status.
  • /share   - Share object in front of you to ALL.
  • /share PLAYERNAME - Share object in front of you to specified player.
• /unshare - Remove all sharing for object in front of you.
• /bshare - (Requires lootprotect.admin) Share all entities in range of the local TC (Range set by BuildingShareRange config)
• /bshare ? - Check the building share status - Or hit the TC with a hammer.
• /bunshare - (Requires lootprotect.admin) Unshare all entities in range of the local TC (Range set by BuildingShareRange config)

• /lp (Requires lootprotect.admin permission)
  • /lp enable/e/1/true - Enable plugin
  • /lp disable/d/0/false - Disable plugin
  • /lp logging/log/l - Toggle logging on/off
  • /lp status - Show current config and enable status

    For the above, you can type /lp enable OR /lp 1 to enable, etc.

    If a player does not own the storage or are not a friend of the owner, they cannot share/unshare it.

    If Friends/Clans/Teams support is NOT enabled, players can share/unshare items they own.  If any of those features are enabled, they can still share/unshare to players not in their friend list, etc.

  Note that bshare/bunshare are currently bulk commands for share/unshare with all.  In other words they do not currently allow you to be specific about with whom you are (un)sharing.  This is mostly needed for admins sharing items in a town, etc.

Permissions

• lootprotect.all - Player overrides all access controls
• lootprotect.admin - Player can run the /lp command
• lootprotect.share - Player can run the /share and /unshare commands
• lootprotect.player - Player boxes protected (only if RequirePermission is true)

Configuration

{
  "Options": {
    "RequirePermission": false,
    "useZoneManager": false,
    "protectedDays": 0,
    "useSchedule": false,
    "useRealTime": false,
    "useFriends": false,
    "useClans": false,
    "useTeams": false,
    "HonorRelationships": false,
    "OverrideOven": false,
    "OverrideTC": false,
    "StartEnabled": true,
    "StartLogging": false,
    "LogToFile": false,
    "AdminBypass": false,
    "BuildingShareRange": 150.0,
    "BShareIncludeSigns": false,
    "BShareIncludeLights": false,
    "BShareIncludeElectrical": false,
    "TCAuthedUserAccess": false,
    "useHammerForShareStatus": false,
    "respondToActivationHooks": false,
    "allowLootingInPVPAreas": false,
    "allowLootingOfflineOwner": false
  },
  "Rules": {
    "bbq.deployed": true,
    "box.wooden.large": true,
    "campfire": true,
    "cursedcauldron.deployed": true,
    "fridge.deployed": true,
    "furnace.large": true,
    "furnace.small": true,
    "mixingtable.deployed": false,
    "player": true,
    "player_corpse": true,
    "recycler_static": false,
    "refinery_small_deployed": false,
    "repairbench_deployed": false,
    "researchtable_deployed": false,
    "woodbox_deployed": true,
    "workbench1.deployed": true,
    "workbench2.deployed": true,
    "workbench3.deployed": true,
    "fuelstorage": true,
    "hopperoutput": true,
    "scientist_corpse": false,
    "murderer_corpse": false,
    "vendingmachine.deployed": false,
    "sign.small.wood": true,
    "sign.medium.wood": true,
    "sign.large.wood": true,
    "sign.huge.wood": true,
    "sign.pictureframe.landscape": true,
    "sign.pictureframe.portrait": true,
    "lock.code": true,
    "lock.key": true
  },
  "EnabledZones": null,
  "DisabledZones": null,
  "Schedule": "",
  "Version": {
    "Major": 1,
    "Minor": 0,
    "Patch": 32
  }
}

Global Options

• RequirePermission -- If set to true, players must have the lootprotect.player permission.  This could be assigned to the default group, for example.
• useZoneManager -- Use ZoneManager to only protect boxes in specified zones.
• protectedDays -- If set to any value other than zero, player containers will only be protected if the user has been online sometime within that number of days.
• useClans -- Use various Clans plugins for determining relationships.
• useFriends -- Use various Friends plugins for determining relationships.
• useTeams -- Use Rust native teams for determining relationships.
• HonorRelationships -- If set, honor any of the useXXX features to determine ability to access boxes.
• OverrideOven -- Allow access to ovens (campfire, furnace, etc.). Set this to only protect storage boxes, etc.
• OverrideTC -- Allow access to authenticate on an unlocked TC.
• StartEnabled -- Start plugin in enabled mode (default true).
• StartLogging -- Log all check activity by default on plugin load (default false).
• LogToFile -- Log to dated file in oxide/logs/LootProtect folder. If false, log to oxide log file/rcon.
• AdminBypass -- Allow admins or players with permLootProtAdmin permission to bypass checks for access.

• BuildingShareRange -- Range within which to take action when running bshare/bunshare.

• BShareIncludeSigns -- Include signs when giving access with bshare/bunshare.

• BShareIncludeLights -- Include lighting fixtures when giving access with bshare/bunshare.

• BShareIncludeElectrical -- Include electric switches, etc.,  when giving access with bshare/bunshare.

• TCAuthedUserAccess -- Player authed to local TC gets access

• useHammerForShareStatus -- Set true to enable share checks via hammer hit

• respondToActivationHooks -- Set true to enable the EnableMe/DisableMe hooks.  These are currently only used by NextGenPVE at purge end/start.

• allowLootingInPVPAreas -- If in a NextGenPVE PVP (damage allowed) zone, allow looting.

• allowLootingOfflineOwner -- If true, and protectedDays == 0, any item owned by an offline player can be looted.

Rules

    This is a simple list of prefab names and whether or not they will be protected. Several defaults are included to work with standard storage boxes, furnaces, campfire, etc.

    For each prefab, if true is specified, they will be protected.

    If NOT listed, access will be allowed...

ZoneManager (Optional)

    If ZoneManager is loaded, and useZoneManager is true, you can specify zone ids here. The default value is:

  "Zones": null,

To set a zone or list of zones, specify them as follows:

  "EnabledZones": [
    "123456"
  ],
  "DisabledZones": [
    "112233",
    "221122"
  ],

Or:

  "EnabledZones": [
    "123456",
    "345678"
  ],

DynamicPVP (Optional)

If DynamicPVP is installed, it will (as of March 2023) call functions to automatically manage enabled zones.  In this case, set DisabledZones to [].

Schedule (Optional)

    The schedule follows this simple format. A schedule determines when the plugin is active. If not set, it is always active.

• FORMAT: DAYOFWEEK_OR_*;START:TIME;END:TIME
  • 1;1:00:21:00 == Monday between 1AM local time and 9PM local time
  • *;4:00;15:00 == Every day between 4AM and 3PM

The default schedule is:

  "Schedule": "",

Enter your schedule into the config as follows:

  "Schedule": "*;4:00;15:00",

Schedule flags (global options)

• useSchedule -- Must be true to enable the schedule
• useRealTime -- Use the actual server host clock to determine activity (if false, use in-game time)

Future

• Disable protection after X hours or days of player inactivity.  This might be its own plugin for use by this and others.
• Add other storage types by default as needed.
• GUI Announcement support, etc.