Keycards

A plugin that allows players to open doors using specific keycards in Unturned.

Features

• Create doors that require specific keycards to open
• Configure whether players need to hold the keycard or just have it in inventory
• Doors automatically close after a configurable delay
• Set custom door health or make doors invulnerable

Setting Up Keycard Doors

1. Place a normal door barricade in-game
2. Configure your KeycardAuthentications in the config file (see Configuration section)
3. Stand in front of the door you want to secure
4. Use the command /authkey <AuthID> while looking directly at the door
   • The AuthID must match one from your configuration (e.g., 1 or 2)
5. You'll see a success message when the door is properly set up
6. Now only players with the correct keycard can open this door

Commands

• /authkey <AuthID> - Makes the door you're looking at require a keycard to open
  • You must be looking at a door when using this command
  • The AuthID must match one from your configuration

Configuration

<?xml version="1.0" encoding="utf-8"?>
<KeycardConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <KeycardAuthentications>
    <KeycardAuthentication AuthenticationID="1" Keycards="1196 519" />
    <KeycardAuthentication AuthenticationID="2" Keycards="519" />
  </KeycardAuthentications>
  <ShouldEquip>true</ShouldEquip>
  <DoorHealth>0</DoorHealth>
  <CloseDoorDelay>3</CloseDoorDelay>
  <ToggleDoorRange>4</ToggleDoorRange>
  <CheckFrequency>40</CheckFrequency>
</KeycardConfiguration>

Configuration Options

• KeycardAuthentications: Define different keycard access levels

  • AuthenticationID: Unique ID to assign to doors (used with /authkey command)
  • Keycards: Item IDs of keycards that can open doors with this authentication level

• ShouldEquip: If true, players must hold the keycard in their hands. If false, having it in inventory is enough.

• DoorHealth: Health of keycard-locked doors. Set to 0 for invulnerable doors.

• CloseDoorDelay: Time in seconds before doors automatically close after being opened.

• ToggleDoorRange: Maximum distance (in meters) a player can be from a door to open it with a keycard.

• CheckFrequency: How often the plugin checks if a player is looking at a door (in frames). Lower values are more responsive but may impact performance.