로블록스 커스텀 인벤토리 아키텍처: 데이터 기반 핫바, 버퍼 직렬화 및 복사 버그 방지 뮤텍스

현대 로블록스 게임에서 엔진 기본 제공 기능인 `Backpack`과 `Tool` 인스턴스에 의존하는 것은 심각한 기술적 부채를 초래합니다. 기본 Tool 방식은 제어되지 않는 물리 복제와 무기 장착 시 캐릭터 튕김 버그를 일으키며, 클라이언트 메모리 변조를 통한 아이템 복사 버그에 극히 취약합니다.

상용 RPG, 생존 샌드박스, 익스트랙션 게임을 제작하려면 순수 데이터 기반 커스텀 인벤토리 시스템이 필수적입니다. Luau 테이블로 상태를 관리하고, 네이티브 `buffer` 비트패킹을 통해 네트워크 패킷을 90% 절감하며, 서버 뮤텍스(Mutex) 락을 통해 아이템 복사를 완벽히 방어하는 아키텍처를 소개합니다.

1. 기본 Tool 탈피: 데이터 기반 인벤토리 아키텍처

프로덕션 프로젝트에서 기본 Backpack Tool을 버리고 데이터 기반 설계를 택하는 이유:

• 물리 및 계층 구조 오버헤드: 기본 Tool은 파트, 스크립트, 핸들 인스턴스를 통째로 캐릭터에 복제하므로 물리 엔진에 불필요한 부하를 주고 래그돌 시 튕김을 유발합니다.
• 순수 데이터 상태 관리: 아이템은 단순히 `{ itemId: number, quantity: number, durability: number }` 형태의 불변 데이터로만 존재하며, 3D 메시는 실제로 장착했을 때만 Workspace에 동적 스폰합니다.
• 네트워크 복제 분리: 인벤토리 데이터는 서버의 PlayerProfile에 안전하게 보관되고, 단일 압축 RemoteEvent를 통해 클라이언트로 전송되어 인스턴스 스폰 렉이 0ms가 됩니다.
• 단일 진실 공급원(SSOT): 아이템 소비, 이동, 버리기는 오직 서버에서만 연산하며, 클라이언트 UI는 서버 데이터의 시각적 반영체에 불과합니다.

2. 버퍼 비트패킹(Bitpacking) 및 네트워크 직렬화

40칸 인벤토리 전체를 수백 바이트의 네이티브 바이너리 버퍼로 압축 동기화하는 기법:

• Luau 버퍼 기본 함수: `buffer.create`, `buffer.writeu16`, `buffer.writeu8`를 활용하여 슬롯당 단 4바이트로 아이템 데이터를 완벽히 인코딩합니다.
• 바이너리 슬롯 레이아웃: ItemID에 2바이트(u16, 최대 65,535종 아이템), 수량에 1바이트(u8, 0~255개), 내구도 비율에 1바이트(u8, 0~100%)를 배정합니다.
• 대역폭 절감 효과: 40칸 인벤토리를 일반 JSON/딕셔너리로 전송하면 약 1.2 KB가 소모되지만, 버퍼 비트패킹 시 단 160바이트(87% 대역폭 절감)로 축소됩니다.
• 델타 동기화: 게임 도중 변경이 발생한 특정 슬롯 번호만 부분 전송하여 대규모 멀티플레이어 환경에서도 핑 튐이 전혀 발생하지 않습니다.

--!strict
local Players = game:GetService("Players")

local InventoryService = {}
InventoryService.__index = InventoryService

export type ItemSlot = {
    itemId: number,      -- u16 (0 - 65535)
    quantity: number,    -- u8  (0 - 255)
    durability: number,  -- u8  (0 - 100)
}

local playerInventories: { [Player]: { slots: { ItemSlot }, isLocked: boolean } } = {}

-- 40칸 빈 인벤토리 초기화
function InventoryService.InitPlayer(player: Player)
    local emptySlots: { ItemSlot } = {}
    for i = 1, 40 do
        emptySlots[i] = { itemId = 0, quantity = 0, durability = 0 }
    end
    playerInventories[player] = { slots = emptySlots, isLocked = false }
end

-- 40칸 슬롯을 단 160바이트 바이너리 버퍼로 직렬화
function InventoryService.SerializeToBuffer(player: Player): buffer?
    local data = playerInventories[player]
    if not data then return nil end
    
    local buf = buffer.create(160) -- 40슬롯 * 4바이트
    for i = 1, 40 do
        local slot = data.slots[i]
        local offset = (i - 1) * 4
        buffer.writeu16(buf, offset, slot.itemId)
        buffer.writeu8(buf, offset + 2, slot.quantity)
        buffer.writeu8(buf, offset + 3, slot.durability)
    end
    return buf
end

-- 아이템 복사 방지 뮤텍스 락 기반 슬롯 교환
function InventoryService.MoveItem(player: Player, fromSlot: number, toSlot: number): boolean
    local data = playerInventories[player]
    if not data or data.isLocked then return false end
    
    if fromSlot < 1 or fromSlot > 40 or toSlot < 1 or toSlot > 40 then return false end
    if fromSlot == toSlot then return false end
    
    -- 트랜잭션 락 획득 (경쟁 상태 차단)
    data.isLocked = true
    
    local source = data.slots[fromSlot]
    local target = data.slots[toSlot]
    
    -- 원자적 교환 수행
    data.slots[fromSlot] = target
    data.slots[toSlot] = source
    
    -- 트랜잭션 락 해제
    data.isLocked = false
    return true
end

return InventoryService

3. 핫바 슬롯 관리 및 Motor6D 무기 장착 연동

캐릭터 물리 충돌 없이 3D 무기 모델을 손에 쥐여주는 정밀 구현:

• 동적 모델 생성: 1~9번 숫자키로 핫바를 선택하면 클라이언트가 서버에 장착을 요청하고, 서버는 ReplicatedStorage에서 해당 3D 모델을 클론하여 장착합니다.
• Motor6D 용접: 기존 Weld 대신 Motor6D를 사용하여 캐릭터의 RightHand와 무기 손잡이를 결합합니다. 이를 통해 무기 흔들림 및 휘두르기 애니메이션이 자연스럽게 골격에 블렌딩됩니다.
• 고속 슬롯 스왑 디바운스: 0.2초의 스왑 쿨다운을 강제하여 무기 교체 키 연타로 인한 애니메이션 깨짐과 공격 판정 꼬임을 방지합니다.
• 클라이언트 예측 렌더링: 조작감을 위해 클라이언트는 즉시 발도 애니메이션을 재생하고 UI 하이라이트를 이동시키며, 서버는 쿨다운을 검증한 뒤 공식 히트박스를 활성화합니다.

4. 복사 버그 방지 뮤텍스 락 및 트랜잭션 안전성

멀티플레이어 경제를 파탄 내는 아이템 복사 버그의 완벽한 기술적 차단:

• 비동기 경쟁 상태(Race Condition) 취약점: 창고에 아이템을 넣음과 동시에 바닥에 버리는 패킷을 같은 프레임에 전송하는 방식이 대표적인 복사 취약점입니다.
• 서버 측 트랜잭션 뮤텍스: 모든 인벤토리 및 보관함 객체에 `isLocked` 불리언 락을 배치하여, 하나의 이동 작업이 처리 중일 때는 다른 모든 요청을 즉시 거부합니다.
• 유저 간 거래의 2단계 커밋(2-Phase Commit): 양측 인벤토리를 동시에 잠그고, 한쪽이라도 접속이 끊기거나 취소하면 이전 스냅샷으로 롤백합니다.
• 아이템 드롭 원자성: 아이템을 월드에 떨어뜨릴 때, Workspace에 물리 오브젝트를 스폰하기 전에 인벤토리 데이터에서 먼저 아이템을 완전히 삭제해야 합니다.

5. 모바일 터치 UX 최적화 및 프로덕션 수칙

PC, 콘솔, 모바일 터치스크린을 모두 아우르는 인벤토리 UI 구축 원칙:

• 터치 타깃 최소 면적 보장: 모바일 화면의 핫바 슬롯 크기를 최소 48x48 포인트 이상으로 확보하여 난전 중 오작동을 차단합니다.
• 드래그 앤 드롭 대안 인터페이스: 모바일에서는 손가락이 화면을 가리는 드래그 방식 대신 "선택 슬롯 탭 -> 이동 대상 슬롯 탭" 방식의 2스텝 모달을 병행 지원해야 합니다.
• UI 슬롯 오브젝트 풀링: 인벤토리를 열 때마다 GuiObject를 새로 생성하지 말고, 40개 슬롯 Frame을 미리 생성해 둔 뒤 Visible과 아이콘 텍스처만 동적으로 변경합니다.
• MicroProfiler UI 렌더링 검증: 100칸짜리 대형 인벤토리를 열 때 UI 레이아웃 재계산(`AutomaticSize`)으로 인한 프레임 드랍이 없도록 1.5ms 미만을 유지합니다.

Frequently Asked Questions