VNDB-HTML-Generator_v1.1 (업로더용)
게임 업로드할 때 매번 똑같은 양식을 4~5개씩 작성하다 보면 너무 귀찮아서
준자동 프로그램 만들어서 쓰고 있었음
그럼 공지에 있는 업로드 양식을 조금 더 간소화 하면 되는거 아닌가요?
라는 나쁜말은 ㄴㄴ...
해당 프로그램은
vndb.org 주소를 입력하면
vndb api를 호출하여 데이터를 가지고와 정해진 양식에 따라 자동으로 html로 파싱해줌
제미나이키를 추가하면 개요 및 별칭 번역을 시도하고, 실패 시 영문으로 넣어줌
단 해당 게임 릴리즈 주소를 입력 (ex:
https://vndb.org/r
~~) 하면 작동하지 않고
https://vndb.org/v56650
처럼 v로 시작하는 주소만 인식하여 동작함
캡처 이미지에서는 아이콘이 깨지고 있는데
아이콘 이미지가 안깨지게 수정했음
아무나 사용해도 상관없고 겸사겸사 기록용으로 작성함
다운로드 링크
v1.0 :
https://workupload.com/file/q2EYTtQT9Zy
v1.1 :
https://workupload.com/file/QcFBKLeeqjJ
- 준비물
Gemini key (무료로 발급 가능)
발급 받은 API 키를 복사 해야함
- 내부작동 로직
데이터 추출 및 API 연동: 입력된 URL에서 고유 식별자(VN ID)를 파싱한 후, 로컬 프록시 서버를 통해 VNDB API를 호출하여 원제, 제작사, 퍼블리셔, 평점 등의 메타데이터 원본을 수집합니다.
제미나이(Gemini) 기반 데이터 가공: 수집된 영문 시놉시스와 별칭(Alias) 데이터를 Gemini API로 전송하여, 자연스러운 한국어 번역 및 독음 텍스트로 변환하는 자연어 처리 과정을 거칩니다.
최종 HTML 구조화: 취합된 원본 데이터와 AI 번역 결과물을 미리 정의된 커뮤니티 게시 양식(HTML 테이블 및 details 태그)에 맞춰 렌더링하고, 사용자가 즉시 복사할 수 있는 최종 코드로 출력합니다.
입력된 제미나이키는 로컬 환경에서만 저장합니다. 외부 유출 없습니다.
Version 1.0
＊ 실행화면
＊ 사용 방법
발급 받은 API 키를 프로그램 GEMINI API KEY 항목에 붙여넣기 (API KEY는 PC 브라우저 저장소에 저장)
업로드 할 게임의 vndb.org 주소를 복사하여 프로그램 VNDB URL에 붙여넣고 생성 버튼 클릭
생성된 코드를 프로그램 하단에 클립보드 복사 버튼을 선택
게시글 작성 버튼을 선택 후 편집모드로 변경 하여 복사된 코드를 그대로 내용에 붙여넣기
v.1.1은 편집모드로 변경하지 않고 게시글 내용 그대로 복사하기가 가능
＊ 결과
Version 1.1 (04/16 Update)
＊ 신규 기능
Gemini 번역 모델 드롭다운 선택 추가 (gemini-2.5-flash / gemini-2.5-flash-lite / gemini-2.5-pro)
VNDB 이미지 업로드 모드 추가 — 커버 + 스크린샷 URL을 태그로 자동 삽입
- 일반 이미지만 (최대 5장) / 성인 이미지 포함 (최대 6장) 선택
- Pool 방식으로 이미지 수집, 부족 시 하위 수위 이미지로 자동 보완
- 커버 없을 경우 스크린샷으로 슬롯 대체생성 완료 시 자동 클립보드 복사 (글 내용에 바로 붙이기 가능)
TXT 파일 다운로드 기능 추가 (HTML 다운로드 대체)
API Key 표시/숨기기 토글 (눈 아이콘)
창 크기 및 위치 기억
＊ 개선 및 버그 수정
Gemini 번역 실패 시 서버에서 2회 자동 재시도
콘텐츠 필터(SAFETY) 거부 시 CONTENT_BLOCKED 반환, 원문 삽입 후 프론트에 메시지 표시
번역모델, 업로드 모드 토글, 이미지 모드 선택 값을 재실행해도 초기화 되지 않게 개선
VNDB 이미지 업로드 동작방식 (Pool)
- 일반 이미지 모드 (최대 5장)
커버 → Safe 스크린샷으로 채우기 부족하면 채우지 않음
- 성인 이미지 포함 모드 (최대 6장) 고정 슬롯 3자리를 먼저 채우고, 나머지 3자리는 pool에서 채우기
이미지 채우는 순서
1번 슬롯 : Cover 이미지
2번 슬롯 : Suggestive 1장 (없으면 Explicit으로 대체)
3번 슬롯: Explicit 1장 (없으면 Suggestive로 대체)
나머지 3자리는 Safe → Suggestive → Explicit 순으로 이미 쓴 URL 제외하고 채우기
커버가 없으면 풀 맨 앞 이미지를 커버 슬롯으로 당겨서 사용
＊ v1.1 사용 방법
Gemini api key를 발급 받아 프로그램에 추가한다.
URL에 업로드할 게임의 VNDB 주소를 붙인다. (VNDB에 저장된 게임 이미지까지 포함시키고 싶다면 옵션 선택)
자동으로 클립 보드에 복사되니 작성할 게시글 내용에 그대로 Ctrl+V로 붙여 넣는다. (원본유지 선택)
