FiveM 电梯脚本：Agency-Elevator 2026 设置指南

FiveM 电梯脚本是什么？

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

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

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

为什么你需要 Agency-Elevator

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

Agency-Elevator was built to solve all of those problems cleanly. It is actively maintained by the Agency Scripts team, fully documented, and, crucially, completely free. You can grab it directly from the Tebex store at no cost, no strings attached. Here is why it stands out:

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

功能深度解析

多层建筑

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

NUI面板

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

动画与音效

Agency-Elevator plays a door-close animation and sound when a floor is selected, then smoothly teleports the player to the destination floor after a configurable delay. On arrival, the door-open sound plays and the panel disappears. All animation and sound timings are configurable in 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？

Agency-Elevator is the right choice for any FiveM server that has:

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

立即开始

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