VaultLock

VaultLock

Container locking for Minecraft Paper servers, simple and reliable.

🇬🇧 English

VaultLock is a Minecraft Paper plugin that protects your chests and other containers from theft, with no complex configuration: one click, and it's locked.

Features

• GUI-based locking: Shift + right-click on a container opens a small management menu (lock / unlock), no commands needed for everyday use (see gallery photo #1).
• Single ownership: once locked, only you (and admins if needed) can access the container (see gallery photos #4 and #5).
• Trusted players (26.2.x only): grant specific players access to a locked container without making them owner, via an in-game menu — type the username directly in chat, no need to remember a command (see gallery photo #6).
• Supported containers: single and double chests, trapped chests, furnaces, shulker boxes, hoppers, dispensers, droppers — plus barrels, blast furnaces, smokers, and copper chests on 26.2.x (these blocks don't exist on 1.12.x). Copper chests are supported across all 4 oxidation stages and their waxed variants, and double copper chests are handled just like double wooden chests.
• Break protection: nobody but you can break a locked container.
• Piston protection (26.2.x only): a locked container cannot be pushed or pulled by a piston, not even by its owner.
• Anti-piping protection: an unlocked hopper cannot drain a locked container, even your own — lock your hoppers too so your auto-sorting keeps working.
• Explosion resistant: TNT and creepers won't damage a locked container.
• Shulker box: the lock follows the shulker box even when picked back up as an item.
• Auto-lock on placement (26.2.x only): optional per-player setting — toggle it on and every container you place gets locked to you automatically.
• Placement hint: players are reminded that a container can be locked each time they place an unprotected one.
• Hologram (26.2.x only): show a floating text above a locked container, per-container toggle, fully custom message (type it in chat, with {owner} and {type} placeholders). Off by default until a text is set. Not available on shulker boxes.
• Ownership transfer (26.2.x only): give a container away to another player — type their username in chat, then confirm. The previous owner automatically becomes a trusted player.
• Per-player limits (26.2.x only): configurable caps on locked containers (200 by default) and active holograms (20 by default) per player — set to 0 for unlimited — ignored by admins with vaultlock.admin.bypass.
• Automatic cleanup: a container whose owner hasn't played in a long time (90 days by default, configurable) unlocks itself silently.
• Periodic update check: VaultLock checks Modrinth regularly (interval configurable) and shows a status line on the credits icon — red if an update is available, green once confirmed up to date (see gallery photo #7).
• Multilingual: 12 languages on 1.12.x, 30 languages on 26.2.x (see table below). The management menu's info icon also shows the container's type and owner status at a glance, whether it's free (see gallery photo #2) or already locked (see gallery photo #3).

Languages

1.12.x line (12 languages)

26.2.x line (30 languages — all of the above, plus:)

The language is set globally by the server admin (no per-player detection), with automatic fallback to English if a text is missing.

Commands

• /vaultlock setlang <code> — changes the server language (permission vaultlock.admin.bypass)
  • 1.12.x codes: fr, en, es, pt-br, pt-pt, fr-ca, de, it, nl, sv, nb, fi
  • 26.2.x: see the full 30-code list on this page
• /vaultlock autolock <on|off> — toggles auto-lock on placement for yourself (26.2.x only)

Permissions

• vaultlock.use — lock/unlock your own containers (all players by default)
• vaultlock.admin.bypass — open/break any locked container, change the language (OP by default)

Installation

1. Download the .jar matching your Minecraft version
2. Drop it into your server's plugins folder
3. Restart the server

Compatibility

Paper (Spigot/Purpur compatible) on both lines.

Statistics

This plugin uses bStats to collect anonymous usage statistics. You can disable it globally in plugins/bStats/config.yml.

On the 26.2.x line, VaultLock also uses FastStats in parallel (never as a replacement) for error tracking. You can opt out in plugins/faststats/config.properties (enabled=false).

🇫🇷 Français

VaultLock est un plugin Minecraft Paper qui protège tes coffres et autres conteneurs contre le vol, sans configuration complexe : un clic, et c'est verrouillé.

Fonctionnalités

• Verrouillage par GUI : Shift + clic droit sur un conteneur ouvre un petit menu de gestion (verrouiller / déverrouiller), aucune commande à retenir pour l'usage courant (voir photo n°1 de la galerie).
• Propriétaire unique : une fois verrouillé, seul toi (et les admins si besoin) peux accéder au conteneur (voir photos n°4 et n°5 de la galerie).
• Joueurs de confiance (26.2.x uniquement) : donne accès à un conteneur verrouillé à des joueurs précis sans en faire des propriétaires, via un menu en jeu — le pseudo se tape directement dans le tchat, aucune commande à retenir (voir photo n°6 de la galerie).
• Conteneurs supportés : coffres simples et doubles, coffres piégés, fours, shulker box, hoppers, dispensers, droppers — plus barils, hauts-fourneaux, fumoirs et coffres en cuivre sur la 26.2.x (ces blocs n'existent pas en 1.12.x). Les coffres en cuivre sont pris en charge sur leurs 4 stades d'oxydation et leurs variantes cirées, et les coffres en cuivre doubles sont gérés comme les coffres en bois doubles.
• Protection contre le cassage : personne d'autre que toi ne peut casser un conteneur verrouillé.
• Protection contre les pistons (26.2.x uniquement) : un conteneur verrouillé ne peut pas être poussé ou tiré par un piston, même par son propriétaire.
• Protection anti-tuyauterie : un hopper non verrouillé ne peut pas vider un conteneur verrouillé, même si c'est le tien — verrouille aussi tes hoppers pour que ton auto-tri continue de fonctionner.
• Résistant aux explosions : TNT et creepers n'endommagent pas un conteneur verrouillé.
• Shulker box : le verrouillage suit la shulker box même reprise en item dans l'inventaire.
• Verrouillage automatique au placement (26.2.x uniquement) : réglage optionnel par joueur — active-le et chaque conteneur que tu poses se verrouille automatiquement à ton nom.
• Astuce au placement : les joueurs sont rappelés qu'un conteneur peut être protégé à chaque fois qu'ils en posent un non verrouillé.
• Hologramme (26.2.x uniquement) : affiche un texte flottant au-dessus d'un conteneur verrouillé, activable/désactivable par conteneur, message entièrement personnalisable (à taper dans le tchat, avec les variables {owner} et {type}). Désactivé par défaut tant qu'aucun texte n'est défini. Non disponible sur les shulker box.
• Transfert de propriété (26.2.x uniquement) : cède un conteneur à un autre joueur — tape son pseudo dans le tchat, puis confirme. L'ancien propriétaire devient automatiquement joueur de confiance.
• Limites par joueur (26.2.x uniquement) : plafonds configurables sur les conteneurs verrouillés (200 par défaut) et les hologrammes actifs (20 par défaut) par joueur — mets 0 pour illimité — ignorés par les admins avec vaultlock.admin.bypass.
• Nettoyage automatique : un conteneur dont le propriétaire n'a pas joué depuis longtemps (90 jours par défaut, configurable) se déverrouille tout seul, silencieusement.
• Vérification périodique des mises à jour : VaultLock vérifie Modrinth régulièrement (intervalle configurable) et affiche une ligne d'état sur l'icône de crédits — rouge si une mise à jour est disponible, verte une fois confirmé à jour (voir photo n°7 de la galerie).
• Multilingue : 12 langues sur la 1.12.x, 30 langues sur la 26.2.x (voir tableau ci-dessous). L'icône d'info du menu de gestion affiche aussi le type et le statut du conteneur en un coup d'œil, qu'il soit libre (voir photo n°2 de la galerie) ou déjà verrouillé (voir photo n°3 de la galerie).

Langues

Ligne 1.12.x (12 langues)

Ligne 26.2.x (30 langues — toutes les précédentes, plus :)

La langue est réglée globalement par l'administrateur du serveur (pas de détection automatique par joueur), avec un repli automatique sur l'anglais si un texte venait à manquer.

Commandes

• /vaultlock setlang <code> — change la langue du serveur (permission vaultlock.admin.bypass)
  • Codes 1.12.x : fr, en, es, pt-br, pt-pt, fr-ca, de, it, nl, sv, nb, fi
  • 26.2.x : voir la liste complète des 30 codes sur cette page
• /vaultlock autolock <on|off> — active/désactive le verrouillage automatique au placement pour toi-même (26.2.x uniquement)

Permissions

• vaultlock.use — verrouiller/déverrouiller ses propres conteneurs (tous les joueurs par défaut)
• vaultlock.admin.bypass — ouvrir/casser n'importe quel conteneur verrouillé, changer la langue (OP par défaut)

Installation

1. Télécharge le .jar correspondant à ta version de Minecraft
2. Dépose-le dans le dossier plugins de ton serveur
3. Redémarre le serveur

Compatibilité

Paper (compatible Spigot/Purpur) sur les deux lignes.

Statistiques

Ce plugin utilise bStats pour collecter des statistiques d'utilisation anonymes. Vous pouvez le désactiver globalement dans plugins/bStats/config.yml.

Sur la ligne 26.2.x, VaultLock utilise aussi FastStats en parallèle (jamais en remplacement) pour le suivi d'erreurs. Vous pouvez le désactiver dans plugins/faststats/config.properties (enabled=false).