FAQ

Do I need to know how to code?

No. Everything is edited in-game from the admin panel, in an editor with a live preview of the real screen. Drag blocks where you want them, type your text, click Publish.

Do I have to restart the server to change the loading screen?

No. Publishing takes effect immediately for everyone connecting from that moment. The only exception is scenes, which are edited as a file and need a restart.

Why don't I see my own change?

Your loading screen was destroyed when you spawned — there is nothing left on your screen to update. Reconnect to see the result. Everyone connecting after your publish already has it.

Does it work with ESX, QBCore and QBox?

Yes. HZ-Loading is standalone and needs no framework at all. It only requires HZ-Bridge, which is free.

Is the progress bar real?

Yes. It is bound to FXServer's actual streaming events — init / map / run phases, the file currently downloading, and a true percentage. It is not an animation on a timer.

Can it really show my live player count?

Yes, and it is correct even for a player who is still connecting. Player count, slots and uptime are pushed by your own server and delivered through the connection handshake — the only channel that reaches a player mid-connect. A periodic refresh keeps screens already on display up to date.

Which languages are included?

English, French, Spanish, German, Portuguese, Turkish and Italian. Both the interface and the built-in example content are translated, so a fresh install already reads like a finished product in every language.

The language is a server-wide setting, not per-player. Your loading screen is your front door; it speaks one language.

Can players upload images from the panel?

Not yet. Files are dropped in the resource's assets/ folders — but you do not need a restart afterwards: the Creator has a picker and a Rescan button. See Assets.

Does it look right in 4K and on ultrawide?

Component positions are stored as percentages of the screen, so a logo placed bottom-right stays bottom-right at any resolution and any aspect ratio.

Can I schedule a Halloween version?

Yes — see Scene scheduler. Cron-scheduled config overlays, first match wins, and anything a scene does not override falls through to your normal settings.

Can I use a video background?

Yes: a local MP4, or YouTube. Keep local files at 720p, under 5 MB, H.264 — the video decodes while the game streams assets, so an oversized file costs the player frames at the worst moment.

Is the Markdown safe?

Yes. Embedded HTML is stripped, not rendered. A compromised panel account cannot inject a script into every connecting player.

Do I need Node.js or a build step?

No. The interface ships pre-built. Drop the resource in, ensure it after HZ-Bridge, reconnect.

Can a moderator edit it without being a full admin?

Yes. Panel access and the right to publish are two separate permissions. A moderator can open the editor and run a rescan without being able to publish — or to touch the Discord webhook.

Something is wrong and I can't see the screen to debug it.

Run /hzloading:diag. If you see the default "Your Server" brand and a 0 / – count, the boot payload never arrived — check that HZ-Bridge starts before HZ-Loading in server.cfg. See Commands & permissions.