Locki

A Quilt library that provides tools for managing player inventory locking. Can be used as a standalone modification through the /locki command.

For proper operation, the mod must be installed on both server and client.

How the locking system works

Locki uses the concept of "inventory nodes" to represent slots. These nodes are organized in a tree structure, allowing quick locking or unlocking of entire inventory sections while maintaining control over individual elements.

The path to an inventory node is written with dots, starting from the most general ancestor and ending with a specific child node. For example, inventory describes the entire player's inventory, while inventory.armor.chest points to the chestplate slot.

When a parent node is locked, child elements can remain accessible. This allows excluding specific slots from a general ban. For example, if you lock inventory and then unlock inventory.armor.chest, the player won't be able to interact with any item in their inventory except the chestplate.

Management commands

The mod adds the /locki command, which allows server administrators and map creators to interact with the API through the console.

Inventory locking

/locki lock <node> [targets] [lock_type]

• <node> - full path to a known inventory node
• [targets] (optional) - player name or target selector. If not specified, applies to the command executor. In command blocks, this parameter is mandatory
• [lock_type] (optional) - identifier of a registered lock. Defaults to the standard "command" lock

Inventory unlocking

/locki unlock <node> [targets] [lock_type]

• [targets] (optional) - player name or target selector. If not specified, applies to the command executor. In command blocks, this parameter is mandatory
• [lock_type] (optional) - identifier of a previously used lock for affecting players' inventories. Defaults to the standard "command" lock

Access permissions

With LuckPerms installed, the above commands are available to players with the locki.command.lock permission. If only locki.command.lock.self is granted, players can only use commands on themselves.