Agency-Elevator : rendre les bâtiments à plusieurs étages vraiment pratiques

Le problème des étages dans GTA V

GTA V compte de superbes immeubles de grande hauteur, dont presque aucun n’est réellement utilisable. Téléporter les joueurs d’un étage à l’autre fait bricolé et brise l’immersion. Les étages de MLO nécessitent des intérieurs personnalisés coûteux et causent souvent des problèmes de physique lors des transitions. Agency-Elevator est notre solution : une vraie mécanique d’ascenseur qui donne la sensation d’utiliser un ascenseur, fonctionne dans n’importe quel bâtiment et s’intègre parfaitement à l’écosystème de scripts de ton serveur.

Une expérience naturelle

L’ascenseur se déroule en trois temps : l’animation d’entrée, la montée avec un léger mouvement de caméra et une ambiance sonore, puis l’ouverture des portes à l’étage de destination. La séquence dure six secondes, assez longtemps pour sembler réaliste, mais pas assez pour donner l’impression d’attendre. La conception sonore compte : un léger bourdonnement mécanique, le doux ding à ton étage. Les joueurs remarquent rarement tout cela consciemment, et c’est exactement le but.

Configurer de nouveaux ascenseurs

Ajouter un nouvel ascenseur prend cinq lignes de configuration : les coordonnées d’entrée, les coordonnées de destination de chaque étage, les étiquettes des étages et une fonction facultative de vérification des permissions. Pas besoin de modifier un MLO ni d’astuces de streaming d’intérieur. Colle tes coordonnées, attribue tes étages, et c’est terminé. Certains propriétaires de serveur ont configuré des immeubles de bureaux de 12 étages en moins de dix minutes.

Un contrôle d’accès réellement fonctionnel

L’accès aux étages selon le métier est pris en charge nativement. Le hall est public, les étages 5-10 nécessitent une carte-clé de gestionnaire d’immeuble, et l’accès au penthouse requiert un identifiant de personnage précis. Ces règles sont évaluées instantanément à partir des données des joueurs de n’importe quel framework, sans attente de requêtes à la base de données susceptibles de ralentir la transition de l’ascenseur.

Pourquoi c’est un favori des serveurs standalone

Agency-Elevator est compatible avec tous les frameworks dès l’installation. Peu importe que tu utilises QBCore, ESX ou une stack personnalisée standalone, les hooks de permissions sont des fonctions configurables, pas des imports de framework. C’est pourquoi c’est l’un de nos scripts les plus téléchargés dans les trois communautés.

Installation & configuration

Agency-Elevator ne dépend d’aucune base de données pour son fonctionnement de base. Télécharge-le depuis Tebex, dépose le dossier dans ton répertoire de ressources, puis ajoute ensure agency-elevator à server.cfg . Les définitions des ascenseurs, les coordonnées d’entrée, les destinations des étages, les étiquettes et les règles d’accès se trouvent toutes dans config.lua.

La configuration par défaut comprend des définitions d’ascenseurs pour plusieurs bâtiments GTA V vanilla accessibles (le hall du FIB, l’entrée de la tour Maze Bank, les entrées d’immeubles résidentiels). Remplace-les ou complète-les avec les coordonnées des bâtiments personnalisés de ton serveur. Chaque définition prend moins de cinq minutes à configurer.

Options de configuration

Le config.lua définit le comportement des ascenseurs et le contrôle d’accès :

• Définitions des ascenseurs, tableau d’ascenseurs, chacun avec un nom, les coordonnées et le rayon du déclencheur d’entrée, ainsi qu’un tableau de destinations d’étages.
• Destinations des étages, chaque étage possède des coordonnées, une étiquette affichée et une fonction d’accès facultative.
• Fonction d’accès, une fonction Lua pour chaque étage, qui reçoit player src et renvoie true/false. Utilise-la pour vérifier le métier, l’objet ou l’identifiant du personnage.
• Durée de transition, durée de l’animation de montée ou de descente en millisecondes. Valeur par défaut : 6000 (6 secondes).
• Son d’ambiance, active ou désactive le bourdonnement mécanique de l’ascenseur et les sons de ding à chaque étage. Valeur par défaut : activé.
• Comportement de la caméra, légère inclinaison de la caméra pendant la transition pour créer un effet de mouvement. Valeur par défaut : activée, intensité configurable.
• Style de l’interface, l’apparence du panneau de sélection des étages (minimaliste ou détaillée avec descriptions des étages).

Compatibilité avec les frameworks

Agency-Elevator est entièrement standalone par conception. Les fonctions de contrôle d’accès dans ta configuration peuvent récupérer les données des joueurs depuis n’importe quel framework, QBCore, ESX ou une solution personnalisée. Aucune importation de framework n’est incluse dans la ressource de base. C’est pourquoi il s’agit de l’un des scripts Agency les plus téléchargés de façon constante dans les trois communautés de serveurs : il fonctionne sans configuration particulière, quel que soit ton stack.

Pourquoi c’est important pour le roleplay

L’espace vertical est l’une des dimensions les moins exploitées dans GTA V RP. La carte compte des dizaines de grands immeubles impressionnants et d’intérieurs à plusieurs étages. Sans ascenseurs fonctionnels, ces espaces sont soit inaccessibles, soit accessibles grâce à des téléportations qui brisent l’immersion. Agency-Elevator ouvre cet espace vertical au RP sans la coupure brutale d’une téléportation.

La transition de six secondes n’est pas là pour meubler, elle donne un rythme précis. Les trajets en ascenseur en roleplay sont des micro-scènes. Un détective et un suspect qui montent tous deux au 12e étage sont contraints de rester à proximité pendant six secondes. Des partenaires commerciaux qui se rendent à une réunion ont six secondes pour échanger quelques mots. Ces brèves interactions font la richesse du RP, et un ascenseur fonctionnel les crée naturellement au lieu de les zapper.

Le système de contrôle d’accès permet de créer une hiérarchie entre les bâtiments en RP. Une tour d’entreprise dont le hall est public, où les étages 5 à 20 nécessitent un badge d’employé et où l’étage de direction est réservé à un personnage précis, c’est une organisation avec une structure spatiale. Quand l’accès physique correspond à la hiérarchie de l’organisation, le bâtiment devient un véritable territoire en jeu de rôle plutôt qu’un simple décor.

Ce script est particulièrement utile dans les intérieurs MLO personnalisés. Un serveur doté d’un MLO personnalisé pour le commissariat, d’un MLO d’hôpital ou d’un quartier d’affaires avec des gratte-ciel personnalisés peut rendre chaque étage accessible et praticable sans devoir empaqueter de nouvelles zones de streaming côté client. Les transitions entre les zones intérieures existantes s’occupent du reste.

Questions fréquentes

Deux joueurs peuvent-ils utiliser le même ascenseur en même temps pour se rendre à des étages différents ?

Oui. L’interaction avec l’ascenseur est indépendante pour chaque joueur. Si le joueur A appelle l’ascenseur au 5e étage et que le joueur B l’appelle au 12e étage depuis le même point d’entrée, les deux transitions se lancent simultanément sur le client de chacun. L’ascenseur n’a ni capacité simulée ni temps d’attente, il s’agit d’une transition par joueur, pas d’un objet physique partagé.

Peut-on ajouter un opérateur PNJ ou un clavier à l’ascenseur ?

La zone de déclenchement ne nécessite aucun prop en particulier, elle est basée sur les coordonnées. Tu peux placer le prop de ton choix aux coordonnées d’entrée, un clavier, un comptoir d’accueil ou un PNJ, à l’aide des outils de placement de props de ton serveur. L’interaction avec l’ascenseur se déclenche quand le joueur entre dans le rayon d’activation, quel que soit l’objet présent sur place.

Est-ce compatible avec les ressources de streaming d’intérieurs personnalisés ?

Oui. Dans la configuration, les coordonnées intérieures fonctionnent exactement comme les coordonnées extérieures. Veille à utiliser les coordonnées dans l’intérieur, que tu obtiens en t’y rendant en jeu, et non les coordonnées extérieures du bâtiment. Si ton intérieur utilise un ID d’intérieur personnalisé, indique-le dans la définition de l’étage et Agency-Elevator placera le joueur dans le bon intérieur lors de la transition.

Peut-on verrouiller complètement l’ascenseur pendant certains événements RP ?

Utilise exports['agency-elevator']:LockElevator(elevatorName, reason) depuis n’importe quel script de serveur. Les joueurs qui tentent d’utiliser l’ascenseur pendant le verrouillage voient le message « actuellement indisponible ». Déverrouille avec exports['agency-elevator']:UnlockElevator(elevatorName). Utilise cette option lors d’événements scriptés où un accès incontrôlé aux étages briserait la scène.

Prérequis

• Serveur FiveM (n’importe quel framework ou standalone)
• Compte cfx.re avec une licence Agency-Elevator valide
• Aucune dépendance à une base de données pour le fonctionnement de base
• Aucune dépendance à des ressources externes