Skip to content

Repository files navigation

Refinômetro

Testes Deploy Base de itens Preços Licença MIT Node 22+ Apoie por Pix

Buy Me A Coffee

Calculadora e simulador de custo de refino para o Ragnarok Latam. Diz quanto zeny, quantos minérios e quantas cópias do próprio equipamento você precisa ter em caixa para levar uma arma ou equipamento até um refino e um grau alvo, qual a melhor estratégia de minérios em cada faixa, e quanto o item vale no fim.

Abrir a calculadora de refino do Ragnarok Latam

A tela da calculadora: uma arma nível 5 do +0 sem grau até o +8 Grau C, o orçamento recomendado, a distribuição das campanhas simuladas e o plano fase a fase.

Por que não basta multiplicar

Um refino não é uma sequência de tentativas independentes. Uma falha pode destruir o item, derrubar 1 refino ou derrubar 3, dependendo do minério — então a melhor escolha em cada nível depende do custo esperado dos níveis vizinhos, inclusive dos que ficam abaixo de onde você começou. E cada subida de Grau zera o refino de volta para +0, o que transforma "quero Grau A +11" em cinco subidas de refino, não uma.

O motor trata isso como um processo de decisão de Markov e resolve o custo esperado de forma exata, escolhendo o minério ótimo de cada nível em vez de seguir uma receita fixa. Em cima disso roda uma simulação de Monte Carlo, que dá os percentis: a distribuição tem cauda longa e quem se planeja pela média fica sem recursos no meio do caminho quase metade das vezes.

O que ela faz

  • Estratégia por faixa, não receita fixa. O minério de cada nível sai de um MDP resolvido exatamente, com a taxa do refinador contada por tentativa — é o que faz o Enriquecido competir com o Oridecon numa arma nv4. → O motor
  • Campanhas com Grau. Subir de grau zera o refino, então o alvo vira várias fases; o motor escolhe em que refino tentar, qual processo e quanta Bênção de Éter comprar.
  • Percentis, não só a média. Quanto custa no caso comum, no ruim e no muito ruim.
  • Modo "não posso perder o item". Com carta ou encanto, a quebra vira restrição e não custo: o motor deriva o piso seguro e recusa o alvo quando não existe caminho.
  • Cópias do equipamento como material. Na faixa de quebra, o item também é consumo.
  • Comprar × fabricar. Cada minério é cotado pelo menor entre o mercado e a receita de NPC, e a lista de compras vem em duas partes: o que comprar e o que fabricar no balcão.
  • "Dá com o que eu tenho?" O painel de estoque responde o inverso: dado o seu zeny, os seus minérios e as suas cópias, qual a chance de chegar ao alvo. Ele já abre preenchido com o que a chance escolhida pede, e aqui o zeny paga só as taxas — minério que faltar trava a campanha, não vira compra.
  • Busca de item por nome, com a base do Divine Pride do LATAM versionada no repositório — funciona offline e sem chave de API. → Itens
  • Preços seus, salvos no navegador, com a cotação real do mercado LATAM como palpite inicial. → Preços

O que ela não considera (cartas, encantamentos, pergaminhos e martelos) está em O motor · O que não é considerado.

Rodando

Precisa de Node.js 22 ou mais novo (é a versão que o CI usa) e do npm que vem junto. Na raiz do repositório:

npm install       # só na primeira vez, e quando o package.json mudar
npm run dev       # servidor de desenvolvimento em http://localhost:5173

O npm run dev fica em modo watch: salvou um arquivo, a página atualiza sozinha. Para parar, Ctrl+C.

Testes e build

npm test            # testes do motor de cálculo (uma passada, é o que o CI roda)
npm run test:watch  # reexecuta a cada alteração, para desenvolver
npm run typecheck   # só o TypeScript, sem gerar nada
npm run build       # build de produção em dist/
npm run preview     # serve o dist/ para conferir o build antes de publicar

Vale saber: npm run build roda o tsc -b antes do Vite, então erro de tipo derruba o build. E o base do Vite muda entre dev (/) e build (/refinometro/) — no preview o site abre em http://localhost:4173/refinometro/, não na raiz.

São os mesmos três comandos que o CI roda em cada push e em cada pull request (o selo Testes lá em cima) — ver Publicação.

Os demais comandos — inspeção pelo terminal e atualização dos dados versionados — estão em CONTRIBUTING.md.

Como contribuir

Toda ajuda serve: um preço errado, um item que a busca não acha, uma chance que não bate com o jogo, um teste, uma tradução de rótulo. Não é preciso saber TypeScript para reportar que a conta não fecha in-game — esse tipo de relato é o mais valioso que o projeto recebe.

Documentação

O detalhe todo mora em docs/:

Documento O que tem lá
O motor O que é calculado, em que ordem, e o que cada decisão muda na tela
A matemática A especificação formal: o MDP, as demonstrações e o erro de cada aproximação
A interface Material Design 3, o botão informativo e a lista de compras
Os dados A ordem das fontes, e por que ela é essa
Chances e custos As tabelas oficiais da GNJOY e as divergências registradas
Itens A base do Divine Pride: varredura, armadilhas e o que não é refinável
Preços A cotação do mercado LATAM, e por que a média de 30 dias não serve
Publicação Os dois workflows do GitHub Actions

Licença

O código está sob a licença MIT. Os dados não são meus e seguem a licença de quem os publicou — o detalhe está em Os dados · Proveniência.

Ragnarok Online é da Gravity; este é um projeto de fã, sem vínculo com a Gravity, a GNJOY Latam ou o Divine Pride.

Apoie

A calculadora é de graça, sem anúncio e sem cadastro. Se ela te poupou zeny ou ajudou suas decisões:

Buy Me A Coffee

Ou por Pix, se preferir. Chave aleatória, em nome de Fernando H Fernandes:

dede1a1e-bbe2-48ca-b972-00e26b7b217c

Ou o Pix Copia e Cola, que o aplicativo do banco lê inteiro — sem valor definido, você escolhe quanto na hora de pagar:

00020101021126580014br.gov.bcb.pix0136dede1a1e-bbe2-48ca-b972-00e26b7b217c5204000053039865802BR5920FERNANDO H FERNANDES6013PAU DOS FERRO62070503***63046636

O site tem os dois prontos, com botão que copia, em Apoie o Refinômetro.

About

Calculadora de custo de refino para Ragnarok Latam: zeny, minérios e risco de quebra, com estratégia ótima (MDP) e percentis por Monte Carlo.

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages