Factorio.com | Forums | Wiki | Mod Portal | API Docs
Log in

LUIS DAS ARTIMANHAS - Biblioteca Utilitária

Biblioteca utilitária para criação rápida de itens, receitas e outros protótipos Factorio.. local LDA = require('__LDA-LIB__/init') local PATH = LDA.setBasePath('Quantum-Teleporter')

Internal
5 days ago
2.1
697
source code
Download
Owner:
LUIS_DAS_ARTIMANHAS
Source:
https://github.com/LUISDASARTIMANHAS/...
Homepage:
https://luisdasartimanhas.github.io/f...
License:
GNU General Public License v3.0
Created:
a year ago
Latest Version:
0.0.17 (5 days ago)
Factorio version:
2.1
Downloaded by:
697 users

LDA-LIB – Biblioteca Utilitária para Mods Factorio 2.0

local LDA = require('__LDA-LIB__/init') 
-- OBRIGATÓRIO: Define o caminho base do seu mod para busca de assets (gráficos/sons)
local PATH = LDA.setBasePath('Seu-Mod-Nome')

📘 Descrição

A LDA-LIB é uma biblioteca utilitária para Factorio 2.0 projetada para acelerar a criação de mods, fornecendo funções prontas para gerar:

  • Itens, Fluidos e Gases
  • Receitas simples e complexas
  • Minérios e Recursos de mapa (Autoplace)
  • Tecnologias (comuns e por gatilhos)
  • Estruturas completas (item + receita + entidade)
  • Versões especializadas (fornalhas, montadoras, "jogar na água")

O objetivo é reduzir trabalho repetitivo e manter um padrão uniforme entre todos os seus mods.

Arquitetura do repositório

  • data.lua carrega data-stage/init.lua; os add-ons próprios ficam em data-stage/addons/.
  • data-stage/builders/ organiza os construtores de protótipos modulares e encapsulados:
  • base/: construtores individuais de protótipos (itens, fluidos, gases, entidades, receitas).
  • composites/: combinações reutilizáveis (item + receita, fluido + receita, bloco + receita).
  • specialized/: construtores especializados (máquinas categorizadas, triggers de tecnologia).
  • shared/ reúne utilitários compartilhados (animações, fontes de energia, mod paths, efeitos).
  • runtime/ concentra lógica de runtime (control.lua, comandos /lda-list e registros de estado).
  • api/registry.lua e api/modules.lua centralizam a API pública consumida através de init.lua.
  • Módulos legados (base-functions/, generic-functions/, functions/, utils/) atuam como proxies delegadores garantindo 100% de compatibilidade retroativa.

Essa separação mantém os pontos de entrada do Factorio na raiz e evita carregar módulos de protótipos no estágio runtime.

FOLDER STRUCTURE (Padrão esperado pelo Mod)

A biblioteca busca assets automaticamente baseada nesta estrutura:

  • graphics (recipe)
  • graphics/icons - ícones de itens gerais
  • graphics/entities - ícones de entidades
  • graphics/equipment - ícones de equipamentos
  • graphics/fluid - ícones de fluidos

  • graphics/gas - ícones de gas

  • graphics (item,fluid)

  • graphics/icons/ - ícones de itens gerais
  • graphics/icons/fluid - ícones de fluidos
  • graphics/icons/gas - ícones de gas

  • audios - arquivos de som (.ogg)

  • graphics (item-group)

  • graphics/item-group - ícones de item-group e subgroup (categoria)

⚙️ Configurações (settings.lua)

  • LDA-LIB: Modo Debug – habilita logs detalhados durante a geração de protótipos.
  • Ativar em: Configurações → Mods → Startup

🔎 Comando /lda-list

Lista todas as funções públicas expostas pela biblioteca LDA no console do jogo.

✨ Como usar

  1. Ative o mod LDA-LIB no gerenciador de mods do Factorio.
  2. No seu mod, importe a biblioteca com:
local LDA = require('__LDA-LIB__/init')
LDA.setBasePath('Seu-Mod-Nome')
  1. Use as funções do LDA para criar protótipos e receitas.
  2. Se quiser ver todas as funções carregadas, abra o console do jogo e use /lda-list.

Recomenda-se definir o setBasePath logo no início do seu data.lua ou arquivo principal de geração de protótipos.

🧩 Funções Disponíveis

Base Functions

Função Descrição Rápida
LDA.createAutoplaceControl Cria controles de autoplace para geração de recursos no mapa.
LDA.createResource Cria a entidade de recurso (o minério físico no chão).
LDA.createOre Cria o item do minério (adiciona automaticamente o prefixo -ore).
LDA.createItem Cria um item simples com sons e ícone.
LDA.createBlockItem Cria itens do tipo bloco estrutural.
LDA.createEquipmentItem Cria itens do tipo equipamento (colocáveis em grids).
LDA.createFluid Cria fluidos com temperatura e ícone.
LDA.createGas Variante visual de fluido como gás.
LDA.createRecipe Cria uma receita simples.
LDA.createItemGroup Cria grupos de itens e categorias no inventário.
LDA.createItemSearch Cria itens de busca/pesquisa (ex: science packs).
LDA.createEntity Cria uma entidade base (ex: painel solar customizado).

Generic Functions (Combos Item + Receita)

Função Descrição Rápida
LDA.createItemWithRecipe Cria item + receita associada em um único comando.
LDA.createFluidWithRecipe Cria fluido + receita associada.
LDA.createBlockItemWithRecipe Cria bloco + receita completa.
LDA.createEquipmentItemWithRecipe Cria Equipamento + Receita associada.
LDA.createGenericRecipe Gera receitas modulares definidas por matriz.
LDA.createThrowInWaterItemWithRecipe Cria item + receita que exige "jogar na água" (ex: sementes).

Advanced Functions (Especializadas)

Função Descrição Rápida
LDA.createAssemblerItemWithRecipe Cria itens produzidos especificamente em montadoras.
LDA.createSmeltingItemWithRecipe Cria itens produzidos em fornalhas.
LDA.createChemicalPlantItemWithRecipe Cria itens produzidos em Chemical Plants.
LDA.createBiochamberItemWithRecipe Cria itens produzidos na Biochamber.
LDA.createTechnology Cria tecnologias completas com efeitos e custos.
LDA.createTechnologyTrigger Cria tecnologia com gatilho genérico.
LDA.createTechnologyCraftEntityTrigger Tecnologia desbloqueada ao fabricar um item específico.
LDA.createTechnologyMineEntityTrigger Tecnologia desbloqueada ao minerar uma entidade específica.

🛠️ Utilitários (Utils)

LDA.utilsAnimations

  • LDA.utilsAnimations.createLayer(filename,width,height,frame_count,line_length,shift,scale,draw_as_shadow,priority,extra_props)
  • LDA.utilsAnimations.createAnimation(layers)
  • LDA.utilsAnimations.createAnimationLayer(filename, width, height, hr_scale, shift, draw_as_shadow, custom_props)
  • LDA.utilsAnimations.createGraphicsSet(animation_progress,frozen_patch,always_draw_idle_animation,reset_animation_when_frozen)

LDA.utilsEnergySource

  • LDA.utilsEnergySource.createPipeConnection(flow_direction, direction, position, connection_type, params)
  • LDA.utilsEnergySource.createFluidBox(volume, filter, production_type, pipe_connections, pipecoverspictures, params)
  • LDA.utilsEnergySource.createBurnerEnergySource(fuel_inventory_size, effectivity, fuel_categories, emissions_per_minute, render_no_power_icon, render_no_network_icon, params)
  • LDA.utilsEnergySource.createElectricEnergySource(usage_priority, buffer_capacity, input_flow_limit, output_flow_limit, emissions_per_minute, render_no_power_icon, render_no_network_icon, params)
  • LDA.utilsEnergySource.createFluidEnergySource(fluid_volume, fluid_connections, fluid_filter, effectivity, burns_fluid, emissions_per_minute, render_no_power_icon, render_no_network_icon, params)
  • LDA.utilsEnergySource.createHeatEnergySource(max_temperature, specific_heat, max_transfer, default_temperature, min_working_temperature, emissions_per_minute, render_no_power_icon, render_no_network_icon, params)
  • LDA.utilsEnergySource.createVoidEnergySource(emissions_per_minute, render_no_power_icon, render_no_network_icon, params)

LDA.utilsAmbientEffects

  • LDA.utilsAmbientEffects.createExplosion(surface, position)
  • LDA.utilsAmbientEffects.createCrashFire(surface, center, count)
  • LDA.utilsAmbientEffects.createSecondaryExplosions(surface, center, count)
  • LDA.utilsAmbientEffects.createScorchmark(surface, position)

LDA.utils (Geral)

  • LDA.setBasePath(modName)
  • LDA.getBasePath()
  • LDA.utils.array_contains(array, value)
  • LDA.utils.tableMerge(target, source, overwrite)
  • LDA.utils.createBoundingBox(x, y)
  • LDA.utils.createModuleSpec(slots, icon_shift)
  • LDA.utils.createResistance(resistenceType, percent)
  • LDA.utils.getFullResistance(percent)
  • LDA.utils.getRandomPositionAround(centerX, centerY, min, max)
  • LDA.utils.getAudio(filename, volume)
  • LDA.utils.getSequentialAudioList(base_filename, start_index, end_index, volume)
  • LDA.utils.CreateBaseAmbientSound(nameTrack, track_type, volume, SpaceLocationID)
  • LDA.utils.CreateInterludeAmbientSound(nameTrack, volume, SpaceLocationID)
  • LDA.utils.CreateMenuAmbientSound(nameTrack, volume)
  • LDA.utils.getPicture(filename, size, scale, mipmap_count)
  • LDA.utils.getSequentialPictureList(base_filename, start_index, end_index, size, scale, mipmap_count)
  • LDA.formatResultsList(results_list)

📝 Formato Bruto (Parâmetros)

Recursos e Itens

  • LDA.createAutoplaceControl(name, order, tint, icon_size, icon_mipmaps)
  • LDA.createResource(name, order, particleName, resource_parameters, autoplace_parameters)
  • LDA.createOre(name, stack_size, fuel_category, fuel_value)
  • LDA.createItem(name, subgroup, stack_size, pictures)
  • LDA.createBlockItem(name, subgroup, stack_size)
  • LDA.createEquipmentItem(name, subgroup, weight)
  • LDA.createFluid(name, energy)
  • LDA.createGas(name, energy)
  • LDA.createItemGroup(group_name, group_order, icon_size, subgroups, icon_mipmaps)
  • LDA.createEntity(typeEntity, name, subgroup, stack_size)

Receitas

  • LDA.createRecipe(typeIcon, name, crafted_in, time, ingredients, results, alt_unlocks, enabled)
  • LDA.createItemWithRecipe(name, subgroup, stack_size, crafted_in, time, ingredients, results, alt_unlocks, isEnabled, pictures)
  • LDA.createThrowInWaterItemWithRecipe(name, time, qtde, ingredients, stack_size, requiredWaterValue, alt_unlocks, isEnabled)
  • LDA.createFluidWithRecipe(name, heatEnergy, crafted_in, time, ingredients, results, alt_unlocks)
  • LDA.createBlockItemWithRecipe(name, subgroup, stack_size, crafted_in, time, ingredients, results, alt_unlocks, isEnabled, icon_size, pick_sound, drop_sound)
  • LDA.createEquipmentItemWithRecipe(name, subgroup, weight, crafted_in, time, ingredients, results, alt_unlocks, isEnabled)
  • LDA.createSmeltingItemWithRecipe(name, time, qtde, ingredients, crafted_in, alt_unlocks, isEnabled)
  • LDA.createAssemblerItemWithRecipe(name, time, qtde, ingredients, stack_size, alt_unlocks, isEnabled)
  • LDA.createChemicalPlantItemWithRecipe(name, time, qtde, ingredients, stack_size, alt_unlocks, isEnabled)
  • LDA.createBiochamberItemWithRecipe(name, time, qtde, ingredients, stack_size, alt_unlocks, isEnabled)
  • LDA.createGenericRecipe(name)

Tecnologia

  • LDA.createTechnology(name, ingredients, prerequisites, unlocks, time, count, isUpgrade)
  • LDA.createTechnologyTrigger(name, unlocks, prerequisites, research_trigger)
  • LDA.createTechnologyCraftEntityTrigger(name, unlocks, prerequisites, item, count)
  • LDA.createTechnologyMineEntityTrigger(name, unlocks, prerequisites, mine_entity)
  • LDA.techUtils.createEffectsUnlocksRecipes(recipesList)

Utilidades

  • LDA.setBasePath(modName)
  • LDA.getBasePath()
  • LDA.utilsAmbientEffects.createExplosion(surface, position)
  • LDA.utilsAmbientEffects.createCrashFire(surface, center, count)
  • LDA.utilsAmbientEffects.createSecondaryExplosions(surface, center, count)
  • LDA.utilsAmbientEffects.createScorchmark(surface, position)
  • LDA.utils.getRandomPositionAround(centerX, centerY, min, max)
  • LDA.formatResultsList(results_list)

Categorias de crafted_in Comuns

ID Descrição
crafting Feito à mão.
basic-crafting Máquinas de montagem Tier 1.
advanced-crafting Máquinas de montagem Tier 2 e 3.
smelting Fornalhas.
centrifuging Centrífuga.
chemistry Chemical plant e outros processos químicos.
organic Biochamber / processos orgânicos.
throw-in-water Gatilho de água (customizado pela LIB).

📘 Documentação de uso

Para exemplos detalhados de uso e padrões de chamada, consulte o arquivo USAGE.md.

Terms of Service|Privacy|Imprint|Presskit|Contact|FAQ|Jobs
Copyright © 2015 - 2026 Wube Software - all rights reserved.