본문 바로가기

DP-SFXEditor개요

소개

DP-SFXEditor는 마인크래프트 게임 안에서 효과음을 직접 합성하고, 서버에서 재생하는 도구입니다. 언리얼 엔진의 MetaSound처럼 오실레이터·노이즈·엔벨로프·필터·이펙트를 노드로 연결해 소리를 만들고, 고치는 즉시 게임 안에서 들어볼 수 있습니다. 만든 사운드는 JSON 파일 하나로 저장되며, 서버에 올리면 /dpsfx play 명령이나 다른 플러그인에서 바로 재생할 수 있습니다.

클라이언트 모드(편집기·재생)와 서버 플러그인(사운드 보관·재생 지시) 두 부분으로 되어 있습니다. 소리는 클라이언트 모드가 합성하며, 서버는 합성하지 않고 사운드 id와 파라미터만 전달합니다.

주요 기능

  • 게임 안 노드 편집기: 핀 타입(오디오·실수·트리거·시간)이 있는 노드 그래프, 서브그래프, 되돌리기/다시 하기 200단계
  • 합성 노드: 오실레이터(사인·톱니·사각·삼각, 톱니·사각·삼각은 기본으로 앨리어싱을 줄인 대역 제한 파형), 노이즈(화이트·핑크), ADSR·AD 엔벨로프, LFO, 랜덤, 트리거 반복·지연, 수식, 트리거 라우팅·카운터·필터·확률, 시퀀스·무작위 선택(변주), 샘플 앤 홀드·스무딩·임계값
  • 샘플 재생: 클라이언트의 samples/ 폴더에 넣은 .ogg·.wav·.mp3 파일을 sampleplayer로 재생(변주 목록, 시작 위치)
  • 필터와 이펙트: 바이쿼드 필터(1.3.0부터 peak·셸프·올패스 모드 추가), 1차·올패스·래더·콤 필터, 딜레이, 리버브, 디스토션, 컴프레서, 게인, 팬, 믹서, 크로스페이드, 그리고 1.3.0의 코러스·플랜저·페이저·룩어헤드 리미터·스테레오 딜레이
  • 변조와 악기 (1.3.0): 오디오를 값으로 바꾸는 audiotofloat·floattoaudio와 ringmod로 FM·링 변조, 엔벨로프 팔로워, 디시메이터, 카플러스-스트롱 방식의 뜯는 현(string)
  • 음악 유틸 (1.4.0): MIDI 음↔주파수(midi2hz·hz2midi), 반음 배율(semitones), 템포의 음표 길이(bpm), 템포 클록(clock, 스윙·마디), 음계에 맞추기(quantize)와 음계 단계→음(scalenote)
  • 실시간 미리보기: 편집하면 짧은 크로스페이드로 바로 다시 로드됩니다. UI 소리로, 또는 월드의 한 점에서 재생합니다.
  • 스코프·파라미터·로그: 파형과 스펙트럼, 입력 파라미터 슬라이더·트리거 버튼, 컴파일 문제와 서버 알림
  • 서버 연동: 올리기·내려받기·이름 바꾸기·삭제, 같은 id/바뀜 감지, 근처 플레이어에게 재생
  • 베이크 (1.5.0): 사운드를 .ogg 리소스 팩으로 구워, 모드가 없는 플레이어도 팩과 서버 폴백으로 들을 수 있게 합니다. 편집기의 베이크 메뉴, MCP(bake_sound), 서버 /dpsfx bake
  • MCP 연동: Claude가 게임 안 편집기를 직접 다루며 효과음을 만들고, 측정(analyze)하고, 재생하고, 서버에 올립니다 (코어 MCP 허브)

지원 환경

항목 값
서버 Paper / Spigot 1.20 ~ 1.21.x (Java 21)
의존 플러그인 DPP-Core
클라이언트 DPP-ModCore 2.24.0 이상 + DP-SFXEditor 클라이언트 모드 (Fabric / Forge)
모드 없는 플레이어 서버가 베이크한 리소스 팩을 설치하면 .ogg로 구운 소리를 들을 수 있습니다(1.5.0, "베이크" 문서). 팩이 없으면 소리는 들리지 않습니다
  • 패치와 프리셋 (1.4.0): 저장한 사운드를 다른 사운드 안에서 patch 노드로 불러 쓰고(서브그래프를 패치로 내보내기), Params 탭에서 입력 값 묶음을 프리셋으로 저장·적용합니다. 자세한 내용은 "패치와 프리셋" 문서를 보세요.