Skip to content

Home ko

ToughkidCST edited this page Sep 16, 2026 · 3 revisions

MUCOMSX 위키

MUCOM88 for MSX — 작곡 가이드

저장소의 설명서는 툴을 어떻게 다루는지를 다룹니다. 어떤 키가 컴파일인지, 오류 코드가 무슨 뜻인지, 세션이 어떻게 동작하는지. 이 위키는 음악을 어떻게 쓰는지를 다룹니다. MML 작성 요령과, PC에서 만든 FM 음색·PCM 뱅크를 MSX로 가져오는 방법입니다.

🇺🇸 English · 🇯🇵 日本語


먼저 이해할 것 하나

MUCOMSX는 음악을 연주합니다. 사운드 에셋을 만들지는 않습니다.

MSX 쪽에는 FM 음색 에디터도, PCM 샘플 변환기도 없습니다. 애초에 그럴 의도가 아니었습니다. YM2608 음색은 오퍼레이터 파라미터 25바이트인데 만지면서 바로 들어봐야 하고, ADPCM 뱅크는 16비트 WAV 파일에서 출발합니다. 둘 다 24 KiB짜리 MSX 텍스트 버퍼 안에서 하기엔 맞지 않는 일입니다.

그래서 작업이 둘로 나뉩니다.

어디서 무엇을
PC (윈도우) FM 음색 설계, PCM 뱅크 제작, 아이디어를 빠르게 들어보기
MSX MML 작성·편집, 컴파일, 실제 YM2608 하드웨어에서 연주, .MUB / .VGM 내보내기

에셋은 평범한 파일로 한 번 건너옵니다. 그다음부터 MSX 쪽은 자급자족합니다.

flowchart LR
  subgraph PC["PC / 윈도우"]
    T["FmToneEditor"]
    W["WAV 샘플"]
  end
  subgraph MSX["MSX"]
    S["SONG.MUC"]
    O["SONG.MUB"]
    S -- "컴파일 — MUCPLAY / MUC2MUB" --> O
  end
  T -- "VOICE.DAT" --> S
  W -- "MUCOMPCM.BIN" --> S
Loading

전체 경로는 **Workflow**에서 단계별로 다룹니다.


페이지

지금 볼 수 있는 문서

페이지 다루는 내용
작업 흐름 PC → MSX 전체 경로, 파일명 규칙, 무엇을 언제 복사할지
도구와 링크 MUCOM88 Windows, 변환 도구, 상류 문서

작성 중

아직 올라오지 않았습니다. 아래는 예정된 제목이라 일부러 링크를 걸지 않았습니다.

페이지 다룰 내용
MML 기본 파일 구조, 헤더 태그, 채널 A–K, 음표, 길이, 옥타브, 템포
MML 레퍼런스 표현 명령, 반복, 매크로, 포르타멘토, 고급 명령표
FM 음색 PC에서 음색 설계, @ 형식들, 라이브러리 방식과 인라인 정의
PCM과 ADPCM WAV로 뱅크 만들기, K 채널, PCM이 .MUB 안으로 들어가는 과정
리듬 G 채널, 일곱 값 음량 형식, 패턴 작성
제한값과 사양 모든 크기 제한을 한 표에, 그리고 실제로 부딪히는 것은 어느 것인지
문제 해결 증상 → 원인. 소리가 안 나는 채널, 이상한 음색, 빠진 PCM

그때까지는 MUCEdit 설명서가 MML 문법과 모든 컴파일 오류 코드를 담고 있고, 상류의 onitama/mucom88 위키가 MUCOM88 자체의 정본 레퍼런스입니다.


시작하기 전에

MSX 쪽이 먼저 동작해야 합니다. 요구 사항은 저장소 README에 있습니다 — MSX2 이상, MSX-DOS2 또는 Nextor, 512 KB 매퍼 권장, 연주하려면 MAKOTO(YM2608) 카트리지.

PC 쪽에는 ONION software의 MUCOM88 Windows가 필요합니다. 단독으로 동작하며, 음색 에디터와 PCM 뱅크 제작 기능이 여기 들어 있습니다.

문법에 관한 참고. MUCOMSX는 MUCOM88 v1.7 계열을 대상으로 하고 MUB8 형식을 출력합니다. MUCOM88용으로 쓰인 MML은 대부분 컴파일되지만, MUCOMSX가 모든 MUCOM88 파생본의 비트 단위 복제는 아닙니다. 이 위키가 제한이나 동작을 서술할 때는 MUCOMSX를 기준으로 합니다. 상류 프로젝트 자체의 레퍼런스는 onitama/mucom88 위키를 보십시오.


기여

수정과 추가를 환영합니다. 여기 틀린 내용이 있거나 빠진 요령이 있으면 이슈 게시판에 남겨 주세요. 한국어·일본어·영어 모두 괜찮습니다.

MUCOMSX Wiki

🇺🇸 English

🇰🇷 한국어

🇯🇵 日本語


More pages are being written — see Home for the list.

Repository · Issues

Clone this wiki locally