Guia de modsModding guide

1. Coloque a pasta do mod em %APPDATA%\Racefoot\mods\ (na demo: %APPDATA%\Racefoot Demo\mods\). Para abrir, cole esse endereço na barra do Explorador de Arquivos. Se a pasta mods não existir, crie.
2. Put the mod folder into %APPDATA%\Racefoot\mods\ (demo: %APPDATA%\Racefoot Demo\mods\). To open it, paste that address into File Explorer's address bar. If the mods folder doesn't exist, create it.
3. Abra o jogo e clique em Nova Carreira. Na tela de mods, marque o seu.
4. Open the game and click New Career. On the mod screen, tick yours.
5. Editou o mod? Feche e abra o jogo de novo: os arquivos são lidos na abertura.
6. Edited the mod? Close and reopen the game: files are read at startup.

Cada carreira guarda os mods com que foi criada. Um save antigo continua abrindo com os mesmos mods, mesmo que você marque outros numa carreira nova.

Each career remembers the mods it was created with. An old save keeps loading with those mods, even if you tick different ones for a new career.

O jeito mais fácil de começar. O modelo é uma pasta meu-mod com todos os arquivos já preenchidos com os valores originais do jogo: equipes, pilotos, motores, combustíveis, pneus, circuitos, patrocinadores e regras. Aplicado sem mudanças, ele não altera nada.

The easiest way to start. The template is a meu-mod folder with every file already filled with the game's original values: teams, drivers, engines, fuels, tyres, circuits, sponsors and rules. Applied unchanged, it changes nothing.

Baixar modelo (.zip)Download template (.zip)

1. Extraia o .zip dentro da pasta mods.
2. Extract the .zip inside the mods folder.
3. Renomeie a pasta e troque o "id" no manifest.json para o mesmo nome da pasta. Mude também o "name", que é o que aparece no jogo.
4. Rename the folder and change the "id" in manifest.json to the same name as the folder. Change "name" too; that's what shows in the game.
5. Edite os valores que quiser. Recomendado: apague as linhas e os arquivos que você não mudou. O mod fica menor, mais fácil de conferir e combina melhor com outros mods.
6. Edit whatever you want. Recommended: delete the lines and files you did not change. The mod gets smaller, easier to check and combines better with other mods.

1. Crie uma pasta (ex.: meu-mod) com um manifest.json. O id precisa ser igual ao nome da pasta:

1. Create a folder (e.g. meu-mod) with a manifest.json. The id must match the folder name:

{
  "id": "meu-mod",
  "name": "Meu Mod",
  "author": "Seu nome",
  "version": "1.0.0",
  "description": "O que o mod muda."
}

2. Crie só os arquivos das categorias que você vai mudar: teams.json, drivers.json, engines.json, fuels.json, tires.json, circuits.json, sponsors.json ou rules.json.

2. Create only the files for the categories you'll change: teams.json, drivers.json, engines.json, fuels.json, tires.json, circuits.json, sponsors.json or rules.json.

3. Em cada arquivo, use o id (veja as tabelas) e coloque só os campos que mudam. Tudo o que você não escrever continua como no jogo original:

3. In each file, use the id (see the tables) and write only the fields that change. Anything you leave out stays as in the original game:

{
  "drv-07": { "name": "Novo Nome", "teamId": "team-01", "role": "first" },
  "drv-19": { "attributes": { "skill": 95, "wetWeather": 90 } }
}

Algumas regras dependem de mais de um valor ao mesmo tempo. O jogo corrige sozinho, para que um mod nunca quebre a carreira:

Some rules depend on more than one value at once. The game fixes them on its own, so a mod never breaks a career:

• Retas e curvas sempre somam 100%. Informou só uma? A outra é calculada.
• Straights and corners always add up to 100%. Gave only one? The other is worked out.
• Temperaturas: se a mínima for maior que a máxima, os valores são trocados.
• Temperatures: if the minimum is above the maximum, they are swapped.
• Calendário: a temporada tem 20 corridas, 2 por mês, de março a dezembro. Se as mudanças de mês deixarem algum mês sem 2 circuitos garantidos, todas as mudanças de mês do mod são desfeitas. Atenção aos pares que nunca correm no mesmo ano: crc-01/crc-30 e crc-09/crc-16.
• Calendar: a season has 20 races, 2 per month, March to December. If the month changes leave any month without 2 guaranteed circuits, all of the mod's month changes are undone. Mind the pairs that never race in the same year: crc-01/crc-30 and crc-09/crc-16.
• Pilotos: toda equipe do grid começa com um 1º e um 2º piloto. O piloto que o mod coloca numa vaga fica com ela; quem estava lá passa para a outra vaga da equipe ou fica livre. Vaga que sobrar vazia recebe o melhor piloto livre. Só equipes que estão no grid da 1ª temporada aceitam pilotos.
• Drivers: every grid team starts with a 1st and a 2nd driver. A driver the mod puts in a seat keeps it; whoever was there moves to the team's other seat or becomes a free agent. Any seat left empty gets the best free agent. Only teams on the season-1 grid accept drivers.

Meu mod não aparece no jogo.My mod doesn't show up in the game.

Confira se o manifest.json está dentro da pasta do mod (e não numa subpasta), se tem "id" e "name", e se o jogo foi aberto de novo depois da mudança.

Check that manifest.json sits directly inside the mod folder (not in a subfolder), that it has "id" and "name", and that the game was reopened after the change.

Uma mudança não teve efeito.A change had no effect.

Quase sempre é um erro de digitação no JSON: vírgula faltando ou sobrando, aspas, ou um nome de campo escrito errado. Um arquivo com erro de sintaxe é ignorado por inteiro. Use um editor que aponte erros de JSON, como o VS Code (gratuito). E lembre: o mod só vale para carreiras novas.

It's almost always a JSON typo: a missing or extra comma, quotes, or a misspelled field name. A file with a syntax error is ignored entirely. Use an editor that flags JSON errors, such as VS Code (free). And remember: the mod only applies to new careers.

Posso usar mais de um mod ao mesmo tempo?Can I use more than one mod at once?

Sim. Se dois mods mudarem o mesmo campo, vale o do mod cuja pasta vem depois em ordem alfabética.

Yes. If two mods change the same field, the one whose folder comes later alphabetically wins.

Posso adicionar equipes, pilotos ou circuitos novos?Can I add new teams, drivers or circuits?

Ainda não. Um mod altera o que já existe; para uma "nova" equipe, renomeie e ajuste uma das 9 equipes da reserva.

Not yet. A mod changes what already exists; for a "new" team, rename and tweak one of the 9 reserve teams.

Como compartilho meu mod?How do I share my mod?

Compacte a pasta do mod num .zip. Quem receber só precisa extrair na pasta mods.

Zip the mod folder. Whoever gets it just extracts it into the mods folder.