> For the complete documentation index, see [llms.txt](https://info.unitedlands.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.unitedlands.net/gameplay-mechanics/towny/locks.md).

# Locks

## Introduction

Locks are a common way to protect your items are an important part of living with other people. On United Lands, locks can only be created inside [towns](/gameplay-mechanics/towny.md) so make sure to join or create one if you plan on leaving stuff behind. There are many different lock types to fit different situations, so use the command list below to find the ones that work for you.

## Commands

### Protection Creation

These commands can create different types of protections for specific purposes.

* `/lock public` : Create a public protection, anyone can use it but only the owner is able to modify the lock properties.&#x20;
* `/lock private` : Create a private protection, only you or anyone specified can access the locked container. Adding a username is optional, leaving it blank will lock to only you.
* `/bolt modify add normal password [Password]` : Password-protect a container. Anyone who knows the password can unlock it. The container will remain unlocked to the user until next login.&#x20;
* `/lock deposit` : Anyone can put items inside the protection, but they cannot be taken back out.
* `/lock display` : Anyone can view the protection's contents, but cannot modify them.
* `/bolt trust add [Username]` : The player that you include in this command will always be added to all future protections created automatically.

### Protection Management

These commands can modify or manage existing protections for a more specialised use.

* `/bolt edit add [Username]` : Add a player to an existing protection.
* `/bolt unlock` : Remove a protection from a block entirely.
* `/bolt password [password]` : Input a password to a protected block.
* `/bolt info` : Display information about the selected block.

### Protection Modes

Per player modes for easy mass changes.

* `/bolt mode persist` : Persistent mode will let you perform your last action on several blocks without needing to re-type the command.
* `/bolt mode nolock` : Disable automatic protection creation.
* `/bolt mode nospam` : Disable protection notification messages.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://info.unitedlands.net/gameplay-mechanics/towny/locks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
