대시보드
불러오는 중이에요.
소유자 인증하기
메타모아에 올라와 있는 공간의 공간운영자라면 소유를 확인하고 공간 정보·정각 모임·소식을 직접 관리할 수 있어요. 공간 주소나 이름으로 찾아 주세요. 아직 없는 공간은 등록 요청 으로 올려 주세요.
키 발급
소식·접속자 수를 보내거나, 이 페이지에서 고치는 이름·소개·대표 이미지·링크를 프로그램으로 고치려면 키가 필요해요. 쓰는 법은 API 안내 에 있어요. 키는 여러 개 둘 수 있어요. 추가로 발급해도 예전 키는 그대로 쓰이고, 「멈추기」를 누른 키만 바로 멈춰요.
키 발급
이 키는 지금 한 번만 보여요. 안전한 곳에 보관해 주세요.
복사
사이트로 소유 확인
아래 셋 중 하나를 사이트에 넣고 「확인하기」를 눌러 주세요. 네이버 서치어드바이저·구글 서치 콘솔과 같은 방식이에요. 코드는 이 브라우저에 묶여 있으니 넣은 뒤 이 화면에서 「확인하기」를 눌러 주세요. 확인되면 메일 없이 바로 「공간 관리」로 넘어가요. 넣은 것을 지우면 며칠 뒤 공간운영자 권한이 풀려요.
이 공간은 받아 둔 공간운영자 메일이 없어요. 메일 대신 아래 셋 중 하나로 사이트에서 확인해 주세요.
메타 태그 공간 페이지나 사이트 첫 화면의 <head> 안에 넣기복사
HTML 파일 파일 다운로드 이 파일을 사이트 맨 위 폴더에 올리고 이 열리면 확인하기
DNS TXT 레코드 에 TXT 레코드로 넣기복사
확인하기
메일로 확인
이 공간을 운영하고 있다면 저희가 받아 둔 공간운영자 메일 주소를 넣어 주세요. 주소가 맞으면 확인 링크를 보내 드려요. 링크를 누르기 전에는 아무것도 바뀌지 않아요.
메일이 없거나 다르다면
스레드 @float_1122 에 DM으로 이메일 주소를 보내 주시면 확인 후 연결해 드려요.
대시보드 로그인용 메일 등록
넣으면 다른 기기에서도 이 메일로 로그인(인증번호·Google)해서 대시보드로 바로 들어와요. 넣지 않아도 이 브라우저에서는 그대로 관리할 수 있어요.
저장하면 확인 메일 없이 바로 이 공간의 공간운영자 메일이 돼요.
접속자 API 연결
위 공간 키로 지금 접속자 수를 10분에 한 번 보내면 랭킹과 첫 화면 합계에 반영돼요. 키는 서버에서만 쓰고 브라우저 코드에는 넣지 마세요. 업데이트 소식·이벤트·정보 수정도 같은 키로 돼요. 자세한 건 API 안내 에 있어요.
예시 복사
포탈 연결
다른 공간과 서로 오가는 포탈은 공간운영자끼리 맞춰서 연결해요. 연결할 곳은 제작자 커뮤니티 의 「공간연동」에서 찾아요.
서로 수락(매치)하면 두 공간에 포탈이 켜지고, 한쪽이 끊으면 양쪽 다 꺼져요. 넣는 법: 포탈 키트 · 포탈 API
3D 광고
광고 API
아래 한 줄을 공간 페이지에 넣고, three.js 공간이면 장면을 만든 뒤 자리를 불러요. 광고 키는 공개해도 되는 키예요(공간 키는 넣지 마세요). 자세한 건 3D 광고 안내 · AI에게는 /ads/llms.txt 를 주세요.
한 줄 복사
three.js 예시 복사
광고 모델의 크기는 공간에 따라 공간운영자·메타모아가 조절할 수 있어요.
광고 모델과 텍스처 원판 내려받기 광고주가 고르는 기본 모델이에요. 텍스처형 원판(PNG)을 내려받아 미리 꾸며 볼 수 있어요. 출처는 모델 출처 표기 에 있어요.
광고 자리
SDK로 등록된 자리는 꺼진 채로 들어와요. 위치를 확인하고 켜 주세요.
대표 캐릭터 보내기
대표 캐릭터를 보내 주면 모아 야영지 에서 우리 공간 포탈 옆 고블린이 그 캐릭터로 바뀌어요. 자동 검사를 통과하면 바로 서고, 새 캐릭터를 검사하는 동안에는 지금 캐릭터가 그대로 있어요.
3D 모델 GLB 파일, 4MB까지. 움직임(애니메이션)은 없어도 되고, 있으면 하나만 써요(이름에 idle이 있으면 그것).
그림 PNG 파일, 1MB까지. 서서 도는 그림으로 보여요.
다른 회사 로고나 남의 게임·영화·만화 캐릭터는 받지 않아요. 자세한 기준은 API 안내 에 있어요.
지금 서 있는 캐릭터: 고블린
계좌번호 대신, 공간에서 결제 받기
계좌번호를 붙여 두지 않아도 흐름 결제로 공간 안에서 바로 결제를 받고 상품을 팔 수 있어요. 흐름 판매자 가입은 이 화면 아래 「메타모아 파트너사 특전」에서 시작해요.
판매 시작하기 결제 API 문서
공간 정보 고치기
고친 내용은 저장하면 바로 목록에 반영되고, 바뀐 기록이 남아요. 새 공간은 등록 요청 에서 같은 칸으로 올릴 수 있어요.
업데이트 소식
업데이트 소식과 이벤트는 「등록」 화면에서 이 공간을 골라 올려요. 이 브라우저에서 확인을 마쳤으니 바로 올릴 수 있어요.
소식 올리기 이벤트 올리기
메타모아 파트너사 특전
판매 수수료 5% (1년간)
카드 수수료 실비
지급 신청 시 100원(부가세 별도)의 수수료가 들어가요
토스 앱 판매분은 앱마켓·토스 수수료를 뺀 뒤 정산
모두 부가세 별도
결제는 흐름에서 판매자 등록과 결제 키를 따로 받아요. 흐름 판매자 등록 때 이 공간 주소를 넣으면 인증된 판매처가 돼요.
판매하기 판매자 등록 결제 키 발급
판매 현황 보기
공간운영자 메일
여기 있는 메일로 로그인(인증번호·Google)해서 이 공간을 함께 관리해요. 운영 소식도 이 메일로 보내요.
공간운영자 추가하기
메일을 넣고 「추가」를 누르면 그 메일로 확인 링크가 가요. 받은 사람이 링크를 열고 그 메일로 로그인하면 공간운영자가 돼요. 그 전에는 「대기 중」으로 보여요.
메타모아 앱 받기 · App Store · Google Play
제작자 커뮤니티 — 공간운영자끼리 공간연동(포탈)·구인·협업 이야기를 나눠요.
공간운영자 확인과 수정은 이용약관 과 개인정보처리방침 에 따라 처리해요. 공간운영자가 아닌 것이 확인되면 연결을 끊고 고친 내용을 되돌릴 수 있어요.
공간운영자 메일을 넣지 않으면 연락과 다른 기기 로그인이 안 돼요. 지금 넣을까요?
메일 넣기
나중에
무엇을 올릴까요
새 공간
업데이트
이벤트
공간 고르기
메타모아에 올라와 있는 공간의 소식과 이벤트를 올려요. 소유자 확인을 마친 브라우저에서 바로 올릴 수 있어요.
이미 있는 메타버스는 소유자 등록이 가능합니다. 소유자 인증하기
아바타로 들어가 돌아다닐 수 있는 웹 메타버스라면 신청할 수 있어요. 운영자가 확인한 뒤 목록에 올려요. 주소를 넣으면 그 사이트의 제목·소개·대표 이미지(og:image)를 불러와 칸을 미리 채워 드려요. 대표 이미지가 없으면 확인을 마친 뒤 저희가 직접 화면을 찍어 넣어요.
AI에게 주기
메타모아(https://metamoa.com)에 내 웹 메타버스를 등록하고 API까지 연결해 줘.
① 등록 신청
POST https://metamoa.com/api/submit
Content-Type: application/json
{"name": "공간 이름", "url": "https://내 메타버스 주소/", "email": "공간운영자 이메일", "region": "kr", "api_hookup": true, "agree": true}
- 응답의 request_key(mm_req_로 시작)는 서버 환경 변수에만 보관해. 결과는 GET https://metamoa.com/api/submit/{id} (Authorization: Bearer request_key)로 확인해.
- 결과를 바로 받고 싶으면 webhook_url(https 주소)을 넣어. 응답의 webhook.secret으로 X-Metamoa-Signature(HMAC-SHA256)를 확인해.
- email은 꼭 넣어(없으면 400). 나(사람)에게 물어보고 넣어. 이 이메일로 공간관리 대시보드를 이용할 수 있어. 메일로도 결과를 받고 싶을 때만 "notify_email": true를 넣어.
- region: 한국 서비스면 "kr", 해외면 "global".
- cat1(분류)·langs(지원 언어)·summary(한 줄 소개, 60자까지)는 알면 넣고, 모르면 빼도 돼. 빼면 메타모아가 판단해서 등록해.
- agree: true는 이용약관·개인정보처리방침 동의야. 나에게 확인받고 넣어.
- 칸과 규칙: https://metamoa.com/api
② 승인 뒤 API 연결
승인되면 https://metamoa.com/owner?id={id} 에서 소유자 확인(사이트에 확인 코드 넣기)을 하고 공간 키(mm_live_로 시작)를 받아. 키는 코드나 채팅에 적지 말고 서버 환경 변수 METAMOA_KEY에만 넣어.
그다음 https://metamoa.com/update-guide 안내대로 접속자 수·업데이트·이벤트 API를 서버에 연결해 줘. 모아 야영지에 내 캐릭터(GLB 또는 PNG)를 세우려면 PUT https://metamoa.com/api/space/{space_id}/character 로 올려(https://metamoa.com/api 의 「7. 야영지 캐릭터」).
복사
또는 직접 등록할 수 있어요
주소 https:// 로 시작하는 주소만 받아요
공간 이름
지역
한국
해외
분류 고르지 않으시면 AI가 자동으로 판단해서 등록해요
고르지 않음
종교·명상 휴식·힐링 자연·여행 우주·과학 놀이·게임 만남·대화 기타
지원 언어 고르지 않으시면 AI가 자동으로 판단해서 등록해요
한국어
English
日本語
中文
Español
Français
Deutsch
Português
Русский
Tiếng Việt
ไทย
Bahasa Indonesia
हिन्दी
العربية
Italiano
Türkçe
한 줄 소개 60자까지
API
접속자 수
AI에게 주기
업데이트 AI에게 주기
이벤트 AI에게 주기
캐릭터 AI에게 주기
메타모아(https://metamoa.com)에 내 메타버스의 지금 접속자 수를 보내게 해 줘.
- 서버에서 10분에 한 번: POST https://metamoa.com/api/live/{space_id} (Authorization: Bearer $METAMOA_KEY, 본문 {"count": 12}). 공간 키는 https://metamoa.com/owner 에서 소유자 확인을 마치면 받아.
- 또는 지금 접속자 수를 숫자로 알려 주는 https 주소를 만들어 줘. 그 주소를 메타모아 등록 신청의 「접속자 수 API」 칸(live_api)에 넣어.
- 지금 함께 있는 사람 수만 보내(봇·테스트 제외). 이용자 정보는 보내지 마.
- 알림은 API 조회와 웹훅으로 받아: PUT https://metamoa.com/api/space/{space_id}/webhook 에 {"url": "https://…"}. 메일은 선택이야(나에게 물어보고 {"contact_email": "…", "notify_email": true}).
- 자세한 안내: https://metamoa.com/update-guide
메타모아(https://metamoa.com)에 내 메타버스의 업데이트 소식을 보내게 해 줘.
- 새 기능을 배포할 때 서버에서: POST https://metamoa.com/api/update/{space_id} (Authorization: Bearer $METAMOA_KEY, 본문 {"text": "겨울 맵이 열렸어요"}). 하루 한 번, 200자까지.
- 공간 키는 https://metamoa.com/owner 에서 소유자 확인을 마치면 받아. 키는 서버 환경 변수 METAMOA_KEY에만 넣어.
- 알림은 API 조회와 웹훅으로 받아: PUT https://metamoa.com/api/space/{space_id}/webhook 에 {"url": "https://…"}. 메일은 선택이야(나에게 물어보고 {"contact_email": "…", "notify_email": true}).
- 자세한 안내: https://metamoa.com/update-guide
메타모아(https://metamoa.com)에 내 메타버스의 이벤트를 올리게 해 줘.
- 이벤트를 열 때 서버에서: POST https://metamoa.com/api/space/{space_id}/events (Authorization: Bearer $METAMOA_KEY). 칸과 규칙은 https://metamoa.com/api 의 「6. 이벤트 등록」.
- 공간 키는 https://metamoa.com/owner 에서 소유자 확인을 마치면 받아. 키는 서버 환경 변수 METAMOA_KEY에만 넣어.
- 알림은 API 조회와 웹훅으로 받아: PUT https://metamoa.com/api/space/{space_id}/webhook 에 {"url": "https://…"}. 메일은 선택이야(나에게 물어보고 {"contact_email": "…", "notify_email": true}).
- 자세한 안내: https://metamoa.com/update-guide
메타모아(https://metamoa.com) 모아 야영지에서 내 공간 앞에 설 캐릭터를 올려 줘. 기본은 고블린이고, 올린 파일이 자동 검사를 통과하면 바뀌어.
- 서버에서: PUT https://metamoa.com/api/space/{space_id}/character (Authorization: Bearer $METAMOA_KEY). 본문은 JSON이 아니라 파일 그대로(curl --data-binary @character.glb).
- GLB는 Content-Type: model/gltf-binary, 4MB까지(삼각형 2만 개, 텍스처 4장·한 변 2048px, 뼈대 64개, 바깥 파일 주소 안 됨). PNG는 image/png, 1MB까지(가로·세로 1024px까지, 세로 128px 이상). 공간마다 하루 5번.
- 성공하면 202 {"status": "checking"}. GET 같은 주소로 결과를 봐: live면 야영지에 서 있고, rejected면 reasons에 이유가 있어. DELETE면 고블린으로 돌아가.
- 내가 만들었거나 쓸 권한이 있는 캐릭터만 올려. 다른 회사 로고나 남의 게임·영화·만화 캐릭터, 성인물·폭력은 거절돼. 파일은 나(사람)에게 받아.
- 공간 키는 https://metamoa.com/owner 에서 소유자 확인을 마치면 받아. 키는 서버 환경 변수 METAMOA_KEY에만 넣어.
- 알림은 API 조회와 웹훅으로 받아: PUT https://metamoa.com/api/space/{space_id}/webhook 에 {"url": "https://…"}. 메일은 선택이야(나에게 물어보고 {"contact_email": "…", "notify_email": true}).
- 칸과 규칙: https://metamoa.com/api 의 「7. 야영지 캐릭터」
이메일 필수 이 이메일로 공간관리 대시보드를 이용할 수 있어요.
결과와 운영 안내를 메일로 받기 끄면 결과는 API 조회·웹훅으로 받아요
웹사이트
이 공간을 만들었거나 올릴 권한이 있어요. 주소가 열리는지·제목과 대표 이미지·금지어를 자동으로 확인하고, 이메일을 넣고 메일 받기를 켜면 결과 메일과 승인 뒤 공간 운영 안내 연락처로 쓴다는 개인정보처리방침 을 읽었어요.
신청하기