메이플스토리 개인 서버를 운영하거나 커스터마이징하고 있다면, 자신만의 아이템을 추가해보고 싶은 생각이 드셨을 겁니다. 이 포스팅에서는 HaRepacker를 이용해
.wz파일에 새로운 아이템을 추가하는 방법을 정리해보았습니다.
✅ 준비물
-
HaRepacker 최신 버전
다운로드 링크: GitHub - HaRepacker (Releases) -
수정할
.wz파일
예:Item.wz,Character.wz,String.wz등 -
추가할 아이템 이미지 (
.img,.png) 및 아이템 ID와 기본 구조
🛠️ HaRepacker 설치 및 실행
- 위 링크에서
.zip파일을 다운로드 후 압축을 해제합니다. HaRepacker.exe를 실행합니다. (별도 설치 없이 바로 실행됩니다.)
📁 아이템 추가하기 (예: 모자 아이템)
1. Item.wz 열기
- HaRepacker 실행 후
File > Open클릭 Item.wz파일 선택 (서버 클라이언트 내에서 가져옵니다)
2. 경로 탐색
- 경로:
Item.wz > 0500.img(모자 아이템은 0500번대에 저장됩니다)
3. 새 아이템 복제
- 이미 존재하는 비슷한 아이템을 복사(Ctrl+C) 하고, 같은 경로에 붙여넣기(Ctrl+V)
- 붙여넣은 아이템의 ID를 새 아이템의 ID로 변경 (예: 1009999)
4. 아이템 세부정보 수정
-
복제한 아이템을 클릭하여 내부 속성(ID, 이름, 설명, 가격 등)을 수정
info > name,info > desc,info > price등
🧑🎨 아이템 외형 설정 (Character.wz)
1. Character.wz 열기
Character.wz > Cap.img경로로 이동 (모자일 경우)
2. 새 항목 생성
- 오른쪽 클릭 →
Add Child > Canvas선택 - 새로 만든 아이템 ID로 이름 지정 (예: 1009999)
3. PNG 이미지 삽입
Add Child > Canvas또는Add Child > UOL등으로 적절한 레이어 및 방향 프레임 생성- PNG 파일을 드래그하여 삽입하거나 직접 설정
Tip: 기존 아이템 구조를 복제해서 이름만 바꾸고 이미지만 바꾸는 방식이 간편합니다.
📝 아이템 이름 등록 (String.wz)
String.wz > Cash.img또는Eqp.img열기- 동일한 ID로 새 항목 생성
name,desc,msg등 속성 수정
💾 저장 및 적용
- 각
.wz파일을 수정한 후File > Save또는Save As클릭 - 클라이언트 폴더에 덮어쓰기
- 서버에서는 해당 아이템 ID를 DB 및 코딩 쪽에도 반영해야 정상적으로 작동합니다
📢 주의사항
- 반드시 기존 파일 백업 후 수정하세요.
- 아이템 ID가 중복되면 클라이언트에서 충돌 발생 가능
- 서버 소스에도 해당 아이템 ID 등록이 필요합니다 (예: DB insert, Drop, Shop 등)
📦 다운로드 링크 정리
| 이름 | 설명 | 링크 |
|---|---|---|
| HaRepacker | WZ 편집 툴 | GitHub 다운로드 |
| PNG 리소스 예시 | 커스텀 아이템 PNG | [파일 업로드 시 제공 가능] |
예시 아이템 .wz 파일 |
연습용 | [직접 제작 필요] |
🙋♂️ 마무리
HaRepacker는 메이플스토리 개인 서버 커스터마이징의 핵심 도구입니다. 아이템 외에도 맵, 몬스터, UI 등 다양한 요소를 수정할 수 있으니, 익숙해지면 상상하는 거의 모든 걸 구현할 수 있습니다.
궁금한 점이나 다음에 다뤄줬으면 하는 주제가 있다면 댓글로 남겨주세요 😊