Master Guide & Documentation

공정한 추첨을 위한 완벽한 가이드

오렌지 쿠지는 인터넷 방송, 사내 행사, 공동구매 지분 나눔 등 다양한 환경에서 최고의 신뢰와 재미를 제공합니다. 각 모드별 활용법을 익혀보세요.

00. 왜 오렌지 쿠지인가요?

오렌지 쿠지는 단순히 숫자를 뽑는 도구가 아닙니다. 오프라인 제일복권의 '비복원 추출' 매커니즘과 '라스트원 상'의 긴장감을 디지털 환경에서 완벽하게 재현하기 위해 설계되었습니다. 티켓 순서는 모든 배치가 같은 확률로 나오는 Fisher-Yates 셔플로 섞으며, 모든 데이터는 사용자의 브라우저에만 안전하게 보관됩니다.

01. 프로젝트 및 라이브러리 관리

오렌지 쿠지는 여러 이벤트를 동시에 준비하거나 과거 기록을 관리할 수 있는 로비(Lobby) 시스템을 제공합니다. 모든 진행 데이터는 브라우저의 로컬 스토리지에 실시간으로 저장되어, 로그인 없이도 언제든지 중단한 시점부터 다시 시작할 수 있습니다.

프로 팁: 브라우저 캐시 삭제 시 데이터가 유실될 수 있으므로, 대규모 이벤트 종료 후에는 반드시 '이미지 저장' 기능을 활용해 백업하세요.

로비 화면: 진행 중인 프로젝트 카드와 새 프로젝트 버튼
로비 화면: 진행 중인 프로젝트 카드와 새 프로젝트 버튼

02. 핵심 설정 (Core Setup)

  • 1

    전체 티켓 수량: 실제 준비된 경품 세트의 총 수량과 일치시켜야 확률이 정확해집니다.

  • 2

    상품 등급(A~E): 설정 화면에서는 A~E상 다섯 등급까지 직접 추가할 수 있습니다. 등급이 더 많다면(최대 K상) 스마트 임포트로 목록 파일을 불러오세요.

  • 3

    라스트원(Last One): 마지막 티켓을 뽑는 사람에게 줄 보너스 경품입니다. 이벤트 후반부의 몰입감을 극대화합니다.

Fisher-Yates

수학적으로 완벽한 무작위 셔플 알고리즘 적용

Real-time

설정 즉시 확률 데이터가 자동 산출됩니다.

설정 화면: 등급별 상품, 라스트원 상, 합계 일치 배지
설정 화면: 등급별 상품, 라스트원 상, 합계 일치 배지

03. 추첨 모드 활용법

상황에 맞는 최적의 모드를 선택하여 최고의 경험을 선사하세요.

플레이 모드

인터넷 방송 및 현장 행사에 최적화되어 있습니다. 참여자의 이름을 입력하고 한 장씩 직접 뜯는 재미를 강조합니다.

Live Streaming Focus

마블 룰렛

물리 엔진 기반으로 구슬이 떨어지는 과정을 실시간 생중계합니다. 하단 대시보드에서 참가자별 당첨 현황이 실시간 합산됩니다.

Physics Visual Show

1/N 예약 모드

온라인 공동구매 및 지분 나눔에 필수적입니다. 각자 가져갈 티켓 수를 먼저 정한 뒤 한 번에 추첨하고, 라스트원은 보유 수량에 비례해 추첨합니다.

Group Share & Raffle

03-1. 플레이 모드: 한 장씩 열어 보는 방식

진행 순서

  1. 1

    로비에서 "새 프로젝트"를 누르고, 모드 선택 화면에서 "플레이 모드"를 고릅니다.

  2. 2

    설정 화면에서 전체 티켓 수량을 정하고, 등급(A~E)마다 상품명과 수량을 추가합니다. 라스트원 상을 쓰려면 토글을 켠 채 라스트원 상품명을 등록합니다.

  3. 3

    합계 배지가 "일치"로 바뀌면 "설정 완료 및 시작"을 누릅니다. 등급별 수량을 더한 값이 전체 수량과 다르면 시작되지 않습니다.

  4. 4

    추첨 화면에서 "참가자 닉네임"과 "뽑을 개수"를 입력하고 "뽑기!"를 누르면 그 수만큼 뒤집힌 카드가 나타납니다.

  5. 5

    카드를 누르거나 오른쪽으로 밀면 결과가 보입니다. 한꺼번에 확인하려면 "전체 공개"를 누릅니다.

결과는 "뽑기!"를 누를 때 정해집니다

카드를 뒤집는 동작은 결과를 보여 주는 연출입니다. 티켓 순서는 추첨을 시작할 때 한 번 섞여 있고, "뽑기!"를 누르는 순간 그 순서대로 필요한 수만큼 꺼내 참가자 이름으로 기록합니다. 그래서 어떤 카드를 먼저 뒤집든 당첨 내용은 달라지지 않습니다. 방송에서 "어느 카드부터 열까"로 분위기를 띄울 수는 있지만, 카드 위치가 확률에 영향을 주지 않는다는 점을 참여자에게 미리 알려 두면 오해를 줄일 수 있습니다.

현황판과 통털이 버튼

"실시간 현황" 패널에는 등급마다 남은 수량과 남은 확률이 나옵니다. 확률은 그 등급의 남은 수를 전체 남은 수로 나눈 값이라 누군가 뽑을 때마다 바로 바뀝니다. 휴대폰에서는 본문 위에, 태블릿 폭 이상에서는 왼쪽에 고정돼 있어 방송 화면에 함께 담기 좋습니다. "통털이" 버튼은 남은 티켓을 바로 뽑는 버튼이 아니라 "뽑을 개수" 칸에 남은 수를 채워 주는 버튼입니다. 숫자를 확인한 뒤 "뽑기!"를 눌러야 실제로 추첨됩니다. 마지막 티켓을 가져간 참가자에게는 라스트원 상이 자동으로 기록되고 축하 알림이 나옵니다.

플레이 화면: 실시간 현황판의 남은 수량과 남은 확률
플레이 화면: 실시간 현황판의 남은 수량과 남은 확률
뽑기! 버튼을 누른 뒤 공개된 카드
뽑기! 버튼을 누른 뒤 공개된 카드

03-2. 마블 룰렛: 구슬이 떨어지는 과정을 보여 주는 방식

참가자 순번 정하기

설정 화면에서 "마블 투척!"을 눌러도 바로 구슬이 떨어지지는 않습니다. 먼저 참가자 설정 화면으로 넘어가 이름과 각자 던질 구슬 수를 입력합니다(1/N 모드와 같은 입력 방식입니다). 수량 합계가 전체 티켓 수와 같아야 "마블 룰렛 설정 완료 및 시작"으로 넘어갈 수 있습니다. 시작하면 입력한 수량만큼 이름을 모은 뒤 무작위로 섞어 투척 순번을 만들고, 지금 던질 사람과 남은 수를 화면에 표시합니다. 입력 순서와 상관없이 순번이 섞이므로, 목록 맨 아래에 적힌 사람이 마지막 구슬을 던진다는 보장이 없습니다.

한 개씩 던질지, 한꺼번에 던질지

"마블 투척!"은 구슬 한 개를 떨어뜨립니다. 구슬이 굴러가는 동안에는 버튼이 잠기므로, 한 사람씩 결과를 확인하며 진행하기 좋습니다. "마블 모두 투척"은 확인 창을 거친 뒤 남은 티켓 수만큼 구슬을 짧은 간격으로 연달아 떨어뜨리고, 끝나면 등급별 당첨 개수를 한 번에 알려 줍니다. 인원이 많아 시간이 부족할 때 유용하지만, 성능이 낮은 기기에서는 화면이 잠시 느려질 수 있습니다. 구슬이 핀 사이에 끼어 멈추면 "마블공 회수"를 누르세요. 판 위의 구슬을 치우고, 아직 던지지 않은 사람으로 순번을 다시 만듭니다.

착지 칸과 확률의 관계

판 아래에는 라스트원을 뺀 등급마다 칸이 하나씩 있습니다. 결과는 구슬이 떨어진 위치로 정해지지 않고, 구슬을 던지는 순간 추첨 시작 때 섞어 둔 티켓 더미에서 한 장을 배정해 정합니다. 플레이 모드가 "뽑기!"를 누를 때 티켓을 꺼내는 것과 같은 방식이라, 등급별 당첨 확률은 현황판의 "남은 확률"과 같습니다. 구슬은 배정된 등급 칸으로 부드럽게 유도되며, 드물게 핀에 튕겨 옆 칸에 떨어지더라도 결과는 바뀌지 않고 배정된 등급 칸이 강조됩니다.

마블 룰렛 참가자 설정: 줄 순서가 투척 순번이 됩니다
마블 룰렛 참가자 설정: 줄 순서가 투척 순번이 됩니다
마블 판과 등급별 착지 칸, 다음 순번 표시
마블 판과 등급별 착지 칸, 다음 순번 표시

03-3. 1/N 모드: 수량을 나눠 한 번에 추첨하는 방식

수량 나누기

설정을 마치고 "설정 완료 및 시작 (1/N 예약 모드)"를 누르면 참가자 입력 화면이 나옵니다. "참가자 추가"로 줄을 늘리고, 줄마다 이름과 가져갈 티켓 수를 −/+ 버튼으로 정합니다. 여기서 "예약"은 시간을 예약한다는 뜻이 아니라 추첨 전에 각자의 몫을 미리 정한다는 뜻입니다. 인원만 정해져 있다면 "자동 배분"을 눌러 보세요. 수량을 직접 입력하지 않은 줄에 남은 티켓을 똑같이 나눕니다. "배분 합계" 배지는 합계가 전체 수량을 넘으면 빨간색이 되고, 추첨은 합계가 정확히 같을 때만 시작됩니다.

그룹 추첨과 결과 확인

"그룹 추첨 시작"을 누르면 입력한 줄 순서대로 각자 몫만큼 섞인 티켓을 받습니다. 결과 화면에서는 참가자별 카드를 하나씩 뒤집거나 "전체 공개"로 한꺼번에 확인할 수 있고, 아래 "참가자별 당첨 요약"에 등급별 개수가 정리됩니다. 공동구매처럼 결과를 따로 공지해야 한다면 하단의 "이미지"나 "CSV" 버튼으로 저장해 두세요.

라스트원 행운 번호의 실제 역할

라스트원 상이 켜져 있으면 결과 화면에 "라스트 원 추첨" 상자가 나타납니다. 번호를 넣고 "확인하기"를 누르면 참가자 수만큼 카드가 섞여 나오고, 그중 당첨 카드를 찾아 엽니다. 당첨자는 입력한 번호로 정해지지 않고, 가진 티켓 수에 비례해 무작위로 뽑힙니다. 예를 들어 전체 10장 중 5장을 가진 사람은 50% 확률로 라스트원을 받습니다. 입력한 번호는 당첨 카드가 놓일 자리만 정합니다. 참여자에게 "번호를 잘 고르면 유리하다"고 안내하지 않도록 주의하세요.

1/N 그룹 추첨 결과: 참가자별 카드
1/N 그룹 추첨 결과: 참가자별 카드
라스트 원 추첨 상자: 번호는 카드 위치만 정합니다
라스트 원 추첨 상자: 번호는 카드 위치만 정합니다

04. 이벤트 운영 베스트 프랙티스

  • ✔ 투명성 강조: '실시간 현황판'을 화면에 상시 노출하세요.
  • ✔ 결과 증빙: 종료 후 생성되는 요약 리포트를 캡처하여 공유하세요.
  • ✔ 데이터 보호: 중요한 이벤트 전에는 반드시 테스트를 진행하세요.
Report
Backup

05. 내 데이터는 어디에 저장되나

오렌지 쿠지는 서버에 아무것도 보내지 않습니다. 프로젝트 설정과 추첨 결과는 전부 사용자 브라우저의 로컬 저장소(localStorage)에만 기록됩니다. 회원가입이 없고 개인정보를 수집하지 않는 이유가 여기 있지만, 그만큼 알아둬야 할 제약도 있습니다.

상황 데이터는 어떻게 되나
브라우저를 닫았다 다시 열기그대로 유지됩니다. '이어하기'로 진행 중이던 추첨을 계속할 수 있습니다.
새로고침유지됩니다. 마음에 들지 않는 결과를 새로고침으로 되돌릴 수는 없습니다.
브라우저 데이터·쿠키 삭제전부 사라집니다. 복구할 방법이 없습니다.
시크릿·프라이빗 모드창을 닫는 순간 사라집니다. 중요한 이벤트에는 쓰지 마십시오.
다른 기기·다른 브라우저공유되지 않습니다. PC에서 만든 프로젝트가 휴대폰에는 보이지 않습니다.

그래서 중요한 이벤트라면 끝난 직후 결과를 이미지나 CSV로 저장해 두는 것이 안전합니다. 브라우저 밖으로 꺼내 놓은 파일만이 기기·브라우저와 무관하게 남습니다.

06. 문제가 생겼을 때

진행하던 추첨이 사라졌습니다

브라우저 데이터를 지웠거나 시크릿 모드였을 가능성이 큽니다. 위 표를 확인해 보십시오. 다른 기기에서 접속한 경우에도 프로젝트가 보이지 않습니다. 로컬 저장소 특성상 복구는 불가능하므로, 앞으로는 종료 시 결과를 파일로 내려받아 두십시오.

화면이 예전 상태로 보입니다

오프라인 지원을 위해 페이지를 캐시하기 때문에, 업데이트 직후 잠시 이전 화면이 보일 수 있습니다. 새로고침을 한 번 더 하면 최신 상태로 바뀝니다.

소리가 나지 않습니다

헤더의 스피커 아이콘이 음소거 상태인지 확인하십시오. 또한 브라우저는 사용자가 화면을 한 번 터치하거나 클릭하기 전까지 소리 재생을 막습니다. 첫 조작 이후부터 정상적으로 들립니다.

마블 구슬이 중간에 멈췄습니다

구슬이 핀 사이에 끼면 공 회수 버튼을 누르십시오. 남아 있는 구슬을 정리하고 투척 버튼을 다시 활성화합니다. 이미 확정된 결과는 그대로 보존됩니다.

인터넷 없이도 쓸 수 있나요

한 번 접속한 뒤에는 가능합니다. 오프라인 사용을 위해 필요한 파일을 미리 저장해 두기 때문에, 네트워크가 끊긴 상태에서도 추첨을 진행할 수 있습니다. 브라우저 메뉴의 '홈 화면에 추가'로 앱처럼 설치해 두면 더 편합니다.