Lock your chests with a PIN code – entered as a pattern on a 3×3 grid, right in-game.

How it works

Stand in front of a chest and type /chpin. A 3×3 grid opens with the numbers 1 to 9. Click your combination in whatever order you like – done, the chest is locked.

When someone else opens the chest, the same grid appears. Without the right sequence, the contents stay out of reach.

Why a grid instead of chat?

Because you click the PIN instead of typing it. Nobody can read it from the chat log, and a pattern is easier to remember than a string of digits.

Features

• PIN protection for chests, trapped chests and barrels via click input
• 3×3 interface, no chat entry required
• Both halves of a double chest are always locked together
• Protection can be removed at any time
• Three wrong tries and the chest goes quiet for 30 seconds
• PINs are salted and hashed – chests.yml never contains the digits themselves
• English and German messages, switchable in the config
• Runs on Paper 1.20 through 26.2

Commands

Command	Description
/chpin	Locks the chest you're looking at with a PIN
/chpin remove	Removes the protection
/chpin info	Shows who the protection belongs to
/chpin reload	Reloads the config and language files

Permissions

Permission	Default	Description
chestpin.use	everyone	Lock and unlock your own containers
chestpin.bypass	op	Open and break protected containers without the PIN
chestpin.admin	op	Access to /chpin reload

Installation

1. Drop ChestPin-1.0.0.jar into your server's plugins/ folder.
2. Start the server once. config.yml and lang/ appear under plugins/ChestPin/.
3. For German messages set language: de and run /chpin reload.

Configuration

Key	Default	Description
language	en	Which file from lang/ to use
pin-length	4	Number of clicks that make up a PIN (3–9)
require-confirmation	true	Ask for a new PIN twice before storing it
owner-bypass	true	The owner opens their own chest without typing the PIN
protect-against-breaking	true	Stop other players from mining a protected container
prevent-double-chest-merge	true	Stop a chest being placed against a protected one
max-attempts	3	Wrong tries before the lockout starts
lockout-seconds	30	How long that lockout lasts
sounds	true	Click and feedback sounds in the grid
containers	chest, trapped chest, barrel	Which blocks /chpin accepts

Note

ChestPin prevents other players from opening the chest. It is not a replacement for a full claim plugin – hoppers, redstone and explosions are not affected. A protected chest still blows up, and its contents still drop.

Two things it does block, because the PIN would be pointless otherwise:

• breaking a protected container
• placing a chest against a protected one to merge the two into a double chest

The stored hash is not the real defence. Four clicks out of nine is 6561 combinations, which no hash survives offline. What actually protects the chest is the attempt limit – the hash only means that someone reading chests.yml still cannot walk up and type the PIN in.

Soon

• Explosion protection – right now TNT and creepers open a protected chest
• Hopper and dropper protection – right now items can be pulled out from below
• Redstone protection for trapped chests
• Sharing a chest with other players instead of handing the PIN around
• Per-player PINs rather than one PIN per chest

Deutsch

Schütze deine Kisten mit einer PIN – eingegeben als Muster auf einem 3×3-Raster, direkt im Spiel.

So funktioniert's

Stell dich vor eine Kiste und tippe /chpin. Es öffnet sich ein 3×3-Raster mit den Zahlen 1 bis 9. Klick deine Kombination in beliebiger Reihenfolge – fertig, die Kiste ist verschlossen.

Wenn jemand anderes die Kiste öffnet, erscheint dasselbe Raster. Ohne die richtige Reihenfolge bleibt der Inhalt unerreichbar.

Warum ein Raster statt Chat?

Weil du die PIN klickst, statt sie zu tippen. Niemand kann sie im Chatverlauf mitlesen, und ein Muster merkt man sich leichter als eine Ziffernfolge.

Funktionen

• PIN-Schutz für Kisten, Redstone-Kisten und Fässer per Klick-Eingabe
• 3×3-Oberfläche, keine Eingabe im Chat nötig
• Beide Hälften einer Doppelkiste werden immer gemeinsam verschlossen
• Der Schutz lässt sich jederzeit wieder entfernen
• Nach drei Fehlversuchen bleibt die Kiste 30 Sekunden lang stumm
• PINs werden gesalzen und gehasht – in der chests.yml stehen nie die Ziffern selbst
• Deutsche und englische Texte, umschaltbar in der Konfiguration
• Läuft auf Paper 1.20 bis 26.2

Befehle

Befehl	Beschreibung
/chpin	Verschließt die Kiste, die du gerade ansiehst, mit einer PIN
/chpin remove	Entfernt den Schutz
/chpin info	Zeigt, wem der Schutz gehört
/chpin reload	Lädt Konfiguration und Sprachdateien neu

Berechtigungen

Berechtigung	Standard	Beschreibung
chestpin.use	alle	Eigene Behälter ver- und entschließen
chestpin.bypass	op	Geschützte Behälter ohne PIN öffnen und abbauen
chestpin.admin	op	Zugriff auf /chpin reload

Installation

1. Leg ChestPin-1.0.0.jar in den Ordner plugins/ deines Servers.
2. Starte den Server einmal. Unter plugins/ChestPin/ erscheinen config.yml und lang/.
3. Für deutsche Texte language: de setzen und /chpin reload ausführen.

Konfiguration

Schlüssel	Standard	Beschreibung
language	en	Welche Datei aus lang/ benutzt wird
pin-length	4	Aus wie vielen Klicks eine PIN besteht (3–9)
require-confirmation	true	Neue PIN zur Sicherheit zweimal abfragen
owner-bypass	true	Der Besitzer öffnet seine Kiste ohne PIN-Eingabe
protect-against-breaking	true	Verhindert, dass andere den Behälter abbauen
prevent-double-chest-merge	true	Verhindert, dass eine Kiste an eine geschützte gesetzt wird
max-attempts	3	Fehlversuche, bis die Sperre greift
lockout-seconds	30	Wie lange diese Sperre dauert
sounds	true	Klick- und Rückmeldungsgeräusche im Raster
containers	Kiste, Redstone-Kiste, Fass	Welche Blöcke /chpin akzeptiert

Hinweis

ChestPin verhindert, dass andere Spieler die Kiste öffnen. Es ersetzt kein vollwertiges Claim-Plugin – Trichter, Redstone und Explosionen bleiben davon unberührt. Eine geschützte Kiste fliegt weiterhin in die Luft, und ihr Inhalt fällt heraus.

Zwei Dinge unterbindet es trotzdem, weil die PIN sonst sinnlos wäre:

• das Abbauen eines geschützten Behälters
• das Setzen einer Kiste an eine geschützte, um beide zu einer Doppelkiste zu verbinden

Der gespeicherte Hash ist nicht der eigentliche Schutz. Vier Klicks aus neun ergeben 6561 Kombinationen – das übersteht kein Hash, wenn jemand ihn offline durchprobiert. Was die Kiste wirklich schützt, ist die Begrenzung der Fehlversuche. Der Hash sorgt nur dafür, dass jemand, der die chests.yml liest, nicht einfach hingehen und die PIN eintippen kann.

Demnächst

• Schutz vor Explosionen – aktuell öffnen TNT und Creeper eine geschützte Kiste
• Schutz vor Trichtern und Droppern – aktuell lassen sich Gegenstände von unten herausziehen
• Redstone-Schutz für Redstone-Kisten
• Kisten mit anderen Spielern teilen, statt die PIN herumzureichen
• PINs pro Spieler statt einer PIN pro Kiste