Skip to content

About

Planejador open source de receitas, produção e mercado para Black Desert Online (SA/PT-BR).

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

782 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Black Market

Planejador independente para jogadores de Black Desert Online, com foco inicial na região SA e no português brasileiro. Reúne receitas, materiais e cotações para ajudar a planejar a produção e organizar o inventário.

O projeto está em desenvolvimento. Ele não é afiliado à Pearl Abyss, e o código aberto não implica a publicação de um serviço hospedado.

Tela de planejamento de uma receita, com materiais e resultado da simulação

Captura da aplicação em desenvolvimento; os valores apresentados dependem das premissas da simulação.

O que o projeto faz

  • Explora receitas e sub-receitas em uma árvore de produção.
  • Compara compra e produção de materiais, considerando preços, maestrias e tempo informado.
  • Consulta itens e preços de mercado com indicação da origem e da disponibilidade dos dados.
  • Permite organizar materiais e revisar sugestões de leitura de capturas antes de salvá-las.
  • Oferece ferramentas de cálculo e planejamento para diferentes atividades do jogo.

Preços, resultados de OCR e cálculos podem depender de dados incompletos ou de fontes externas. Confira as premissas exibidas na aplicação antes de tomar decisões no jogo.

Arquitetura

Monorepo em TypeScript com Angular e SSR, NestJS, PostgreSQL, Drizzle e Docker Compose. As regras de cálculo compartilhadas são usadas pelo navegador e pela API.

Diretório Responsabilidade
apps/web Interface Angular e renderização no servidor
apps/api API, catálogo e integrações
packages/calculators Cálculos compartilhados
packages/database Schema e migrations
packages/domain e packages/shared Contratos e utilitários

Consulte arquitetura e o índice da documentação para detalhes.

Rodar localmente

Requisitos: Node.js 24.21.0, pnpm 10.28.1, Docker e Docker Compose. Em um clone novo, crie .env a partir de .env.example e siga as instruções de desenvolvimento local. Não substitua um .env ou banco existente.

git clone https://github.com/bellussi1/Black-Market.git
cd Black-Market
cp .env.example .env
corepack enable
corepack prepare [email protected] --activate
pnpm install --frozen-lockfile
docker compose up -d postgres
pnpm db:migrate

Depois, em terminais separados:

pnpm dev:api
pnpm dev:web

A interface fica em http://localhost:4200 e a API em http://localhost:3000. A rota /ready verifica a conexão da API com o banco. Para executar a aplicação inteira em containers, consulte a seção de Docker em desenvolvimento local.

Catálogo e dados do jogo

O clone não inclui um banco populado nem o conjunto de assets extraídos do jogo. Para carregar o catálogo, consulte o pipeline de dados e as atualizações do catálogo. A extração depende de uma instalação legítima do jogo e de ferramenta comunitária com licença própria; verifique os termos aplicáveis antes de usar ou redistribuir dados e imagens.

As cotações usam integrações comunitárias e podem estar desatualizadas ou indisponíveis. A coleta persistente não deve ser ativada sem revisar as condições da fonte. Capturas e dados pessoais devem permanecer fora do Git.

Qualidade e contribuição

pnpm check
pnpm test
pnpm build

Antes de contribuir, consulte desenvolvimento e qualidade e descreva o problema ou a proposta em uma issue. Não inclua credenciais, arquivos do jogo, catálogos extraídos ou capturas privadas em contribuições.

Licença e conteúdo de terceiros

O código de autoria do projeto está disponível sob a licença MIT. Nomes, marcas, imagens, dados do jogo e outros conteúdos de terceiros pertencem aos respectivos titulares e não são licenciados por este projeto. Veja procedência dos dados.

O uso de conteúdo do jogo também está sujeito às diretrizes de conteúdo de fãs da Pearl Abyss, que tratam de uso não comercial e das exceções mencionadas pela própria empresa. A licença MIT não concede direitos sobre a propriedade intelectual do jogo.


English: Black Market is an independent, work-in-progress planning tool for Black Desert Online. It combines nested recipes, production costs, market data and screenshot review. The repository does not provide a populated game database or extracted assets. See local development and data sources.

About

Planejador open source de receitas, produção e mercado para Black Desert Online (SA/PT-BR).

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages