Inworld Product

크리에이터는 자신이 제작한 월드에 코인 같은 재화나 아이템, 스테이지2 해금 같은 월드 내 요소를 사용자가 크레딧으로 구매할 수 있도록 인월드 상품 기능을 사용할 수 있어요.

1 판매자의 의무🚩

크리에이터는 자신이 판매한 인월드 상품에 대한 사용자의 문의에 반드시 대응해야 하며, 이를 준수하지 않는 경우 🟥판매 자격이 정지될 수 있어요

자세한 내용은 디토랜드 정책 센터내 UGC 정책의 제 2장 유료 UGC의 판매 항목을 참고하세요.

⇒ https://ditoland.net/policyCenter/studio

2 상품 등록하기🎀

월드 관리 페이지내 월드 상품 관리 메뉴에 진입해요.
월드 상품 관리 페이지에서 등록하기 버튼을 눌러 상품을 등록할 수 있어요. (등록한 상품은 삭제할 수 없어요.)

상품 등록 화면에서 상품 정보를 입력 후, 등록 버튼을 눌러요.

상품 정보

상품명 / 상품설명 / 상품이미지 : 상품의 용도를 기입합니다. 혐오감, 성희롱을 유발하는 등의 내용은 사용이 불가하며, 예고 없이 운영진에 의해 삭제될 수 있어요
판매 금액 : 구매 시 필요한 크레딧(가격)

상품 종류

종류	기능	사용 예시
이용권(영구성)	일회성 구매 상품 (특전, 접근권) 이용권 상품은 반복 구매할 수 없어요.	스테이지2 해금 상품
소모품(비영구)	반복 구매 상품 (재화, 소모성)	코인 +200 상품 무기아이템 1번 상품 스킨 상품 부활권 경험치 부스터 상품

종류

기능

사용 예시

이용권(영구성)

일회성 구매 상품 (특전, 접근권)
이용권 상품은 반복 구매할 수 없어요.

스테이지2 해금 상품

소모품(비영구)

반복 구매 상품 (재화, 소모성)

코인 +200 상품
무기아이템 1번 상품
스킨 상품
부활권
경험치 부스터 상품

판매상태 : 최초 등록 시 비공개로 등록되며, 등록 후에 상태를 변경할 수 있어요
상품 ID : 상품 등록 완료 시 자동으로 생성되며, Script에서 기능 연결 시 사용해요

※주의 사항

상품 등록 완료 후 이미지, 판매 상태만 수정할 수 있어요 (상품명, 상품설명, 판매금액 종류는 등록 후에 수정이 불가해요)
등록한 상품 내용의 수정은 제한되니 입력한 정보를 잘 확인 후 저장해 주세요.

3 상품 상태 변경하기⚙️

등록한 상품의 상태를 변경하기 위해 상품 이름 영역을 클릭해요.
상품 상태를 변경 후 수정 버튼을 누르면 상품 상태가 변경돼요.
상태 기능
비공개
상품을 판매 목록에서 노출하지 않아요. (구매한 상품은 보존됩니다.)
공개
상품을 판매 목록에 노출해요.

상태	기능
비공개	상품을 판매 목록에서 노출하지 않아요. (구매한 상품은 보존됩니다.)
공개	상품을 판매 목록에 노출해요.

4 스튜디오에서 상품 정보를 불러올 월드 ID 입력하기🏷️

스튜디오에서 파일 메뉴 - 스튜디오 설정을 열고, Developer 탭에서 인월드 상품용 테스트 월드 ID에 상품이 등록된 월드의 ID를 입력해요.
- 월드의 ID는 월드 페이지의 주소에서 마지막 번호나 상품 관리 페이지에서 각 상품 번호의 앞 글자로 알 수 있어요.
인월드 상품용 테스트 월드 ID를 입력한 다음, 적용 버튼을 눌러요.

※주의 사항

설정한 인월드 상품용 테스트 월드 ID 정보는 맵(RMO)에 저장되는 정보가 아니기 때문에, 스튜디오를 끄면 다시 입력해야 해요

5 스크립트 기능 구현🛠️

5-1 판매할 상품 정보 가져오기🎁

공개 상태의 상품을 스크립트에서 가져오는 방법이에요.

--클라이언트 스크립트에서

ProductList = nil -- 상품 정보를 가져올 변수

----------------------------------------------------------------------------------------
--특정 상품 정보 출력
local function PrintProductData(productData)    
    local productID       = productData.ID           --상품 ID
    local productName     = productData.Name         --상품 이름
    local productType     = productData.ProductType  --상품 종류
    local productDesc     = productData.Comment      --상품 설명
    local priceType       = productData.PriceType    --상품 가격 타입
    local productPrice    = productData.Price        --상품 가격  
    local productImageURL = productData.ImageURL     --상품 이미지    
     
    print("productID", productID, "productName", productName, "productDesc", productDesc)
      
    if     productType == Enum.ProductType.Ticket      then 
        print("productType", "이용권")
           
    elseif productType == Enum.ProductType.Expendables then 
        print("productType", "소모품")
    end  
      
    if priceType == Enum.PriceType.DitoCredit then 
        print("priceType", "크레딧", "productPrice", productPrice)  
    end      
      
     print("productImageURL", productImageURL)
     print("--------------------------------------------")
end

----------------------------------------------------------------------------------------
--모든 상품 정보 가져오기 
--(GetProductList 함수는 OnEnterPlayer나 OnSpawnCharacter가 아닌 UI 활성화시 같은 특정 시점에서 호출해야 해요.)
--(활성화된 상품 수가 많으면 반환이 늦을 수 있어요.)
local function RefreshProductList(self)
    ProductList = Marketplace:GetProductList()  
    print("공개 상태의 상품 수 : ", #ProductList)
    
    for i = 1, #ProductList do       
        local productData = ProductList[i]
       
        PrintProductData(productData)
    end
end
Workspace.ShopUI.ShopOpenButton.OnPressEvent:Connect(RefreshProductList)

5-2 상품 구매 요청🛒

특정 상품(상품 ID)에 대한 구매 시도를 요청하는 방법이에요.

--클라이언트 스크립트에서

----------------------------------------------------------------------------------------
--상품 구매 버튼 클릭시 상품 ID로 구매를 요청해요.
local function ClickPurchaseButton(self)
    local productID = productData.ID
	
    --OpenConfirmPopup 함수로 특정 상품의 구매 창을 출력해요.
    Marketplace:OpenConfirmPopup(productID)
end
productButton.OnPressEvent:Connect(ClickPurchaseButton)

5-3 상품 구매 결과 처리📢

구매가 발생했을 때, 어떻게 결과를 판단하는지에 대한 방법이에요.

--클라이언트 스크립트에서

----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(buyEventData, flag)
    local player = LocalPlayer:GetRemotePlayer()
    local productID = buyEventData.ID --구매 시도한 상품의 ID
    
    --구매 성공시
    if flag == 1 then      
        print(player.Name .. " " .. productID .. " 구매 성공!")
        
        --실제 지급 처리는 Server에서 
    
    --충전 필요시
    elseif flag == 2 then  
        print(player.Name .. " " .. productID .. " 충전 필요!")
    
    --중복 구매 또는 기타 이유
    elseif flag == 3 then  
        print(player.Name .. " " .. productID .. " 중복 또는 기타 사유로 구매 실패!")
    end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)

--서버 스크립트에서

----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(player, buyEventData, flag)    
    local productID = buyEventData.ID --구매 시도한 상품의 ID

    --구매 성공시
    if flag == 1 then      
        print(player.Name .. " " .. productID .. " 구매 성공!")
        
    --충전 필요시
    elseif flag == 2 then  
        print(player.Name .. " " .. productID .. " 충전 필요!")
    
    --중복 구매 또는 기타 이유
    elseif flag == 3 then  
        print(player.Name .. " " .. productID .. " 중복 또는 기타 사유로 구매 실패!")
    end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)

5-4 구매 성공한 상품의 지급 처리📩

구매 결과가 성공(1)일 때, 상품을 지급하는 방법이에요.

OnBuyDoneEvent 함수에서 결과가 성공으로 반환되었을 때, SaveUserProductData 함수로 반드시 지급을 처리해야 해요.
구매는 성공했지만 통신 장애 등으로 인해 지급이 처리되지 않은 경우, 구매 상품에 대해서 OnBuyDoneEvent 함수가 다시 호출돼요.
즉, 구매한 상품들은 SaveUserProductData 함수가 반드시 호출되어야 하고, 호출되지 않으면 플레이어가 접속할 때마다 미지급 상품에 대해 OnBuyDoneEvent가 다시 호출돼요.

--서버 스크립트에서

----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(player, buyEventData, flag)    
    local productID = buyEventData.ID --구매 시도한 상품의 ID
    local playerID = player:GetPlayerID()

    --구매 성공시
    if flag == 1 then      
        print(player.Name .. " " .. productID .. " 구매 성공!")
        
        -- 상품 번호 1234_1가 Coin 200개 구매 상품일 때
        if productID = "1234_1" then
            --'Coin' 상품에 대한 구매 처리
            local saveKey = "Coin"
            local addValue = 200
			      
            local saveValue = player.Coin + addValue 
	        
            --지급 처리와 함께 유저데이터 저장을 처리해요.
            Marketplace:SaveUserProductData(playerID, saveKey, saveValue, buyEventData)
            player.Coin = saveValue 
			      
            print(player.Name .. " " .. productID .. " 지급 처리 완료!")
        end
    end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)

----------------------------------------------------------------------------------------
--'Coin' 재화 불러오기
local function LoadPlayerData(player)
    local playerID = player:GetPlayerID()    
    
    --유저 데이터 불러오기
    local saveKey = "Coin"
    local loadValue = Game:GetSavedUserGameData(playerID, saveKey)    
    
    --불러올 데이터가 없으면
    if loadValue == nil then 
        loadValue = 0
        Game:SaveUserGameData(playerID, saveKey, loadValue) --초기값 저장
    end    
    player.Coin = loadValue
end
Game.OnEnterPlayer:Connect(LoadPlayerData)