Agency-Loadingscreen：服务器的前五秒决定一切

第一印象很重要

每个新玩家加入服务器时，会花30-90秒观看加载屏幕，才看到其他内容。这比大多数教程序列还长。默认GTA V加载屏幕无法告知玩家服务器信息；优秀的加载屏幕则能传达全部。Agency-Loadingscreen正是基于此理念打造。

我们提供什么

精致的玻璃拟态 UI，显示服务器规则、Discord 链接、工作人员名单和轮换的主图。自定义音乐播放器带音量控制。迷你服务器状态：当前人数、运行时间、下一个活动。加载完成时平滑过渡。所有内容通过单一配置以您的服务器颜色品牌化。

为什么音乐很重要

加载时的音频设定情绪基调。轻松RP服务器使用Lo-fi嘻哈，赛博朋克主题服务器使用合成波，严肃RP社区使用电影氛围音。玩家在生成前无意识地调节到氛围。我们内置曲库并提供配置选项指向您自己的音频CDN。

性能

加载界面在游戏资源加载前于浏览器运行，因此性能取决于页面大小。Agency-Loadingscreen总大小不足400KB（含字体）。即使在慢速连接下也能瞬间加载，这很重要，因为部分玩家使用50Mbps的农村宽带。

管理员的A/B测试

管理面板包含简单的A/B测试模式：设置两个加载屏幕变体，我们将分别向50%的新玩家展示，跟踪每个变体有多少玩家成功进入出生点。这是专业服务器用来微调第一印象漏斗的优化工具。

安装与设置

Agency-Loadingscreen is a pure client resource with no database dependency. Download from Tebex, drop the folder into your resources directory, and add ensure agency-loadingscreen 到 server.cfg. 资源必须提前加载，请在 server.cfg 中将其置于框架核心资源之前，以确保在游戏资产加载前显示。

所有自定义均在 config.lua 和 html/config.js 文件。你的服务器品牌（名称、颜色、标志、规则文本、工作人员名单、Discord链接）写入config.js。无需网页开发知识，配置是一个扁平的JavaScript对象，字段名称清晰。

配置选项

配置涵盖视觉、内容和性能设置：

• 服务器名称和标语，显著显示在主视觉区。
• 配色方案，主色、次色和强调色的十六进制值。全局应用于文本、边框和按钮颜色。
• Logo URL，你服务器角落显示的服务器标志。推荐使用SVG和WebP以保证清晰度。
• 主图，最多10张轮换图片，支持配置切换间隔和淡入淡出效果。
• 服务器规则，规则面板中呈现的markdown文本。支持标题、列表和加粗文本。
• 音乐曲目，音频URL数组，带有随机播放模式切换。玩家可以静音或通过隐蔽控件调整音量。
• 实时统计，切换当前玩家数量、服务器运行时间和下一个预定事件的显示。
• A/B测试，启用变体B配置及50/50分成追踪。

框架兼容性

Agency-Loadingscreen runs entirely in the browser layer, before any FiveM resource has initialized. It has no framework dependency and works identically on QBCore, ESX, and standalone servers. The live player count stat pulls from the FiveM server info endpoint, which is framework-agnostic.

为什么这对角色扮演很重要

加载界面是一种门槛仪式。玩家每次登录都会经历，是“我启动游戏”与“我进入世界”之间的时刻。利用这段时间让玩家沉浸于服务器的美学和规则，设定期望。阅读加载界面规则的玩家不太可能声称不知情。听到合适音乐的玩家会以正确的情绪进入游戏。

新玩家留存常在首次会话失败。如果新玩家在服务器的前六十秒看到的是空白屏幕或通用 GTA V 加载图像，你就浪费了一个高度关注的时刻。Agency-Loadingscreen 将这一时刻转化为主动的服务器营销、Discord 邀请、工作人员名单、即将活动和服务器视觉识别。

A/B测试功能存在是因为加载屏幕优化是可测量的。如果变体A显著展示你的Discord链接，而变体B没有，且变体A中新玩家加入Discord的比例是变体B的两倍，这就是值得采取行动的具体发现。专业服务器运营依赖数据；这是加载屏幕数据实际可收集的一个场景。

常见问题

我可以在加载屏幕上显示当前地图事件或活跃的角色扮演场景吗？

是的。实时统计面板支持自定义文本字段，可通过服务器的 HTTP 端点更新。运行一个小型服务器脚本，每隔几分钟将事件状态推送到该端点，加载屏幕实时显示。这是服务器在玩家生成前向加入玩家传达活动状态的方式。

音乐是否会自动播放，忽略浏览器自动播放策略？

FiveM 嵌入式浏览器运行环境不受自动播放限制，它不是需要用户手势的标准浏览器标签页。音乐可可靠自动播放。玩家角落有静音控制，作为礼貌而非变通。

如何跟踪A/B测试结果？

在config.js中启用A/B跟踪端点，并指向您的分析服务器或简单的Webhook。每个变体都会被标记，加载屏幕关闭时触发加入事件。比较Discord加入率、首次访问的会话时长或服务器关心的任何指标在两组之间的差异。

我可以显示视频而不是旋转图片吗？

是的。设置 heroType: 'video' 并提供视频URL。视频静音播放并循环。请保持视频文件小于20MB，以保证慢速连接下的加载性能。推荐使用720p的WebM格式编码。

需求

• FiveM 服务器（任意框架或独立）
• 拥有有效 Agency-Loadingscreen 许可证的 cfx.re 账户
• 音频与图像托管（CDN、Discord CDN或您自己的服务器）
• 无数据库依赖

您的加载屏幕内容策略

大多数服务器填充加载屏幕后从不更新。服务器规则写于一年前，工作人员名单六个月未更新，英雄图是早已过去活动的截图。陈旧加载屏向有经验玩家传递服务器不注重细节的信息。

为每月第一天设置日历提醒：更新轮换图片为最近的活动截图，核实员工名单是否最新，检查 Discord 链接是否有效，刷新“下一次活动”字段。此操作需十五分钟，保持加载界面活跃感。

更好：将加载屏幕更新纳入您的活动规划流程。当活动安排时，更新加载屏幕以推广该活动。活动结束后，用回顾截图替换该推广。加载屏幕变成当前活动公告板，而非静态宣传册。

音乐库值得季节性轮换。夏季主题、冬季氛围、特别活动播放列表。每天加入的玩家比其他元素更注意音乐，偶尔提供新内容表明服务器在积极维护。