Package Description

A simple module to use loot actors and it will be possible to configure traps and locks. It was created for testing and learning purposes with foundry vtt


You can install this module by using the following manifest URL :

As GM go to the Manage Modules options menu in your World Settings tab then enable the Innocenti-OpenLock. 

Thieves' Tool

Name of the item used as thieves' tools. By default, it always accepts Thieves’ Tools, and/or the name for its translation in the language file and/or the one indicated in these settings.

Maximum distance for perception (in grids)

The maximum grid distance for the perception action to be performed.

Maximum distance to interact (in grids)

the maximum distance for players to interact with the lock in number of grids.

Remove Lock

if enabled, whenever the chest is opened the lock item will be removed from the chest items.

Repeat Check

if enabled, players will be able to repeat the check the same loot.


This module was created to work in a world with other support modules so you don't have to increase your workload.

The module is system dependent:

And the Modules:

How to Use

the module basically works looking for a feat that has the open lock option enabled in loot sheet with the character's target and macro activation.

  1. Create an NPC using the loot sheet.

  1. Create an item of type Feat and in the tab Open Lock for settings.

If you have a lock trap, set the damage and the actions in this item in detail tab. If you select an **Action Type** it will recognize this trapped lock, if empty it will consider that there are no traps.

How to Use - For Doors

It works the same way as looting, but ideally, use a transparent actor next to the door so that the player can use it as a target. when unlocking a lock if the coordinate door is locked, it will open automatically.

If using thieves' tools, the door goes from locked to closed. If you use force, the door goes directly to the open state.

Enable Lock/Trap

feat to function as locks need to activate the module on the item.

Wall Coordenates

Enter the number of the door coordinates, see the door coordinates field in the wall layer (something like 1100,1200,1000,1100), if any coordinate (or other text) is entered here, the system will recognize it as a door instead of a loot.

Item Key Name

if you want this lock to have a key, fill with the exact name of the item you want to use as a key for that lock.

Disarm Trap DC

the value for the difficulty class to disarm the trap on it, the player will make a dexterity Tool check against this value, it will only be tested if the player has the item thieves' tools in his inventory.

Find Trap DC

the value for the difficulty class to find the trap in close distance, the player will make a perception/investigation test against this value

Passive Find Trap DC

the value for the difficulty class to find the trap in distance, will be tested against the passive perception, if it is not successful a test of the perception or investigation skill will be requested. Passive perception serves to locate secret doors, verify that the player has the right key, and / or display the name and image of the correct key.

Force Lock DC

the value for the difficulty class to force open the lock, the player will make a strength test against this value to open the lock. The lock will only be broken if the player passes the CD + Threshold test.

Open Lock DC

the value for the difficulty class to open the lock, it is necessary to have one thieves'tool in your inventory. the player will make a Tool Dexterity test against this value to open the lock.

Threshold of Tools Break

If the value of the thieves' tools use test is below the threshold indicated, the tool will break and will be removed from the character's inventory.

  1. Place the "Lock" object on the loot sheet.

  2. Create two macros with permission for all your players with the following content:

macro1 - FIND TRAP let actions = new InnocentiOpenLock.Actions('FindLockTrap');

macro2 - OPEN CHEST let actions = new InnocentiOpenLock.Actions('OpenLock');

Advanced: you can also separate the workflow into individual macros, just change the name of the actions in parentheses. 'Breaklock', 'Picklock', 'DisarmTraps'

there are examples in the module pack

5)The player must aim at the token of the chest and choose one of the macro actions. 

Macro 1: Find Trap

Find Trap will test the passive perception of the player against the DC, to identify if there is a trap, if there a Key and if lock is blocked.

If the passive perception does not reach the DC, the player will be asked for a perception/investigation check.

if you succeed in any of the perception tests the option to "disarm the trap" will appear when trying to open the loot(player need to have the thieves'tools in your inventary).

A chat card will be created with the results, including the indication if player has the key (if the lock has one, the player has the correct one and passed the perception test for looking for).

Update: Now whenever an attempt to search for a lock is made, a roll will be requested, even if it does not have a lock, so that the player does not know on the first attempt that there is not a lock.

Macro 2: Open Chest

Future Features


If you like this module and would like to help or found a bug or request new features call me on discord @Innocenti#1455 or create a issue here.


If you do all the steps and are unable to activate thives' tools (no rolls happens).

Check the spelling of the name Thivies's tools. In some cases the apostrophe used in the name of the compendium is different, some use ' others use ’ depending on the font used in the layout, the two may look identical. The SRD use ’ which is the default. In any case, copy and paste exactly the text of your item (ctrl + c and ctrl + v) in module settings.


This Foundry VTT module, writen by Innocenti, is licensed under a Creative Commons Attribution 4.0 International License.

Required Game Systems

  1. DnD5e Latest Version: Version 1.2.4 Last Updated 2 weeks, 4 days ago

Tagged Categories

  1. Automation Enhancers
  2. Tools and Controls

Available Versions

  1. Version 0.3.3