View source for Pt-br/XBLAH's Modding Tool

{{GoldSrc topicon}} {{Source topicon}} {{Source 2 topicon}}

{{LanguageBar}}

{{SoftwareBox
<!-- Basic info -->
| title     = XBLAH's Modding Tool Details
| image     = Software Cover - XBLAH's Modding Tool.jpg

<!-- Details -->
| initial_release = 11 de Janeiro, 2020
| stable_release = 13 de Janeiro, 2024
| written_in = csharp
| distribution = Commercial software
| type = Mod tool • Map compiler • Map tool • Model compiler • Model tool • Texture tool • Sound tool • VPK tool

<!-- Operating system(s)-->
| windows = 1

<!-- Target engine(s)-->
| goldsrc = 1
| source = 1
| source2 = 1

}}

{{Xblahmt|4}} é um ambiente de desenvolvimento integrado criado pelo '''[[User:XBLAH|XBLAH]]''' para melhorar a produtividade e a qualidade de vida dos modders dos {{Valve|4.1|jogos da Valve}}.

O IDE inclui recursos como criação de mods, edição de mapas, compilação e descompilação, compilação, edição e descompilação de modelos, edição de materiais, edição de paisagens sonoras, empacotamento e descompactação de vpk e scripts e automação em geral.

{{notice|A partir de dezembro de 2023, com a versão 2.0 ou mais recente, a Ferramenta de Modding da XBLAH estará disponível em duas edições. A Essentials Edition, gratuita, e a Advanced Edition, que requer uma assinatura do [https://www.patreon.com/xblah Patreon].}}


__TOC__

= Funcionalidades =
[[File:XBLAH's Modding Tool - Welcome Tab - v2.2.0.png|thumb|480px|{{xblahmt|4}} - Tela de Boas Vindas]]
{{Xblahmt|4}} é organizado em diferentes painéis, dependendo da função que você tem no desenvolvimento do mod. Há painéis disponíveis para líderes de mods, designers de níveis, designers de materiais, designers de modelos, designers de som, programadores, animadores e designers de partículas, cada um com um conjunto de ferramentas especializadas nesse campo.
{{notice|A Essentials Edition contém apenas o Modding Dashboard e parte do Level Design Dashboard. A Advanced Edition contém o conjunto completo de ferramentas.}}

== Jogo ==

;Criando um Mod
:{{L|Create a Mod|Criando um mod simples}} Normalmente precisa de mais do que apenas criar um {{L|liblist.gam}} ou um {{L|gameinfo.txt}}. Mods baseados em jogos {{gldsrc|4}} e {{source|4}} podem ser criados com o {{Xblahmt|4}} usando uma interface intuitiva, que cria todos os arquivos e diretórios necessários. Os mods do {{mapbase|4}} também são compatíveis. ({{L|XBLAH's_Modding_Tool/Docs/Game/New Mod|Veja a documentação}}).

;Mods de atualização
:Caso tenha adicionado ou modificado manualmente algum mod para o jogo atual, você pode atualizar a lista de mods. ({{L|XBLAH's_Modding_Tool/Docs/Game/Refresh Mods|Ver documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Create a mod v1.17.0.png|Criando um mod
</gallery>

== Modificação ==
;Executar um Mod
:Você pode executar mods diretamente do {{Xblahmt|4}}, sem precisar reiniciar o Steam quando criar ou instalar um novo mod. O {{Xblahmt|4}} suporta vários modos de execução diferentes. Ele contém predefinições básicas para cada jogo, e você pode adicionar novas predefinições.  ({{L|XBLAH's_Modding_Tool/Docs/Mod/Run|Veja a documentação.}})

;Abra a pasta Mod
:{{Xblahmt|4}} fornece um atalho para a pasta de mods selecionada, o que se mostra útil caso você precise modificar algum arquivo manualmente. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Open_Mod_Folder|Veja a documentação.}})

;Explorador de arquivos
:Todos os arquivos montados nas informações do jogo podem ser visualizados com {{Xblahmt|4}} no Explorador de arquivos. O File Explorer substitui o {{L|GCFScape}} como a melhor ferramenta de navegação de arquivos, pois ele monta todos os VPKs e arquivos soltos de acordo com as informações do jogo, para mostrar ao modder uma lista abrangente de arquivos. Isso alivia o modder da necessidade de procurar vpks individualmente, e os recursos integrados da ferramenta geralmente dispensam a necessidade de extrair os arquivos dos vpks, já que eles podem ser acessados nativamente clicando duas vezes no arquivo (ou clicando com o botão direito do mouse para obter mais opções). ({{L|XBLAH's_Modding_Tool/Docs/Mod/File_Explorer|Veja a documentação.}})

;Deletando um mod
:Você pode excluir o mod selecionado caso não queira mais trabalhar com ele ou tê-lo.({{L|XBLAH's_Modding_Tool/Docs/Mod/Delete_Mod|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's_Modding_Tool_-_Modding_-_Run_-_Expert_Mode.png|Executando um mod
Image:XBLAH's Modding Tool - Modding - File explorer.png|Explorador de Arquivos
</gallery>

=== Configuração do mod ===

;Informações do jogo
:As informações do mod podem ser editadas com {{Xblahmt|4}} por meio de uma interface de usuário abrangente, sem que o modder precise mexer em arquivos de texto. Ele inclui todas as principais chaves de {{gldsrc|4}} e {{source|4}}.({{L|XBLAH's_Modding_Tool/Docs/Mod/Game_Info|Veja a documentação.}})

;Montagem de assets de jogos
:O conteúdo montado no mod pode ser editado com {{Xblahmt|4}}, apontando para diretórios e {{L|VPK|VPKs}} na ordem desejada, sem o risco de bagunçar o {{L|Gameinfo.txt|game info}}. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Content_Mount|Veja a documentação.}})

;Gerenciando capítulos
:Os capítulos para jogos de um jogador podem ser criados com {{Xblahmt|4}} por meio de uma interface do usuário. O modder pode criar facilmente novos capítulos, selecionar as imagens do capítulo, as imagens de fundo do capítulo, o primeiro mapa do capítulo, o mapa de fundo, e a ferramenta fará o trabalho sujo de criar os vtfs, vmts e scripts necessários. Ela oferece a opção de desfocar automaticamente as imagens de fundo, de modo que o modder pode simplesmente tirar uma captura de tela do mapa de fundo e a ferramenta aplicará o desfoque usual. Isso substitui a necessidade de salvar {{L|VTF|VTFs}}, criar imagens de capítulo com proporções estranhas e assim por diante. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Chapters|Veja a documentação.}})

;Mapas iniciais
:Para jogos {{gldsrc|4}}, você pode definir o mapa que será executado quando você iniciar um novo jogo e o mapa que será executado quando você iniciar a seção de treinamento. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Starting_Maps|Veja a documentação.}})

;Itens do menu
:Os itens do menu principal podem ser adicionados, modificados ou removidos com {{Xblahmt|4}} com base em uma lista de opções fornecida. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Menu_Items|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Game Info v1.17.png|Informações
Image:XBLAH's Modding Tool - Content Mount v1.17.png|Montando o conteúdo
Image:XBLAH's Modding Tool - Chapters v1.17.0.png|Capítulos Single-Player
Image:XBLAH's Modding Tool - Starting maps v1.17.png|Mapas iniciais
Image:XBLAH's Modding Tool - Menu Items v1.17.png|Editor do menu do jogo
</gallery>

=== Gerenciamento de arquivos ===
;Empacotar arquivos manualmente
:Em vez de distribuir arquivos soltos, você pode selecionar os arquivos que deseja e empacotá-los em um {{L|VPK}}. Os arquivos selecionados serão excluídos automaticamente depois de serem empacotados no {{L|VPK}}, limpando a pasta do mod. O {{L|VPK}} será salvo em {{path|MOD_NAME/custom/}}. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Pack_Files_Manually|Veja a documentação.}})

;Subdiretório de pacotes em {{path|MOD_NAME/custom/}}
:Em vez de empacotar manualmente os arquivos em um {{L|VPK}}, você pode selecionar uma pasta no diretório {{path|MOD_NAME/custom/}} e ele converterá todos os arquivos descompactados em um único {{L|VPK}}. Você terá a opção de excluir os arquivos descompactados. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Pack_Files_Manually|Veja a documentação.}})

;Descompactação de arquivos
:Você pode converter rapidamente {{L|VPK|VPKs}} montados em arquivos descompactados para ajudar no processo de modificação. Todos os arquivos no {{L|VPK}} serão extraídos para a pasta mod e você terá a opção de excluir o {{L|VPK}}. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Pack_Files_Manually|Veja a documentação.}})

;Limpar arquivos temporários
:Antes de enviar o mod, o {{Xblahmt|4}} fornece ao modder uma lista de arquivos desnecessários, que podem ser removidos com o apertar de um botão. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Clean_Files|Veja a documentação.}})

;Remover Duplicados
:A ferramenta listará todos os arquivos que tenham o mesmo nome, diretório relativo e conteúdo e que estejam montados pelo menos duas vezes, e dará a você a opção de excluir os arquivos descompactados extras com um único clique no botão. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Remove_Duplicates|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Clean Files v1.17.png|Limpeza de arquivos
Image:XBLAH's_Modding_Tool_-_Pack_Files_Manually_v1.17.png|Packing Files Manually
Image:XBLAH's_Modding_Tool_-_Pack_Custom_Folder_v1.17.png|Empacotar arquivos manualmente {{path|MOD_NAME/custom/}}
Image:XBLAH's Modding Tool - Unpack Files v1.17.png|Descompactação de arquivos
</gallery>

== Animações ==

;Editor de cenas
O Source Choreography Editor será configurado automaticamente se você o executar por meio do {{Xblahmt|4}}, corrigindo os ícones ausentes. Para jogos compatíveis, o Scene Maker será instalado e executado em seu lugar. ({{L|XBLAH's_Modding_Tool/Docs/Animations/Scene_Editor|Veja a documentação.}})

{{note|O Scene Maker foi desenvolvido por [[User:Cvoxalury|Cvoxalury]], está disponível gratuitamente e pode ser baixado {{L|https://drive.google.com/file/d/1UBUN3ks5f_1_g8ecAXQpL_mC55-57jQp/view?usp=share_link here}}. Você não precisa ter acesso ao {{xblahmt|4}} para baixar ou executar o Scene Maker.}}

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool v1.17 - Scene maker.png|Criador de cenas
</gallery>

== Mapas ==
;Editor de Mapas:
:{{hammer3|4}} e o {{hammer|4}} serão configurados automaticamente se forem executados por meio do {{Xblahmt|4}}. O {{jack|4}} será instalado e configurado para jogos {{gldsrc|4}} compatíveis. O {{hammerpp|4}} será instalado e configurado para jogos {{source|4}} compatíveis. ({{L|XBLAH's_Modding_Tool/Docs/Maps/Map_Editor|Veja a documentação.}})

;Compilação de mapas
:Os mapas para {{source|4}} podem ser compilados por meio da ferramenta. A ferramenta listará e explicará as opções mais comuns de compilação, tornando-a o mais intuitiva possível. ({{L|XBLAH's_Modding_Tool/Docs/Maps/Compile|Veja a documentação.}})

;Descompilação de Mapas
:Os mapas compilados para {{gldsrc|4}} e {{source|4}} podem ser descompilados por meio da ferramenta. A ferramenta listará todos os mapas montados, tanto os arquivos soltos quanto os que estão dentro dos {{L|VPK|VPKs}}. Você poderá descompilar os mapas sem precisar extraí-los antes. ({{L|XBLAH's_Modding_Tool/Docs/Maps/Decompile|Veja a documentação.}})

;Abra a pasta Prefabs
:{{Xblahmt|4}} fornece um atalho para a pasta Prefabs do jogo selecionado, o que se mostra útil caso você precise modificar algum arquivo manualmente. ({{L|XBLAH's_Modding_Tool/Docs/Maps/Open_Prefabs_Folder|Veja a documentação.}})

;Extrair ativos usados
:Você pode selecionar {{Path||vmf|icon=file}} em {{Xblahmt|4}} e ele listará todos os recursos necessários para os arquivos selecionados, mostrando a qual pacote ou pasta solta eles pertencem e oferecendo a opção de copiar o que você deseja para uma pasta separada em {{path|MOD_NAME/custom/}}. Por padrão, ele selecionará todos os arquivos que não estiverem localizados dentro de {{Path|||vpk|icon=file}}, mas você pode extrair os arquivos do {{Path|||vpk|icon=file}} em qualquer lugar, se desejar, caso esteja usando recursos de jogos que não são de todos. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Extract_Used_Assets|Veja a documentação.}})

;Gerador de construção
:O {{Xblahmt|4}} vem com um gerador de construção para o Source. A ferramenta inclui alguns arquivos de exemplo, e os usuários podem criar seus próprios modelos. ({{L|XBLAH's_Modding_Tool/Docs/Maps/Building_Generator|Veja a documentação.}})


<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool v1.17 - Hammer++.png|Editor de mapas
Image:XBLAH's Modding Tool - Compile Maps v1.17.png|Compilando Mapas
Image:XBLAH's Modding Tool - Maps - Decompile.png|Descompilando Mapas
Image:XBLAH's_Modding_Tool_-_Assets_Copier_v1.17.png|Extrair ativos usados
Image:XBLAH's Modding Tool - Building Generator v1.17.png|Gerador de construção
</gallery>

== Materiais ==
;Editor de Materiais
:{{Xblahmt|4}} pode ser usado para criar arquivos {{Path||vtf}} e {{Path||vmt|icon=file}}. Também pode ser usado para gerar {{L|Bump_map|mapas normais}}. ({{L|XBLAH's_Modding_Tool/Docs/Materials/Material_Editor|Veja a documentação.}})

;Editor de WADs
:{Você pode visualizar, editar e criar arquivos {{Path|WAD|icon=file}}. ({{L|XBLAH's_Modding_Tool/Docs/Materials/WAD_Editor|Veja a documentação.}})

;Editor de Detalhes
:Os arquivos de detalhes {{Path|details|vbsp|icon=file}} podem ser criados ou editados usando o {{Xblahmt|4}}. O editor mostra uma visualização dos objetos de detalhe, exibindo sprites e objetos, e está integrado ao Explorador de arquivos para facilitar a criação de novos objetos de detalhe. ({{L|XBLAH's_Modding_Tool/Docs/Materials/Details_Editor|Veja a documentação.}})

;Editor de Skyboxes
:Os Skyboxes podem ser criados diretamente a partir de arquivos de imagem com o {{Xblahmt|4}} usando uma interface intuitiva, que cria todos os vtfs e vmts necessários. Tudo o que você precisa fazer é selecionar cada face do cubemap, visualizá-lo e salvar. Ele tem um visualizador 3D integrado para que você verifique se o skybox está perfeito e é compatível com os skyboxes quadrados regulares e com os fixados. Ele também fornecerá a você as configurações ideais de {{ent|light_environment}}, {{ent|env_sun}} e {{ent|env_fog_controller}} para cada céu. ({{L|XBLAH's_Modding_Tool/Docs/Materials/Skybox_Editor|Veja a documentação.}})

;Extrair ativos usados
:Você pode selecionar {{L|VMT|VMTs}} em {{Xblahmt|4}} e ele listará todos os recursos necessários para os arquivos selecionados, mostrando a qual pacote ou pasta solta eles pertencem e oferecendo a opção de copiar o que você deseja para uma pasta separada em {{path|MOD_NAME/custom/}}. Por padrão, ele selecionará todos os arquivos que não estão localizados dentro de {{L|VPK|VPKs}}, mas você pode extrair os arquivos dos {{L|VPK|VPKs}} em movimento, se desejar, caso esteja usando recursos de jogos que não são de todos. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Extract_Used_Assets|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool v1.18.1.1 - Material Editor.png|Editor de Materiais
Image:XBLAH's Modding Tool - WAD Editor v1.15.png.png|Editor de WADs
Image:XBLAH's Modding Tool - Detail Editor v1.18.1.png|Editor de Detalhes
Image:XBLAH's Modding Tool - Skybox Editor v1.17.png|Editor de Skyboxes
</gallery>

== Modelos ==
;Decompile Models
:Os modelos compilados para {{gldsrc|4}} e {{source|4}} podem ser descompilados por meio da ferramenta {{Xblahmt|4}}. A ferramenta listará todos os modelos montados, tanto os arquivos soltos quanto os que estão dentro dos {{L|VPK|VPKs}}. Você poderá descompilar os modelos sem precisar extraí-los antes. ({{L|XBLAH's_Modding_Tool/Docs/Models/Decompile|Veja a documentação.}})

;Extrair assets usados
:Você pode selecionar {{L|MDL|MDLs}} em {{Xblahmt|4}} e ele listará todos os recursos necessários para os arquivos selecionados, mostrando a qual pacote ou pasta solta eles pertencem e oferecendo a opção de copiar o que você deseja para uma pasta separada em {{path|MOD_NAME/custom/}}. Por padrão, ele selecionará todos os arquivos que não estão localizados dentro de {{L|VPK|VPKs}}, mas você pode extrair os arquivos dos {{L|VPK|VPKs}} em movimento, se desejar, caso esteja usando recursos de jogos que não são de todos. ({{L|XBLAH's_Modding_Tool/Docs/Mod/Extract_Used_Assets|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Decompile Models.png|Descompilando um modelo
</gallery>

== Particulas ==
;Gerar o Manifesto de Partículas
:Um arquivo {{L|Particles_manifest.txt|manifest}} é necessário para renderizar as partículas no jogo. O arquivo {{L|Particles_manifest.txt|Particle Manifest}} pode ser gerado automaticamente com o {{Xblahmt|4}}, com base em todos os arquivos de partículas montados no mod. ({{L|XBLAH's_Modding_Tool/Docs/Particles/Generate_Particle_Manifest|Veja a documentação.}})
;Conversor de versão PCF
:Os arquivos {{L|PCF|particle files}} gerados terão formatos diferentes, dependendo do jogo base. Esses arquivos podem ser convertidos em um formato de arquivo compatível com {{xblahmt|4}}. ({{L|XBLAH's_Modding_Tool/Docs/Particles/Version Converter|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - PCF Version Converter.png|Conversor de versão PCF
</gallery>

== Scripts ==
;Editor de Localização
:As cadeias de caracteres {{L|VGUI_Documentation#Localization|Localização}} podem ser adicionadas e editadas por meio de uma interface de usuário intuitiva com {{Xblahmt|4}}. ({{L|XBLAH's_Modding_Tool/Docs/Scripts/Locatization_Editor|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Localization.png|Editor de Localização
</gallery>

== Sons ==
;Editor de Soundscapes
:{{L|Soundscape|Soundscapes}} agora podem criar ou modificar facilmente usando o {{Xblahmt|4}}. A interface do usuário oferece uma maneira intuitiva de criar novas paisagens sonoras, usando o explorador de arquivos integrado. Isso permite que o usuário navegue por todos os arquivos montados ({{Path||vpk|icon=file}} e arquivos soltos), permite que o usuário visualize os arquivos individualmente e permite que o usuário visualize como toda a paisagem sonora será reproduzida no jogo. ({{L|XBLAH's_Modding_Tool/Docs/Sounds/Soundscape_Editor|Veja a documentação.}})

;Gerar o manifesto de paisagem sonora
:É necessário um arquivo de manifesto para que você possa reproduzir {{L|Soundscape|soundscapes}} no jogo. O arquivo de manifesto de paisagem sonora pode ser gerado automaticamente com {{Xblahmt|4}}, com base em todos os arquivos de paisagem sonora montados no mod. ({{L|XBLAH's_Modding_Tool/Docs/Sounds/Generate_Soundscape_Manifest|Veja a documentação.}})

;Gerar o manifesto de sons do jogo
:Você precisa de um arquivo de manifesto para fazer o pré-armazenamento dos sons no jogo. O arquivo de manifesto de sons do jogo pode ser gerado automaticamente com {{Xblahmt|4}}, com base em todos os arquivos de som do jogo montados no mod. ({{L|XBLAH's_Modding_Tool/Docs/Sounds/Generate_Game_Sounds_Manifest|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Soundscape Editor.png|Editor de Soundscapes
</gallery>

== Opções ==
;Bibliotecas Steam
:As bibliotecas usadas pelos jogos e mods na ferramenta são definidas automaticamente se você tiver uma instalação legítima do Steam. Lembre-se de que as bibliotecas definidas aqui são usadas apenas pela ferramenta, e os jogos e mods ainda usarão suas gameinfo para montar seus conteúdos. ({{L|XBLAH's_Modding_Tool/Docs/Options/Steam_Libraries|Veja a documentação.}})

;Presença do Discord
:Por padrão, a ferramenta permite que seus amigos do Discord saibam no que você está trabalhando. Se quiser privacidade, você pode configurar o que é mostrado no Discord. As opções são mostrar o jogo e o mod em que você está trabalhando, apenas o jogo que você selecionou no momento ou não mostrar nada. ({{L|XBLAH's_Modding_Tool/Docs/Options/Discord_Presence|Veja a documentação.}})

<gallery mode=nolines widths=384px heights=288px>
Image:XBLAH's Modding Tool - Steam Libraries v1.17.png|Bibliotecas Steam
Image:XBLAH's Modding Tool v1.17 - Discord Presence.png|Presença do Discord
</gallery>

= XBLAH's Modding Tool para Equipes =
Os Patrons VIP têm direito a criar uma equipe de até 10 membros para usar o {{Xblahmt|4}}. Você pode adicionar outros membros aumentando o compromisso em US$ 1/membro.

Para criar uma equipe, o Patron VIP deve [https://xblah.dev/xblah-modding-tool registrar] usar o mesmo e-mail usado para se comprometer no Patreon. Os membros da equipe também devem se registrar, embora não seja necessário que tenham uma conta no Patreon. O gerente da equipe poderá então adicionar os membros às vagas disponíveis.

= Links Externos =
* [https://modding-assets.net/source/tools/modding/xblah-modding-tool/ XBLAH's Modding Tool] página em [https://modding-assets.net Modding Assets.net]
* [https://www.moddb.com/downloads/xblahs-modding-tool ModDB] - última versão grátis (1.13)
* [https://www.patreon.com/xblah Página do Patreon]

{{sdktools|1}}

{{goldsrc sdktools}}

{{sdktools|0}}

{{sdktools/source2|0}}

{{ACategory|Third Party Tools}}
{{ACategory|Third Party Source Tools}}
{{ACategory|Third Party GoldSrc Tools}}
{{ACategory|Non-Steam Applications}}