<div align="center"> <h1>titanjails</h1> (https://img.shields.io/badge/Version-1.0.0-blue.svg)](#) (https://img.shields.io/badge/Platform-Spigot_|_Paper_|_Purpur-green.svg)](#) (https://img.shields.io/badge/Developer-Varnox-gold.svg)](#) *© 2026 Developed exclusively by **Varnox**. All rights reserved.* </div> --- <details> <summary>EN</summary> <div dir="ltr"> # ⛓ TitanJails – Global Iron Fist System **A professional Spigot/Paper jail plugin with hardcore enforcement.** > **Supports all modern versions (1.20+)** | Developed by **Varnox** | © 2026 --- ## 🌟 Detailed Features * 🌍 **Multi-Language Support** – Instantly switch between Arabic, English, French, and Spanish. * 🎒 **Full Inventory Vault** – Safely captures inventory, armor, offhand, XP, and exact location, restoring everything flawlessly upon release. * ⚖️ **Courtroom Trial Phase** – 60-second staging phase before final cell transfer for admin questioning. * 🔄 **Periodic Cell Rotation** – Automatically shuffles prisoners between valid cells to prevent teaming up or item dropping. * 💀 **Death Respawn Locks** – Prisoners respawn inside their cell upon death. No cheap escapes! * 🔗 **Smart Handcuffs** – Use `/jaillcuff` to tether a prisoner to an admin. * 📊 **Smart Load Balancing** – Distributes jailed players across cells evenly. * ⏱ **Online-Only Timers** – Offline players do not serve jail time. * 🔴 **BossBar UI** – Persistent red UI bar indicating remaining sentence length. * 🚫 **Total Lockdown** – No chatting, no commands (except `/appeal`), and no block breaking (triggers an alarm!). * 📱 **Discord Webhook** – Rich embeds sent directly to Discord for jail logic. * 🗺 **Movement Replay Logs** – Records the final 3 minutes of a player's movement before being jailed. * 💾 **Rock-Solid Persistence** – Unaffected by server crashes; data is fully state-saved to disk. --- ## 📋 Commands & Permissions | Command | Description | Permission | | :--- | :--- | :--- | | `/jail <player> <time_in_sec> <reason>` | Jail a player | `titanjails.jail` | | `/unjail <player>` | Release a prisoner | `titanjails.unjail` | | `/setjail cell <name>` | Set a cell location | `titanjails.setjail` | | `/setjail court` | Set trial room location | `titanjails.setjail` | | `/jaillcuff <player>` | Handcuff a player | `titanjails.jail` | | `/jailinfo <player>` | Check player jail history | `titanjails.jailinfo` | | `/jailbuild` | Auto-build a 20x20 cell | `titanjails.build` | | `/jailpanel` | Open GUI Control Panel | `titanjails.panel` | | `/appeal <message>` | Send an admin appeal | Prisoners only | | `/helpjaill` | View the help screen | Everyone | --- ## 🔌 Optional Dependencies **CRITICAL NOTE**: TitanJails is **100% Standalone**. It works flawlessly out of the box. Installing the plugins below only unlocks extra features: * **(https://modrinth.com/plugin/placeholderapi)**: Displays jail stats (time left, cell, reason) in custom scoreboards. * **()**: Spawns Warden NPCs outside cells. * **(https://modrinth.com/plugin/skinsrestorer)**: Forces prisoners to wear "inmate" skins. ### 📈 PlaceholderAPI Placeholders | Placeholder | Output Example | | :--- | :--- | | `%titanjails_jailed%` | `true` or `false` | | `%titanjails_time%` | `1h 30m 15s` | | `%titanjails_time_seconds%` | `5415` | | `%titanjails_reason%` | `Griefing Spawn` | | `%titanjails_admin%` | `Varnox` | | `%titanjails_cell%` | `cell_1` | </div> <br><br><br> <div dir="rtl"> --- </details> --- <details> <summary>AR</summary> # ⛓ TitanJails – نظام السجن الحديدي **إضافة احترافية لـ (Spigot/Paper) لنظام سجن متقدم ومحكم.** > **يدعم جميع الإصدارات الحديثة (1.20+)** | تطوير: **Varnox** | © 2026 --- ## 🌟 المميزات الرئيسية * 🌍 **دعم متعدد اللغات** – عربي، إنجليزي، فرنسي، إسباني (من الكونفق `config.yml`). * 🎒 **حفظ شامل للشنطة (Inventory Vault)** – سجن اللاعب يحفظ كل شيء (دروع، أوفهاند، XP، الموقع) ويستعيده بالكامل عند الخروج. * ⚖️ **قاعة المحاكمة** – فترة محاكمة 60 ثانية قبل دخول الزنزانة المخصصة للتحدث مع اللاعب. * 🔄 **التدوير الأمني للزنازين** – نقل تلقائي ودوري للسجناء بين الزنازين لمنع التآمر. * 💀 **العودة للسجن (Death Respawn)** – الموت لا يعني الهروب. اللاعب يرسبن في زنزانته إجبارياً. * 🔗 **أصفاد الاعتقال (Handcuffs)** – أمر `/jaillcuff` يقيد اللاعب ليتبع الأدمن. * 📊 **توزيع ذكي** – توجيه السجناء الجدد للزنزانة الأقل زحمة لتخفيف الضغط. * ⏱ **عدّاد أونلاين فقط** – وقت السجن يتوقف تلقائياً إذا خرج اللاعب من السيرفر. * 🔴 **شريط (BossBar)** – شريط أحمر ثابت يعرض الوقت المتبقي للسجين. * 🚫 **عزل وحظر كامل** – منع المحادثات، منع تكسير البلوكات (مع إنذار صوتي)، ومنع جميع الأوامر ما عدا الاستئناف. * 📱 **ربط مباشر بالديسكورد** – لوج كامل بجميع عمليات السجن والإفراج. * 🗺 **تسجيل الحركة (Replay Logging)** – تسجيل آخر 3 دقائق للمسجون لتسهيل المراجعات الإدارية. * 💾 **حفظ دائم** – استقرار كامل للبيانات حتى بعد إعادة تشغيل السيرفر. --- ## 📋 الأوامر | الأمر |