⚡ Getting Started

1. Install Loqor by placing the `.jar` into your `/plugins` folder.
2. Restart your server to generate the default configuration.
3. Edit `config.yml` to your liking:
   - Set whether to use a database or file storage.
   - Customize Vault Spirit personalities & messages.
   - Add lore trigger words and possible lore lines.
4. Use `/loqor reload` to apply changes instantly.

Using Lockers

• Opening Lockers – Use `/locker [#]` to open a specific locker.
• Opening Another Player’s Locker – Requires proper permissions (e.g., `loqor.admin`).
• Deleting Lockers – `/lockerdel <#>` will permanently delete that locker.
• Binding Signs – Place a sign and run `/lockersign <#>` to link it.
• Finding Items – `/lockerfind <item>` searches all lockers for matching items.
• Quick Deposit – Hold an item and use `/lockerdeposit [locker]` to store it instantly.

Vault Spirits
Vault Spirits add personality to your lockers. They will greet you and comment when you open a locker.
You can customize their:

• Names (stored in `spirits.yml`)
• Messages for each personality type (in `config.yml`)
• Chance for special interactions (like the “Greedy” spirit taking your item)

Available Personalities:

• Hoarder – Loves full lockers.
• Minimalist – Likes emptiness.
• Tidy – Appreciates organization.
• Messy – Embraces chaos.
• Greedy – Sometimes keeps your items!

Lore Infusion
Items with names containing trigger words (set in `config.yml` under `lore.trigger_names`) will be infused with a random lore line from `lore.line_pool`.
This happens automatically when the locker is opened.

Example:
If a player stores an item named "Ancient Relic", it may gain lore like:
⚙ Commands Reference

Command	Description	Permission
/locker [#] [player]	Opens a specified locker	loqor.commands.locker
/lockerdel <#> [player]	Deletes a specified locker	loqor.commands.lockerdel
/lockersign <#> [player]	Binds a locker to a sign	loqor.commands.lockersign
/lockerfind <item> [player]	Finds a locker containing the item	loqor.commands.lockerfind
/lockerdeposit [locker] [player]	Deposits the held item	loqor.commands.lockerdeposit
/loqor reload	Reloads Loqor’s config	loqor.reload

Permissions Reference

Permission	Description	Default
loqor.commands.locker	Allows use of `/locker`	true
loqor.commands.lockerdel	Allows use of `/lockerdel`	op
loqor.commands.lockersign	Allows use of `/lockersign`	op
loqor.commands.lockerfind	Allows use of `/lockerfind`	true
loqor.commands.lockerdeposit	Allows use of `/lockerdeposit`	true
loqor.base	Base permission for `/loqor`	true
loqor.reload	Allows reloading the plugin	op
loqor.lockers.#	Access to # locker (if higher than 1 will also have access to lockers below #)	false
loqor.lockers.#.<size:1x9 / 2x9 / 3x9 / 4x9 / 5x9 / 6x9>	Access to # locker with custom gui size	false
loqor.lockers.*	Access to all lockers	false
loqor.admin	Full locker access	op
loqor.delete	Delete other players' lockers	op
loqor.signs.use	Use locker signs	true
loqor.signs.set	Set locker signs	op
loqor.signs.bypass	Bypass locker sign restrictions	op