Intermediário 📄 XML

Tuning XML e ITUN

Entenda como usar arquivos XML para configurar e ativar seus mods no jogo.

⏱️ 45 minutos 📊 Nível: Intermediário

🎯 Objetivo

Aprender a criar arquivos XML que ativam classes, configuram variáveis tunables e definem dados de buffs/interações.

1️⃣

O Que é Tuning XML?

O sistema de tuning do The Sims 3 usa arquivos XML para:

Ativar classes de mod (instantiator)
Configurar valores de variáveis [Tunable]
Definir dados de buffs, interações, objetos
Modificar comportamentos do jogo sem recompilar

2️⃣

XML Instantiator

Este XML ativa sua classe quando o jogo carrega:

<?xml version="1.0" encoding="utf-8"?>
<C>
  <T n="SeuNamespace.ModMain,SeuMod">
    <L n="_TunableFields">
      <T>kInstantiator</T>
    </L>
    <T n="kInstantiator" type="Boolean">true</T>
  </T>
</C>

💡 Como Funciona

O jogo lê este XML, encontra a classe SeuNamespace.ModMain na DLL SeuMod.dll, e tenta atribuir true ao campo kInstantiator. Isso força o .NET a inicializar a classe, executando o construtor estático.

3️⃣

Tipos de Dados no XML

Tipo C#	Tipo XML	Exemplo
`bool`	`Boolean`	`<T type="Boolean">true</T>`
`int`	`Int32`	`<T type="Int32">100</T>`
`float`	`Single`	`<T type="Single">50.5</T>`
`string`	`String`	`<T n="texto">Valor</T>`
`ulong`	`UInt64`	`<T type="UInt64">0x12345678</T>`
`int[]`	`Int32[]`	`<L><I>1</I><I>2</I></L>`

4️⃣

XML de Buff

<?xml version="1.0" encoding="utf-8"?>
<C>
  <T n="SeuBuff" s="0x1234567890ABCDEF">
    <L n="buff_name"><T n="Seu Buff"></T></L>
    <L n="buff_description"><T n="Descrição"></T></L>
    <T n="mood_change" type="Int32">25</T>
    <T n="timeout" type="Single">120</T>
    <T n="mood_color" type="Int64">0x00FF00FF</T>
    <T n="product_version" type="Int64">0x20</T>
  </T>
</C>

5️⃣

Empacotando no S3PE

Abra o S3PE
File → New
Resource → Add
Tipo: ITUN
Selecione seu arquivo XML
Repita para cada XML
File → Save As → SeuMod.package