O Metamétodo __index

Agora que você sabe como anexar metatabelas a tabelas, é hora de aprender sobre o metamétodo mais importante: __index. Este metamétodo controla o que acontece quando você tenta acessar uma chave que não existe em uma tabela.

Normalmente, quando você procura uma chave que não está em uma tabela, o Lua retorna nil. Mas quando uma tabela tem uma metatabela com um campo __index, o Lua verificará esse campo em vez disso. Se o __index apontar para outra tabela, o Lua procurará a chave lá:

local defaults = {
    health = 100,
    speed = 10
}

local player = {name = "Alice"}
local meta = {__index = defaults}

setmetatable(player, meta)

print(player.name)    -- Saída: Alice
print(player.health)  -- Saída: 100

Neste exemplo, player possui apenas uma chave name. Quando você acessa player.health, o Lua não a encontra em player, então ele verifica o campo __index da metatabela. Como __index aponta para a tabela defaults, o Lua procura lá e encontra health = 100.

Isso cria um mecanismo de fallback onde uma tabela pode fornecer valores padrão para outra. A tabela original mantém seus próprios valores, mas quaisquer chaves ausentes são procuradas automaticamente na tabela de fallback.