🔐 NiroxyLocker

NiroxyLocker est un plugin avancé de lockers sécurisés (coffres-forts) pour Nova-Life, pensé pour créer de vrais points de retrait RP gérés par une entreprise (livraison / logistique).
Chaque locker est protégé par code, monétisé, et surtout contrôlé côté serveur pour éviter les abus.

👉 Le concept : un livreur configure le locker (prix + code + contenu), puis les joueurs paient pour y accéder pendant un temps limité.

🎯 Objectif

Créer un système de lockers RP réaliste :

📦 retrait de colis / matériel / commandes
💳 paiement obligatoire (cash ou banque)
🔐 accès par code
⏱️ accès temporaire, puis verrouillage définitif
🏢 configuration réservée à une entreprise (BizId)

Sans spam chat, sans commandes complexes, 100% via panels.

✨ Fonctionnalités principales

🔒 Lockers sécurisés par code

🔢 Code numérique 4 à 8 chiffres
🛡️ Vérification côté serveur
🙈 Saisie masquée (mode mot de passe)
✅ Locker utilisable uniquement si configuré

💰 Paiement avant accès

💵 Paiement en espèces
🏦 Paiement en banque
🚫 Refus automatique si fonds insuffisants
💳 Montant précis (arrondi propre)

⏱️ Accès temporaire + verrouillage automatique

✅ Après paiement, le joueur obtient un droit d’accès temporaire
⏳ Accès pendant X secondes (configurable)
🔒 Une fois le délai expiré :
- le locker devient verrouillé
- le contenu devient non récupérable (jusqu’à reconfiguration)

🏢 Gestion “entreprise livraison” (BizId)

Le plugin ne s’active que sur le terrain de l’entreprise configurée.

📌 Seuls les livreurs en service (métier + permissions) peuvent :

💰 définir le prix
🔐 définir / modifier le code
📦 ouvrir le coffre pour ajouter du contenu
🔄 réinitialiser le locker (bloque l’accès client)

👮 Bypass staff sécurisé

Les admins (service admin + AdminLevel requis) peuvent :

ouvrir directement le locker
bypass l’accès code/paiement
assurer la modération ou le support RP

🧭 Comment fonctionne le plugin ?

👤 Côté joueur

1️⃣ Le joueur interagit avec un coffre (itemId 1044)
2️⃣ Le plugin vérifie si c’est un locker autorisé (terrain BizId)
3️⃣ Si locker dispo → panel “code”
4️⃣ Code correct → panel “paiement”
5️⃣ Paiement accepté → ouverture du locker
6️⃣ Après X secondes → locker verrouillé automatiquement

🚚 Côté livreur (entreprise)

1️⃣ Le livreur interagit avec le coffre
2️⃣ Il obtient un panel “Livreur”
3️⃣ Il configure :

le prix
le code
le contenu
4️⃣ Il peut réinitialiser le locker si besoin

🔥 Anti-usage simultané

Un locker ne peut être utilisé que par une seule personne à la fois
Si un joueur a déjà un accès actif :
- ✅ lui seul peut rouvrir
- ❌ les autres voient un message “en cours d’utilisation”

🧩 Configuration intégrée (en jeu)

Aucune config fichier : tout se fait via panel.

✅ Commande

/niroxylockerconfig

⚙️ Options configurables

🔐 AdminLevel (accès panel + override staff)
🏷️ Title (titre panels)
⌨️ ConfigCommand (commande configurable)
🏢 DeliveryBizId (entreprise qui gère les lockers)
⏱️ AccessSeconds (durée accès après paiement)
🎯 PositionPrecision
- ex : 100 = précision centimètre
- plus c’est haut, plus l’identifiant est strict

🧱 Stockage & persistance

Tout est stocké en base SQLite (ORM) :

📌 NiroxyLockerConfig

AdminLevel
Title
ConfigCommand
DeliveryBizId
AccessSeconds
PositionPrecision

📌 NiroxyLockerChest

AreaId
Rx/Ry/Rz (position quantifiée)
IsConfigured / IsLocked
Price
Code

✅ Les lockers restent configurés après redémarrage serveur.

🔒 Sécurité & contrôle

✅ Vérifications serveur
✅ Locker utilisable uniquement sur le terrain de l’entreprise (Biz)
✅ Panel configuration verrouillé par AdminLevel
✅ Empêche l’ouverture brute (code + paiement)
✅ Anti-conflit (usage exclusif par locker)
✅ Lock automatique après délai

🎮 Idéal pour

📦 Points relais / casiers de livraison
🏢 Entreprise de logistique RP
🧾 Système de récupération de commandes
🕵️ Lockers scénarisés (trafic, planques, objets sensibles)
💰 Gameplay économique (paiement pour accès)

🧑‍💻 Auteur

👤 Niroxy
🔧 Plugin : NiroxyPickupPoint
💙 Intégration parfaite avec l’écosystème Niroxy