Agency-Housing : construis des maisons FiveM en jeu, pas dans un fichier de configuration

Les maisons se construisent dans la ville

Agency-Housing est un système de logement pour FiveM basé sur une base de données. Les maisons sont créées en jeu à l’aide d’un créateur, plutôt que dans un fichier de configuration rempli de coordonnées. Un admin exécute /acreatehouse , place l’entrée là où il se trouve, délimite le terrain, choisit un intérieur, donne un nom et un prix à la maison, puis l’enregistre. À partir de là, la maison existe pour tous les joueurs et est stockée dans MySQL.

Le script détecte automatiquement QBCore, QBox et ESX, et fonctionne aussi en mode standalone sans framework. Ses tables de base de données sont créées automatiquement au premier démarrage.

Le créateur

• Entrée : placée exactement là où se trouve l’admin.
• Limites du terrain : délimitées depuis les airs et enregistrées sous forme de PolyZone.
• Intérieur : un des 18 intérieurs, ou un intérieur personnalisé enregistré en jeu.
• Blips sur la carte : définis pour chaque maison.

Les menus proposent sept couleurs d’accentuation, pour que l’interface de logement s’accorde au style de ton serveur.

Ce que les propriétaires peuvent faire

• Achète et vends des maisons, avec des remboursements configurables et une limite par joueur.
• Donne les clés à d’autres joueurs et récupère-les.
• Meuble toute la parcelle avec jusqu’à 60 objets.
• Verrouille et déverrouille les vraies portes MLO dont tu as la clé.
• Utilise les points de garage, de stockage et de garde-robe, et installe des améliorations pour la maison.
• Réponds à la sonnette.

Deux touches font presque tout le travail : F7 ouvre le menu du logement et F3 ouvre le menu du propriétaire sur ta propre propriété. E entre dans une maison au marqueur de porte, répond à la sonnette et verrouille ou déverrouille les portes MLO. Chaque commande commence par un « a », comme /ahousing et /ahousemenu , pour éviter tout conflit avec les autres ressources.

Une garde-robe à part entière

Depuis la version 1.0.2, Agency-Housing intègre une garde-robe. Les joueurs enregistrent une tenue sous un nom et peuvent la remettre dans n’importe quelle garde-robe de leurs maisons, jusqu’à 20 tenues chacun. Aucun script de vêtements n’est nécessaire, quel que soit le framework ou même en standalone. Si illenium-appearance ou qb-clothing est installé, le script le détecte automatiquement. Les admins ouvrent la garde-robe intégrée où qu’ils soient avec /ahwardrobe.

Framework, ou aucun

Avec la config laissée sur auto, le script détecte lui-même le framework, même s’il démarre en retard, et la console indique ce qu’il a détecté à chaque démarrage. Sans QBCore, QBox ou ESX, il fonctionne en standalone : les joueurs sont identifiés par leur licence Rockstar, les admins sont définis par ACE ou par une liste de licences dans la config, et l’argent passe par trois petits hooks. Si tu préfères, les maisons peuvent tout simplement être gratuites.

L’achat, la vente, les clés, les meubles, les améliorations, les portes MLO, la sonnette et l’application Companion fonctionnent et sauvegardent les données exactement comme sur un serveur avec framework.

Le stockage est détecté de la même manière. Il s’ouvre avec ox_inventory, qb-inventory 1 et 2, qs, ps, lj et jpr. Sur un serveur sans inventaire, le point de stockage n’est tout simplement pas proposé.

Aucun import SQL

Chaque table et chaque nouvelle colonne sont créées au premier démarrage, sur MariaDB et MySQL 8. Pour les serveurs dont l’utilisateur de base de données ne peut pas créer de tables, sql/install.sql est toujours inclus.

Gère les maisons depuis le monde réel

Agency-Housing fonctionne avec l’application gratuite Agency Companion sur iOS, Android, iPad, Mac et Apple Watch. Les joueurs verrouillent et déverrouillent les portes, donnent et récupèrent les clés, répondent à la sonnette, achètent et vendent des maisons et définissent un itinéraire vers n’importe laquelle de leurs propriétés. Le staff peut se téléporter, mettre des maisons en vente ou les supprimer.

L’association fonctionne avec /ahconnect , un code court /ahc , un QR code ou un code à six chiffres. Le serveur doit pouvoir effectuer des requêtes HTTPS sortantes vers api.agencyg.de.

Mise à jour vers la version 1.0.2

La mise à jour est gratuite pour toutes les personnes qui possèdent déjà Agency-Housing. La config comprend un nouveau bloc standalone et de nouvelles options de garde-robe. Sauvegarde tes valeurs, utilise le nouveau config.lua et configure-les à nouveau. Les maisons, les clés, les meubles et les associations Companion sont conservés après la mise à jour, et rien n’a besoin d’être importé. Le manifest a changé, alors exécute refresh avant de redémarrer la ressource, ou redémarre le serveur.

Obtenir Agency-Housing

Agency-Housing est disponible sur le boutique Agency Scripts, et le documentation répertorie chaque commande, option de configuration et export.