Jim Mining

Job de mineração completo: extrair minério com picareta, furadeira ou laser, quebrar e lavar pedras, garimpar, fundir minérios em lingotes, lapidar joias e vender tudo para NPCs compradores.

Este é o fork da MRI sobre o jim-mining 3.0.12 do Jimathy. O código é o do upstream. A camada nossa é pequena e está listada em O que é da MRI.

Sumário

1. Dependências
2. Instalação
3. Configuração
4. Itens
5. Ciclo de produção
6. Locais
7. Receitas de crafting
8. Preços de venda
9. NPC de tutorial
10. Entrypoints para outros recursos
11. Localização
12. O que é da MRI
13. Estrutura de arquivos

Dependências

Instalação

1. Copie a pasta jim-mining para resources/.
2. Adicione ao server.cfg, depois das dependências:

   ensure oxmysql
   ensure jim_bridge
   ensure jim-mining

3. Copie o conteúdo de images/ para a pasta de imagens do inventário (ox_inventory/web/images/). São 62 imagens, uma por item.
4. Cadastre os itens no inventário. O recurso não traz items.lua nem SQL. Na inicialização, o servidor confere item por item e imprime avisos do tipo:

   Selling: Missing Item from Items: 'goldore'
   CrackPool: Missing Item from Items: 'carbon'
   Shop: Missing Item from Items: 'pickaxe'
   Crafting recipe couldn't find item 'steel' in the shared

   Os itens necessários vêm de Config.Items.items (loja), Config.CrackPool, Config.WashPool, Config.PanPool, Selling (shared/selling.lua) e de todas as receitas em Crafting (shared/crafting.lua).
5. Ajuste o config.lua e o shared/locations.lua.

Não há permissões ACE nem comandos.

Configuração

Todas as opções ficam em config.lua.

Config.System

As convars jim_menuScript, jim_notifyScript, jim_progressBarScript e jim_drawTextScript do jim_bridge, se definidas no server.cfg, sobrescrevem esses valores.

Config.General

Config.Crafting

Config.BreakTool

Cada ferramenta com true perde de 2 a 3 de durabilidade por uso, via breakTool do jim_bridge. Só funciona com inventário que tenha durabilidade, como o ox_inventory.

Config.Timings

Os intervalos são sorteados a cada ação.

Config.PoolAmounts

Quantas vezes cada ação sorteia (Successes) e quanto sai por sorteio (AmountPerSuccess). Padrão: minerar e quebrar dão de 1 a 3 do item sorteado. Lavar e garimpar fazem 1 ou 2 sorteios, cada um dando de 1 a 3.

Pools de itens

Itens que não existem no inventário são ignorados no sorteio.

Config.Items

Loja de mineração. label, slots e a lista items com name, price, amount e slot. Veja Itens.

Itens

A loja de mineração vende:

Os preços dos consumíveis, lanterna e bateia são da MRI. O upstream vem com 2, 2, 25, 75 e 25.

Minerar produz stone, a matéria-prima de quebrar e lavar. Com AltMining, produz direto o minério da pedra.

Ciclo de produção

1. Minerar nas pedras das minas habilitadas, com pickaxe, miningdrill ou mininglaser. Dá de 1 a 3 stone. A pedra troca pelo modelo vazio e volta depois de OreRespawn.
2. Quebrar pedra na bancada prop_vertdrill_01. Consome 1 stone e sorteia do CrackPool. Exige drillbit por padrão.
3. Lavar pedra nos pontos de Locations.Washing. Consome 1 stone e sorteia do WashPool.
4. Garimpar com goldpan nas áreas de Locations.Panning. Não consome nada e sorteia do PanPool.
5. Fundir na fundição. Minérios viram lingotes e metais pelas receitas SmeltMenu.
6. Lapidar na bancada gr_prop_gr_speeddrill_01c. Gemas brutas viram gemas, e lingotes viram anéis, colares e brincos.
7. Vender para o comprador de minérios ou de joias, pela loja de venda do inventário registrada pelo jim_bridge.

Antes de entregar qualquer recompensa, o servidor confere com canCarry se o jogador tem espaço para tudo. Se não tiver, nada é consumido e o jogador recebe "Seu inventário está cheio!". Ao lavar, a checagem cobre todos os itens sorteados de uma vez.

Se o cw-rep estiver ligado, cada recompensa dá 5 de XP na skill mining, independente de ter espaço.

Locais

Ficam em shared/locations.lua, na tabela global Locations.

Minas incluídas:

Job = "<nome>" numa mina restringe os alvos dela a esse emprego. Config.General.requiredJob faz o mesmo para o recurso inteiro.

Para adicionar uma mina, use o bloco comentado no fim de shared/locations.lua:

["NovaMina"] = {
    Enable = true,
    Job = nil,
    Blip = { Enable = true, name = "Mina", coords = vec4(0.0, 0.0, 0.0, 0.0), sprite = 527, col = 43 },
    Store = { },
    Smelting = { },
    Cracking = { },
    OreBuyer = { },
    JewelCut = { },
    OrePositions = { vec4(0.0, 0.0, 0.0, 0.0) },
},

O recurso esconde as portas do mineshaft com CreateModelHide quando MineShaft está habilitado, fixo no client/client.lua.

Receitas de crafting

A tabela Crafting em shared/crafting.lua tem cinco menus. Em cada receita, a chave externa é o item produzido, as chaves internas são os ingredientes e amount é quanto sai por fabricação (padrão 1).

Exemplo de leitura:

{ ["steel"] = { ["ironore"] = 1, ["carbon"] = 1 } },
{ ["gold_ring"] = { ["goldingot"] = 1 }, ['amount'] = 3 },

Preços de venda

Ficam em shared/selling.lua, na tabela Selling. OreSell é a lista do comprador de minérios. JewelSell tem uma seção por tipo de joia (Emerald, Ruby, Diamond, Sapphire, Rings, Necklaces, Earrings). Todos os itens vêm com preço 100 do upstream e não foram ajustados.

NPC de tutorial

Camada da MRI, em client/npc.lua. Com Config.General.npcTalk = true e rep-talkNPC mais pickle_waypoints ligados, um NPC (s_m_m_dockwork_01, "Seu Fábio") é criado em vec4(-599.69, 2093.15, 130.31, 347.62), na entrada da mina.

O diálogo explica o ciclo em três passos e, em cada um, oferece marcar no GPS as minas, os pontos de lavagem, a fundição, a joalheria e as áreas de garimpo. As coordenadas ficam na tabela Tutorial.waypoints no topo do arquivo, e são independentes de shared/locations.lua. Se mudar um local lá, ajuste aqui também.

O NPC é criado no onPlayerLoaded e apagado no onResourceStop.

Entrypoints para outros recursos

O recurso não registra exports. O único evento de servidor é interno:

O nome do evento usa getScript(), então renomear a pasta do recurso muda o nome do evento junto.

As lojas e a venda são registradas no onResourceStart do servidor pelo jim_bridge: registerShop("miningShop", …) para cada loja e registerSellShop para cada comprador de minérios e de joias.

No cliente, as ações ficam em Mining.Functions, Mining.MineOre, Mining.Other e Mining.Menus, globais dentro do recurso mas não exportadas.

Localização

Os textos ficam em locales/, carregados como shared_scripts, e são lidos com locale("secao", "chave"). O idioma ativo é Config.Lan, não a convar ox:locale.

Idiomas incluídos: cn, da, de, en, et, fr, nl, pt, tr. O pt.lua foi traduzido por completo pela MRI. Os outros vêm do upstream.

Fora dos locales, em português fixo: os nomes dos locais em shared/locations.lua e o diálogo do NPC em client/npc.lua.

O que é da MRI

Tudo o mais é o upstream 3.0.12 sem alteração.

Ao atualizar do upstream, faça merge e confira só esses arquivos. Mudança de comportamento vai em PR pro Jimathy, não aqui.

Estrutura de arquivos

jim-mining/
├── client/
│   ├── client.lua        — targets, props, minas, mineração, quebra, lavagem, garimpo, menus de crafting e venda
│   └── npc.lua           — NPC de tutorial (MRI)
├── server/
│   └── server.lua        — recompensas com canCarry, registro de lojas e compradores, validação de itens
├── shared/
│   ├── shared.lua        — sons da furadeira, timings, carrinho de mina
│   ├── crafting.lua      — receitas dos 5 menus
│   ├── selling.lua       — preços de venda
│   └── locations.lua     — minas, lavagem, garimpo, fundição e compradores
├── locales/              — cn, da, de, en, et, fr, nl, pt, tr
├── images/               — 62 imagens dos itens (copiar para a pasta do inventário)
├── config.lua            — idioma, sistema, geral, durabilidade, timings, pools e loja
├── version.txt
├── README.md
└── fxmanifest.lua