여러분의 Roblox 게임 속 플레이어들이 게임 안에서 직접 AI와 채팅할 수 있다면 어떨까요? 혹은 가상 의자에 앉는 것만으로 실제 세계의 IoT 기기를 작동시킬 수 있다면 어떨까요?

이 튜토리얼에서는 Roblox를 AWS 서비스, 특히 생성형 AI를 위한 Amazon Bedrock 및 IoT 명령/센서 데이터를 위한 Amazon DynamoDB와 통합하여 가상 세계와 물리적 세계가 연결되는 인터랙티브한 경험을 만드는 방법을 보여드리겠습니다.

그 결과 다음과 같은 기능을 갖춘 Roblox 게임이 탄생합니다:

• 플레이어가 게임 내 채팅 명령을 통해 AI(Amazon Nova Lite)에게 질문할 수 있음
• NPC가 DynamoDB와 MQTT를 통해 실제 세계의 IoT 동작을 트리거함
• 물리적 세계의 센서 데이터가 게임 내부에 나타남

아키텍처 개요 (Architecture Overview)

┌─────────────────────────────────────────────────────────────┐
│                      ROBLOX GAME                            │
│                                                             │
...

두 가지 통합 경로:

1. Bedrock (AI 채팅): Roblox → HTTP GET → API Gateway → Lambda (Quarkus) → Amazon Bedrock → 게임 채팅으로 응답 반환
2. DynamoDB (IoT): Roblox → Roblo3 SDK → DynamoDB 직접 API 호출 → 센서 읽기 / 명령 쓰기

사전 요구 사항 (Prerequisites)

• Roblox Studio 설치됨
• Amazon Bedrock(Nova Lite 모델 활성화됨)에 접근 가능한 AWS 계정
• AWS SAM CLI 설치됨
• Java 17 및 Maven 설치됨
• Lua (Roblox 스크립팅) 및 Java에 대한 기본 지식

파트 1: AWS Lambda 백엔드 (Bedrock 통합)

1단계: Quarkus 프로젝트 생성

우리는 Amazon Bedrock을 래핑하는 서버리스 REST API를 만들기 위해 quarkus-amazon-lambda-http 확장을 사용하는 Quarkus를 사용합니다.

roblox-bedrock/
├── pom.xml
├── template.yml          (SAM 배포 템플릿)
...

2단계: Bedrock REST 엔드포인트

다음은 Roblox로부터 질문을 받아 Amazon Nova Lite 모델을 사용하여 Amazon Bedrock의 Converse API로 전달하는 핵심 Java 클래스입니다:

package org.acme;

import jakarta.ws.rs.GET;
...

주요 사항:

• question 쿼리 파라미터와 함께 GET 방식을 사용합니다 — Roblox의 HttpService:GetAsync()에서 사용하기에 충분히 간단합니다.
• 응답은 일반 텍스트 (Plain text)입니다 (JSON이 아님) — Roblox 채팅창에 직접 표시하기 더 쉽습니다.
• maxTokens=300 설정은 게임 내 표시를 위해 응답을 간결하게 유지합니다.
• Bedrock 모델과 상호작용하는 권장 방식인 Converse API를 사용합니다.

Step 3: Maven 의존성 (Maven Dependencies)

<dependencies>
    <dependency>
        <groupId>io.quarkus</groupId>
...

quarkus-amazon-lambda-http 확장은 REST 엔드포인트를 Lambda 함수로서 API Gateway 뒤에서 작동하도록 자동으로 조정합니다 — 로컬 개발과 프로덕션 환경 간에 코드 변경이 필요 없습니다.

Step 4: 배포를 위한 SAM 템플릿 (SAM Template for Deployment)

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: Roblox Quarkus AWS SAM application
...

주요 배포 기능:

• SnapStart — Java를 위한 Lambda 콜드 스타트 (Cold start) 시간을 획기적으로 줄여줍니다.
• HttpApi — 낮은 지연 시간과 비용을 위해 API Gateway HTTP API (v2)를 사용합니다.
• bedrock:/* — Lambda가 모든 Bedrock 모델을 호출할 수 있도록 허용합니다.
• 15초 타임아웃 (15-second timeout) — Bedrock 추론 (Inference)에는 몇 초가 소요될 수 있습니다.

Step 5: 빌드 및 배포 (Build and Deploy)

# 프로젝트 빌드
./mvnw clean package -DskipTests

...

배포 후에는 API Gateway URL을 받게 됩니다. 다음 명령어로 테스트해 보세요:

curl "https://<your-api-id>.execute-api.us-east-1.amazonaws.com/bedrock/ask?question=What+is+cloud+computing"

Part 2: Roblox 스크립트 (게임 측)

게임 계층 구조 설정 (Game Hierarchy Setup)

Roblox Studio에서 다음 항목들이 필요합니다:

• ReplicatedStorage: 두 개의 RemoteEvent 객체 — AWSChatBedRockRS 및 AWSChatIOTRS
• ServerScriptService: 서버 스크립트 + Roblo3 모듈 + AWS 모듈
• StarterPlayerScripts: 클라이언트 측 AWSChatClientScript
• TextChatService: 커스텀 채팅 명령어 (chatAWSBedrock, chatAWSIoT, chatAWSConfig)

Script 1: Bedrock Chat ServerScript

이 서버 스크립트(server script)는 /bedrock 채팅 명령어를 감지하고, Lambda API를 호출하며, AI 응답을 모든 플레이어에게 브로드캐스트(broadcast)합니다:

print("AWS Config initializing")
DataStoreService = game:WaitForChild("DataStoreService")
awsCredentialStore = DataStoreService:WaitForChild("AwsCredential")
...

작동 방식:

1. 플레이어가 /bedrock What is serverless computing?을 입력합니다.
2. TextChatService 명령어가 채팅 텍스트와 함께 트리거(trigger)됩니다.
3. 질문( "bedrock " 이후의 모든 내용)을 추출합니다.
4. HttpService:GetAsync()를 통해 Lambda API를 호출합니다.
5. RemoteEvent를 통해 연결된 모든 클라이언트(client)에 응답을 전달합니다.

⚠️ 중요: Roblox 게임 설정에서 HttpService를 활성화해야 합니다 (Game Settings → Security → Allow HTTP Requests).

Script 2: 클라이언트 측 표시 (AWSChatClientScript)

이 로컬 스크립트(LocalScript)는 각 플레이어의 클라이언트에서 실행되며 채팅창에 AI 응답을 표시합니다:

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local listenerIoT = ReplicatedStorage:WaitForChild("AWSChatIOTRS")
local listenerBedrock = ReplicatedStorage:WaitForChild("AWSChatBedRockRS")
...

Part 3: DynamoDB 통합 (IoT 명령 및 센서)

AWS 모듈 (ModuleScript)

이 재사용 가능한 모듈은 Roblo3 라이브러리(Roblox/Lua용 AWS SDK 구현체)를 사용하여 모든 DynamoDB 상호작용을 처리합니다:

local module = {}
local ServerScriptService = game:WaitForChild("ServerScriptService")
local roblo3 = require(ServerScriptService.Roblo3)
...

IoT 채팅 서버 스크립트 (ServerScript)

플레이어는 채팅 명령을 통해 센서를 조회하거나 IoT 장치를 제어할 수 있습니다:

print("Chat initializing")
local ServerScriptService = game:GetService("ServerScriptService")
local roblo3 = require(ServerScriptService.Roblo3)
...

NPC 및 게임 오브젝트 트리거 (Triggers)

게임 오브젝트 또한 AWS 명령을 트리거할 수 있습니다. 예를 들어, 의자에 앉는 동작이 IoT 액션(action)을 트리거할 수 있습니다:

local seat = script.Parent
local ServerScriptService = game:WaitForChild("ServerScriptService")
local aws = require(ServerScriptService.AWS)
...

Part 4: AWS 자격 증명 관리 (AWS Credential Management)

DynamoDB 직접 액세스를 위한 자격 증명 (Credentials)은 게임 내 채팅 명령어를 통해 구성됩니다:

print("AWS Config initializing")
DataStoreService = game:GetService("DataStoreService")
awsCredentialStore = DataStoreService:GetDataStore("AwsCredential")
...

🔒 보안 참고 사항 (Security Note): 프로덕션 환경에서는 최소 권한을 가진 IAM 역할 (IAM roles)을 사용하고, 자격 증명을 내장하는 대신 프록시 서비스 (proxy service) 사용을 고려하십시오. DataStore 방식은 자격 증명을 서버 측에만 유지하여 (클라이언트에 절대 노출되지 않음) 보안을 유지하지만, 정기적으로 자격 증명을 교체(rotate)하고 특정 DynamoDB 테이블로 범위를 제한해야 합니다.

Part 5: DynamoDB 테이블 설계 (DynamoDB Table Design)

gaming_sensors 테이블

속성 (Attribute)	유형 (Type)	설명 (Description)
pk	String	파티션 키 (Partition key) ("sensor")
...

gaming_commands 테이블

속성 (Attribute)	유형 (Type)	설명 (Description)
command	String	명령 문자열 (예: "lamp-on")
timestamp	Number	Unix 에포크 타임스탬프 (Unix epoch timestamp)

명령어 형식은 MQTT 라우팅을 지원합니다: mqtt-publish|<topic>|<payload> — 별도의 IoT 마이크로서비스 (microservice)가 이 테이블을 폴링(poll)하여 적절한 MQTT 토픽 (topics)으로 발행(publish)합니다.

Part 6: Roblox Studio에서 설정하기 (Setting Up in Roblox Studio)

1. HTTP 요청 활성화 (Enable HTTP Requests)
Game Settings → Security → Allow HTTP Requests → Enable 순으로 이동합니다.

2. RemoteEvent 생성 (Create RemoteEvents)
ReplicatedStorage에 두 개의 RemoteEvent 인스턴스를 생성합니다:

• AWSChatBedRockRS
• AWSChatIOTRS

3. TextChatService 명령어 설정 (Set Up TextChatService Commands)
TextChatService에서 TextChatCommand 객체를 생성합니다:

• chatAWSBedrock — /bedrock에 의해 트리거됨
• chatAWSIoT — /iot에 의해 트리거됨
• chatAWSConfig — /aws에 의해 트리거됨

4. Roblo3 라이브러리 추가 (Add the Roblo3 Library)
Roblo3 라이브러리는 Roblox Lua를 위한 AWS SDK 기능을 제공합니다. 이를 ServerScriptService 아래에 DynamoDB 서브 모듈을 포함한 ModuleScript로 배치합니다.

5. 스크립트 배포 (Deploy Scripts)

• 서버 스크립트(server scripts)를 ServerScriptService에 배치합니다.
• AWSChatClientScript LocalScript를 StarterPlayerScripts에 배치합니다.
• AWS ModuleScript를 ServerScriptService에 배치합니다.

모든 것이 결합되는 방식 (How It All Comes Together)

AI 채팅 흐름 (AI Chat Flow)

플레이어가 입력: /bedrock What is Amazon Bedrock?
  → ServerScript가 명령어를 포착
  → HttpService:GetAsync(API Gateway URL)
...

IoT 센서 흐름 (IoT Sensor Flow)

플레이어가 입력: /iot temperature
  → ServerScript가 명령어를 포착
  → Roblox DynamoDB: gaming_sensors 테이블에서 GetItem 수행
...

물리적 세계 트리거 흐름 (Physical World Trigger Flow)

플레이어가 게임 내 의자에 앉음
  → Seat.Occupant 변경 감지
  → aws.publish_command("mqtt-publish|command|audio_kiro_code1")
...

성능 고려 사항 (Performance Considerations)

구성 요소 (Component)	최적화 (Optimization)
Lambda 콜드 스타트 (cold start)	SnapStart + 계층형 컴파일 (Tiered compilation)
...

배운 점 (Lessons Learned)

1. 단순하게 유지하기 (Keep it simple) — 쿼리 파라미터(query parameter)와 함께 GET을 사용하면 Roblox 통합이 매우 간단해집니다. HttpService:GetAsync()만 있으면 충분합니다.

2. 일반 텍스트 응답 (Plain text responses) — JSON 대신 일반 텍스트(plain text)를 반환하면 Roblox 측에서의 JSON 파싱(parsing) 필요성을 제거할 수 있습니다.

3. SnapStart는 필수적입니다 (SnapStart is essential)