[FiveM × Discord] 올인원 실시간 사전예약 & 인게임 비콘 보상 시스템

디스코드 사전예약부터 인게임 자동 보상 지급까지, 서버 오픈 초반 유저 유입과 전환율을 극대화하는 올인원 자동화 패키지입니다.

관리자의 수동 지급 작업 없이, 디스코드에서 예약한 유저가 인게임 지정 비콘에 방문해 즉시 자신의 보상을 수령할 수 있습니다. discord.py 비동기 봇과 FiveM oxmysql 기반 리소스를 연동하여 빠르고 안전한 데이터 트랜잭션을 보장합니다.

✦ 핵심 기능 요약

1. 디스코드 봇 사전예약 시스템 (Python / aiomysql)

• 슬래시 커맨드 지원: /사전예약설정 명령어로 원하는 채널에 사전예약 임베드 및 버튼을 즉각 임베드 형태로 전송합니다. 유저는 /사전예약확인 명령어로 본인의 등록 여부와 예약 순번을 조회할 수 있습니다.

   

• 실시간 DB 연동 & 순번 발급: 디스코드 버튼 클릭 즉시 비동기 DB 조회를 거쳐 중복 참여를 방지하며, 실시간 사전예약 번호(순번)를 자동 발급합니다.

   

• 영구 버튼(Persistent View) 탑재: 봇이 재부팅되거나 점검을 거쳐도 기존 메시지의 사전예약 인터랙션 버튼이 만료되지 않고 정상 작동합니다.

   

2. FiveM 인게임 비콘 & 글래스모피즘 NUI (Lua / Web)

• 스마트 비콘 감지 및 카운트다운 알림: 비콘 반경 접근 시 화면 우측 중앙에 세련된 5초 네온 카운트다운 알림이 표시되어 자연스럽게 상호작용을 유도합니다.

   

• 다크 네온 글래스모피즘 UI: E 키 입력 시 반투명 블러 효과와 다크 네온 액센트가 적용된 고품질 반응형 모달 창이 오픈됩니다.

   

• 디스코드 식별자 자동 대조: FiveM 접속자의 discord: 라이선스 식별자를 실시간으로 조회하여 디스코드 닉네임과 사전예약 상태를 화면에 즉각 렌더링합니다.

   

• 철저한 악용 방지: 이미 수령을 완료한 유저의 중복 수령 시도와 사전예약 미등록자의 보상 획득 시도를 서버 사이드에서 이중 검증하여 원천 차단합니다.

   

✦ 구동 환경 및 호환성

✦ 동작 프로세스

Plaintext

[디스코드 커뮤니티]
유저: 사전예약 버튼 클릭
  └─ Bot: Discord 고유 ID + 닉네임 + 타임스탬프 DB 기록
  └─ DB: 실시간 사전예약 순번 부여

[FiveM 인게임 서버 오픈]
유저: 인게임 사전예약 비콘 구역 진입
  └─ 비콘: 우측 중앙 5초 네온 알림 노출
  └─ 상호작용 (E키): 글래스모피즘 다크 네온 모달 UI 호출
  └─ 검증: 접속자 Discord 식별자로 DB 대조
      ├─ [미예약] "사전예약 내역이 없습니다." 차단
      ├─ [수령 완료] "이미 보상을 수령하셨습니다." 차단
      └─ [정상 예약] 보상 박스(Item) 즉시 지급 및 DB '수령 완료' 상태 업데이트

✦ 패키지 구성품

1. FiveM 리소스 (/server_scripts, /client_scripts, /html)

    

   • 비콘 프롭/마커 생성 스크립트

      

   • NUI 프론트엔드 에셋 (HTML/CSS/JS 글래스모피즘 템플릿 포함)

      

   • 프레임워크(QBCore/ESX/OX) 선택 가능한 서버 사이드 보상 지급 로직

      

2. 디스코드 봇 소스코드 (bot.py 및 모듈)

    

   • 슬래시 커맨드 핸들러

      

   • Persistent View 기반 버튼 인터랙션 리스너

      

   • aiomysql 비동기 DB 커넥션 풀 스크립트

      

3. 데이터베이스 스키마 (schema.sql)

    

   • 사전예약 유저 관리 테이블 및 인덱스 정의 쿼리

      

4. 상세 설정 및 가이드 문서 (README.md)

    

   • DB 테이블 셋업 가이드

      

   • 비콘 좌표 설정 및 보상 아이템/수량 커스텀 가이드