Jim Trains

Faz trens de carga e metrô circularem pelo mapa, com blips ao vivo, paradas automáticas nas estações e um sistema opcional de passagem para o metrô.

Sumário

1. Dependências
2. Instalação
3. Configuração
4. Comandos
5. Trens de carga
6. Metrô e passagens
7. Locais
8. Entrypoints para outros recursos
9. Localização
10. Estrutura de arquivos

Dependências

Instalação

1. Copie a pasta jim-trains para resources/.
2. Adicione ao server.cfg, depois das dependências:

   ensure oxmysql
   ensure jim_bridge
   ensure jim-trains

3. Ajuste o config.lua conforme a seção abaixo.

Não há SQL, itens ou permissões ACE.

Conflitos — o recurso chama SetRandomTrains(true), SwitchTrainTrack e SetTrainTrackSpawnFrequency nos tracks 0 e 3. Não rode junto com outro script que também controle o spawn de trens.

Configuração

Todas as opções ficam em config.lua.

Comandos

Trens de carga

Ao iniciar, o recurso carrega os modelos freight, freight2, freightcar, freightcar2, freightgrain, freightcont1, freightcont2, freighttrailer, tankercar e metrotrain, liga os tracks 0 e 3 com frequência de spawn de 480000 ms (8 minutos) e ativa trens aleatórios.

Todo trem detectado tem tratamento automático:

• O maquinista NPC fica invencível e não reage a eventos ao redor.
• O trem em si fica invencível e com as portas travadas (SetVehicleDoorsLocked(train, 10)). Em movimento, SetTrainsForceDoorsOpen(true) mantém as portas abertas; ao parar numa estação elas são liberadas.
• Trens de carga que chegam a até 15 metros de uma das paradas em freightStops param sozinhos: desaceleram até zero via SetTrainCruiseSpeed, ficam 40 segundos parados e retomam até a velocidade 15. Esses tempos são fixos no client/client.lua.

Com ShowTrainBlips = true, cada trem ganha um blip que segue a entidade, gira conforme o heading e fica azul quando o trem está parado.

Metrô e passagens

Com requireMetroTicket = true:

1. Zonas de target são criadas nas 17 máquinas de passagem listadas em TicketPurchase (opção "Buy Train Ticket").
2. Comprar debita Config.General.chargeAmount do banco ou do dinheiro vivo, conforme chargeBank. Sem saldo, a compra é recusada. Com societyAccount preenchido, o valor é depositado nessa sociedade.
3. Entrar no metrô sem passagem teleporta o jogador para fora, na parada mais próxima de MetroRemoveStops.
4. Com passagem, o jogador é sentado automaticamente (se seatPlayer = true) e um texto na tela oferece descer na próxima parada com G.
5. Ao acionar o /getoffnext e o trem parar, o jogador é teleportado para a plataforma e a passagem é consumida — cada passagem vale uma viagem.

Os assentos -1, 0, 1 e 5 são reservados (maquinista e cabine) e nunca são usados para o jogador.

Com seatPlayer = false, o jogador entra livremente e a passagem é consumida quando ele sai do trem por conta própria.

Locais

Todas as coordenadas ficam em shared/locations.lua, em quatro tabelas:

Para adicionar uma nova máquina de passagem:

TicketPurchase = {
    { coords = vec4(115.64, -1725.99, 30.0, 50), w = 5.0, d = 2.05 },
}

Entrypoints para outros recursos

O recurso não tem exports. O único evento de servidor fica em server.lua:

TriggerServerEvent('jim-trains:server:buyTicket', price, chargeType)

chargeType é "bank" ou "cash". O handler chama chargePlayer e, se societyAccount estiver preenchido, fundSociety, ambos do jim_bridge. O nome do evento usa getScript(), então renomear a pasta do recurso muda o nome do evento junto.

As funções em shared/function.lua (LoadTrainModels, isPedInTrain, putPlayerInSeat, putPedInSeat, getClosestCoord, removePlayerFromTrain, getClosest, getVehicleInDirection, isSeatRestricted) são globais e ficam acessíveis dentro do próprio recurso, mas não são exportadas.

Localização

Os textos ficam em locales/, carregados como shared_scripts. O idioma ativo é escolhido por Config.Lan no config.lua — não pela convar ox:locale.

• en.lua — inglês
• de.lua — alemão

Para adicionar um idioma, crie locales/<codigo>.lua seguindo a estrutura do en.lua (tabela Loc['<codigo>'] com as mesmas chaves) e defina Config.Lan = "<codigo>".

Chaves disponíveis: metrain, freight, buy, gettingoff, getoff, lsmetro, seating, welcome, noticket, arrived, already, purchased, nocash.

Estrutura de arquivos

jim-trains/
├── client/
│   └── client.lua        — spawn de trens, blips, parada nas estações, compra e uso de passagem, keybind G
├── shared/
│   ├── function.lua      — helpers: carregar modelos, detectar jogador no trem, sentar, teleportar para plataforma
│   └── locations.lua     — estações de metrô, plataformas, máquinas de passagem e paradas de carga
├── locales/
│   ├── en.lua            — textos em inglês
│   └── de.lua            — textos em alemão
├── server.lua            — evento de compra de passagem: cobra o jogador e deposita na sociedade
├── config.lua            — idioma, sistema de notify/drawText, blips, passagem, cobrança e sociedade
├── version.txt
├── README.md
└── fxmanifest.lua