Script IO de Paths para Vice City v. 2.7f [MAXScript]

Vice City Paths IO Script v.2.7e

Script para trabalhar com paths.ipl (e não só).

Requisitos: 3dsMax 2008 e superior.

Funcionalidades:

- Importação de paths de GTA VC, GTA3, GTA SA (incluindo suporte para paths no formato Fastman92, apenas formato FLA4);

- Exportação de paths de GTA VC (exportação de todos os tipos de linhas suportados pelo jogo (de 3 a 12 pontos inclusive));

- Importação de paths de GTA SA no formato Vice City/3 (veja abaixo);

- Possibilidade de atribuir o tipo de path (peds, carros, barcos) a cada linha. Se nenhum tipo de path for atribuído, o script atribuirá automaticamente o tipo com base no valor de Default Path Type;

- Possibilidade de criar e exportar cruzamentos (em T e em cruz). Veja mais detalhes em "Creating Crossroads.docx" ou arquivos .avi;

- Possibilidade de alterar parâmetros para cada linha/ponto. Para alterar parâmetros, basta selecionar a linha. Todas as alterações serão salvas automaticamente;

Não é necessário inserir tudo manualmente — se as configurações da linha não forem atribuídas, o script as gerará automaticamente;

- Possibilidade de importar/exportar arquivos .dat de paths da pasta data/paths;

- Botões para selecionar paths por tipo (selecionar todos os paths de tráfego/peds/barcos);

- Possibilidade de converter VC Paths.ipl para o formato de paths de GTA 3;

- Conversão de paths de GTA 3 para o formato de GTA VC;

- Exibição dos números dos vértices da linha editável no viewport;

- Exibição dos flags do path, número de pistas, coordenadas e largura do path no viewport;

- Função para mudar a direção do movimento do path;

- Função para atribuir a direção do movimento do path (sentido único/sentido duplo);

- Função para dividir linhas com mais de 12 pontos (para linhas selecionadas);

- Função para resetar parâmetros de linhas (para linhas selecionadas);

- Função para ativar/desativar o tráfego de carros.

- Função para configuração automática de cruzamentos com base nas linhas adjacentes (função ainda não finalizada adequadamente).

- Função para remover linhas "inválidas" com menos de 2 pontos.

Alterações na versão 2.7f (atualização 31.12.2024)

- Adicionada a função de conversão de paths de GTA3 para o formato Vice City. Para isso, é necessário selecionar a pasta onde o GTA3 está instalado, em seguida, indicar onde o Paths.ipl será salvo, e depois clicar no botão Convert.

- Corrigido um erro que, ao converter paths para o formato GTA3 em versões mais recentes do 3dsmax (anteriores a 2012), criava um arquivo .COL com 0 bytes.

- Adicionado um progress bar auxiliar para informar sobre o processo de conversão de paths para o formato GTA3, bem como para a conversão de paths para o formato GTA Vice City.

- Para um carregamento mais rápido dos paths de GTA3, a informação sobre os paths encontrados no MaxScript Listener foi removida — isso atrasava o processo de carregamento dos dados dos paths.

Tipo de linhas suportado Splines — Line. Initial Type — Corner. Drag Type — Bezier.

Não aplique modificadores às linhas! Isso pode levar à impossibilidade de exportar paths e criar cruzamentos corretamente.

Para um traçado mais conveniente dos paths, use os snap points no 3dsMax (veja mais detalhes nos arquivos .docx).

Um exemplo de criação de paths para GTAVC é descrito em paths_tutorial[RU].pdf

O script suporta a importação de paths de GTA VC. Se algo for importado incorretamente (por exemplo, cruzamentos), recomendo corrigir manualmente.

Não é recomendado usar este script para editar o mapa padrão de paths, devido ao fato de que ao importar o mapa padrão de paths, mais linhas são criadas em comparação com o paths.ipl original, violando assim a estrutura original dos paths e do arquivo Paths.ipl; após a exportação, o arquivo de paths pesa mais que o original e isso leva à ausência de tráfego ou pedestres em algumas áreas.

É preferível usar o script para criar novos paths.

O script suporta a importação de paths de GTA3 — apenas importação, para exportar é necessário exportar os paths para o formato Vice City, e depois converter para o formato GTA3.

O script suporta a possibilidade de converter paths.ipl para o formato de paths de GTA 3.

Para isso, é necessário especificar o ID inicial do path, prefixo para modelos de paths, nome para IPL IDE COL, multiplicador de coordenadas dos paths com o qual o paths.ipl foi exportado (para o .exe padrão é 16)

Em seguida, selecionar o diretório para onde os arquivos de paths de GTA 3 serão exportados e, como último passo, selecionar o paths.ipl.

O script notificará sobre a conclusão do processo de conversão. Os arquivos IPL IDE COL estão totalmente prontos para serem adicionados ao jogo.

Não é recomendado usar esta função para editar paths padrão!

É preferível usar a função para criar paths de um novo mapa ou adicionar novos paths aos paths originais.

Observe que ao adicionar paths no GTA 3 na presença dos originais, é necessário aumentar o limite com o adjuster Dynamic Limits: Buildings, PtrNodes, EntryInfoNodes, Treadables; [Pool Limits]: Objects Models; limite de arquivos DFF [ID LIMITS].

Para isso, use Limit Adjuster de Vitlgt. Também deve ser definido o parâmetro "Enable path limits patch=1" e aumentar o ID máximo no bloco PATH LIMITS.

Para aumentar o limite de paths em Vice City, é necessário usar o Maxorator's Path hack.

O script suporta a possibilidade de converter paths de GTA3 para o formato Vice City.

Para isso, é necessário definir os multiplicadores de paths de GTA3 e Vice City, depois indicar o diretório de GTA3 e o caminho para salvar o Paths.ipl.

Depois disso, clique no botão Convert.

Deve-se notar que o tamanho do arquivo de paths resultante é maior que o original, portanto, para que os paths funcionem, será necessário o Maxorator's Path Hack (vcpathlimit.flt).

O script suporta a importação de paths de GTA SA, incluindo a importação de paths no formato Fastman92.

Para importar, clique no botão Import GTASA Paths e especifique a pasta onde estão os 64 arquivos de paths NodesXX.dat.

O processo de importação de paths pode levar de algumas dezenas de segundos a 10 minutos.

Os paths são importados na forma de splines, que podem ser editadas ou configuradas usando o SA Path Tool de Deniska.

O autor não garante 100% de funcionamento dos paths de GTASA após importação/exportação.

É altamente recomendável verificar as configurações de todas as linhas, incluindo a correção das configurações dos semáforos!

É possível carregar paths no formato GTAVC. Após a importação, é altamente recomendável verificar e corrigir as configurações dos paths, bem como os splines de paths e cruzamentos criados! O autor não garante que os paths importados no formato Vice City sejam totalmente funcionais! Em caso de detecção de splines de paths e cruzamentos incorretos, recomenda-se reconstruir o path(s) incorreto(s) manualmente!

Por padrão, o script processa os paths de GTASA durante a importação, ou seja, remove segmentos duplicados e solda pontos para possibilitar a edição posterior das linhas de paths para GTASA ou para GTAVC/GTA3.

É possível desativar essas funções na seção GTASA Import Settings, mas neste caso, as linhas de paths são absolutamente impróprias para edição para GTASA ou para GTAVC/GTA3. Isso pode ser útil se for necessário apenas visualizar o mapa de paths (a importação do mapa padrão de paths sem processamento leva aproximadamente 2 minutos).

Detalhes estão escritos em "Import GTA SA Paths.docx".

Ao criar uma nova linha de path, o script atribui automaticamente configurações a ela, com base nos parâmetros do bloco Default Parameters!

Observe que os parâmetros Lanes para pontos internos são sempre iguais a 1 1! Para atribuir a direção do movimento e o número de pistas, basta editar apenas os pontos finais (externos).

Ou use os botões set one-way/set two-way traffic para atribuir tráfego unidirecional ou bidirecional e use o botão Change the direction of traffic para mudar a direção do tráfego.

Para exibir os parâmetros das linhas no viewport, use a guia Display helper. Para exibição estão disponíveis — números de pontos, número de pistas, flags, largura do path, coordenadas dos pontos.

Para resetar os parâmetros padrão das linhas selecionadas, use a função Reset User Properties.

Em caso de erro "The script does not support splines with a number of points greater than 12 and less than 3!Please edit the spline", aplique a função Split Lines to VC Format.

Esta função divide a linha em n linhas, se o número de seus pontos for estritamente maior que 12, ou divide a linha até três pontos, se a linha procurada tiver dois (Vice City não suporta linhas com dois pontos).

Para exportar o tráfego, basta selecionar as linhas e clicar no botão Export Paths. As linhas prontas para Paths.ipl serão exibidas na janela MAXScript Listener (no canto inferior esquerdo do 3Ds max ou pressione F11 para chamar o MAXScript Listener).

O script tem a capacidade de criar cruzamentos de duas maneiras:

1) — Em cada linha SEPARADAMENTE selecionar um ponto no modo de edição de vértices

— Selecionar as linhas e clicar no botão Create Crossroad

2) — Clicar no botão Create Dummys at line end

— Selecionar os dummies e clicar no botão Create Crossroad

Breve descrição dos botões:

Set Ped — atribuir tráfego de pedestres às linhas.

Select all Ped Paths — selecionar todos os paths de pedestres.

Set Car — atribuir tráfego de carros às linhas.

Select all Car Paths — selecionar todos os paths de carros.

Set Boat — atribuir tráfego de barcos às linhas.

Select all BoatPaths — selecionar todos os paths de barcos.

Select All Paths — selecionar todos os paths.

Import GTAVC Paths — importar paths de GTAVC.

Import GTA3 Paths — importar paths de GTA3.

Import GTASA Paths — importar paths de GTASA.

Import GTASA Paths (Fastman92 FLA4 format only!) — importar paths de GTASA no formato Fastman92.

Delete Double Segments — remover segmentos duplicados ao importar paths de GTASA. Para poder editar paths, esta caixa de seleção deve estar marcada!

ViceCity/III format (beta) — converter paths de GTASA para o formato GTAVC/GTAIII. É necessário marcar esta caixa se os paths forem configurados apenas para GTAVC/GTAIII posteriormente!

Weld paths knots and split paths — soldar pontos de paths e dividir linhas ao importar paths de GTASA. Para poder editar paths, esta caixa de seleção deve estar marcada!

Create CrossRoad — criar cruzamento (com base em dummies auxiliares ou em pontos de splines selecionados)

Set CrossroadPath name — Designar o path como cruzamento. Se o cruzamento estiver configurado incorretamente, o script ignorará esta linha.

Create dummy at line ends — criar dummies nas extremidades das linhas. Útil para criar cruzamentos.

Delete all dummy — remover todos os dummies auxiliares.

Display vertex number — exibir no viewport os números dos pontos dos paths (desde que o número de pontos na linha esteja no intervalo de 2 a 12 inclusive).

Display Lanes — exibir no viewport o número de pistas da linha.

Display width — exibir no viewport a largura do path.

Display flags — exibir no viewport os flags dos paths.

Display XYZ coordinate — exibir no viewport as coordenadas dos pontos.

Import .dat — importar arquivo .dat de paths flightX.dat/tracksX.dat/spathX.dat.

Export .dat — exportar arquivo .dat de paths.

Split lines — converter as linhas selecionadas para o formato de paths GTAVC/III.

Reset user properties — resetar todas as configurações da linha selecionada.

Enable Traffic — ativar o tráfego (define flag 0)

Disable Traffic — desativar o tráfego (define flag 1)

Delete zero shapes — remove linhas inválidas com menos de 2 pontos.

Reverse knot order — altera a prioridade dos pontos.

set one way traffic — criar tráfego unidirecional.

set two way traffic — criar tráfego bidirecional.

Change direction traffic — mudar a direção do tráfego.

Assign Line Parameter for Crossroad by lines — configurar o número de pistas nos cruzamentos com base nas linhas adjacentes. Não funciona em caso de cruzamentos adjacentes!

Select Directory — selecionar diretório para exportar arquivos de paths de GTA3.

Select ViceCity paths.ipl — selecionar Vice City paths.ipl para sua conversão para o formato de paths de GTAIII.

Select GTA3 Directory — selecionar a pasta onde o GTA3 está instalado.

Select save path for Paths.ipl — selecionar o caminho para salvar o Paths.ipl

O script suporta a importação e exportação de arquivos .dat de paths de GTA 3 ou GTA Vice City da pasta data/paths, a saber flightX.dat, tracksX.dat, spathX.dat, onde X — é o número do arquivo.

Para exportar, é necessário selecionar UMA linha de path e clicar em exportar. O script solicitará que você selecione um arquivo para salvar.

Agradecimentos: Shagg_E; Starenat — pelo suporte ao escrever o script.

Agradecimentos especiais: Ilufir — pela ajuda com a estrutura dos paths de GTASA, ZZPuma — pela informação sobre os semáforos dos paths de GTASA.

É utilizado o código do script SA Path Tool de autoria de Deniska.

31/12/2024