뽑기 상자

대부분의 GUI 모드는 접속하는 인원 전원이 같은 모드를 설치해야 화면이 보입니다. 이 모드는 바닐라 상자 창만 쓰므로, 서버에만 넣으면 끝입니다. 접속하는 인원은 아무것도 설치하지 않습니다.

상자는 새 아이템을 추가하지 않습니다. 기존 아이템에 표시를 붙여 구분하므로, 클라이언트에 이 모드가 없어도 접속이 끊기지 않습니다.

클라이언트에도 넣으면 전용 화면이 더해집니다. (선택 사항입니다) 관리자는 마우스로 편집하는 화면을, 플레이어는 스크롤되는 미리보기 화면을 봅니다. 설치하지 않은 인원은 지금까지처럼 상자 창과 명령어로 전부 그대로 이용합니다. 한 서버에 섞여 있어도 문제없이 함께 플레이할 수 있습니다.

플레이어는 명령어를 쓰지 않습니다. 상자를 우클릭하면 열리고, 좌클릭하면 내용을 봅니다.

• 내용물과 확률을 전부 직접 정합니다. 어떤 아이템이든, 몇 퍼센트든 가능합니다.
• 손에 든 아이템을 그대로 담습니다. 이름·색·커스텀 모델이 붙은 아이템도 붙은 그대로 들어갑니다. 아이템 이름을 타이핑할 필요가 없습니다.
• 확률은 가중치로 적습니다. 항목을 넣고 빼도 나머지를 다시 계산할 필요가 없습니다. 합을 100으로 맞추지 않아도 됩니다.
• 열기 전에 안을 봅니다. 상자를 들고 좌클릭하면 들어 있는 것과 뽑힐 확률이 상자 창에 나옵니다. (확률이 낮을수록 다른 색으로 표시됩니다)
• 두 가지 방식을 지원합니다.
  • 랜덤 뽑기: 열면 정해진 횟수만큼 뽑아 전부 줍니다.
  • 선택 뽑기: 후보 몇 개를 무작위로 뽑아 보여 주고, 그중 하나를 고릅니다. 항목이 아주 많은 상자에 적합합니다.
• 갈래 나누기: 항목에 묶음 이름을 달면, 선택 뽑기에서 먼저 갈래를 고른 뒤 그 안에서 후보가 나옵니다.
• 전체 알림: 희귀한 것이 나왔을 때 서버 전체에 알릴 수 있습니다.
• 인벤토리가 가득 차도 아이템을 잃지 않습니다. 우편 기능이 있으면 우편으로, 없으면 바닥으로 보내고 반드시 안내합니다.
• 상자 창에서 아이템을 꺼낼 수 없습니다. 모든 클릭이 차단되어 있습니다.
• 전용 화면 (클라이언트에도 설치한 경우)
  • 편집 화면 /상자편집: 상자 만들기·지우기, 이름·색·설명·지급 횟수, 겉모습 바꾸기, 가방에서 여러 개를 한 번에 담기, 가중치·개수 고치기, 항목 빼기를 전부 마우스로.
  • 미리보기 화면: 좌클릭하면 내용물이 목록으로 나옵니다. 상자 창(45칸)과 달리 항목이 아무리 많아도 스크롤해서 전부 볼 수 있습니다.
  • 선택 뽑기·묶음 설정은 명령어로 합니다.

/상자만들기 lucky_box
(다이아몬드 3개를 손에 들고)  /상자넣기 lucky_box 10
(철괴 16개를 손에 들고)       /상자넣기 lucky_box 90
/상자설정 lucky_box 이름 §6행운 상자
/상자설정 lucky_box 설명추가 §7운이 좋으면 다이아몬드!
(상자로 쓸 아이템을 손에 들고) /상자겉모습 lucky_box
/상자지급 플레이어이름 lucky_box 5

위 예시는 다이아몬드 10% · 철괴 90% 입니다. 가중치 합이 100일 필요는 없습니다. 설명과 이름에는 §6(금색) 같은 색 코드를 쓸 수 있습니다.

서버를 한 번 실행하면 설정 파일이 자동으로 생성됩니다.

config/pang_lootbox.json: 상자와 전역 설정

boxes                  상자 목록: 내용물·확률·겉모습이 전부 여기 있습니다
maxRolls              한 번에 뽑을 수 있는 최대 개수
defaultPicks          선택 뽑기의 기본 후보 수
defaultWeight         항목을 새로 넣을 때 주는 기본 가중치
defaultBoxItem        새로 만든 상자의 기본 아이템
defaultColor          새로 만든 상자의 기본 이름 색
fallbackItem          없는 아이템 id 를 만났을 때 대신 쓸 아이템
previewInfoItem       미리보기 창 마지막 줄의 안내 아이템
groupIconItem         갈래 고르기 창에서 쓸 기본 아이콘
openSound             개봉 소리 (비워 두면 소리가 나지 않습니다)
openSoundVolume       소리 크기 (0 ~ 10)
openSoundPitch        소리 높이 (0.5 ~ 2.0)
previewPercentTiers   미리보기에서 확률을 색으로 나누는 경계 (%)

상자 하나(boxes 안)의 값

name              상자 이름 (§ 색 코드 사용 가능)
item              상자로 쓸 아이템 id
customModelData   커스텀 텍스처 번호 (0 이면 쓰지 않습니다)
color             이름 색
lore              설명 줄 목록 (§ 색 코드 사용 가능)
rolls             한 번 열 때 몇 번 뽑는지
announce          결과를 서버 전체에 알릴지
choice / picks    선택 뽑기 여부와 후보 수
entries           항목 목록: item(아이템) · weight(가중치) · group(묶음, 선택)

없는 아이템 id 를 넣어도 서버가 멈추지 않습니다. 대체 아이템으로 표시하고 로그에 경고만 남깁니다. (같은 id 에 대해 한 번만 남깁니다)

설정을 고칠 때는 서버를 끄거나, 고친 뒤 /상자리로드 를 실행해 주세요. 서버가 켜진 상태에서 파일만 고치면 /상자만들기 같은 명령이 덮어쓸 수 있습니다.

주의: Modrinth App (https://modrinth.com/) 을 기준으로 설명합니다.

서버에만 설치하는 경우 (권장)

1. 서버의 mods 폴더에 제공받은 .jar 파일을 넣습니다.
2. 서버를 실행하면 적용이 완료됩니다.
3. 접속하는 인원은 아무것도 설치하지 않아도 이용할 수 있습니다.

전용 편집·미리보기 화면까지 사용하는 경우

1. 모드를 적용할 인스턴스로 이동합니다.
2. 우측 상단의 세로 점 3개를 클릭합니다.
3. [폴더 열기]를 누른 후 mods 폴더로 이동합니다.
4. 제공받은 .jar 형식의 파일을 넣습니다.
5. 서버의 mods 폴더에도 동일한 파일을 넣습니다.
6. Modrinth App으로 돌아와 인스턴스를 실행하면 적용이 완료됩니다.
7. 설치하지 않은 인원은 상자 창과 명령어로 이용하게 되며, 문제없이 함께 플레이할 수 있습니다.

이 모드는 플레이어별 기록을 저장하지 않습니다. world 폴더에 파일을 만들지 않습니다. 설정 파일은 저장 실패에 대비해 .bak 백업을 함께 만듭니다.

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• 상자 아이템은 표시가 붙은 일반 아이템입니다. 상자를 설정에서 지워도 이미 나눠 준 아이템은 남아 있으며, 열면 "없어진 상자입니다" 라고 알립니다.
• 가중치는 0보다 커야 합니다. 0 이하를 적으면 1로 고쳐 읽습니다. (절대 나오지 않는 항목은 넣지 않은 것과 같은데 목록에는 보여 혼란을 줍니다)
• 한 번에 너무 많이 뽑도록 설정하면 인벤토리가 넘칠 수 있습니다. 넘친 아이템은 잃지 않지만, maxRolls 로 상한을 두는 것을 권장합니다.
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.