본문으로 건너뛰기

Web3.unity 시작하기

업데이트 날짜:
2025년 11월 26일

읽는 데 2분

개요

web3.unity는 Chainsafe 팀이 개발한 강력한 오픈소스 게임 SDK입니다. 이를 통해 Unity 엔진으로 제작된 게임에 블록체인 기능을 추가할 수 있습니다. 이 가이드에서는 Unity 에디터에서 web3.unity를 설정하는 방법, 나만의 블록체인 dApp을 만드는 방법, 그리고 web3.unity 게임에 NFT 민트 기능을 추가하는 방법을 알아보겠습니다.

더 많은 영상을 보시려면 저희 유튜브 채널을 구독해 주세요!

web3.unity 설정하기

Unity 에디터와 WebGL 플러그인이 필요합니다. Unity Hub를 통해 Unity 에디터를 다운로드할 수 있습니다.

참고

반드시 Unity 에디터의 LTS 버전만 설치하고, Unity 6는 피하십시오.

원하는 유형(2D 또는 3D)의 새 프로젝트를 생성한 다음, ‘창( Window) ’ 탭에서 패키지 관리자로 이동합니다. ‘+’ 버튼을 클릭하고 ‘Git URL에서 패키지 추가...’를 선택합니다 .

Unity 패키지 관리자

입력란에 다음 URL을 붙여넣고‘추가’를 클릭하세요. 설치 도중WebGLThreadingPatcher를 설치할지 묻는 메시지가 표시될 수 있습니다. 이 경우 ‘예’를 클릭하여 해당 프로그램도 함께 설치하세요.

https://github.com/ChainSafe/web3.unity.git?path=/Packages/io.chainsafe.web3-unity

설치가 완료되면 프로젝트를 설정할 수 있는 서버 설정 창이 나타납니다.

웹3.unity 서버 설정

다음과 같은 세부 정보를 입력하세요:

그런 다음 창을 닫으세요. 이 설정이 프로젝트 전체에 걸쳐 적용될 서버 설정이며, 이제 Unity에서 web3 프로젝트를 사용할 준비가 완료됩니다.

Web3.unity에는 프로젝트에서 사용할 수 있는 샘플 앱이 미리 포함되어 있습니다. 샘플 앱을 가져오려면 패키지 관리자로 이동하여 web3.unity SDK를 선택한 다음, ‘Samples’ 탭으로 이동해 ‘가져오기’를 클릭하세요.

web3.unity 게임에서 NFT를 발행하는 스크립트를 한 번 살펴보겠습니다.

NFT 발행

영상 후반부에서 아바타를 생성하기 위해 다음 스크립트를 사용했습니다.

using UnityEngine;
using ChainSafe.Gaming.Evm.Contracts.BuiltIn;
using ChainSafe.Gaming.UnityPackage;
using Scripts.EVM.Token;

public class Erc721Mint : MonoBehaviour
{
// Variables
private string contractAddress = "0x4f75BB7bdd6f7A0fD32f1b3A94dfF409F5a3F1CC"; // web3.unity default contract for ERC-721
private string uri = "QmfUHuFj3YL2JMZkyXNtGRV8e9aLJgQ6gcSrqbfjWFvbqQ"; // Replace with your own token URI here

// Function
public async void MintErc721()
{
var response = await Web3Accessor.Web3.Erc721.Mint(contractAddress, uri);
var output = SampleOutputUtil.BuildOutputValue(response);
SampleOutputUtil.PrintResult(output, "ERC-721", nameof(Erc721Service.GetUri));
// You can make additional changes after this line
}
}

ChainSafe의 공식 문서에서 더 많은 web3.unity 샘플 스크립트를 확인해 보세요.

여러분의 피드백을 ❤️ 환영합니다!

의견이나 다루었으면 하는 새로운 주제가 있다면 알려주세요. 여러분의 의견을 기다리고 있습니다.

이 가이드를 공유하세요