Skip to content

jshsakura/passion-gamer

Repository files navigation

🧙‍♂️ Retro Passion Gamer 프로젝트.

  • 사용자가 간단하게 윈도우에서 설치 없이 exe 파일로 실행이 가능한 SF2000용 롬 파일명 일괄 수정 프로그램입니다.
  • 게임파일의 썸네일을 보고 한글명을 입력하거나 사전에 입력된 DB 데이터를 이용해 편리하게 전체 파일의 일괄 변환 작업을 진행 할 수 있습니다.
  • SF2000 기본테마를 아름다운 한글 테마로 쉽게 변경이 가능합니다.


🎮 Retro Passion Gamer (패션 게이머)

  • Retro Passion Gamer는 가성비 장난감 SF2000의 기본 롬 파일명 변경을 도와주는 용도로 개발되었습니다.
  • 호기심에 기기를 구매했지만 6천개의 영문 목록에서 무엇을 찾아야할지 물음표를 띄우고 계실겁니다.
  • 관련 지식이 전무하지만 열정 넘치는 게이머들을 돕기 위한 유틸리티입니다.
  • 개선 사항이나 오류가 있다면 깃허브 상단에 이슈(issue)탭을 이용해주세요.


  • Releases 에서 zip 파일을 다운로드 받아 압축을 풀고 exe를 이용해 프로그램을 실행합니다.


    1. 가장 먼저 프로그램을 실행하면 좌측 상단의 설정 버튼을 눌러 메뉴를 눌러줍니다.
    1. 폴더 선택 버튼을 눌러서 SF2000의 SD 카드 폴더 위치를 지정해줍니다.
    1. SF2000의 드라이브 경로를 지정하고 아래의 저장을 눌러줍니다.


  • 아래의 롬 파일 검색 버튼을 누르면 전체 롬 파일의 검색이 시작되니 잠시 기다려줍니다.


  • 롬 파일 갯수가 무려 6,000개가 넘어가기 때문에 전체 조회시 시간이 좀 걸립니다.
  • 화면당 1000개씩 페이징해서 보여주기 때문에 상단의 페이지 이동 버튼을 이용해 수정파일을 확인해야합니다.
  • 수정사항 적용 버튼은 전체 적용으로 6,000개 가량의 파일명 업데이트를 한번에 진행하니 사용에 주의하시길 바랍니다.


  • 만약 조회된 목록에서 롬 파일 명을 확인하고 누락된 건이 있다면 입력해줍니다.
  • 사전 입력된 한글 롬파일 목록은 무적풍화륜 소통카페의 삼색이냥님이 고생해주셨습니다.
  • 아케이드 한글 바로가기의 경우 드드라님이 고생해주셨습니다. 마찬가지로 감사합니다.
  • 전체 한글 롬 파일명 목록은 구글 독스에서 확인이 가능합니다.


  • 프로그램이 설정해준 이름으로 기본 적용하거나 또는 수정 사항을 모두 작성했다면 우측 하단의 (1) 수정사항 적용 버튼을 눌러줍니다.
  • 다시 한번 확인 창이 나타나는데 (2) Yes 를 누르고 파일명 변경 작업이 끝날때까지 잠시 기다려줍니다.


  • 작업이 모두 완료되면 안내창이 나타나며, 확인 버튼을 누르면 롬 목록을 새로고칩니다.


  • 정상적으로 사전입력된 DB 데이터와 동일하거나, 원본명과 수정 파일명이 동일하다면 상태 항목이 수정완료녹색으로 표시됩니다.


  • 수정 파일명은 클릭해서 정렬 변경 시 누락된 파일명이 있다면 변경하거나 선택항목 제외를 통해 파일명 수정에서 제외시키는 등의 추가 작업도 가능합니다.
  • 현재 개발 시점인 23년 9월 18일 기준으로 전체 기본 롬의 누락 건은 없었습니다.


  • 추가로 중문 패치버전(CN) 중국 롬의 경우 불필요한 파일이나 마찬가지기 때문에 중국 롬 검색 버튼을 눌러 별도로 조회가 가능합니다.


  • 파일명의 (CN) 을 기준으로 단순 검색됩니다.
  • Ctrl + A 버튼으로 전체 목록을 선택하시고 아래의 (1) 선택항목 삭제를 눌러줍니다.
  • 다음 확인 창에서 (2) Yes를 눌러주시고 수정사항 적용 버튼을 누르면 실제로 SD 카드에서 제거됩니다.


  • 한글 목록으로 변환 이후에는 영문 키보드만 지원하는 덕에 기본 게임 검색이 불가능해지니 참고하세요.
  • 기종 별로 화면에 4개씩 지정된 기본 바로가기인 숏컷 링크파일명 수정으로 동작하지 않기 때문에 직접 사용자의 수정이 필요합니다.
  • 한글 파일 명으로 바뀐 탓에 동작하지 않게 되었을 기종별 4개의 바로가기 게임인 숏컷을 상단의 한글 숏컷 설치 버튼을 눌러 수정할 수 있습니다. (xfgle.hgp 파일 교체)


  • 한글 숏컷 목록의 경우 위 사진처럼 직접 Resources 폴더의 파일이 수정됩니다.
  • 추가로 무작정 파일을 덮어 쓰는게 것이 아닌, 롬 폴더에 실제로 숏컷을 위한 한글 파일명이 모두 존재하는 경우에만 한글 숏컷이 적용됩니다.


  • SF2000의 SD 카드 내 설정된 기본 테마를 위 사진처럼 인디케이터가 포함된 편리한 한글 테마로 변경이 가능합니다.
  • 무려 한글로 제작된 테마인 드드라님의 드드라 테마듀얼코어님이 수정한 퀵메뉴 한글 리소스 설치를 지원합니다.


  • 상단의 한글 테마 설치 버튼을 클릭하면 SF2000Resources 폴더에 파일을 확인하고, 테마 적용에 필요한 46개의 파일이 존재하면 해당 파일들을 덮어 쓰게 됩니다.


  • 멋진 테마를 제작해주신 드드라님과 게임 내 퀵 메뉴 호출 시 등장하는 한국어 및 열기 이미지를 수정해주신 듀얼코어님께 감사합니다.


  • 게임보이 어드밴스(GBA) 구동 성능을 향상하는 바이오스와 슈퍼 패미컴(SFC) 의 느린 구동 문제를 해결하는 펌웨어를 설치할 수 있습니다.
  • (1) 1.71 펌웨어 및 바이오스 버튼을 누르고 (2) Yes 를 선택하면 SD 카드bios 폴더의 파일을 교체합니다.


  • 위 파일 교체 작업은 사실상 펌웨어를 재설치 하는 작업과 동일합니다.
  • 반드시 작업 전 기존 원본 바이오스 폴더백업하시고 진행하시길 바랍니다.


  • 본 프로그램은 SD 카드의 롬 폴더 내의 파일 명을 실제로 직접 변경하기 때문에, 아무쪼록 사용전에 항상 백업이 중요하며 주의가 필요합니다.

한글화 작업에 대한 좀 더 자세한 후기는 오픈코스 블로그 에서 만나 보실 수 있습니다.

💌 무한한 감사를 드립니다. 🫶

  • 프로그램 내 버튼 아이콘은 멋진 무료 아이콘을 제공하는 Feather를 이용합니다.
  • 윈도우 프로그램의 아이콘은 svgrepo에서 무료 아이콘을 사용했습니다.
  • 프로그램의 로딩 오버레이 아이콘은 loading.io 에서 무료 svg 아이콘을 이용하고 있습니다.
  • 롬파일의 썸네일 추출을 위해 tadpole 이 수정한 frogtool.py을 적용했습니다.
  • 기종별 아이콘은 Onion OSDot-art by Yoshi-kun 를 적용했습니다.
  • 테마 설치 기능은 무적풍화륜 소통카페의 드드라 테마 를 허락 받아 적용했습니다.
  • 인게임 설정 한글화는 무적풍화륜 소통카페의 듀얼코어님의 허락을 받아 한글 펌웨어 겸 패치 파일에서 추출했습니다.
  • SF2000의 수많은 정보를 일일이 정리한 vonmillhausen의 자료들이 큰 도움이 되었습니다.
  • SF2000의 구세주와 같은 프로그램인 EricGoldsteinNztadpole의 보석같은 소스를 상당부분 차용했습니다.
  • 친절한 도우미, 그러나 심각하게 멍청한 ChatGPT의 코드 리팩토링 서포트.