FiveM 电梯脚本：Agency-Elevator 安装指南 2026

FiveM 电梯脚本是什么？

FiveM 电梯脚本是一种自定义资源，可为您的角色扮演服务器中的多层建筑添加功能性、交互式电梯。没有专用的电梯脚本，GTA V / FiveM 服务器中的玩家无法以现实方式在高楼层之间移动，他们只能使用楼梯、传送命令或笨拙的变通方法，这些方法会立即破坏沉浸感。

合适的电梯脚本在玩家进入电梯区域时呈现游戏内 UI 面板。玩家选择目标楼层，电梯门动画关闭，摄像机或角色平滑过渡到目标层，播放音效，抵达时门再次打开。整个交互感觉像游戏世界的真实部分，而非附加机制。

对于严肃的角色扮演服务器，公寓楼、医院建筑、警察总部、摩天大楼办公室、停车场，一个好的电梯脚本不是奢侈品。它决定了建筑是感觉有生命还是像空壳道具。2026年，Agency Scripts的Agency-Elevator已成为社区首选的免费解决方案，本指南涵盖了在您的服务器上运行它所需了解的一切。

为什么你需要 Agency-Elevator

FiveM社区论坛和GitHub上有一些电梯脚本，但大多数存在一个或多个严重问题：过时代码导致在现代FiveM版本中崩溃、无维护、硬编码楼层坐标、无NUI面板或动画处理差，导致玩家穿模。

Agency-Elevator 旨在彻底解决所有这些问题。它由 Agency Scripts 团队积极维护，文档齐全，而且最重要的是，完全免费。你可以直接从 Tebex 商店免费获取，无附加条件。以下是它的突出之处：

• 多层支持： 定义你的建筑物有多少层。脚本中没有硬性限制。
• 流畅动画： 脚本使用GTA V原生动画和精心计时的传送，避免玩家看到突兀的位置跳跃。
• NUI 楼层选择面板： 简洁轻量的浏览器覆盖层显示当前楼层，玩家可点击或按键选择目的地。
• 音效： 电梯铃声、门开关及环境移动音效均包含在内。
• 完全可配置： 每栋建筑、每个电梯井、每个楼层坐标、每个楼层标签，全部定义在一个单一的 Config.lua 文件。
• 框架无关： 兼容 QBCore、ESX 及完全独立的设置。默认无框架依赖。
• 零成本： 免费，无需付款，无需托管，无需 Tebex 订阅，仅需免费账户。

功能深度解析

多层建筑

Agency-Elevator中的每个电梯在配置中定义为表条目。你指定触发区域（玩家站立呼叫电梯的位置），然后列出每层楼的名称、目的地坐标（x, y, z, 朝向）及可选访问限制。你可以在单个资源中为任意数量建筑定义电梯，如医院、警察总部、公寓楼、赌场塔，全部集中管理。

NUI面板

当玩家进入电梯触发区时，浮动 NUI 面板淡入。面板列出所有可用楼层及其标签（例如“底层”、“2楼，公寓”、“屋顶”）。玩家点击目的地或使用键盘导航。面板风格符合 Agency Scripts 设计语言，但可通过 NUI HTML/CSS 文件完全自定义，以匹配服务器品牌。

动画与音效

选择楼层后，Agency-Elevator 会播放关门动画和音效，然后在可配置的延迟后平滑地将玩家传送到目标楼层。抵达后会播放开门音效，面板随即消失。所有动画和音效时长均可在 中配置 Config.lua 以便你可以调整感觉以匹配你建筑的电梯速度。

访问限制

单独的楼层可以通过职业检查（QBCore/ESX）或物品检查进行锁定。例如，您可以将公寓楼的顶层限制为拥有顶层钥匙物品的玩家，或将服务器机房楼层限制为警察/工作人员职业。当玩家尝试选择没有所需职业或物品的受限楼层时，会显示通知且电梯不会移动。

可配置触发区域

每个电梯触发器由一个3D位置和半径定义。您还可以选择添加一个标记（信号点），以便新玩家可以步行找到电梯。对于喜欢简洁小地图的服务器，可以关闭标记。

安装：逐步指南

步骤 1：下载 Agency-Elevator

前往 Tebex 列表页面 agency-script.tebex.io/package/7285036 并将Agency-Elevator添加到购物车。它是免费的，只需完成零总额订单的结账。您将通过Tebex交付系统（链接到您的CFX账户或提供直接下载）收到下载链接。

步骤 2：放置资源

解压下载的压缩包并放置 agency-elevator 服务器的文件夹内 resources 目录（或子文件夹如 resources/[scripts]/).

步骤 3：添加到 server.cfg

打开你的 server.cfg 并在您的框架资源之后的任意位置添加以下行：

ensure agency-elevator

步骤 4：配置 Config.lua

打开 agency-elevator/config/Config.lua 并配置您的电梯。完整示例见下文。至少需要设置您的框架并定义至少一个电梯，且该电梯至少有两层。

步骤 5：启动服务器

重启你的服务器（或使用 refresh + start agency-elevator 在服务器控制台中）。走到游戏内任意电梯触发区域，NUI面板应出现。如果面板未出现，请检查服务器控制台的错误信息，大多数问题是配置中的坐标不匹配。

Config.lua 示例

下面是Agency-Elevator配置的示例。请根据您的服务器地图和建筑内部调整坐标：

-- Agency-Elevator: Config.lua

Config = {}

-- Framework: "standalone", "qbcore", or "esx"
Config.Framework = "qbcore"

-- Show floor markers on the minimap
Config.ShowBlips = false

-- Default floor label shown when no floor is selected
Config.DefaultFloorLabel = "Select Floor"

-- Elevator transition delay in milliseconds (door close → teleport)
Config.TransitionDelay = 1500

-- Enable NUI debug mode (shows borders on the panel)
Config.Debug = false

-- Define your elevators
Config.Elevators = {
    {
        name = "Mission Row PD - Elevator",
        -- Zone where players stand to call the elevator
        trigger = { x = 441.6, y = -982.3, z = 30.7, radius = 1.5 },
        floors = {
            { label = "Ground Floor",    coords = { x = 441.6, y = -982.3, z = 30.7,  h = 90.0 } },
            { label = "2nd Floor",       coords = { x = 441.6, y = -982.3, z = 34.7,  h = 90.0 } },
            { label = "3rd Floor",       coords = { x = 441.6, y = -982.3, z = 38.7,  h = 90.0 } },
            {
                label = "Roof Access",
                coords = { x = 441.6, y = -982.3, z = 50.7, h = 90.0 },
                -- Restrict to police jobs only
                jobRestrict = { "police", "sheriff" },
            },
        },
    },
    {
        name = "Alta Apartments - Elevator",
        trigger = { x = -268.4, y = -955.8, z = 31.2, radius = 1.5 },
        floors = {
            { label = "Lobby",       coords = { x = -268.4, y = -955.8, z = 31.2, h = 0.0  } },
            { label = "Floor 2",     coords = { x = -268.4, y = -955.8, z = 35.2, h = 0.0  } },
            { label = "Floor 3",     coords = { x = -268.4, y = -955.8, z = 39.2, h = 0.0  } },
            {
                label = "Penthouse",
                coords = { x = -268.4, y = -955.8, z = 48.0, h = 0.0 },
                -- Restrict to players who own this item
                itemRestrict = "penthouse_key",
            },
        },
    },
}

框架兼容性

设置 Config.Framework = "standalone" 使Agency-Elevator无需依赖QBCore或ESX即可运行。楼层选择和NUI面板在独立模式下完美工作；唯一需要框架的功能是对各楼层的可选职业和物品限制检查。如果你设置 Config.Framework = "qbcore" 或 "esx"，脚本加载相应桥接以检查玩家职业和库存物品，当选择受限楼层时生效。

文档与支持

完整文档，包括所有配置选项、坐标提示、NUI 自定义和常见问题，均可在此获得 docs.agencyg.de/elevator. 如果遇到问题，Agency Scripts Discord 服务器是获得开发者和社区支持的最快途径。

定价：完全免费

Agency-Elevator carries a price tag of 免费没有任何陷阱，没有托管锁定，没有订阅，没有解锁隐藏功能的高级版本。本文描述的完整脚本及其所有功能均可免费获得。这是Agency Scripts回馈FiveM社区并展示Agency Scripts系列品质的方式。您将获得与付费脚本相同的构建质量和积极维护，且完全免费。

作为参考：CFX论坛上许多类似的电梯资源要么无人维护、闭源，要么为Agency-Elevator免费提供的功能收取数欧元费用。如果你因成本或质量顾虑一直推迟为服务器添加电梯，现在没有理由再等待。

谁应该安装 Agency-Elevator？

对于具备以下条件的任何 FiveM 服务器，Agency-Elevator 都是合适的选择：

• 多层室内建筑，医院、警察局、法院、办公楼、公寓楼、停车场。
• 严肃RP社区 关注沉浸感且不希望玩家传送或使用聊天命令换楼层的
• 任何框架设置，QBCore、ESX 或完全自定义的 standalone 构建均开箱即用
• 预算有限的服务器，它是免费的，因此体验高质量电梯没有任何经济障碍

立即开始

下载只需一键。访问Tebex列表，完成免费结账，将资源放入服务器，添加 ensure agency-elevator 您的 server.cfg，配置您的楼层，完成设置。单栋建筑的完整设置通常不到15分钟。详细文档见 docs.agencyg.de/elevator 如果您需要指导，将引导您完成每个选项。