Guia de modsModding guide

1. No menu do jogo, clique em Mods e Oficina e depois em Abrir pasta de mods. Coloque a pasta do mod ali. O endereço é %APPDATA%\Racefoot\mods\ (na demo: %APPDATA%\Racefoot Demo\mods\); também dá para abrir colando esse endereço na barra do Explorador de Arquivos. Se a pasta mods não existir, crie.
2. In the game's menu, click Mods & Workshop and then Open mods folder. Put the mod folder there. The address is %APPDATA%\Racefoot\mods\ (demo: %APPDATA%\Racefoot Demo\mods\); you can also open it by pasting 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, tires, 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 } }
}

Usar mods da OficinaUsing Workshop mods

1. Na Steam, abra a Oficina do Racefoot Manager (ou, no jogo, Mods e Oficina → Abrir a Oficina na Steam) e clique em Inscrever-se no mod que quiser.
2. In Steam, open the Racefoot Manager Workshop (or, in the game, Mods & Workshop → Open the Workshop on Steam) and click Subscribe on the mod you want.
3. A Steam baixa o mod sozinha. Ele aparece no jogo em Mods e Oficina e na tela de mods da Nova Carreira, marcado como (Oficina Steam). Se ainda estiver baixando, a lista se atualiza sozinha.
4. Steam downloads it for you. It shows up in the game under Mods & Workshop and on the New Career mod screen, marked (Steam Workshop). If it's still downloading, the list refreshes on its own.
5. Quando o autor atualiza o mod, a Steam baixa a versão nova. Não é preciso fazer nada.
6. When the author updates the mod, Steam downloads the new version. Nothing to do.

Mods da Oficina funcionam só na versão completa do jogo (a demo não tem acesso à Oficina). Mods da pasta mods continuam funcionando normalmente, com ou sem Steam.

Workshop mods work only in the full game (the demo has no Workshop access). Mods in the mods folder keep working as usual, with or without Steam.

Saves e mods da OficinaSaves and Workshop mods

Se você abrir um save que usa um mod que não está neste computador (outro PC pela nuvem da Steam, inscrição cancelada, mod removido), o jogo avisa antes de carregar e oferece Inscrever-se e baixar. Também dá para Carregar mesmo assim: é seguro, a carreira continua e o que o mod alterava volta aos dados originais.

If you open a save that uses a mod that isn't on this computer (another PC through Steam Cloud, a cancelled subscription, a removed mod), the game warns you before loading and offers Subscribe and download. You can also Load anyway: it's safe, the career goes on and whatever the mod changed goes back to the original data.

Publicar o seu modPublishing your mod

1. Teste o mod na pasta mods até ficar como você quer.
2. Test the mod in the mods folder until it's the way you want.
3. Com a Steam aberta, vá em Mods e Oficina, encontre o mod em Mods locais e clique em Publicar na Oficina.
4. With Steam open, go to Mods & Workshop, find the mod under Local mods and click Publish to Workshop.
5. Escolha a visibilidade (pública, só amigos, não listada ou privada), uma imagem de capa opcional (PNG, JPG ou GIF, até 1 MB) e escreva uma nota do que mudou. Se o mod usa nomes reais, marque a opção correspondente: ela adiciona o marcador Real Names.
6. Pick the visibility (public, friends only, unlisted or private), an optional cover image (PNG, JPG or GIF, up to 1 MB) and write a note about what changed. If the mod uses real names, tick the matching option: it adds the Real Names tag.
7. Na primeira publicação a Steam pode pedir que você aceite o acordo da Oficina; o jogo mostra um botão para isso.
8. On your first upload Steam may ask you to accept the Workshop agreement; the game shows a button for it.

Para atualizar, edite o mod na pasta e clique em Atualizar na Oficina: o mesmo item é atualizado, e quem se inscreveu recebe a versão nova. Os marcadores (Equipes, Pilotos, Circuitos, Temporada…) são colocados automaticamente conforme os arquivos do mod. Só vão para a Oficina o manifest.json e os 8 arquivos de dados; outros arquivos da pasta ficam de fora.

To update, edit the mod in the folder and click Update on Workshop: the same item is updated and subscribers get the new version. Tags (Teams, Drivers, Circuits, Season…) are set automatically from the mod's files. Only manifest.json and the 8 data files are uploaded; anything else in the folder is left out.

Publique apenas conteúdo que você tem o direito de compartilhar e siga as regras da Oficina Steam.

Only publish content you have the right to share, and follow the Steam Workshop rules.

Versões do jogoGame versions

Mods continuam valendo entre versões: campos novos de versões futuras são apenas ignorados por versões antigas. Se o seu mod depende de algo que só existe a partir de uma versão, coloque no manifest.json, por exemplo, "minGameVersion": "2.0.0". Em versões anteriores ele aparece como incompatível, em vez de ser aplicado pela metade.

Mods keep working across versions: new fields from future versions are simply ignored by older ones. If your mod depends on something that only exists from a certain version on, add it to manifest.json, for example "minGameVersion": "2.0.0". Older versions then list it as incompatible instead of half-applying it.

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.
• Aposentadoria: nunca antes da idade atual do piloto nem antes da idade de auge — ele sempre corre ao menos uma temporada e chega ao seu auge.
• Retirement age: never before the driver's current age or before his peak age — he always races at least one season and reaches his peak.
• 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?

O jeito mais fácil é publicar na Oficina Steam. Fora da Steam, compacte a pasta do mod num .zip; quem receber só precisa extrair na pasta mods.

The easiest way is to publish it on the Steam Workshop. Outside Steam, zip the mod folder; whoever gets it just extracts it into the mods folder.

O mod da Oficina não aparece.The Workshop mod doesn't show up.

Confira se a Steam está aberta, se o download terminou (Biblioteca → Downloads) e se você está na versão completa, não na demo. Em Mods e Oficina, clique em Atualizar lista.

Check that Steam is running, that the download finished (Library → Downloads) and that you're on the full game, not the demo. In Mods & Workshop, click Refresh list.