Tela de carregamento

Tela exibida enquanto o jogador conecta, com barra de progresso, dicas, fundo em imagem ou vídeo e player de música. A música continua tocando depois do carregamento, na seleção de personagem e na criação. O script também serve as imagens de banner da conexão.

Precisa de: nenhuma dependência no fxmanifest. Só o spawn fecha a tela, então os dois precisam estar ligados.

Instalação

ensure loading
ensure spawn

Coloque antes do spawn. Veja a ordem completa.

Banners

O script serve banner.jpg e connecting.jpg, da pasta dele, pelo servidor HTTP do FiveM. Para usar, aponte os banners no server.cfg, com o endereço público do servidor:

sets banner_detail "http://SEU_IP:30120/loading/banner.jpg"
sets banner_connecting "http://SEU_IP:30120/loading/connecting.jpg"

As imagens padrão trazem a marca Kroma. Para trocar, substitua os dois arquivos e rode restart loading.

Controles

Controle	O que faz
M	Liga ou desliga a música
Passar o mouse no player	Abre o painel com faixa anterior, pausa, próxima, posição e volume

Volume e mudo ficam salvos no jogador. Se o navegador do jogo bloquear o som automático, o player mostra Clique para ouvir a trilha.

Depois do carregamento, a música segue no ponto onde parou se a troca levar menos de 10 segundos. Na seleção de personagem e na criação, M continua funcionando. A música para quando o jogador entra na cidade.

Configuração

Nome da cidade

shared-side/city.lua vale também para o spawn e o creator.

Opção	Padrão	O que muda
City.Name	"Los Santos"	Nome da cidade nas telas e no documento
City.Code	"LSA"	Código de 3 letras no documento

Tela e música

shared-side/shared.lua:

Opção	Padrão	O que muda
Headline	"Você está chegando a"	Texto acima do nome da cidade
Background.Type	"image"	"image" ou "video"
Background.Files	vazio	Arquivos do fundo. Sem arquivos, a tela usa o fundo escuro padrão
Background.Interval	9000	Tempo de cada imagem, em ms. Mínimo 3000
Tips	5 dicas	Dicas exibidas em rodízio
TipInterval	7000	Tempo de cada dica, em ms. Mínimo 3000
Playlist	2 faixas	Faixas em ordem
Volume	0.6	Volume inicial, de 0 a 1
Autoplay	true	false espera o jogador ligar a música
Dissolve	2200	Duração da saída da tela, em ms

Onde colocar os arquivos:

Tipo	Pasta	Observação
Imagem	web-side/images/	Várias imagens entram em rodízio
Vídeo	web-side/video/	Só o primeiro arquivo toca, mudo e em loop
Música	web-side/audio/	Campo File da faixa

Background = {
	Type = "image",
	Files = { "praia.jpg", "centro.jpg" },
	Interval = 9000
},

Playlist = {
	{ Artist = "Sua banda", Name = "Sua faixa", File = "faixa.mp3" }
},

O selo da marca e a letra K ao fundo fazem parte da interface compilada. Não há opção para trocar esses itens no shared.lua.

Para programadores

Evento de cliente loading:Music:

TriggerEvent("loading:Music", "Start")  -- inicia a Playlist
TriggerEvent("loading:Music", "Stop")   -- para com fade
TriggerEvent("loading:Music", "Toggle") -- liga ou desliga o som

-- troca por uma faixa em loop. O arquivo precisa estar em web-side/audio
TriggerEvent("loading:Music", "Cinema", { File = "faixa.mp3", Name = "Faixa", Artist = "Banda", Volume = 0.25, Fade = 2500 })

-- muda o volume para uma fração do atual
TriggerEvent("loading:Music", "Duck", { Level = 0.12, Time = 1400 })

-- controla o player
TriggerEvent("loading:Music", "Control", { Do = "Next" })

Valores de Do:

Do	Value	O que faz
Toggle		Liga ou desliga o som
Play		Pausa ou retoma
Next, Previous		Troca de faixa
Seek	segundos	Vai para o ponto da faixa
Volume	0 a 1	Muda o volume
Dock	true ou false	Com From, esconde o player pequeno e liga o envio de estado

Enquanto algum Dock estiver ativo, o evento de cliente loading:MusicState chega a cada 500 ms com Active, Name, Artist, Cinema, Muted, Paused, Time, Duration e Volume.