LuauでOOPを実装する完全ガイド — メタテーブル・クラスパターン・継承の実践テクニック【2026年版】

Luauにはクラスキーワードがありません。テーブルと__indexメタメソッドを組み合わせることでOOP（オブジェクト指向プログラミング）を完全に再現できます。本ガイドでは基本パターンから継承・型安全設計まで網羅します。

LuauはLua 5.1をベースとしており、言語仕様としてクラス構文を持ちません。しかしLuauのメタテーブル機能は非常に強力で、実質的にクラスと同等の抽象化が可能です。Robloxの大規模ゲームプロジェクトでも、この手法が標準的に使われています。

以下はLuauで最もよく使われる基本クラスパターンです。

local Animal = {}
Animal.__index = Animal

function Animal.new(name: string, sound: string)
    local self = setmetatable({}, Animal)
    self.name = name
    self.sound = sound
    return self
end

function Animal:speak()
    print(self.name .. " says " .. self.sound)
end

function Animal:getName(): string
    return self.name
end

return Animal

ポイントはAnimal.__index = Animalの一行です。setmetatable({}, Animal)でインスタンスを生成すると、メソッド参照がAnimalテーブルにフォールバックされます。

Luauの型システムを活用すると、IDEの補完や静的解析が有効になります。

local Animal = {}
Animal.__index = Animal

export type Animal = typeof(setmetatable(
    {} :: {
        name: string,
        sound: string,
    },
    Animal
))

function Animal.new(name: string, sound: string): Animal
    local self = setmetatable({} :: { name: string, sound: string }, Animal)
    self.name = name
    self.sound = sound
    return self
end

export typeを使うことで他のModuleScriptからもこの型を参照できます。

Luauでの継承は、親クラスを__indexチェーンに連結することで実現します。

local Animal = require(script.Parent.Animal)

local Dog = setmetatable({}, { __index = Animal })
Dog.__index = Dog

export type Dog = typeof(setmetatable(
    {} :: { breed: string },
    Dog
))

function Dog.new(name: string, breed: string): Dog
    local self = setmetatable(Animal.new(name, "Woof") :: any, Dog)
    self.breed = breed
    return self
end

function Dog:fetch(item: string)
    print(self.name .. " fetches the " .. item)
end

return Dog

setmetatable({}, { __index = Animal })でDogテーブル自体がAnimalのメソッドを継承します。インスタンスはまずDogのメソッドを探し、なければAnimalを参照します。

Luauで使用可能な主要メタメソッドをまとめます。

Robloxコミュニティでは.new()が事実上の標準です。Roblox公式ライブラリもこのパターンを採用しています。

Luauにはアクセス修飾子がありません。以下の2つのアプローチが一般的です。

アンダースコア命名規約（慣習的プライベート）

function Animal.new(name: string)
    local self = setmetatable({}, Animal)
    self._name = name  -- 「内部用」を示す命名規約
    return self
end

クロージャパターン（真のプライベート）

local function createAnimal(name: string)
    local _name = name  -- 外部からアクセス不可
    return {
        getName = function() return _name end,
        setName = function(n) _name = n end,
    }
end

クロージャパターンは真のカプセル化を提供しますが、メタテーブルによる継承は利用できません。

クラスはModuleScriptとして独立させることがベストプラクティスです。

ServerScriptService
  └── Classes
        ├── Animal.luau   (ModuleScript)
        ├── Dog.luau      (ModuleScript)
        └── Cat.luau      (ModuleScript)

各ModuleScriptの末尾にreturn Animalを記述し、利用側でlocal Animal = require(script.Parent.Classes.Animal)と読み込みます。循環参照に注意し、依存関係は常に一方向に保ちましょう。

手動でのOOP実装が煩雑な場合、コミュニティ製ライブラリが利用できます。

ただし小〜中規模プロジェクトでは、標準メタテーブルパターンの習得の方が長期的に有益です。

Q1. なぜLuauにはクラス構文が追加されないのですか？
A. Luaの哲学である「シンプルで拡張可能な言語」を維持するためです。メタテーブルで同等機能が実現できるため、言語レベルのクラスは不要と判断されています。

Q2. TypeScriptのクラスと比べて何が違いますか？
A. TypeScriptはコンパイル時の型チェックと真のプロトタイプ継承を持ちます。Luauのメタテーブルは実行時の動的ディスパッチであり、型推論はLuauの型システムで補完します。

Q3. __indexをテーブルではなく関数にすることはできますか？
A. はい。__index = function(self, key) ... endとすることで、プロパティアクセスをカスタム制御できます。動的プロキシパターンに有用です。

Q4. パフォーマンスへの影響はありますか？
A. メタテーブルルックアップには若干のオーバーヘッドがありますが、Robloxゲームのスケールでは問題になることはほぼありません。ホットパスでの大量インスタンス生成には注意が必要です。

Q5. 多重継承は実装できますか？
A. 直接はサポートされませんが、__indexを関数にして複数のテーブルを検索するミックスインパターンで擬似的に実現できます。

Q6. strict modeと組み合わせて使えますか？
A. はい。--!strictモードでは型アノテーションが必須になりますが、export typeとtypeof(setmetatable(...))パターンで完全に対応できます。

Q7. Roblox公式のOOP推奨パターンはありますか？
A. Roblox公式ドキュメントでも.new()コンストラクタと__indexメタテーブルパターンが標準として紹介されています。

Luauを使ったRobloxゲーム開発やカスタムシステム構築でご支援が必要な方は、Oflightにご相談ください。OOP設計・モジュール分割・パフォーマンス最適化まで、プロフェッショナルな視点でサポートします。詳細はソフトウェア開発サービスをご覧ください。