Atualmente, o Mod Loader Ă© o mod mais apreciado e utilizado pelos usuĂĄrios.

Assim, agora vamos aprofundar nossos conhecimentos sobre ele...


Neste tutorial, pretendo demonstrar desde os conceitos mais bĂĄsicos atĂ© os mais complexos que, provavelmente, vocĂȘ nem imaginava ser possĂ­vel. Sim, Mod Loader nĂŁo Ă© apenas uma pasta para armazenar mods.

A DOCUMENTAÇÃO GRANDE
Claro, nĂŁo Ă© necessĂĄrio ler tudo, mas tente ler o mĂĄximo possĂ­vel, pois Ă© proveitoso.


(Abra o post para ler)




ESTA DOCUMENTAÇÃO FOI CRIADA EM BASE DA VERSÃO V0.2.5 DO MODLOADER



BĂĄsicos

Como instalar mods
"modloader\infernus.txd" - ERRADO
"modloader\.data\infernus.txd" - ERRADO
"modloader\alguma pasta\infernus.txd" - CERTO
"modloader\alguma pasta\quantas pastas quiser\infernus.txd" - CERTO

Detalhe: Se o nome da pasta estiver em russo, chinĂȘs ou outra lĂ­ngua e o seu computador nĂŁo for (quase todos que estĂŁo lendo isso sĂŁo brasileiros, certo?), ele poderĂĄ bugar. Para resolver isso, renomeie as pastas para letras comuns.

Como instalar linhas do arquivo "leiame/ree"
O Mod Loader certamente Ă© um refĂșgio para os preguiçosos, vocĂȘ pode atĂ© mesmo inserir linhas de instalação manual nos arquivos .txt (como "instale esta linha no seu handling.cfg") e o Mod Loader irĂĄ ler o arquivo .txt e instalar a linha automaticamente! Apenas coloque o arquivo .txt em qualquer pasta. (Excelente para instalar veĂ­culos!!!)
O tamanho mĂĄximo de um arquivo .txt que pode ser lido na versĂŁo 0.2.4 Ă© 10(?) KBs. Foi aumentado para 60 KBs a partir da versĂŁo v0.2.5.

Como saber o que o Mod Loader a
Atualmente, o Mod Loader a quase tudo, portanto, normalmente não é necessårio se preocupar com isso. No entanto, sempre existem exceçÔes, portanto:
"Modloader\.data\extensores\GTA3"
Nesta pasta existem arquivos .md que podem ser ados através do bloco de notas (botão direito > abrir como).
Por exemplo, abra o arquivo std.data.md, a seguir uma print traduzida:
(A print foi tirada da versĂŁo v0.2.4)
Em outras palavras, "fusĂŁo" refere-se Ă  junção de dois ou mais arquivos em um Ășnico, enquanto "leiame" refere-se Ă  leitura e instalação das linhas desses arquivos diretamente de um arquivo .txt que normalmente acompanha o mod.
Como se pode observar, o Mod Loader atualmente substitui (ou melhor, instala/carrega) todos os tipos de arquivos data.

Nos outros arquivos .md existem mais informaçÔes sobre a instalação, vou destacar os detalhes relevantes aqui:


Sobre Instalação:
No Mod Loader, tudo o que vocĂȘ precisa fazer Ă© colocar o conteĂșdo do mod em uma pasta, porĂ©m, em algumas situaçÔes, Ă© necessĂĄrio deixar em formatos especĂ­ficos.
Normalmente, é necessårio deixar o arquivo dentro da pasta com o caminho da pasta ou arquivo para onde ele vai, para que o Mod Loader possa identificar o local adequado para a instalação. Veja:


Instalando mods Cleo
Sim, o Mod Loader pode carregar mods cleos instalados de qualquer maneira em qualquer pasta. No entanto, Ă© aconselhĂĄvel instalĂĄ-los em uma pasta cleo, jĂĄ que a maioria dos mods cleos utiliza arquivos de terceiros, e se estiverem fora de uma pasta cleo, o programa nĂŁo conseguirĂĄ localizar os arquivos.
Por exemplo, "modloader\nĂŁo importa\cleo", garantindo que o mod cleo funcione corretamente.

(Foi relatado que arquivos .mp3 nĂŁo sĂŁo carregados pelo Mod Loader, mesmo estando dentro de uma pasta cleo. Se vocĂȘ enfrentar esse problema, instale manualmente na pasta cleo.)

Alguns mods, por exemplo, possuem uma pasta "Audio" separada da pasta Cleo, contendo arquivos de ĂĄudio. Acredite ou nĂŁo, mesmo que vocĂȘ instale essas pastas normalmente no Mod Loader, o mod cleo ainda assim irĂĄ localizar e carregar o arquivo. (O Mod Loader Ă© mĂĄgico).


Instalando arquivos de sprites
Os sprites sĂŁo ficheiros .txd localizados na pasta "models\txd", normalmente sĂŁo imagens para scripts, minigames ou loadscreens, entre outros.
VocĂȘ precisa inserir esses arquivos .txt na pasta indicada. No exemplo: "modloader\algum mod\models\txd", somente dessa forma o Mod Loader entenderĂĄ que se trata de um arquivo .txd de sprites, e nĂŁo de modelos como gta3.img ou similares.


Instalando arquivos data
Geralmente vocĂȘ pode instalar todos eles de qualquer jeito, mas:

Arquivos decision (.ped/.grp) - Precisam estar dentro de uma pasta "*decision\allowed", por exemplo: "modloader\qualquer nome\decision\allowed".
Arquivos .IDE ou .IPL nĂŁo originais do jogo (adicionados) - Precisam estar com as linhas de carregamento instaladas (gta.dat).
NĂŁo Ă© aconselhĂĄvel alterar o seu gta.dat original - Para otimizar a fusĂŁo de arquivos gta.dat, mantenha sempre o seu "data/gta.dat" totalmente original e coloque novos gta.dat (ou linhas deles) no Mod Loader. NĂŁo edite o seu gta.dat na pasta data! Deixe tudo no Mod Loader. (Isso Ă© vĂĄlido para outros arquivos data, nĂŁo apenas o gta.dat!)

Importante: É aconselhável evitar a instalação de arquivos como handling.cfg, vehicles.ide e outros, já que o Mod Loader não mescla arquivos data com extensão .txt! 
Por exemplo, se vocĂȘ instalou um pacote de veĂ­culos que contĂ©m os arquivos handling.cfg, vehicles.ide, carcols.dat e carmods.dat, e agora deseja adicionar um novo carro a esse pacote, vocĂȘ deve manter o arquivo leiame/ree do carro em uma pasta para que o Mod Loader possa ler automaticamente as informaçÔes. O problema Ă© que, para o Mod Loader, o handling.cfg (entre outros arquivos data) terĂĄ sempre uma prioridade maior em relação aos arquivos .txt! 
Portanto, não serå possível utilizar um handling.cfg enquanto tenta instalar informaçÔes por meio de um .txt. Isso se aplica a qualquer arquivo data. O LINK/2012 comentou que solucionar isso é complicado, e até a versão atual, este "bug" permanece. 
Vale ressaltar que isso se aplica apenas a fusĂ”es de linhas idĂȘnticas; ao usar gta.dat ou um .txt que contenha linhas para gta.dat, nĂŁo haverĂĄ problemas, pois o Mod Loader simplesmente incorporarĂĄ a linha do .txt no seu gta.dat sem dificuldades.


Instalando arquivos de IMG's
VocĂȘ pode adicionar qualquer tipo de arquivo a um .img da forma usual, mas Ă© importante observar algumas regras:

Os arquivos de roupas novas que vocĂȘ deseja incluir (sem substituir os existentes) precisam ser colocados em uma pasta chamada "player.img". Por exemplo: "modloader\qualquer\player.img" (nĂŁo Ă© aceitĂĄvel usar "modloader\player.img") onde vocĂȘ deve adicionar suas novas roupas.

Os arquivos do tipo nodes#.dat também precisam estar dentro de uma pasta que tenha o nome do respectivo .img, como em "modloader\qualquer\gta3.img\nodes#.dat" (novamente, "modloader\gta3.img" não é permitida).

Instalar um .img completo também é viåvel. Basta inserir, por exemplo, um player.img no Mod Loader e tudo serå carregado corretamente (caso o .img seja novo, serå necessårio adicionar uma linha no gta.dat).


Instalando arquivos de ĂĄudio
Normalmente, os mods de ĂĄudio vĂȘm prontos ou organizados em pastas para serem inseridos diretamente no Mod Loader. Isso ocorre porque o Mod Loader corrige os arquivos de ĂĄudio, deixando-os sem artefatos. Atualmente, os mods de sons aproveitam essa vantagem e publicam arquivos separados para reduzir o tamanho do e simplificar a instalação.

No entanto, caso tenha baixado mods de åudio para instalação manual (vindos de arquivos.wav), siga as instruçÔes:
"(SFXPak_Name)/Bank(X)/sound(Y).wav"
Por Exemplo:

"modloader/meus sons/GENRL/Bank_007/sound_001.wav"
Portanto, o arquivo sound_001.wav serĂĄ adicionado ao GENRL, no banco 007.
O arquivo de ĂĄudio precisa estar no formato Mono PCM 16 bits, se nĂŁo estiver, use um programa de conversĂŁo. (O aviso de que o arquivo nĂŁo foi carregado estarĂĄ no Modloader.log)

AtĂ© agora, o Mod Loader nĂŁo instala arquivos de mĂșsica (.ogg de rĂĄdios, por exemplo), apenas instala os arquivos jĂĄ compilados e nĂŁo os.ogg  separadamente.


Instalando arquivos ASI
A maior incompatibilidade ocorre nos arquivos .asi, que utilizam elementos incompatíveis com o Mod Loader (jå que foram criados numa época em que nem se cogitava a possibilidade de tal coisa existir).
Portanto, vårios mods, como Ryosuke839 e Alexander Blade, não são compatíveis, além de outros.
Normalmente, o Mod Loader notifica automaticamente sobre um .asi incompatĂ­vel ao clicar no .exe do GTA SA.
Portanto, sĂł Ă© possĂ­vel instalar manualmente, fora do Mod Loader.
O mesmo se aplica às séries ENB, algumas não operaram corretamente dentro do Mod Loader.


Instalando arquivos COL
(super importante saber!)
Existem limit adjusters que ampliam o nĂșmero mĂĄximo de arquivos .COL permitidos. Mas, segundo o LINK/2012, isso nĂŁo Ă© aconselhĂĄvel, pois prejudica o jogo. O prĂłprio Open Limit Adjuster nĂŁo possui esse aumento de limite devido a isso. 
Portanto, COMO INSTALAR .COL SEM EXCEDER O LIMITE?
Eis que surge novamente o Mod Loader

Adicione o arquivo .col a uma em alguma pasta dentro do Mod Loader, por exemplo: "modloader\alguma pasta\outra\test.col"
Crie um arquivo .txt na pasta "alguma pasta" e inclua as seguintes informaçÔes:
COLFILE 0 outra\test.col
Pronto!
Realize o mesmo procedimento com todos os arquivos .col necessĂĄrios (podem estar todos na mesma pasta e no mesmo .txt, o .txt serve apenas para simular um leiame).
Nota: Quando o limite de .col Ă© ultraado, ocorre o erro "0x015632B0" ou "0x0040FB80"(?). (consultar a Lista de Crash)



Atualização de mods in-game
Mod Loader nĂŁo atualiza dentro do jogo nenhum tipo de mod de script, por inĂșmeros motivos. NĂŁo Ă© nada bom fazer isso com o jogo, pode causar bugs, crashes, vazamentos de memĂłria etc, entĂŁo o Mod Loader nĂŁo faz isso.
Handlings sĂŁo sim atualizados dentro do jogo (atualização: sĂł sĂŁo atualizados caso vocĂȘ use o IndieVehHandlings.cs), parece que nĂŁo... mas Ă© que na verdade os carros precisam ser recriados para assim eles ganharem o novo handling, portanto, se vocĂȘ estĂĄ afim de editar um handling sem sair do jogo, vocĂȘ pode, mas a cada atualização terĂĄ que spawnar um novo carro pro novo handling ser adicionado nele.



VocĂȘ estĂĄ com dĂșvida em instalar um tal arquivo e nĂŁo encontrou explicaçÔes aqui neste post?
NĂŁo entre em pĂąnico, instale de qualquer jeito, sĂł listei os tipos de arquivos na qual precisam instalar de forma diferente, todo o resto tĂȘm instalação normal sem se preocupar com os nomes das pastas.




Modloader.ini
No arquivo "modloader\modloader.ini" vocĂȘ pode configurar a instalação dos seus mods, Ă© um arquivo extremamente importante e indispensĂĄvel para vocĂȘ controlar seus mods instalados.

Geralmente dentro deste arquivo pode nĂŁo ter nenhum texto explicativo caso vocĂȘ jĂĄ teve o Mod Loader e instalou uma atualização, se vocĂȘ quer os textos explicativos novamente, vocĂȘ pode encontrĂĄ-los abrindo o arquivo "modloader\.data\modloader.ini.0" com o bloco de notas, lĂĄ dentro terĂĄ pequenas explicaçÔes, irei explicar melhor aqui:


.Config
Começando pelos båsicos.
Embaixo de "[Profiles.Default.Config]" temos:
"IgnoreAllMods" - Coloque "true" para ignorar todos os mods, basicamente irĂĄ desativar todo o carregamento de mods.
"ExcludeAllMods" - Coloque "true" para nĂŁo carregar todos os mods, exceto os listados em ".IncludeMods".
(hå mais 2 configuraçÔes, falarei na sessão "Perfis")


.Priority
(Ă© indispensĂĄvel vocĂȘ saber!!!)
Embaixo de "[Profiles.Default.Priority]" vocĂȘ pode colocar o nome das suas pastas seguido de um nĂșmero indicando a prioridade dela, simples.
Por exemplo:

[Profiles.Default.Priority]
Pack de carros = 10
Novos carros = 20

No exemplo, eu baixei um pack de carros, criei uma pasta "modloader\Pack de carros" e coloquei meu pack de carros ali.
Baixei alguns novos carros que gostei, entĂŁo eu criei uma pasta "modloader\Novos carros" e instalei meus novos carros lĂĄ dentro.
Dentro do modloader.ini eu deixei a pasta "Novos carros" com mais prioridade do que a "Pack de carros", para ela ser carregada "por cima" do Pack de carros, assim "substituindo" os carros do pack pelos novos que baixei (sem mudar nenhum arquivo!)

Se vocĂȘ nĂŁo organizar e configurar bem a prioridade de suas pastas dentro do Modloader, vocĂȘ possivelmente verĂĄ bugs como: Carros, pedestres ou objetos aparecendo brancos, onde ficar branco quer dizer: falta de textura, que quer dizer: .TXD errado ou faltando, pois por exemplo o Mod Loader carregou um .DFF de um mod mas com um .TXD de outro.
Além de outros problemas incontåveis, portanto, ao ver problemas em mods que substituem o mesmo arquivo que outro mod também substitui, aumente a prioridade da pasta de um mod ou então abaixe a prioridade da pasta de outro. Ou faça manualmente: Delete os arquivos de um dos mods (não recomendo).

Aproveitando: Packs de carros geralmente vĂȘm com arquivos .cfg, .ide e .dat, recomendo vocĂȘ ler a parte "Importante" ali em cima, na sessĂŁo "Instalando arquivos data" para nĂŁo ter problemas com handling nĂŁo carregando.

Os nĂșmeros da prioridade vĂŁo de 1 a 100, usar 0 faz a pasta nĂŁo ser carregada. Todas as pastas tĂȘm padrĂŁo "50", sendo assim, se vocĂȘ marcar uma pasta com prioridade em "40", ela serĂĄ carregada embaixo de todas as pastas na qual nĂŁo estĂŁo com prioridade alguma, pois as que nĂŁo tĂȘm prioridade no .ini, sĂŁo consideradas com prioridade "50".

FĂĄcil, nĂŁo? Se nĂŁo entendeu alguma coisa, releia devagar.


.IgnoreFiles
Embaixo de "[Profiles.Default.IgnoreFiles]" vocĂȘ pode colocar os nomes dos arquivos na qual vocĂȘ nĂŁo quer carregar (assim carregando o arquivo original do GTA SA.
Por exemplo:

[Profiles.Default.IgnoreFiles]
vehicle.txd

E assim nenhum vehicle.txd dentro do seu Mod Loader serĂĄ carregado (irĂĄ usar o vehicle.txd da pasta "models/generic".

FĂĄcil, nĂŁo?


.IgnoreMods
Embaixo de "[Profiles.Default.IgnoreMods]" vocĂȘ pode colocar os nomes das pastas para nĂŁo serem carregadas
Por exemplo:

[Profiles.Default.IgnoreMods]
Carros

E assim a pasta "Carros" nĂŁo serĂĄ carregada.

FĂĄcil, nĂŁo?


.IncludeMods
Embaixo de "[Profiles.Default.IncludeMods]" vocĂȘ coloca o nome das pastas na qual vocĂȘ quer que carregue quando estiver usando "ExcludeAllMods = true" em "[Profiles.Default.Config]", assim, todos os mods nĂŁo serĂŁo desativados e somente os mods listados embaixo de .IncludeMods serĂŁo carregados.


.ExclusiveMods
Embaixo de "[Profiles.Default.ExclusiveMods]" vocĂȘ coloca os nomes das pastas na qual vocĂȘ quer que carregue somente no atual perfil, e nĂŁo nos outros. (explicarei sobre Perfis logo!)
EXTREMAMENTE ÚTIL PARA CONVERSÕES TOTAIS.
Basta criar um perfil e colocar o nome da pasta da ConversĂŁo Total ai embaixo e estarĂĄ feito, assim quando vocĂȘ ativar o seu perfil (como dito antes aqui neste tutorial), o Mod Loader irĂĄ carregar somente a pasta com a conversĂŁo total. Se nĂŁo estĂĄ com o tal perfil ativo, o Mod Loader nĂŁo irĂĄ carregar a conversĂŁo total.
Assim vocĂȘ pode juntar .ExclusiveMods e colocar o nome da pasta da sua TC, e colocar embaixo de .IncludeMods as pastas que vocĂȘ quer que seja carregada junto com a TC.
Lembre-se que as conversĂ”es totais pode ter arquivos nĂŁo compatĂ­veis com o Mod Loader, geralmente ela vem com uns .dll e .asi que vocĂȘ precisa deletar entre outras coisas.
Para mais informaçÔes e explicaçÔes: Clique aqui para ver uma wiki de como instalar conversÔes totais e ver quais são ou não compatíveis com ele


Glob
Antes de falar sobre perfis, saiba que vocĂȘ pode tambĂ©m usar glob no modloader.ini
Isso cria tantas, mas tantas possibilidades que Ă© impossĂ­vel citar tudo neste post.
Clique aqui para uma pĂĄgina (pequena) na Wikipedia (PortuguĂȘs)
Clique aqui para uma pĂĄgina (bem completa) na Wikipedia (InglĂȘs)
Tudo listado ai funciona no Mod Loader (exceto os [], por compatibilidades de nomes)

Alguns exemplos para vocĂȘs terem noção:

[Profiles.Default.IgnoreFiles]
*.ifp

NĂŁo irĂĄ carregar nenhum arquivo .ifp



[Profiles.Default.IgnoreMods]
?car

NĂŁo irĂĄ carregar as pastas com nome "carro" ou "car" ou "scarface" etc


[Profiles.Default.IgnoreMods]
exemplo/*

NĂŁo irĂĄ carregar os arquivos nesta pasta:
"modloader/alguma coisa/exemplo"
Mas irĂĄ carregar nesta:
"modloader/alguma coisa/exemplo/coisa"


[Profiles.Default.IgnoreMods]
exemplo/**

(Isso não estå listado no Wikipedia mas também é ado)
"modloader/alguma coisa/exemplo/coisa/outra coisa"
NĂŁo irĂĄ carregar nem a pasta "exemplo" e nem nenhuma dentro dela. SĂł irĂĄ carregar a pasta "alguma coisa"

etc etc etc etc


Perfis
(ótimo para usar no SAMP ou ConversÔes Totais!)
Ainda no modloader.ini, vocĂȘ pode criar perfis e ter vĂĄrios GTA num sĂł!!
É isso mesmo, vocĂȘ pode criar conjuntos de mods no mesmo GTA, Ăłtimo para vĂĄrias situaçÔes, principalmente conversĂ”es totais ou SA-MP.

Embaixo de "[Folder.Config]" vocĂȘ tem "Profile = Default", onde "Default" Ă© o perfil padrĂŁo que jĂĄ vem no Mod Loader
Como pode se ver no .ini, vocĂȘ tem um monte de ".Default", como "[Profiles.Default.Priority]", onde este "Default" Ă© o nome do perfil da tal configuração.
(o nome do perfil nĂŁo Ă© case sensitive, pode por exemplo usar "default" ou "DEFAULT" que tanto faz)

Vamos usar um exemplo simples:
(na print acima eu usei o Notepad++ pra ficar mais bonito, claro, Ă© a mesma coisa usando Bloco de Notas)

Aqui eu configurei para usar o perfil "PackDeCarros", onde nele eu configurei o .ExcludeMods para excluir todos os mods do carregamento exceto o "ECG Vehicle TXD" onde eu também o aumentei para prioridade 100 e deixei a pasta "90s atmosphere vehicles pack" como exclusivo (a pasta só ser carregada neste perfil).

E ali em outro canto eu configurei um outro perfil chamado "JogoLeve", onde eu adicionei configuraçÔes que fazem não carregar uma enb series e um pack de vegetação.

(se vocĂȘ ainda nĂŁo leu ali em cima onde começa a sessĂŁo "Modloader.ini", leia para aprender a configurar o perfil!)


Então, basta eu trocar ali em cima o "Profile = PackDeCarros" para "Profile = JogoLeve" que eu irei deixar de ter o pack de carros, enb series e pack de vegetação...


Viu? NĂŁo Ă© dificĂ­l, basta usar um pouco de lĂłgica e se sentir livre.


Pasta .Profiles
Um outro modo de fazer isso (um modo mais organizado), é criar um arquivo .ini dentro da pasta "modloader\.profiles" (o nome do .ini lå dentro não importa mas por organização é legal usar o mesmo nome do perfil né).
Dentro do tal .ini, coloque as configuraçÔes do perfil como mostrado na print acima (exceto a parte onde diz ao jogo qual perfil usar, no caso "[Folder.config]")
Assim, dentro do seu "modloader\modloader.ini" coloque o nome do perfil que vocĂȘ quer usar, normalmente...

Em outras palavras, a pasta ".profile" sĂł serve para organizar e nĂŁo precisar colocar todas as configuraçÔes de todos os perfis dentro do modloader.ini, vocĂȘ escolhe como fazer (eu prefiro usar a pasta).


Mais configuraçÔes:
Embaixo de "[Profile.NomeDoPerfil.Config]" vocĂȘ tambĂ©m pode usar a configuração "Parent" (pai) seguido do nome dos perfis separados em vĂ­rgulas. Assim as configuraçÔes dos outros perfis impostos irĂŁo se juntar neste perfil atual (para nĂŁo precisar ficar copiando configuraçÔes de outros perfis).
VocĂȘ pode usar "$Current" para o perfil atualmente setado no modloader.ini, ou $None para nĂŁo usar Parents.

VocĂȘ tambĂ©m pode incluir a configuração "UseIfModule", onde vocĂȘ coloca o nome de um .exe ou .dll, caso ele estiver carregado, o jogo irĂĄ usar este perfil.
Por exemplo:
"UseIfModule = SAMP"
(na print acima foi usado o Notepad++ pra ficar mais bonito, claro, Ă© a mesma coisa usando Bloco de Notas)

Origem/Créditos: MixMods

PĂĄgina inicial