팝골프 타석 PC 설치 가이드

개요

이 프로그램(타석 에이전트)을 설치하면, 손님이 타석을 쓰기 시작할 때 자동으로 보호화면(장막)이 걷히고 게임(X-GREEN)이 켜집니다. 이용 시간이 끝나면 자동으로 게임이 꺼지고 다시 보호화면으로 돌아갑니다.

타석 PC 1대당 한 번만 설치하면 되고, 그 이후에는 따로 손댈 일이 없습니다.

준비물

• 인터넷에 연결된 타석 PC(Windows)
• Node.js 설치 여부 확인
  1. 시작 메뉴에서 cmd 검색 → 명령 프롬프트 실행
  2. node -v 입력 후 Enter
  
  ▲ 이렇게 버전이 바로 출력되면 정상입니다.
  3. v18 이상 버전이 나오면 이미 설치됨 → 다음 단계로
  4. "'node'은(는) 내부 또는 외부 명령…" 오류가 뜨면 미설치 → 같은 명령 프롬프트에 아래 명령어 입력 후 Enter:

  winget install OpenJS.NodeJS.LTS

  5. 설치 끝나면 명령 프롬프트 창을 닫았다 다시 열어서 node -v로 확인

설치 단계

1. 타석 PC 브라우저에서 ops.thegolf.com/dl/bay-agent.zip 접속 → 자동 다운로드
2. 다운로드된 bay-agent.zip 파일을 우클릭 → "압축 풀기"(압축 해제), 바탕화면에 타석 이름으로 폴더를 만들어 두면 나중에 찾기 편함
3. 폴더 안 install.bat 파일을 우클릭 → "편집"(또는 "열기" → 메모장으로 열기)
4. 파일 안에서 아래 두 줄을 찾음:

   REM set GAME_EXE=C:\XGREEN\XGreen.exe
   REM set GAME_PROC=XGreen.exe

   앞에 붙은 REM 을 지우고, 실제 게임(X-GREEN) 실행파일 경로로 바꿔주기(금산점 예시):

   set GAME_EXE=D:\Build_Black_XGC_MultiBundle\XGolf.exe
   set GAME_PROC=XGolf.exe

5. 저장 후 닫기
6. install.bat 더블클릭 실행 → 창이 2개(에이전트 + 보호화면 브라우저) 뜨면 정상

부팅 자동실행 설정

PC를 켜질 때마다 직접 install.bat을 누르지 않아도 되도록, 시작 프로그램에 등록해둔다.

1. 키보드에서 Win + R → shell:startup 입력 후 Enter
2. 열린 폴더가 바로 시작 프로그램 폴더
3. install.bat 파일을 오른쪽 마우스로 끌어서 그 폴더 안에 놓고 "여기에 바로가기 만들기" 선택 (파일 자체를 옮기면 안 됨, 바로가기만)
4. 이제 PC를 끄고 켜도 에이전트와 보호화면이 자동으로 실행된다

OPS에서 타석 번호 배정하기

1. 관리자 화면 ops.thegolf.com/admin/bay-devices 접속
2. 방금 설치한 PC가 "미배정" 목록에 PC 이름으로 나타남
3. 드롭다운에서 해당 타석(방이름) 선택 → 배정

4. 배정하는 즉시 그 PC 화면이 자동으로 해당 타석 보호화면으로 바뀜

PC를 교체할 때는 새 PC를 그 타석에 다시 배정만 하면 되고, 이전 PC의 배정은 자동으로 풀린다.

장막 배경 이미지/동영상 바꾸기

보호화면(장막)에 매장 자체 이미지나 동영상을 띄울 수 있습니다. 타석마다 다르게가 아니라 매장 전체 공통으로 적용됩니다.

1. 관리자 화면 ops.thegolf.com/admin/bay-devices 접속
2. "보호화면 배경" 영역에서 이미지 또는 동영상 파일 선택 → 업로드
3. 업로드 즉시 모든 타석 보호화면이 그 이미지/동영상으로 꽉 채워져 나옵니다(로고·시계·안내문구 등 다른 요소는 안 보이고 그것만 나옴)
4. 지우려면 같은 화면에서 "제거" 버튼

주의사항

• 파일 용량 제한은 없지만, 너무 큰 동영상은 업로드·재생이 느릴 수 있습니다
• 이미 켜져서 보호화면이 떠 있는 타석 PC는 새로고침(F5)하거나 재부팅해야 바뀐 화면이 바로 보입니다 — 타석 에이전트를 다시 설치할 필요는 없습니다

정상 동작 확인 + 문제해결

배정이 끝난 뒤, 그 타석에 워크인을 넣거나 결제해보세요. 보호화면이 자동으로 걷히고 게임이 켜지면 정상입니다. 이용을 종료하면 게임이 꺼지고 다시 보호화면이 뜨는지도 확인하세요.