Pincho's Locks

⚜ PINCHOS LOCKS ⚜

API-Paper%20%7C%20Spigot%20%7C%20Bukkit-blue

★ FULLY CUSTOMIZABLE ★ MULTI-LANGUAGE ★ LIGHTWEIGHT ★

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DESCRIPTION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Pinchos Locks is a protection plugin that brings an immersive lock system to your Minecraft server. The plugin features an exciting lockpicking minigame that allows players to attempt breaking into locked containers, doors or more.

Whether you're running a survival server, RPG server, faction server, or roleplay server, Pinchos Locks adds a layer of depth and strategy to player interactions and economy.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHY CHOOSE PINCHOS LOCKS?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓	100% Configurable - Every single message, item, sound, and setting can be customized to fit your server's theme
✓	Lightweight & Optimized - Built with Kotlin coroutines for async operations, zero lag guaranteed
✓	Multi-Language Support - English and Spanish included, easily add any language you want
✓	Beautiful Effects - Stunning particle effects and sounds for every interaction (toggleable)
✓	MiniMessage Support - Full gradient, hover, and click event support in all messages
✓	Active Development - Regular updates, bug fixes, and new features based on community feedback

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SCREENSHOTS & PREVIEW
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

► Lockpicking Minigame

The action bar shows real-time progress during lockpicking attempts

► Lock Information

View the lock info including owner and lock tier when left-click on it

► Particle Effects

A lot of visual effects and particles for all lock interactions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TIERED LOCK SYSTEM

Bronze Locks - Entry-level protection, can be picked by basic lockpicks
Silver Locks - Enhanced security, requires advanced lockpicks or higher
Gold Locks - Maximum protection, only master lockpicks can attempt to break in
Each tier has configurable difficulty levels and materials
Custom model data support for resource packs

LOCKPICKING MINIGAME

Skill-based progression - Success depends on lockpick tier vs lock tier
Visual feedback - Action bar shows real-time picking progress with color indicators
Durability system - Lockpicks break after a certain number of uses
Configurable cooldowns - Prevent spam picking attempts
Temporary access - Successfully picked locks grant temporary access (configurable duration)

TRUST SYSTEM

Trust players - Give specific players permanent access to your locks
Trust management - Easy commands to add, remove, and list trusted players
No limits - Trust as many players as you want per lock
Per-lock basis - Each lock has its own trust list

COMPLETE PROTECTION

Explosion proof - TNT, creepers, and other explosions won't break locked blocks
Piston proof - Pistons cannot push or pull locked blocks
Hopper proof - Hoppers cannot extract items from locked containers
Mob proof - Zombies and other mobs cannot break locked doors
Redstone safe - Locked doors are protected from redstone signals (configurable)

VISUAL EFFECTS

Particle effects - Unique particles for placing, removing, accessing, and denying
Sound effects - Satisfying audio feedback for all interactions
Action bar messages - Non-intrusive notifications during gameplay
Fully toggleable - Enable or disable effects in config

MULTI-LANGUAGE

Included languages - English (en_EN) and Spanish (es_ES)
Easy to add more - Simply create a new YAML file in the lang folder
MiniMessage format - Full support for colors, gradients, and formatting
Placeholders - Dynamic values like player names, tiers, and more

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LOCK & LOCKPICK TIERS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

► LOCK TIERS

TIER	DEFAULT MATERIAL	DIFFICULTY
Bronze	COPPER_INGOT	Easy (25)
Silver	IRON_INGOT	Medium (50)
Gold	GOLD_INGOT	Hard (85)

► LOCKPICK TIERS

TIER	SUCCESS BONUS	DURABILITY	CAN PICK
Basic	+0%	5 uses	Bronze only
Advanced	+15%	15 uses	Bronze & Silver
Master	+35%	30 uses	All Locks

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LOCKABLE BLOCKS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CATEGORY	BLOCKS
Storage	Chests, Trapped Chests, Double Chests, Barrels, Shulker Boxes (all colors)
Furnaces	Furnace, Blast Furnace, Smoker
Redstone	Hoppers, Droppers, Dispensers
Brewing	Brewing Stands
Doors	All Wood Doors, Iron Doors, All Trapdoors, Fence Gates

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

► PLAYER COMMANDS

Code:

/lock                    - Place a lock on the block you're looking at
/lock info               - View information about a lock
/lock remove             - Remove your lock from a block
/lock trust <player>     - Trust a player to access your lock
/lock untrust <player>   - Remove a player from your trust list
/lock trustlist          - List all trusted players for a lock

► ADMIN COMMANDS

Code:

/lock give <player> <tier> [amount]      - Give lock items to a player
/lock reload                              - Reload all configuration files
/lockpick give <player> <tier> [amount]  - Give lockpick items to a player

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

► BASIC PERMISSIONS

PERMISSION	DESCRIPTION	DEFAULT
`pinchoslocks.use`	Use basic lock features	true
`pinchoslocks.info`	View lock information	true
`pinchoslocks.trust`	Use trust commands	true

► TIER PERMISSIONS

PERMISSION	DESCRIPTION	DEFAULT
`pinchoslocks.tier.bronze`	Use Bronze locks	true
`pinchoslocks.tier.silver`	Use Silver locks	false
`pinchoslocks.tier.gold`	Use Gold locks	false

► LOCKPICK PERMISSIONS

PERMISSION	DESCRIPTION	DEFAULT
`pinchoslocks.lockpick.basic`	Use Basic lockpicks	true
`pinchoslocks.lockpick.advanced`	Use Advanced lockpicks	true
`pinchoslocks.lockpick.master`	Use Master lockpicks	true

► ADMIN PERMISSIONS

PERMISSION	DESCRIPTION	DEFAULT
`pinchoslocks.bypass`	Bypass all locks	op
`pinchoslocks.bypass.cooldown`	Bypass placement cooldowns	op
`pinchoslocks.admin`	Use admin commands	op

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFIGURATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

YAML:

# ══════════════════════════════════════════════════════════════════════════════
#                         PINCHOS LOCKS - CONFIGURATION
# ══════════════════════════════════════════════════════════════════════════════

general:
  # Language file to use (without .yml extension)
  # Available: en_EN, es_ES (or create your own!)
  language: "en_EN"

  # Enable debug mode for troubleshooting
  debug: false

  # Enable beautiful particle effects
  particles-enabled: true

  # Cooldown between lock placements (in seconds)
  lock-placement-cooldown: 1.0

# ─────────────────────────────────────────────────────────────────────────────
#                              LOCK TIERS
# ─────────────────────────────────────────────────────────────────────────────

tiers:
  bronze:
    enabled: true
    material: COPPER_INGOT      # Item material for the lock
    custom-model-data: 1001     # For resource packs
    difficulty: 25              # Picking difficulty (1-100)

  silver:
    enabled: true
    material: IRON_INGOT
    custom-model-data: 1002
    difficulty: 50

  gold:
    enabled: true
    material: GOLD_INGOT
    custom-model-data: 1003
    difficulty: 85

# ─────────────────────────────────────────────────────────────────────────────
#                            LOCKPICK TIERS
# ─────────────────────────────────────────────────────────────────────────────

lockpicks:
  basic:
    enabled: true
    material: IRON_NUGGET
    custom-model-data: 2001
    durability: 5               # Number of uses
    success-bonus: 0            # Added to success chance

  advanced:
    enabled: true
    material: IRON_INGOT
    custom-model-data: 2002
    durability: 15
    success-bonus: 15

  master:
    enabled: true
    material: DIAMOND
    custom-model-data: 2003
    durability: 30
    success-bonus: 35

# ─────────────────────────────────────────────────────────────────────────────
#                               SOUNDS
# ─────────────────────────────────────────────────────────────────────────────

sounds:
  lock-place: "BLOCK_IRON_DOOR_CLOSE"
  lock-remove: "BLOCK_IRON_DOOR_OPEN"
  lock-denied: "ENTITY_VILLAGER_NO"
  lock-success: "BLOCK_NOTE_BLOCK_CHIME"
  lockpick-start: "BLOCK_CHEST_LOCKED"
  lockpick-progress: "BLOCK_LEVER_CLICK"
  lockpick-success: "ENTITY_PLAYER_LEVELUP"
  lockpick-fail: "ENTITY_ITEM_BREAK"

YAML:

# ══════════════════════════════════════════════════════════════════════════════
#                    PINCHOS LOCKS - ENGLISH LANGUAGE FILE
# ══════════════════════════════════════════════════════════════════════════════
# Supports MiniMessage format: <red>, <green>, <gradient:red:blue>, <bold>, etc.

prefix: "<gold>[<yellow>Locks<gold>]</yellow></gold>"

# ─────────────────────────────────────────────────────────────────────────────
#                              LOCK MESSAGES
# ─────────────────────────────────────────────────────────────────────────────

lock:
  placed: "<green>Lock placed successfully! <gray>({tier})"
  removed: "<red>Lock removed."
  already-locked: "<red>This block is already locked!"
  not-locked: "<yellow>This block is not locked."
  access-denied: "<red>This container is locked!"
  access-granted: "<green>Access granted."
  not-owner: "<red>You don't own this lock!"
  cannot-lock: "<red>You cannot lock this type of block."

# ─────────────────────────────────────────────────────────────────────────────
#                             TRUST MESSAGES
# ─────────────────────────────────────────────────────────────────────────────

trust:
  added: "<green>Added <yellow>{player}</yellow> to trusted players."
  removed: "<red>Removed <yellow>{player}</yellow> from trusted players."
  already-trusted: "<yellow>{player}</yellow> is already trusted."
  not-trusted: "<yellow>{player}</yellow> is not trusted."
  list-header: "<gold>Trusted Players:"
  list-empty: "<gray>No trusted players."

# Add any messages you want - fully customizable!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TECHNICAL INFORMATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PROPERTY	VALUE
Plugin Version	1.0.0
API Version	1.21
Supported Minecraft Versions	1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4+
Supported Server Software	Paper, Spigot, Bukkit, Purpur, Pufferfish
Required Java Version	Java 21 or higher
Dependencies	None (standalone plugin)
Soft Dependencies	None
Programming Language	Kotlin 1.9.22
Data Storage	JSON (file-based, no database required)
File Size	~3.8 MB

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Step 1: Download the latest version of PinchosLocks-x.x.x-release.jar

Step 2: Place the JAR file in your server's plugins folder

Step 3: Restart your server (or use a plugin manager)

Step 4: Configure the plugin in plugins/PinchosLocks/

config.yml - Main configuration
lang/en_EN.yml - English messages
lang/es_ES.yml - Spanish messages

Step 5: Use /lock reload to apply any changes without restarting!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FAQ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Q: Does this plugin work with WorldGuard/GriefPrevention?
A: Yes! Pinchos Locks is designed to work alongside other protection plugins. It adds an extra layer of security on top of region-based protection.

Q: Can I change the items used for locks and lockpicks?
A: Absolutely! You can change the material, custom model data, name, and lore of every item in the configuration.

Q: What happens if a player is banned or leaves the server?
A: Locks remain in place. Admins with pinchoslocks.bypass permission can access any lock.

Q: Can I disable certain lock tiers?
A: Yes! Each tier can be enabled or disabled independently in the config.

Q: Is the data saved when the server restarts?
A: Yes! All lock data is stored in a JSON file and loaded automatically on startup.

Q: Can I add my own language?
A: Yes! Simply create a new YAML file in the lang folder (e.g., fr_FR.yml) and set it in config.yml.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Need help? Found a bug? Have a suggestion?

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TERMS OF USE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ You MAY use this plugin on any number of servers
✓ You MAY modify configuration and language files
✓ You MAY create and share resource packs for the plugin
✗ You may NOT redistribute, resell, or claim this plugin as your own
✗ You may NOT decompile, reverse engineer, or modify the plugin code

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Thank you for choosing Pinchos Locks!

If you enjoy the plugin, please leave a

rating and a review!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Latest reviews

SrAlbedoGG
5.00 star(s)
Mar 9, 2026
Version: v1.0.0

Even though it’s a basic plugin, it is very well designed. I really liked the particles; they are nicely made. There are one or two bugs, but it’s still very usable! I liked it a lot and I hope to see more updates.

Upvote 0 Downvote

Pincho's Locks v1.0.0

Overview Reviews (1) History

Latest reviews