Lua Academy · Aula

Configuração orientada por dados e recarga a quente

Carregue dados do jogo de arquivos Lua e recarregue scripts durante a execução.

Configuração orientada por dados e recarga a quente é uma aula grátis de Lua Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Lua Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Lua Academy inclui 4 aulas no total.

O que é design orientado por dados?

O design orientado por dados separa o quê (dados: atributos, fases, layouts) do como (código: lógica do jogo). Alterações nos dados não exigem recompilação.

Carregando a configuração de um arquivo Lua

Um arquivo de configuração é um script Lua que retorna uma tabela. Carregue-o com dofile ou loadfile + pcall.

-- config.lua
return {
  playerSpeed = 200,
  gravity     = 980,
  maxEnemies  = 10,
}

Lendo a configuração

No script principal, carregue e use a tabela de configuração.

local config = dofile("config.lua")
print(config.playerSpeed)  -- 200

Carregamento isolado da configuração

Por segurança, carregue a configuração em um ambiente restrito para que códigos maliciosos não possam chamar os.execute nem outras funções perigosas.

local function loadConfig(filename)
  local chunk, err = loadfile(filename)
  if not chunk then error(err) end
  local env = {math = math, table = table}
  setfenv and setfenv(chunk, env) or _ENV  -- 5.1 vs 5.2+
  return chunk()
end

Visão geral do hot-reload

O hot-reload permite alterar dados (ou código) enquanto o jogo está em execução. Isso acelera muito a iteração: ajuste um valor e veja o resultado imediatamente, sem reiniciar.

Detectando alterações em arquivos

Use os.difftime(os.time(), lastModified) ou consulte periodicamente o horário de modificação de um arquivo com uma extensão C ou uma técnica de E/S para detectar quando um arquivo de configuração foi alterado.

Recarregando a configuração

Quando houver uma alteração, recarregue o arquivo e atualize a tabela de configuração em execução no próprio lugar, para que todas as referências à tabela vejam os novos valores.

local function hotReload(config, filename)
  local ok, newCfg = pcall(dofile, filename)
  if ok and type(newCfg) == "table" then
    for k, v in pairs(newCfg) do config[k] = v end
    print("Config reloaded")
  else
    print("Reload error:", newCfg)
  end
end

Recarregando módulos Lua

Remova um módulo de package.loaded antes de chamar require novamente para forçar um carregamento novo.

package.loaded["mymodule"] = nil
local mymodule = require("mymodule")

Dados de fases em Lua

Defina as fases como tabelas Lua: layouts de salas, posicionamento de inimigos e zonas de acionamento. Carregue-as durante a execução com dofile para iterar rapidamente.

-- level1.lua
return {
  name = "Forest",
  enemies = {
    {type="goblin", x=100, y=200},
    {type="troll",  x=300, y=150},
  },
  music = "forest_theme.ogg",
}

Validação

Depois de carregar a configuração, valide os campos e tipos obrigatórios. Forneça mensagens de erro claras para dados ausentes ou malformados.

Identificadores de versão

Inclua um campo version nos arquivos de configuração. Rejeite arquivos com versões incompatíveis para evitar erros silenciosos causados por dados desatualizados.

Pergunta sobre hot-reload

Como você força Lua a recarregar um módulo armazenado em cache?

Recapitulação: configuração orientada por dados e hot-reload

Carregue os dados do jogo de arquivos Lua com dofile/loadfile. Use ambientes isolados para configurações não confiáveis. Implemente o hot-reload consultando periodicamente os horários de modificação dos arquivos e limpando package.loaded para recarregar módulos.

Perguntas Frequentes

A aula “Configuração orientada por dados e recarga a quente” é grátis?

Sim — o texto completo de “Configuração orientada por dados e recarga a quente” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Lua Academy, atualize para CoddyKit PRO. O curso de Lua Academy inclui 4 aulas no total.

O que vou aprender em “Configuração orientada por dados e recarga a quente”?

Carregue dados do jogo de arquivos Lua e recarregue scripts durante a execução. Você pratica Lua Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Lua Academy?

Nenhuma experiência prévia é necessária. Lua Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Configuração orientada por dados e recarga a quente”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Lua Academy?

Sim. Cada aula de Lua Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

Sistemas de eventos em Lua
Script baseado em componentes
Comportamento de IA com máquinas de estados
Configuração orientada por dados e recarga a quente

← Voltar para Lua Academy