Tutorial – Instalação e Uso do Addon O3D/CFG para Blender
Aviso Importante
Este addon foi testado no Blender 3.6.23 e funcionou corretamente durante os testes realizados.
Ainda não foi verificado se ele funciona em outras versões do Blender, portanto recomenda-se utilizar a versão 3.6.23 para evitar incompatibilidades.
Créditos e Base do Projeto
Este addon foi desenvolvido unindo recursos de dois projetos já existentes da comunidade OMSI para Blender.
Exportador O3D:
A parte de exportação é baseada no projeto:
Blender-OMSI-Exporter (Road-hog123)
O projeto original fornece a estrutura de exportação de modelos OMSI para o formato .o3d, incluindo suporte a materiais, UVs, pesos de vértices (Skin Weights) e demais recursos necessários para exportação de objetos do Blender para o OMSI.
Importador O3D / CFG
A parte de importação foi baseada no projeto:
Blender-O3D-IO-Public (space928)
O projeto original possui suporte à importação e exportação de arquivos .o3d, .cfg e .sco, incluindo materiais, bones, UVs, LODs e diversos recursos do formato OMSI.
Melhorias Implementadas Nesta Versão
Além dos recursos existentes nos projetos originais, foram realizadas algumas modificações para melhorar a compatibilidade com modelos de ônibus articulados e projetos complexos do OMSI.
> Importação de múltiplos arquivos O3D
O importador foi modificado para permitir a leitura e carregamento de múltiplos arquivos .o3d referenciados em um mesmo .cfg, facilitando a importação completa de veículos compostos por vários modelos.
> Correções para veículos articulados
Foram implementadas melhorias na importação de articulações, corrigindo problemas relacionados à criação e vinculação dos bones utilizados em ônibus articulados.
Essas alterações reduzem erros de importação, melhoram o posicionamento das partes articuladas e facilitam a edição dos modelos dentro do Blender.
Ajustes gerais de compatibilidade
Também foram realizados ajustes adicionais para tornar a importação mais estável em diferentes modelos OMSI, principalmente em projetos que utilizam estruturas mais complexas de CFG e múltiplos O3Ds.
Agradecimentos
Agradecimentos aos desenvolvedores originais:
Thomas Mathieson (space928)
Road-hog123
Sem esses projetos, o desenvolvimento deste addon não seria possível. As modificações realizadas têm como objetivo ampliar a compatibilidade e facilitar o fluxo de trabalho para modeladores da comunidade OMSI.
O que este addon faz?
O addon permite trabalhar com modelos do OMSI(.o3d/cfg) diretamente no Blender.
Recursos disponíveis
Importação
- Importar arquivos .O3D
- Importar arquivos .CFG
- Importar arquivos .RDY
- Importação de múltiplos arquivos simultaneamente
- Opção para ocultar LODs inferiores
- Opção de ajuste de codificação de texto (Encoding Override)
- Opção para importar arquivos auxiliares X
Exportação
- Exportar modelos para .O3D
- Gerar automaticamente arquivo .CFG
- Exportação de múltiplos objetos selecionados
- Exportação de luzes OMSI através de objetos especiais
- Suporte a materiais
- Suporte a UV Maps
- Suporte a Skin Weights
- Opções avançadas de compatibilidade OMSI 1
Instalação do Addon
1. Baixe o arquivo ZIP
Mantenha o arquivo:
io_export_o3d_fkn.zip
Não extraia o conteúdo.
2. Abra o Blender
Abra o Blender 3.6.23.
3. Instale o addon
Vá em:
Edit
└─ Preferences
└─ Add-ons
└─ Install...
Selecione:
io_export_o3d_fkn.zip
Clique em:
Install Add-on
4. Ative o addon
Após a instalação, marque a caixa ao lado do addon:
O3D Exporter
Feche a janela de Preferências.
Como Importar Arquivos OMSI
Vá em:
File
└─ Import
└─ Import O3D/CFG
O addon aceitará:
.o3d
.cfg
.rdy
Opções de Importação
Import X Files
Import X files
Importa arquivos auxiliares referenciados pelo modelo.
Recomendado:
Ativado
Hide Lower LODs
Hide lower LODs
Oculta LODs de menor qualidade após a importação.
Útil para trabalhar apenas com o modelo principal.
Encoding Override
Encoding Override
Permite forçar uma codificação específica caso o CFG apresente caracteres estranhos.
Exemplos:
latin1
cp1252
utf-8
Normalmente pode ficar em branco.
Como Exportar para OMSI
Selecione os objetos desejados.
Depois vá em:
File
└─ Export
└─ Export O3D/CFG
Opções de Exportação
SDK Compatibility
SDK Compatibility
Mantém compatibilidade com OMSI 1.
Ative apenas se necessário.
Apply Transforms
Escolha quais transformações serão aplicadas:
Location
LOC
Posição.
Rotation
ROT
Rotação.
Scale
SCA
Escala.
Normalmente:
LOC + ROT + SCA
Animation Origin
Animation Origin
Exporta matriz de transformação para animações.
Recomendado deixar ativado.
Merge Materials Within Objects
Merge Materials Within Objects
Une materiais duplicados dentro do mesmo objeto.
Recomendado:
Ativado
Merge Materials Between Objects
Merge Materials Between Objects
Une materiais repetidos entre diferentes objetos.
Recomendado:
Ativado
UV Layer
Escolha qual mapa UV será exportado.
Selected
Selected
UV atualmente selecionado.
Render
Render
UV marcado para renderização.
Normalmente:
Render
Skin Weights
Skin Weights
Exporta pesos de vértices para deformações.
Ative apenas quando necessário.
Material Output Node
Permite selecionar qual saída de material será utilizada.
Name
Nome do nó de saída.
Padrão:
Export
Render Target
Pode exportar materiais destinados a:
All
Eevee
Cycles
Exportação Automática do CFG
Ao exportar, o addon também gera automaticamente um arquivo:
nome_do_modelo.cfg
junto com os arquivos O3D.
Objetos Especiais para Luzes OMSI
O addon reconhece objetos pelo nome. (luzes em desenvolvimento, em breve outro tutorial)
Basta criar um objeto vazio ou mesh e utilizar os nomes abaixo.
Interior Light
Nome:
::interiorlight
Será exportado como:
[interiorlight]
no CFG.
SpotLight
Nome:
::spotlight
Será exportado como:
[spotlight]
SpotLight de longo alcance
Adicione:
_high_
ao nome.
Exemplo:
::spotlight_high_farol
O alcance será aumentado automaticamente.
Light Enh 2
Nome:
::light_enh
Será exportado como:
[light_enh_2]
no CFG.
Dicas de Uso
Antes de exportar
Aplicar transformações:
Ctrl + A
└─ Rotation & Scale
evita problemas de posicionamento.
Organização
Mantenha:
Materiais nomeados corretamente
UVs revisadas
Escala correta
antes da exportação.
Exportação de vários objetos
O addon exporta todos os objetos selecionados.
Portanto:
Selecione somente o que deseja exportar.
Solução de Problemas
Menu não aparece
Verifique se:
Edit → Preferences → Add-ons
e confirme que:
O3D Exporter
está ativado.
Erro ao importar CFG
Tente alterar:
Encoding Override
para:
latin1
ou
cp1252
Modelo sem textura
Verifique:
- Caminhos das texturas
- UV Maps
- Arquivos DDS presentes na pasta do projeto
Conclusão
Este addon permite importar e exportar modelos OMSI em O3D, CFG e RDY diretamente pelo Blender, além de gerar automaticamente arquivos CFG e exportar luzes especiais reconhecidas pelos nomes dos objetos. Nos testes realizados, o funcionamento foi confirmado no Blender 3.6.23, sendo esta a versão recomendada até que a compatibilidade com outras versões seja verificada.
*Observação, melhorias que pretendo fazer para próxima versão, no final o processo de conversão vai ser mais rápido usando as diversas ferramentas que o Blender proporciona.
> luzes funcionando 100% importanto e exportando.
> Cria caminhos automatico [passengercabin] usando o Empty e nomea de "caminhao_xx", "porta_1_xx", entrada e saida.
> Cria posicao dos passageiros em pé e sentado [paths]
