ForgeUtils no Planet Coaster 2: guia de instalação e configuração

O que é o ForgeUtils no Planet Coaster 2?

Uma montanha-russa personalizada baixada pode depender de mais do que seus próprios arquivos. Se um mod exige o ForgeUtils para Planet Coaster 2, você precisa instalar o ForgeUtils e sua dependência obrigatória, o ACSE. A instalação dos dois dá ao mod acesso às ferramentas compartilhadas de que ele precisa.

O ForgeUtils é um mod utilitário para criar mods de código, editar bancos de dados do jogo e adicionar conteúdo personalizado. Suas ferramentas permitem trabalhar com cenários personalizados, tipos de montanha-russa e Custom Tracked Rides, geralmente abreviadas como CTRs.

Para os jogadores, sua principal função é dar suporte a outros mods. Para os desenvolvedores, ele oferece:

• Utilitários de edição de banco de dados: Faça alterações por código usando uma API estável.
• Ferramentas de criação de conteúdo personalizado: Trabalhe com cenários personalizados e atrações sobre trilhos.
• Utilitários de prefabs: Gerencie prefabs durante o desenvolvimento de conteúdo.
• Ferramentas de registro de logs: Adicione registros personalizados ao código do mod.

Instale o ForgeUtils quando um mod o listar como requisito. Ele fornece as ferramentas de desenvolvimento; o mod de conteúdo separado fornece a atração, o cenário ou o recurso de jogabilidade que você quer.

Página oficial: Planet Coaster 2 (planetcoaster.com)

Como instalar o ACSE e o ForgeUtils

Estas etapas de instalação manual se aplicam à versão para Windows no Steam. As versões para consoles não permitem usar este método de instalação de mods para PC.

Imagem: Steam / Frontier Developments

Encontre a pasta de mods

1. Abra o Planet Coaster 2 na sua biblioteca do Steam.
2. Selecione o ícone de engrenagem e depois Propriedades.
3. Abra Arquivos instalados e selecione Explorar.
4. Entre na pasta win64 e depois em ovldata.

O botão Explorar do Steam leva você à instalação correta, mesmo quando sua biblioteca está em outra unidade.

Extraia os arquivos necessários

1. Baixe os arquivos compactados do ACSE e do ForgeUtils usando as opções de download manual.
2. Extraia os arquivos com um descompactador.
3. Coloque as pastas dos mods dentro de ovldata, preservando os arquivos internos e a estrutura de pastas.
4. Siga as instruções de instalação do mod que depende deles antes de adicionar seus arquivos.

Preste atenção a uma pasta externa extra. Extrair um arquivo compactado para uma pasta com o nome do download pode deixar o diretório do mod um nível abaixo do necessário. Abra essa pasta externa e mova a pasta correta do mod para ovldata.

Não deixe o mod dentro do arquivo ZIP. Evite reorganizar as pastas existentes do jogo ao adicionar conteúdo baixado.

Confira a instalação no jogo

Inicie o jogo e procure o indicador de compilação do ACSE no canto superior esquerdo do menu principal. Depois, abra um parque novo e teste o recurso fornecido pelo mod que depende dele.

Faça essas verificações na sequência: confira se o ACSE carrega e depois teste o conteúdo personalizado ou a ferramenta que você instalou.

De qual versão do ForgeUtils você precisa?

O ForgeUtils 2.7.0, lançado em 10 de setembro de 2026, adiciona novas APIs de hooking em Lua e uma interface de atalhos de teclado. As versões anteriores incluem mudanças importantes para atender aos requisitos de dependências:

• 2.6.0: Atualizado para o Update 11, com mudanças no esquema do banco de dados e novas ferramentas de criação.
• 2.2.0: Atualizado para a versão 1.10 do jogo, adicionando constantes de código e pequenas mudanças na vinculação ao banco de dados.
• 2.0.2: Corrigiu problemas de hooking da interface encontrados durante os testes do Enhanced Move Tool.
• 2.0.0: Adicionou utilitários de criação de Custom Tracked Rides e mudou o hooking em Lua para carregamento sob demanda.

Confira os requisitos de versão do mod que você quer usar. Um mod que exige APIs mais recentes precisa da versão correspondente do ForgeUtils, mesmo que uma instalação antiga ainda funcione com o conteúdo que você já tem.

Para desenvolvedores, a documentação inclui guias, esquemas de banco de dados e referências de API geradas a partir de anotações de tipos em Lua. Use as funções documentadas para a versão instalada ao criar um mod.

Corrija mods que não aparecem e travamentos

Comece pela cadeia de dependências e pela organização das pastas extraídas quando um mod não aparecer ou causar um travamento ao posicionar conteúdo.

• Confira o ACSE primeiro. O ForgeUtils depende bastante das funções dele.
• Confira a versão exigida do ForgeUtils. Use uma versão que atenda aos requisitos do mod dependente.
• Inspecione as pastas extraídas. Retire o diretório do mod de qualquer pasta extra criada na extração do download.
• Confira a compatibilidade do mod de conteúdo. Atualizar apenas o ForgeUtils não atualiza a atração ou ferramenta separada.
• Siga as instruções de instalação de cada mod. O método da pasta ovldata não se aplica a todos os tipos de modificação.

Diferencie também o funcionamento das atrações do jogo base dos problemas de instalação. O Update 11 Hotfix 15, lançado em 25 de agosto de 2026, alterou vários recursos das atrações:

Atração	Alteração do hotfix
Studio Tour e Re-Motion	Adicionou estações de embarque e desembarque
Fourth Wall e Cinema	Corrigiu a reprodução de músicas personalizadas
New-Gen Flying Coaster	Adicionou freios e pneus de propulsão às estações com embarque à esquerda

Confira a versão do jogo ao investigar esses comportamentos específicos. Se um mod causar travamento ao posicionar conteúdo, inspecione a organização das pastas extraídas e as dependências antes de alterar arquivos do jogo sem relação com o problema.