🛡️ 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)

💻 Commands

👤 Player Commands (/pchests)

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

📖 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 2–4: player names, team:TeamName, or [trusted] 👥
5. Done! The container is now locked to you. 🎉

🏷️ Sign Modifiers

⚙️ 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