코나미 멀티팩 컴포저 (YAMANOOTO 카트리지 전용)

야마노오토 코나미 멀티팩 컴포저
=====================================

MSX 야마노오토(Yamanooto) 8MB 플래시 카트리지용 멀티팩 만들기 도구입니다.
가지고 계신 게임 ROM을 골라 넣으면 메뉴가 딸린 8MB ROM 한 개를 만들어 줍니다.

1. 준비물

• 윈도우 + 파이썬 3.10 이상 (python.org 에서 받으세요. 설치할 때
  "Add Python to PATH" 를 켜 주세요)
• 게임 ROM 파일 - 정품을 소유한 게임만 쓰세요. 이 꾸러미에는 없습니다
• blueMSX (선택) - 만든 ROM을 컴퓨터에서 시험해 보고 싶을 때

※ 게임 ROM은 저작권 때문에 동봉하지 않았습니다. 직접 준비하셔야 합니다.
※ 별도의 베이스 ROM은 필요 없습니다. 메뉴는 이 도구가 직접 만듭니다.

2. 만드는 순서

(1) roms 폴더에 게임 ROM 파일을 넣습니다.
컴포저 창에 파일이나 폴더를 그냥 끌어다 놓아도 됩니다(roms 폴더로 복사됩니다).
같은 파일이 이미 있으면 이름이 달라도 알아보고 다시 넣지 않습니다.

(2) "컴포저 실행.bat" 을 더블클릭합니다.
파이썬이 없으면 어디서 받는지 알려 줍니다.

(3) 왼쪽 목록에서 게임을 골라 오른쪽 팩으로 옮깁니다.
파일명에 품번([RC-767])이 있으면 이름과 발매년도를 자동으로 채웁니다.
비어 있으면 게임을 두 번 눌러 한글명/영어명/품번/발매년도를 채워 주세요.

(4) [타이틀 설정] 으로 메뉴 상단 문구를 정합니다(영문·숫자만).

(5) [빌드 -> ROM] 을 누르고 한글판/영문판을 고릅니다.
결과는 build 폴더에 PACK_K.ROM(한글판) / PACK_E.ROM(영문판) 으로 생깁니다.

(6) [blueMSX 테스트] 로 바로 실행해 확인할 수 있습니다.

3. 이미 만든 ROM에서 이어서 편집하기

만들어 둔 팩 ROM에는 "설계도"(게임 목록과 배치표)가 함께 구워집니다.
그래서 roms 폴더나 목록 파일이 없어도, ROM 파일 하나만 있으면 이어서
편집할 수 있습니다. 컴퓨터를 옮겼거나 폴더를 잃어버렸을 때 쓰세요.

[완성 ROM 불러오기] -> 팩 ROM 고르기

ROM 안의 게임이 roms 폴더로 도로 나오고, 이름·품번·매퍼·발매년도와 팩 제목까지
그대로 되살아납니다. 그 뒤로는 평소와 똑같이 게임을 더 넣고 빼고 다시 구우면
됩니다. 같은 파일이 이미 roms 폴더에 있으면 건드리지 않습니다.

설계도가 없던 시절에 구운 팩도 되짚을 수 있습니다. 이때는 메뉴 목록과 게임별
지문(해시)으로 알아내는데, 아는 게임은 그대로 살아나고 모르는 게임만
"추정"으로 표시됩니다. 그 몇 개만 확인해 주시면 됩니다.

명령줄로 하려면: python build_ultra.py --import build\PACK_K.ROM

4. 실기와 에뮬레이터에서 쓰기

실기 : 만든 ROM을 야마노오토 카트리지에 그대로 구워 넣으세요.
에뮬 : ROM 타입을 반드시 Yamanooto 로 지정해야 합니다.
blueMSX - 카트리지 메뉴에서 ROM 타입 Yamanooto 선택
명령줄 - blueMSX.exe /rom1 PACK_K.ROM /romtype1 Yamanooto

★ blueMSX는 플래시 내용을 SRAM 폴더에 저장해 두었다가 다음에 되살립니다.
ROM을 새로 구웠는데 예전 화면이 그대로 나오면
blueMSX\SRAM\PACK_K.sram 같은 파일을 지우고 다시 실행하세요.

5. 메뉴 조작

위/아래 게임 선택
좌/우 페이지 넘기기
스페이스/A 선택한 게임 실행
B 정렬 바꾸기 (품번순 <-> 가나다순, 영문판은 ABC순)
E 에코 켜기/끄기 (카트리지 음원 설정, 게임에 그대로 넘어갑니다)
V 제목 오른쪽 칸을 버전 <-> 발매년도로 (한글판만)
M 배경음악 바꾸기

게임에서 메뉴로 돌아오려면 본체를 리셋하세요.

6. 배경음악과 효과음

음원이 이미 들어 있어서 따로 준비할 것은 없습니다. 커서·페이지·선택·정렬 등
조작마다 효과음이 나고, 메뉴가 뜨면 배경음악이 흐릅니다.

배경음악은 M키로 바꿉니다. 순서는 아래와 같고, 마지막 다음에 한 번 더 누르면
꺼집니다.

사라만다(부팅 곡) - 페넌트 레이스 - F1 스피릿 - 파로디우스 - 스페이스 만보우

효과음은 PSG, 배경음악은 SCC를 쓰도록 나눠 두어 서로 끊지 않습니다.

다른 곡으로 바꾸고 싶다면 MSX 음악 ROM에서 직접 구울 수 있습니다.

(1) music/mscc 폴더에 음악 ROM(.SCC)을 넣습니다.
(2) music 폴더에서  python packall.py   (배경음악)
                    python packsplit.py (효과음)
(3) music/stream 폴더의 .bin 이 바뀌면 다음 빌드부터 그 곡이 실립니다.

music/stream 폴더를 비우면 음악 없이 조용한 팩이 만들어집니다.

7. 커서가 파란 네모로 나올 때

게임을 고르는 커서는 펭귄 그림이어야 합니다. 꽉 찬 파란 네모로 나온다면
2025년 9월 20일 이전 꾸러미로 구운 팩입니다(커서 그림이 꾸러미에서 빠져 있었습니다).

이미 만든 ROM은 다시 구울 것 없이 그 자리만 채워 넣으면 됩니다.

python fix_cursor.py PACK_K.ROM

원본은 PACK_K.ROM.bak 으로 남습니다. 실기 카트리지라면 고친 ROM으로 다시 구우세요.
이 꾸러미로 새로 구운 팩에는 처음부터 들어 있습니다.

8. 제한과 참고

• 8MB 안에서 게임 크기 합계만 맞으면 개수 제한은 없습니다(메뉴 표 여유까지).
  맨 끝 32KB는 설계도 자리로 비워 둡니다.
• 제목이 길면 자동으로 잘립니다. 편집 창에서 미리 알려 줍니다.
• 지원 매퍼: plain(16K/32K), Konami-4, Konami-SCC, 그리고 페이지0에 얹히는
  초기 8~16KB 게임(크레이지 트레인 같은 부류)도 실행됩니다.
• 한글판은 제목 오른쪽에 버전/발매년도 칸이 붙고, 영문판은 붙지 않습니다.

9. 글꼴 라이선스

한글판 메뉴에 갈무리9(Galmuri9) 글꼴을 씁니다.

Copyright (c) 2019-2025 Lee Minseo (quiple@quiple.dev)
SIL Open Font License 1.1

라이선스 전문은 fonts/Galmuri9-LICENSE.txt 에 있습니다. 이 꾸러미나 만든 ROM을
다시 배포할 때 이 파일과 위 저작권 표시를 함께 넣어 주세요.

10. 들어 있는 것

컴포저 실행.bat 이걸 더블클릭하세요
pack_composer.py 컴포저(GUI) 본체
build_ultra.py ROM 빌더
pack_manifest.py 설계도 굽기/읽기 (완성 ROM에서 이어서 편집하기)
fix_cursor.py 옛 팩의 커서(파란 네모) 고치기
cursor_peng.json 메뉴 펭귄 커서 그림
logo_konami.json 메뉴 로고 그림
menu/ 런처 소스(어셈블리)와 글꼴 변환기
fonts/ 갈무리9 글꼴 + 라이선스
tools/ Z80 어셈블러(sjasmplus)
music/ 음원 기록(.bin)과 음원 굽는 도구
roms/ 게임 ROM을 넣는 곳(비어 있음)
build/ 결과 ROM이 생기는 곳

게임 ROM은 들어 있지 않습니다. 직접 준비하셔야 합니다.