ChestPin

ChestPin

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

34 downloads 1 followers

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
Version Minecraft Loader Download

ChestPin 1.0.0

1.0.0

1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
paper
Download