LISTINGS NITRO - 3D 아케이드 레이싱
=====================================

[실행]
1) ListingsNitro.exe 더블클릭
   - 검은 서버 창이 뜨고, 잠시 후 게임 창(Edge/Chrome 앱 창)이 자동으로 열립니다.
   - 서버 창을 닫으면 게임이 종료됩니다.
   - 게임 창이 안 열리면 브라우저에서 http://127.0.0.1:8765 접속
   - "Windows의 PC 보호" 창이 뜨면: 추가 정보 → 실행
2) 파이썬이 있으면 source 폴더의 run_source.bat 으로도 실행 가능 (추가 설치 불필요)

[계정]
- 첫 화면에서 회원가입 → 로그인
- 가입 보너스: 10,000 크레딧 + 50 토큰 + D 클래스 차량 2대
- 계정 데이터 저장 위치: %APPDATA%\ListingsNitro\listings_nitro.db

[오너 계정]
- 아이디: app   /   비밀번호: app   (회원가입 없이 바로 로그인)
- 서버가 시작될 때 config.json 의 owner_id / owner_password 로 오너 계정을 자동으로 만들어 둡니다.
  (이미 있으면 비밀번호만 config 값으로 맞춥니다. 그래서 다른 사람이 이 아이디로 가입할 수 없습니다.)
- 오너는 메인 메뉴의 [오너 패널]에서 모든 사용자에게
  크레딧 / 토큰 / 특정 차량 / 모든 차량 / 최대 업그레이드를 지급할 수 있습니다.
- 아이디/비밀번호를 바꾸려면 config.json 을 수정하고 exe를 다시 실행하세요.
  (allow_lan 으로 다른 PC에 공개할 때는 더 긴 비밀번호로 바꾸는 것을 권장합니다.)

[같은 네트워크의 친구와 함께]
- config.json 의 "allow_lan" 을 true 로 바꾸고 실행하면
  서버 창에 표시되는 주소(http://192.168.x.x:8765)로 다른 PC에서 접속해 각자 가입/플레이할 수 있습니다.
  (Windows 방화벽 허용 필요)

[조작]
  ← → (A D)          조향 (가속은 자동)
  ↓ (S)              브레이크 · 조향 중이면 드리프트 (니트로 충전)
  SPACE / SHIFT      니트로
  SPACE 두 번 / X    쇼크웨이브 (니트로 게이지가 가득일 때)
  ESC                일시정지

[게임 요소]
- 차량 67대 (D · C · B · A · S 클래스), 구매 · 업그레이드(10레벨) · 도색
- 트랙 3개: 네온 시티(야간) / 썬셋 캐니언(사막) / 알파인 피크(설산)
- 커리어 15개 이벤트 + 빠른 레이스, 라이벌 5명
- 니트로 · 쇼크웨이브 · 드리프트 · 테이크다운 · 니어 미스 · 점프대 배럴롤 · 니트로 아이템
- 설정(⚙)에서 그래픽 품질(낮음/보통/높음)과 볼륨 조절. 느리면 '낮음'으로 바꾸세요.

[exe 직접 만들기]
  source 폴더의 build_exe.bat 실행 (pyinstaller 자동 설치)

※ 차량 이름은 실제 차종명을 참고했으며 3D 모델은 코드로 만든 단순화된 형태입니다.
  개인 학습/연습용 프로젝트입니다.
