SOMUSOFT PLAYGROUND
만든 게임, 함께 플레이.
다운로드 없이 만나는 작은 게임들. 직접 만든 작품을 공개하고 플레이어를 만나보세요.
게임을 불러오고 있어요.
공개 게임
내 미공개 게임
내 웹게임 등록
먼저 게임을 웹에 배포한 뒤, 게임이 바로 실행되는 HTTPS 주소를 입력해 주세요. 어떻게 준비하나요?
공개 검토는 접수 후 약 5영업일이 소요됩니다. 토·일요일 및 공휴일은 제외되며, 보완 요청이나 접수량에 따라 달라질 수 있습니다. 검토 상태는 ‘내 게임·수익’에서 확인할 수 있습니다.
플레이할 준비가 됐나요?
게임 소개
조작 방법
삽입 실행이 차단되거나 게임에 필요한 브라우저 기능이 제한되면 ‘새 창에서 열기’를 이용해 주세요. 외부 페이지에서 플레이한 기록은 소무소프트 집계에 포함되지 않습니다.
게임을 올리는 방법
- 웹에서 실행되는 버전을 만드세요. HTML5는 index.html과 이미지·소리 파일을 준비합니다. Godot은 Web으로, Unity는 Web용으로 내보냅니다. Windows 실행 파일이나 프로젝트 원본은 브라우저에서 실행되지 않습니다.
- 게임 폴더를 웹에 배포하세요. GitHub Pages·Cloudflare Pages 같은 정적 웹 호스팅을 사용할 수 있습니다. 필요한 모든 파일과 경로를 유지하고 HTTPS 실행 주소를 준비하세요.
- ‘내 게임 등록’에서 주소를 제출하세요. 설명·조작법·지원 기기와 배포 권한 동의를 함께 등록합니다. 지금은 ZIP 파일을 직접 업로드하는 방식이 아닙니다.
- 운영자 확인 후 공개됩니다. 공개 검토는 접수 후 약 5영업일(토·일요일 및 공휴일 제외)이 소요됩니다. 소무소프트 페이지 안에서 게임을 불러옵니다. 외부 삽입 차단, 로그인 요구, 모바일 조작, 저작권과 부적절한 콘텐츠를 확인합니다. 게임 수정 시 다시 검토합니다.
제작 도구별 내보내기
사용한 도구의 항목만 펼쳐서 따라오세요. Godot·Unity·HTML5는 웹 빌드 파일을 호스팅하고, Unreal은 별도의 스트리밍 서버나 HTML5 확장이 필요합니다.
Godot 4 · 웹 빌드 만들기
렌더러를 Compatibility(호환성)로 설정하고 프로젝트 → 내보내기 → Web을 선택합니다. 처음에는 Threads(스레드) 지원을 끄고 내보내세요. 빈 폴더에 index.html로 내보내면 주소를 만들기 편합니다. 생성된 HTML·JS·WASM·PCK·이미지·오디오 파일을 전부 함께 보관하세요. 기존 한글 파일명도 사용할 수 있으며, 내보낸 뒤 HTML 파일만 따로 이름을 바꾸면 연결이 끊길 수 있습니다.
- Web 내보내기 템플릿이 없다는 안내가 나오면 현재 편집기 버전에 맞는 Export Templates를 설치합니다.
- 웹 빌드 파일을 아래 Cloudflare 업로드 안내에 따라 모두 올립니다.
- 게임의 HTTPS HTML 주소를 새 창에서 확인하고 제작 도구 ‘Godot 웹 빌드’로 등록합니다.
Unity · Web / WebGL 빌드부터 Cloudflare 업로드까지
1. Web 빌드 지원 설치
Unity Hub의 Installs(설치) → 사용 중인 에디터 버전의 메뉴 → Add modules(모듈 추가)에서 Web Build Support / WebGL Build Support를 설치합니다. 사용 중인 에디터와 같은 버전의 모듈이어야 합니다.
2. Web 플랫폼과 시작 씬 선택
Unity 6은 File → Build Profiles → Web, 구버전은 File → Build Settings → WebGL로 이동합니다. 필요하면 프로파일을 추가하고 Switch Platform / Switch Profile로 전환합니다. 배포할 씬을 씬 목록에 포함하고 시작 씬을 맨 위에 놓습니다. 메뉴 이름은 버전에 따라 조금 다릅니다.
3. 처음에는 압축 설정을 단순하게
Edit → Project Settings → Player → Web(WebGL) → Publishing Settings에서 설정합니다. 이 안내의 첫 실행 확인용 설정은 Compression Format = Disabled입니다. 압축 헤더 설정 없이 테스트하기 쉽지만 다운로드 용량은 커집니다. 나중에 압축할 때는 아래 ‘압축 오류 해결’을 확인하세요. 스레드 관련 옵션을 사용한다면 교차 출처 격리 등 별도 서버 설정이 필요할 수 있으므로 먼저 기본 웹 빌드로 확인합니다.
4. 빌드 폴더 전체 만들기
Build 또는 Build And Run으로 빈 출력 폴더에 빌드합니다. Build And Run은 Unity의 로컬 웹 서버로 실행을 확인하는 방법이며 인터넷 배포는 별도입니다. 보통 index.html, Build/, TemplateData/가 생기며, 생성된 경우 StreamingAssets/도 필요합니다. 출력 폴더에 생긴 파일·폴더를 모두 보관하세요. Assets/나 Library/ 같은 프로젝트 원본 폴더를 올리는 것이 아닙니다.
5. Cloudflare에 폴더 구조 그대로 업로드
- 아래 R2 업로드 안내에 따라 게임 폴더(예:
unity-game)를 만듭니다. - 그 안에
index.html과Build/등 출력 폴더 전체를 올립니다. 예를 들어unity-game/Build/게임이름.wasm경로를 유지해야 합니다. 파일만 한 폴더에 섞거나 Build 폴더만 올리지 마세요. https://games.example.com/unity-game/index.html을 새 창에서 열어 플레이합니다. example.com은 본인의 도메인으로 바꿉니다.- 소무소프트 ‘내 게임 등록’에 위 HTTPS 주소를 입력하고 제작 도구는 Unity 웹 빌드를 선택합니다. 지원 기기는 실제 플레이해 본 기기만 선택합니다.
각 파일이 모두 25 MiB 이하이면 Cloudflare Pages 직접 업로드도 사용할 수 있습니다. 파일 하나라도 한도를 넘으면 R2를 사용하세요.
6. 압축·로딩 오류 해결
- 404 / Unable to load: index.html 기준으로 Build 폴더 경로·파일명·대소문자가 맞는지 확인합니다. 로컬 HTML 더블클릭 대신 웹 주소나 Build And Run으로 테스트합니다.
- Unable to parse / 압축 관련 오류: Gzip 또는 Brotli 빌드에는 각각
Content-Encoding: gzip또는Content-Encoding: br응답 헤더가 필요합니다. R2 업로드 화면이 이를 자동 설정한다고 가정하지 마세요. 설정이 어렵다면 Publishing Settings에서 Decompression Fallback을 켜고 다시 빌드해 전체 파일을 갱신하거나, 첫 테스트처럼 압축을 끕니다. Fallback은 로더가 커지고 로딩 효율이 낮아질 수 있습니다. - .unityweb 파일: Decompression Fallback이 만드는 정상 확장자입니다. 파일명이나 확장자를 임의로 바꾸지 않습니다.
- WASM MIME 오류: 압축하지 않은 .wasm은
application/wasm, .js는 JavaScript MIME, .data는application/octet-stream으로 제공합니다. .wasm.gz / .wasm.br도 MIME은application/wasm이고 Content-Encoding을 추가해야 합니다. - 모바일에서 종료 / 검은 화면: 브라우저 메모리·그래픽 기능, 텍스처·음원 용량을 확인합니다. PC에서 된다고 모바일에서도 지원된다고 표시하지 마세요.
Unity 공식 문서: 웹 빌드 설정 · 빌드 파일 구성 · 배포·압축·서버 헤더
Unreal Engine · Pixel Streaming / HTML5 확장으로 제공하기
Windows 실행 파일이나 패키지 ZIP을 R2에 올리는 것만으로 브라우저 게임이 되지는 않습니다. 일반적인 UE5 웹 제공 방식은 서버에서 게임을 실행하고 브라우저로 화면과 입력을 주고받는 Pixel Streaming입니다. GPU 서버와 운영 비용이 별도로 필요합니다.
A. 이미 스트리밍 호스팅을 사용하는 경우
- 해당 서비스에 서버용으로 패키징한 게임을 배포하고 세션을 실행합니다.
- 방문자가 실제 플레이할 수 있는 공개 HTTPS 플레이어 주소를 발급받습니다. 관리 콘솔 주소나 다운로드 주소는 사용할 수 없습니다.
- 새 창과 다른 네트워크에서 키보드·마우스·소리·접속 대기를 확인하고, 서비스가 외부 iframe 삽입을 허용하는지도 확인합니다.
- ‘내 게임 등록’에서 제작 도구 Unreal · 스트리밍 / 웹 확장을 선택하고 플레이어 주소를 등록합니다. 소무소프트는 검토 후 이 페이지를 삽입하며 게임 서버를 대신 실행하지 않습니다.
B. Pixel Streaming 서버를 직접 운영하는 경우
- Edit → Plugins에서 엔진 버전에 맞는 Pixel Streaming 또는 Pixel Streaming 2 플러그인을 켜고 에디터를 재시작합니다. 지원되는 GPU 영상 인코더가 있는 PC/서버를 준비합니다.
- 서버 운영체제에 맞춰 프로젝트를 Windows 또는 Linux용으로 패키징합니다. 에디터 프로젝트 파일 대신 패키징한 실행 파일을 서버에서 실행합니다.
- Epic의 Pixel Streaming Infrastructure를 엔진과 맞는 브랜치로 준비합니다. 엔진의
Engine/Plugins/Media/PixelStreaming/Resources/WebServers에 제공되는get_ps_servers스크립트나 공식 저장소를 사용합니다. Pixel Streaming 2는 해당 버전의 공식 경로를 확인하세요. - 공식 시작 안내에 따라 SignallingWebServer를 설치·실행합니다. Windows 안내 기준으로
SignallingWebServer/platform_scripts/cmd/setup.bat후start_with_stun.bat를 실행합니다. 파일명·설정은 저장소 버전에 맞춰 확인합니다. - 게임 실행 시 아래처럼 Signalling 서버 주소를 넘깁니다. 이 예시는 같은 PC에서 연결하는 로컬 테스트용입니다.
MyGame.exe -PixelStreamingURL=ws://127.0.0.1:8888 -RenderOffScreen- 로컬 브라우저에서 플레이어 페이지를 열어 영상·입력·소리를 확인합니다. 인터넷 공개 시에는 도메인과 TLS를 구성해 플레이어는 HTTPS, 브라우저의 Signalling 연결은 WSS로 제공합니다. 로컬 HTTP 주소를 그대로 등록하지 않습니다.
- 외부망 접속을 위한 방화벽·포트와 STUN/TURN 설정을 확인합니다. 휴대전화 통신망 등에서는 TURN 중계가 필요할 수 있습니다. 연결이 안 된다고 방화벽 전체를 끄지 말고 필요한 포트만 설정하세요.
- 여러 사람이 각자 독립적으로 플레이하려면 게임 인스턴스 배정·동시 접속 한도·대기열을 따로 설계해야 합니다. 한 실행 화면에 여러 사람이 접속하는 것과는 다릅니다. 서버를 끄면 게임 제공도 중단됩니다.
- 완성된 공개 HTTPS 플레이어 주소를 위 A 절차처럼 등록합니다. R2·Pages는 이 GPU 게임 서버를 대체하지 않습니다.
C. 구버전 커뮤니티 HTML5 확장을 이미 쓰는 경우
Unreal Engine 4의 커뮤니티 HTML5 확장 등으로 실제로 동작하는 웹 빌드를 만든 경우에는 생성된 HTML·JS·WASM·데이터 파일 전체를 아래 R2/Pages 절차로 올리고 HTML 실행 주소를 등록할 수 있습니다. 엔진·확장·툴체인 버전의 호환성을 먼저 확인해야 하며 UE5의 기본 기능과 같지 않습니다. 웹 배포만을 위해 기존 프로젝트를 무작정 구버전으로 옮기지 마세요.
페이지 배너는 게임 공개·광고 승인 후 별도로 연결합니다. Pixel Streaming 게임 내부의 보상 처리는 해당 플레이어 페이지와 서버 게임 로직을 별도로 연결해야 하며, 고돗 예제를 그대로 적용할 수는 없습니다.
공식·개발 원본 문서: Pixel Streaming 시작 · 인터넷 배포·STUN/TURN·확장 · HTML5 지원 이관 공지 · UE4 HTML5 확장 문서
HTML5 / JavaScript · 파일 준비와 업로드
- 실행 시작 파일을
index.html로 준비하고 JS·CSS·이미지·소리 파일을 상대 경로로 연결합니다. - 프로젝트에 빌드 명령이 있다면 빌드 후 생긴 dist/ 또는 build/ 같은 배포용 폴더의 내용을 사용합니다. node_modules/나 개발 서버 주소를 올리는 방식이 아닙니다.
- 아래 R2 또는 Pages 안내대로 필요한 파일과 하위 폴더를 모두 올립니다.
- 공개 HTTPS 주소로 직접 플레이한 뒤 제작 도구 ‘HTML5 / JavaScript’로 등록합니다. 별도 백엔드가 필요한 게임은 그 서버도 계속 운영해야 합니다.
Cloudflare에 게임 올리기
게임 파일은 제작자의 Cloudflare 계정에 올리고, 소무소프트에는 실행 주소를 등록합니다. 게임마다 별도 폴더를 사용하면 여러 작품을 관리하기 편합니다.
1. 큰 게임은 R2에 업로드
- Cloudflare 대시보드에서 Storage & databases → R2 Object Storage → Create bucket을 선택하고 Standard 버킷을 만듭니다. R2 가입 시 표시되는 과금 조건을 확인하세요.
- 버킷의 Objects → Add folder로 게임 폴더(예:
my-game)를 만듭니다. 그 안에서 Upload를 눌러 웹 빌드 파일을 전부 올립니다. HTML 하나나 ZIP만 올리면 게임이 실행되지 않습니다. 하위 폴더 구조와 대소문자도 유지하세요. 대용량 파일이 대시보드 제한에 걸리면 S3 호환 업로드 도구를 사용하세요. - Settings → Custom Domains → Add에서 본인이 관리하는 게임 전용 하위 도메인을 연결합니다. 예:
games.example.com에서 example.com을 본인의 도메인으로 바꾸세요. 도메인은 같은 Cloudflare 계정에서 관리되어야 하며, 상태가 Active가 될 때까지 기다립니다. 버킷 전체가 공개되므로 배포용 게임 파일만 넣으세요. - 완성된 주소는 도메인 + 폴더 + HTML 파일명입니다. 예:
https://games.example.com/my-game/index.html. 버킷 이름은 경로에 붙이지 않습니다. 폴더 주소만으로 index.html이 자동 실행된다고 가정하지 말고 HTML 파일까지 입력하세요. - 주소를 새 창에서 열어 게임 실행을 확인한 다음, ‘내 게임 등록’의 실행 주소에 붙여 넣습니다. 파일을 수정했다면 관련 파일을 함께 갱신하고 캐시도 확인하세요.
개발 테스트는 Settings의 Public Development URL을 켠 뒤 표시된 https://pub-….r2.dev/my-game/index.html 주소로 할 수 있습니다. r2.dev는 속도 제한이 있는 개발용 주소이므로 정식 배포에는 사용자 도메인을 연결하세요. 소무소프트의 play.somusoft.com은 운영자 전용 호스트입니다. 제작자마다 자신의 실행 주소를 사용하면 됩니다.
2. 작은 게임은 Cloudflare Pages도 가능
모든 파일이 각각 25 MiB 이하라면 Workers & Pages에서 Pages 프로젝트의 직접 업로드(Direct Upload) 방식으로 웹 빌드 폴더를 배포할 수 있습니다. 발급된 https://프로젝트.pages.dev/index.html을 실행 주소로 등록하세요. Godot·Unity 등의 WASM·PCK·DATA 파일 중 하나라도 25 MiB를 넘으면 Pages에 통째로 올릴 수 없으므로 위 R2 방식을 사용하세요.
3. 실행 오류와 비용 확인
- ‘가져오기 실패’라면 HTML과 WASM·PCK·JS 파일이 같은 빌드인지, 404/403 오류나 대소문자 차이가 없는지 확인하세요. 로컬 HTML 더블클릭 대신 HTTPS 주소에서 테스트합니다.
- 파일 형식(Content-Type)은 HTML은
text/html, JS는text/javascript, WASM은application/wasm, PCK는application/octet-stream인지 확인하세요. 스레드 빌드의 교차 출처 격리 헤더는 R2에 _headers 파일을 올리는 것만으로 적용되지 않습니다. - R2의 저장·업로드·읽기는 D1 데이터베이스의 행 읽기 한도와 별도입니다. R2 Standard의 무료 사용량을 초과하면 요금이 생길 수 있으며, 예산 알림은 초과 과금을 자동 차단하는 기능이 아닙니다. 사용량을 확인하고 정식 도메인의 캐시를 설정하세요.
공식 안내: R2 업로드 · 공개 주소와 도메인 연결 · Pages 제한 · R2 요금
등록했는데 게임 둘러보기에 안 보이나요?
등록 직후에는 검토 대기이며, 공개 검토는 접수 후 약 5영업일(토·일요일 및 공휴일 제외)이 소요됩니다. 게임 둘러보기의 ‘내 미공개 게임’과 ‘내 게임·수익’에서 본인이 확인할 수 있으며, 다른 방문자는 공개된 게임만 볼 수 있습니다. 운영자는 게임 둘러보기에서 실행·배포 권한·콘텐츠를 확인한 뒤 검토 완료·전체 공개를 누릅니다. 보완 필요·공개 중지 상태는 내 게임·수익의 운영자 검토에서 처리합니다. 게임 공개와 광고 승인은 별개이므로 광고 승인 전에도 게임을 공개할 수 있습니다.
내 게임이 삽입되지 않는다면
게임 서버의 X-Frame-Options 또는 CSP frame-ancestors 설정이 외부 삽입을 막을 수 있습니다. itch.io 소개 페이지가 아니라 제작자가 제공하는 삽입용 주소를 사용하세요. Godot·Unity의 멀티스레드 빌드는 교차 출처 격리 등 추가 서버 설정이 필요할 수 있어, 먼저 단일 스레드 웹 빌드를 권장합니다.
플레이·광고·수익은 각각 기록합니다
게임 시작 후 실행 화면이 열리고 5초 이상 보이면 플레이 신호를 기록합니다. 같은 브라우저·게임은 30분 구간마다 한 번 집계하며 실제 사람 수를 뜻하지 않습니다. 광고 시청 신호도 조작 가능성이 있는 참고 통계입니다. 이 두 수치만으로 돈이 적립되지는 않습니다.
실제 수익은 광고 업체의 게임별 최종 월별 보고서를 운영자가 확인해 반영합니다. 플랫폼 수수료 5%를 차감한 제작자 몫이 후원·판매·정산 내역에 합산되고, 광고 대금 실제 입금 확인 전에는 지급 보류로 표시됩니다. 광고 승인이 나기 전 수익은 0원입니다.
광고 연결도 간단하게
게임 파일에 광고 코드를 넣을 필요가 없습니다. 게임 공개 후 페이지 주변의 배너는 광고 승인·설정이 준비되면 소무소프트 운영자가 연결합니다. 광고 수익은 광고 업체의 게임별 확정 보고서를 기준으로 정산합니다.
선택 기능 · 광고 보고 부활하기
게임 안에서 부활·아이템 같은 보상을 주고 싶은 제작자만 추가로 연결하면 됩니다. 일반 게임 등록과 페이지 배너 이용에는 필요하지 않습니다. 부활은 게임 상태를 바꾸는 기능이므로, 실행 주소를 등록하는 것만으로 자동 추가되지는 않습니다.
개발자용 보상 광고 연결 방법 보기 · Godot / HTML5
게임 안의 ‘광고 보고 이어하기’ 연결
광고 승인 후에는 아래 연결 코드를 게임에 넣고, 이용자가 광고 시청을 선택할 때 호출합니다. 게임 일시 정지·재개와 보상은 게임 제작자가 연결해야 합니다. 광고가 없거나 완료되지 않으면 보상을 지급하지 않습니다.
<script src="https://somusoft.com/somu-games-sdk.js?v=2"></script>
// 이용자가 '광고 보고 부활' 버튼을 누를 때
const result = await SomuGames.requestAd({
type: 'reward',
onPause: () => pauseGame(),
onResume: () => resumeGame()
});
if (result.rewardGranted) revivePlayer();광고 스크립트는 게임이 실행되는 HTML 안에서 동작합니다. Godot은 Web 내보내기의 HTML Head Include에 위 script 태그를 넣고, 실제 광고 버튼과 게임 일시 정지·보상을 연결한 뒤 다시 배포하세요. 외부 호스팅의 광고 허용 여부와 게임 실행 도메인 승인도 확인해야 합니다. 현재는 광고 승인 대기 중이므로 요청은 ‘광고 없음’으로 돌아옵니다. 일반 배너를 게임 화면에 덮어 씌우거나 광고 클릭을 보상 조건으로 삼지 않습니다.
Godot 4에서 부활 버튼과 연결하기
- 고돗 연결 스크립트 다운로드 후 프로젝트에 추가합니다.
- 프로젝트 설정 → 전역(Globals) → Autoload에서 위 파일을
SomuAds이름으로 등록합니다. 이 노드는 장면이 바뀌어도 유지되어야 합니다. - Web 내보내기의 HTML Head Include에 위 SDK의 script 태그를 넣습니다.
- ‘광고 보고 부활’ 버튼에 아래 예시를 연결합니다. 광고가 실제로 재생될 때만 게임과 소리가 멈추고, 종료 후 이전 일시 정지·음소거 상태로 돌아옵니다. 시청 완료가 확인된 경우에만 직접 구현한 부활 함수를 실행하세요.
- Web으로 다시 내보내고 R2 등 게임 호스팅의 파일을 갱신합니다. 본인의 공개된 소무소프트 게임 페이지에서 확인하세요.
# 부활 버튼이 있는 게임 스크립트의 예시입니다.
# revive_player()는 제작자가 구현한 실제 부활 함수로 바꾸세요.
func _on_revive_button_pressed() -> void:
$ReviveButton.disabled = true
var granted: bool = await SomuAds.request_reward()
if granted:
revive_player()
else:
$AdMessage.text = "시청 가능한 광고가 없거나 완료되지 않았습니다."
$ReviveButton.disabled = false게임 오버 화면에서 SceneTree를 멈췄다면 부활 버튼·결과 안내 UI가 일시 정지 중에도 동작하도록 Process Mode를 설정하세요. 부활 함수에서 게임 상태를 복구하고 필요한 경우 일시 정지를 해제합니다. 중복 보상과 한 판당 부활 횟수 제한은 게임에서 관리합니다. 코인·아이템 등 다른 보상도 같은 완료 결과에 연결할 수 있습니다. 홈페이지에 주소만 등록해서 이미 배포된 게임 내부의 부활 처리를 바꿀 수는 없습니다.
이 연결은 소무소프트 안에 삽입된 공개 게임에서만 지원합니다. 고돗 편집기 실행·외부 주소 단독 실행·미승인 게임에서는 보상 없이 반환합니다. 실제 광고는 승인된 AdSense 계정과 별도 H5 Games Ads 이용 승인이 필요합니다. Google 신청 안내
게임 공개 검토는 접수 후 약 5영업일(토·일요일 및 공휴일 제외)이 소요됩니다. 보완 요청이나 접수량에 따라 달라질 수 있습니다.
광고 승인·연결 전에는 수익이 발생하지 않습니다. 확정 수익과 실제 입금 상태는 후원·판매·정산 내역에서도 확인할 수 있어요.
게임 광고 정산
운영자 · 게임 검토
광고 업체 최종 보고서 반영
이번 달 예상액은 입력하지 않습니다. 게임별 최종 월별 보고서의 원화 확정액과 실제 횟수를 입력하세요. 동일 게임·업체·월은 한 번만 반영됩니다.