titanjails

⛓ 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:

PlaceholderAPI: Displays jail stats (time left, cell, reason) in custom scoreboards.
Citizens: Spawns Warden NPCs outside cells.
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`

⛓ TitanJails – نظام السجن الحديدي

إضافة احترافية لـ (Spigot/Paper) لنظام سجن متقدم ومحكم.

يدعم جميع الإصدارات الحديثة (1.20+) | تطوير: Varnox | © 2026

🌟 المميزات الرئيسية

🌍 دعم متعدد اللغات – عربي، إنجليزي، فرنسي، إسباني (من الكونفق config.yml).
🎒 حفظ شامل للشنطة (Inventory Vault) – سجن اللاعب يحفظ كل شيء (دروع، أوفهاند، XP، الموقع) ويستعيده بالكامل عند الخروج.
⚖️ قاعة المحاكمة – فترة محاكمة 60 ثانية قبل دخول الزنزانة المخصصة للتحدث مع اللاعب.
🔄 التدوير الأمني للزنازين – نقل تلقائي ودوري للسجناء بين الزنازين لمنع التآمر.
💀 العودة للسجن (Death Respawn) – الموت لا يعني الهروب. اللاعب يرسبن في زنزانته إجبارياً.
🔗 أصفاد الاعتقال (Handcuffs) – أمر /jaillcuff يقيد اللاعب ليتبع الأدمن.
📊 توزيع ذكي – توجيه السجناء الجدد للزنزانة الأقل زحمة لتخفيف الضغط.
⏱ عدّاد أونلاين فقط – وقت السجن يتوقف تلقائياً إذا خرج اللاعب من السيرفر.
🔴 شريط (BossBar) – شريط أحمر ثابت يعرض الوقت المتبقي للسجين.
🚫 عزل وحظر كامل – منع المحادثات، منع تكسير البلوكات (مع إنذار صوتي)، ومنع جميع الأوامر ما عدا الاستئناف.
📱 ربط مباشر بالديسكورد – لوج كامل بجميع عمليات السجن والإفراج.
🗺 تسجيل الحركة (Replay Logging) – تسجيل آخر 3 دقائق للمسجون لتسهيل المراجعات الإدارية.
💾 حفظ دائم – استقرار كامل للبيانات حتى بعد إعادة تشغيل السيرفر.

📋 الأوامر

الأمر	الوصف	الصلاحية المطلوبة
`/jail <لاعب> <المدة بالثواني> <السبب>`	سجن لاعب	`titanjails.jail`
`/unjail <لاعب>`	إفراج عن لاعب واستعادة ممتلكاته	`titanjails.unjail`
`/setjail cell <اسم>`	إنشاء زنزانة جديدة في موقعك	`titanjails.setjail`
`/setjail court`	تحديد مكان قاعة المحكمة	`titanjails.setjail`
`/jaillcuff <لاعب>`	تقييد/فك أصفاد لاعب	`titanjails.jail`
`/jailinfo <لاعب>`	فحص تاريخ اللاعب في السجن	`titanjails.jailinfo`
`/jailbuild`	بناء زنزانة عملاقة 20x20 تلقائياً	`titanjails.build`
`/jailpanel`	فتح لوحة التحكم (GUI) لإدارة المسجونين	`titanjails.panel`
`/appeal <رسالة>`	رفع طلب استئناف	متاح للسجناء
`/helpjaill`	قائمة أوامر السجن	للجميع

🔌 الإضافات الاختيارية (Soft-Depends)

ملاحظة هامة: الإضافة تعمل 100% بمفردها. الإضافات التالية لفتح ميزات إضافية فقط:

PlaceholderAPI: لربط متغيرات البلقن بلوحات الـ Scoreboard والـ TAB.
Citizens: ينشئ (NPC) حارس للزنزانة مع تفاصيل السجين وزر استئناف.
SkinsRestorer: إمكانية تغيير سكن السجين إلى "سكن سجن" موحد.

📈 متغيرات PlaceholderAPI

المتغير (Placeholder)	النتيجة (Output)
`%titanjails_jailed%`	`true` أو `false`
`%titanjails_time%`	الوقت المتبقي المنسق (مثال: `1س 30د 15ث`)
`%titanjails_time_seconds%`	الثواني المتبقية الصافية
`%titanjails_reason%`	سبب السجن المدخل
`%titanjails_admin%`	الأدمن الذي قام بالسجن
`%titanjails_cell%`	اسم الزنزانة الحالية

🏗 جاهز للتشغيل

لا يتطلب سوى وضع ملف الـ jar في مجلد الـ plugins وتسجيل الزنازين أمر /setjail cell.

© 2026 | Created by Varnox

⛓ TitanJails – Système de Prison de Fer

Une extension professionnelle pour (Spigot/Paper) pour un système de prison avancé et sécurisé.

Supporte toutes les versions modernes (1.20+) | Développé par : Varnox | © 2026

🌟 Caractéristiques Principales

🌍 Support Multilingue – Arabe, Anglais, Français, Espagnol (via config.yml).
🎒 Coffre d'Inventaire Complet (Inventory Vault) – Emprisonner un joueur sauvegarde tout (armure, offhand, XP, position) et le restaure totalement à la libération.
⚖️ Salle d'Audience – Une période de procès de 60 secondes avant l'entrée en cellule pour discuter avec le joueur.
🔄 Rotation Sécurisée des Cellules – Transfert automatique et périodique des prisonniers entre les cellules pour éviter les complots.
💀 Réapparition en Prison (Death Respawn) – La mort ne signifie pas l'évasion. Le joueur réapparaît obligatoirement dans sa cellule.
🔗 Menottes de Détention (Handcuffs) – La commande /jaillcuff restreint le joueur pour qu'il suive l'administrateur.
📊 Distribution Intelligente – Dirige les nouveaux prisonniers vers la cellule la moins peuplée pour équilibrer la charge.
⏱ Compteur Temps En Ligne Uniquement – Le temps de prison s'arrête automatiquement si le joueur quitte le serveur.
🔴 Barre de Boss (BossBar) – Une barre rouge fixe affichant le temps restant au prisonnier.
🚫 Isolement et Restriction Totale – Blocage du chat, interdiction de casser des blocs (avec alerte sonore), et blocage de toutes les commandes sauf l'appel.
📱 Liaison Directe Discord – Journal complet (Log) de toutes les opérations d'emprisonnement et de libération.
🗺 Enregistrement des Mouvements (Replay Logging) – Enregistre les 3 dernières minutes du prisonnier pour faciliter les révisions administratives.
💾 Sauvegarde Permanente – Stabilité totale des données même après le redémarrage du serveur.

📋 Commandes

Commande	Description	Permission Requise
`/jail <joueur> <durée_sec> <raison>`	Emprisonner un joueur	`titanjails.jail`
`/unjail <joueur>`	Libérer un joueur et restaurer ses biens	`titanjails.unjail`
`/setjail cell <nom>`	Créer une nouvelle cellule à votre position	`titanjails.setjail`
`/setjail court`	Définir l'emplacement de la salle d'audience	`titanjails.setjail`
`/jaillcuff <joueur>`	Menotter/Libérer un joueur	`titanjails.jail`
`/jailinfo <joueur>`	Examiner l'historique de prison du joueur	`titanjails.jailinfo`
`/jailbuild`	Construire automatiquement une cellule géante 20x20	`titanjails.build`
`/jailpanel`	Ouvrir le panneau de contrôle (GUI) de gestion	`titanjails.panel`
`/appeal <message>`	Envoyer une demande d'appel	Disponible pour les prisonniers
`/helpjaill`	Liste des commandes de prison	Pour tous

🔌 Extensions Optionnelles (Soft-Depends)

Note Importante : L'extension fonctionne 100% seule. Les extensions suivantes débloquent uniquement des fonctionnalités supplémentaires :

[PlaceholderAPI]: Pour lier les variables du plugin au Scoreboard et au TAB.
[Citizens]: Crée un garde (NPC) avec les détails du prisonnier et un bouton d'appel.
[SkinsRestorer]: Possibilité de changer le skin du prisonnier en "Uniforme de Prison".

📈 Variables PlaceholderAPI

Variable (Placeholder)	Résultat (Output)
`%titanjails_jailed%`	`true` (vrai) ou `false` (faux)
`%titanjails_time%`	Temps restant formaté (ex: `1h 30m 15s`)
`%titanjails_time_seconds%`	Secondes restantes nettes
`%titanjails_reason%`	Raison de l'emprisonnement saisie
`%titanjails_admin%`	L'administrateur qui a effectué l'emprisonnement
`%titanjails_cell%`	Nom de la cellule actuelle

🏗 Prêt à l'emploi

Il suffit de placer le fichier jar dans le dossier plugins et d'enregistrer les cellules avec la commande /setjail cell.

© 2026 | Créé par Varnox

⛓ TitanJails – Sistema de Prisión de Hierro

Un complemento profesional para (Spigot/Paper) para un sistema de prisión avanzado y seguro.

Soporta todas las versiones modernas (1.20+) | Desarrollado por: Varnox | © 2026

🌟 Características Principales

🌍 Soporte Multilingüe – Árabe, Inglés, Francés, Español (desde config.yml).
🎒 Bóveda de Inventario Completa (Inventory Vault) – Encarcelar a un jugador guarda todo (armadura, mano secundaria, XP, ubicación) y lo restaura por completo al salir.
⚖️ Sala de Juicio – Un periodo de juicio de 60 segundos antes de entrar a la celda para hablar con el jugador.
🔄 Rotación de Seguridad – Traslado automático y periódico de prisioneros entre celdas para evitar conspiraciones.
💀 Reaparición en Prisión (Death Respawn) – La muerte no significa escape. El jugador reaparece obligatoriamente en su celda.
🔗 Esposas de Detención (Handcuffs) – El comando /jaillcuff restringe al jugador para que siga al administrador.
📊 Distribución Inteligente – Dirige a los nuevos prisioneros a la celda menos concurrida para equilibrar la carga.
⏱ Contador Solo Online – El tiempo de prisión se detiene automáticamente si el jugador sale del servidor.
🔴 Barra de Jefe (BossBar) – Una barra roja fija que muestra el tiempo restante del prisionero.
🚫 Aislamiento y Bloqueo Total – Bloqueo de chat, prohibición de romper bloques (con alerta sonora), y bloqueo de todos los comandos excepto la apelación.
📱 Vinculación Directa con Discord – Registro completo (Log) de todas las operaciones de encarcelamiento y liberación.
🗺 Registro de Movimiento (Replay Logging) – Graba los últimos 3 minutos del prisionero para facilitar las revisiones administrativas.
💾 Guardado Permanente – Estabilidad total de los datos incluso después de reiniciar el servidor.

📋 Comandos

Comando	Descripción	Permiso Requerido
`/jail <jugador> <tiempo_seg> <razón>`	Encarcelar a un jugador	`titanjails.jail`
`/unjail <jugador>`	Liberar a un jugador y restaurar sus pertenencias	`titanjails.unjail`
`/setjail cell <nombre>`	Crear una nueva celda en tu ubicación	`titanjails.setjail`
`/setjail court`	Definir la ubicación de la sala de juicio	`titanjails.setjail`
`/jaillcuff <jugador>`	Esposar/Desesposar a un jugador	`titanjails.jail`
`/jailinfo <jugador>`	Consultar el historial del jugador en prisión	`titanjails.jailinfo`
`/jailbuild`	Construir automáticamente una celda gigante 20x20	`titanjails.build`
`/jailpanel`	Abrir el panel de control (GUI) de gestión	`titanjails.panel`
`/appeal <mensaje>`	Enviar una solicitud de apelación	Disponible para prisioneros
`/helpjaill`	Lista de comandos de prisión	Para todos

🔌 Extensiones Opcionales (Soft-Depends)

Nota Importante: El complemento funciona 100% por sí solo. Las siguientes extensiones solo desbloquean funciones adicionales:

[PlaceholderAPI]: Para vincular variables al Scoreboard y al TAB.
[Citizens]: Crea un guardia (NPC) con detalles del prisionero y botón de apelación.
[SkinsRestorer]: Posibilidad de cambiar la skin del prisionero a un "Uniforme de Prisión".

📈 Variables de PlaceholderAPI

Variable (Placeholder)	Resultado (Output)
`%titanjails_jailed%`	`true` (verdadero) o `false` (falso)
`%titanjails_time%`	Tiempo restante formateado (ej: `1h 30m 15s`)
`%titanjails_time_seconds%`	Segundos restantes netos
`%titanjails_reason%`	Razón del encarcelamiento ingresada
`%titanjails_admin%`	El administrador que realizó el encarcelamiento
`%titanjails_cell%`	Nombre de la celda actual

🏗 Listo para funcionar

Solo requiere colocar el archivo jar en la carpeta plugins y registrar las celdas con el comando /setjail cell.

© 2026 | Creado por Varnox

TitanJails