Viper Private Chests

Server-side container protection for Minecraft Fabric protects chests, barrels, shulkers, and more using vanilla signs. Zero client-side mods required. Works with Geyser/Floodgate Bedrock players.

---

Features

• Sign-Based Locking Place a [private] or [public] sign on any container to instantly secure it
• Multi-Player Access Add player names, comma-separated lists, or team:TeamName on sign lines
• Global Trust System /pchests trust add <player> evaluated via [trusted] sign marker
• Public Sub-Modes [deposit] (drop-only) and [display] (read-only) variants
• Hopper Safety Prevents unauthorized hoppers from extracting/injecting items
• Explosion Protection Locked containers are immune to TNT, creepers, and withers
• Auto-Lock Mode /pchests autolock auto-places lock signs on container placement
• Redstone Automation [redstone] and [hopper] sign modifiers for technical players
• Intruder Alarm Failed access attempts emit a 1-tick redstone pulse
• Admin GUI /private_chests list opens an interactive virtual chest GUI
• Inspection Tool Right-click with a feather (configurable) to view lock info + audit history
• Claim Decay Automatically unlocks containers after owner inactivity (configurable)

Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials

---

Commands

Player Commands (/pchests)

Command	Description
/pchests trust add <player>	Add a player to your global trusted list
/pchests trust remove <player>	Remove a player from your trusted list
/pchests trust list	View your trusted friends
/pchests autolock	Toggle auto-lock mode

Admin Commands (/private_chests) [OP Level 3+]

Command	Description
/private_chests list [private/public]	Open interactive admin GUI showing all protected containers
/private_chests list_in_area <radius> [private/public]	List locks within a radius
/private_chests info <x> <y> <z>	View lock details + 25-entry audit log
/private_chests unlock <x> <y> <z>	Force-remove a lock
/private_chests cleanup	Purge stale/orphaned lock records

---

How To Use

Locking a Container

1. Place a container (chest, barrel, shulker box, etc.)
2. Place a wall sign on the container
3. Write [private] on line 1
4. (Optional) Lines 24: player names, team:TeamName, or [trusted]
5. Done! The container is now locked to you.

Sign Modifiers

Line Content	Effect
[private]	Standard private lock (only you + whitelisted players)
[public]	Open to everyone
[deposit]	Public drop-box (insert only)
[display]	Public read-only showcase
[trusted]	Check global /pchests trust list for access
[redstone]	Allow comparators to read inventory
[hopper]	Allow hopper interaction
team:<name>	Allow all members of a scoreboard team

---

Configuration

File: config/private-chests.json

{
  "floodgatePrefix": ".",
  "adminPermissionLevel": 3,
  "maxLocksPerPlayer": 0,
  "listMaxEntries": 50,
  "listPreviewEntries": 20,
  "disableProtectionIfOwnerBanned": true,
  "enableClaimDecay": true,
  "daysBeforeClaimDecay": 30,
  "inspectionItem": "minecraft:feather",
  "enableSoundFeedback": true,
  "enableActionBarAlerts": true,
  "maxHistoryLogEntries": 25,
  "allowIntruderRedstonePulse": true
}

---

Installation

1. Install Fabric Loader 0.19.3+ and Fabric API
2. Download the jar for your Minecraft version
3. Place in your mods/ folder
4. Restart the server

Compatible with Geyser/Floodgate Bedrock players are fully supported without any client-side mods.

---

Supported Versions

Minecraft	Branch	Java
1.21-1.21.11	viper-private-chests-1.21.x	21+
26.1-26.1.2	viper-private-chests-26.1.x	25+
26.2	viper-private-chests-26.2.x	25+