This is an old revision of the document!
There are two main type of locks in ChastiKey: fixed locks and variable locks.
Fixed locks are timer-based locks. You set how long the lock should last and it will count down to zero from that given duration.
Fixed locks if run as a solo lock (no keyholder or bot controlling it) can have time added to it once it has started, but you can’t as a lockee remove time.
Fixed locks can be set up to last anywhere between a few minutes or a year.
Lockees can only add time to their fixed lock. They cannot remove time. Keyholder's can add/remove time to the lockees lock. They can also hide the timer so the lockee can’t see how long is left, and they can reset the lock and freeze it. Resetting the lock will set the counter back to its original starting number and start the countdown to zero again. Freezing the lock will pause the timer and will remain paused until the keyholder unfreezes the lock.
Variable locks use a card system to determine when the lockee can unlock. The lockee will get a chance to pick a card at regular intervals, and the cards they reveal will affect how easy it is to get free. More details about each card can be found here. But to summarise them, there are currently 7 types of cards that can be included in the deck, and they are:
It is possible to create a variable lock that is almost guaranteed to run for a minimum duration, where you’re not able to reveal the required number of green card(s) until the minimum duration has passed.
In order to create a variable lock with a minimum duration you need to set the minimum number of red cards above 1 and for the minimum and maximum numbers to be different from each other.
If both the minimum and maximum numbers are the same it will treat the minimum duration as 1 hour or 1 day depending on the other options.
Here’s some examples for an hourly lock:
Setting the minimum and maximum with the values 5 and 10 will create a lock that has between 5 and 10 red cards and will last at least 5 hours. You will not find the green until the 5 hours have passed. Setting the minimum and maximum with the values 1 and 10 will create a lock that has between 1 and 10 red cards and will last at least 1 hour. You will not find the green until the 1 hour has passed. Setting the minimum and maximum with the values 10 will create a lock that has 10 red cards and will last at least 1 hour. You will not find the green until the 1 hour has passed. It doesn’t make sense to have the minimum duration set as 10 in this instance so it defaults to 1. Calculating Chance of Release and Duration of Lock A variable lock in your list of locks will look like this:
ADD IMAGE HERE
This shows a countdown until your next chance of picking a card and the percentage chance of revealing each colour (the 4th circle). For this lock there’s 6.7% chance of finding the green card.
While it’s simple to calculate the chance of picking the green card based on the total number of cards, it’s not possible to calculate the duration of the lock. When setting up the lock an approximate duration is given based on the number of red cards you choose, it doesn’t take into account the number of yellow cards, and the fact that each yellow card could add or remove cards. Another reason why it’s not possible to calculate the duration on a variable lock is because you might be really really lucky and find the green card in the first few days, even if you had 30 red cards in the deck, and 15 yellow cards.
However 30 red cards and 15 yellow cards if you’re really unlucky could turn into a 75 day lock. This is if the green card was revealed last and the 15 yellow cards each added 3 red cards to the deck. The initial 30 red cards and the 45 red cards added from the 15 yellow cards is what gives you a total of 75 days if you picked the green card after all of these cards.
The chances of the above scenario happening are next to nothing, but when setting up a variable lock and adding yellows you may want to factor in the worst case scenario i.e. each of those yellow cards could add up to +3 red cards, and keep in mind that you may be unlucky and reveal a lot of those before you reveal the green card(s).