포켓몬 뽑기

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

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

클라이언트에도 넣으면 전용 화면이 더 뜹니다. 카드가 흘러가다 멈추는 뽑기 연출, 결과를 가렸다가 하나씩 여는 쪼이기, 포켓몬이 튀어나오는 캡슐 개봉 연출 입니다.

넣지 않은 인원도 그대로 플레이할 수 있습니다. 상자 창으로 똑같이 뽑힙니다.

플레이어는 명령어를 쓰지 않아도 됩니다. 뽑기권을 우클릭하면 화면이 열립니다.

• 등급이 자동으로 나뉩니다. Cobblemon 의 포켓몬 데이터(전설·환상 표시와 종족값)를 읽어 일반 / 희귀 / 전설 / 환상 으로 분류합니다. 목록을 손으로 관리할 필요가 없습니다. (판정 기준도 설정에서 바꿀 수 있습니다)
• 확률·천장·레벨을 전부 직접 정합니다. 뽑기권을 원하는 만큼 만들 수 있고, 뽑기권마다 최고 등급·등급별 확률·레벨·샤이니 확률을 따로 정합니다.
• 천장(보장) 기능: 정해진 횟수를 채우면 지정한 등급이 확정으로 나옵니다. 뽑기권마다 따로 셉니다. (일반 뽑기권으로 모은 횟수로 고급 뽑기권 천장이 터지지 않습니다)
• 여러 번 뽑기 보장: 10회를 한 번에 뽑으면 최소 한 마리는 지정한 등급 이상이 나옵니다.
• 뽑기 전에 확률을 봅니다. 화면에 등급별 확률이 적혀 있고, 등장 포켓몬 을 누르면 어느 포켓몬이 몇 퍼센트로 나오는지 전부 볼 수 있습니다.
• 결과는 캡슐로 들어옵니다. 캡슐을 우클릭하면 포켓몬이 나옵니다. 파티가 꽉 차 있어도 받아 둘 수 있고, 다른 사람에게 줄 수도 있습니다.
• 몬스터볼 연출: 눈앞에 몬스터볼이 떠서 한 바퀴 돌고 늘어섭니다. 안에 든 포켓몬이 잠깐 보이고, 하나를 클릭하면 열립니다. 이 연출도 클라이언트 설치가 필요 없습니다.
• 인벤토리가 가득 차도 아이템을 잃지 않습니다. 우편 기능이 있으면 우편으로, 없으면 바닥으로 보내고 반드시 안내합니다.
• 전용 뽑기 화면 (클라이언트에도 설치한 경우): 카드가 흘러가다 멈추는 연출, 결과를 가렸다가 하나씩 열어 보는 쪼이기, 캡슐 개봉 연출이 더해집니다. 확률·천장·상품은 전부 서버가 보냅니다. 설정을 바꿔도 클라이언트를 다시 나눠 줄 필요가 없습니다.
• 상자 창에서 아이템을 꺼낼 수 없습니다. 모든 클릭이 차단되어 있습니다.
• 전설·환상이 나오면 서버 로그에 남습니다. 확률 관련 문의가 있을 때 근거가 됩니다.

/가챠권지급 플레이어이름 basic 10
(플레이어가 뽑기권을 우클릭)  →  화면에서 [1회 뽑기] 또는 [10회 뽑기]
(캡슐을 우클릭)              →  포켓몬 획득

처음 실행하면 뽑기권 3종(basic 일반 / premium 고급 / ball 몬스터볼)이 자동으로 만들어집니다. 바로 쓸 수 있습니다.

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

config/pang_gacha.json: 뽑기권과 전역 설정

뽑기권 하나(tickets 안)의 값

name              뽑기권 이름 (§ 색 코드 사용 가능)
maxRarity         이 뽑기권으로 나올 수 있는 최고 등급
                   weights 에 적어도 이 등급을 넘으면 나오지 않습니다
weights           등급별 가중치 (COMMON / RARE / LEGENDARY / MYTHICAL)
                   확률(%)이 아닙니다. 합이 100일 필요가 없습니다
pity              몇 번 뽑으면 천장이 터지는지 (0 이면 천장 없음)
pityRarity        천장에서 보장하는 등급
tenPullFloor      여러 번 뽑기에서 최소 한 마리 보장할 등급 (없으면 생략)
level             나오는 포켓몬의 레벨 (1 ~ 100)
shinyChance       샤이니 확률 (0 ~ 1 · 0.002 = 0.2%)
item              뽑기권으로 쓸 아이템 id
customModelData   커스텀 텍스처 번호 (0 이면 쓰지 않습니다)
style             chest = 상자 창과 채팅 · ball = 몬스터볼 연출
ballCount         ball 일 때 띄울 몬스터볼 개수 (2 ~ 8)

전역 설정(config 안)

multiPull              "여러 번 뽑기" 가 한 번에 뽑는 횟수 (기본 10)
logFrom                어느 등급부터 서버 로그에 남길지
rewardTimeoutTicks     연출이 끊겼을 때 보상을 자동 지급하기까지의 시간 (틱)
capsuleItem            캡슐로 쓸 아이템 id
capsuleCustomModelData 캡슐의 커스텀 텍스처 번호 (0 이면 쓰지 않습니다)
defaultTicketItem      뽑기권을 새로 적을 때의 기본 아이템
fallbackItem           없는 아이템 id 를 만났을 때 대신 쓸 아이템
infoItem / pullOneItem / pullManyItem / oddsItem / backItem / lockedItem
                       상자 화면에 쓰는 단추 아이템
rarityIcons            등급별 아이콘 (기본은 몬스터볼 4종)
ball.item              몬스터볼 연출에 쓸 아이템
ball.orbitTicks / settleTicks / previewTicks / waitTicks / revealTicks
                       연출 각 단계의 길이 (20 = 1초)
ball.orbitRadius / distance / spacing / height
                       볼이 도는 반경 · 눈앞 거리 · 간격 · 높이
ball.startSound / settleSound / revealSound
                       연출 소리 (비워 두면 소리가 나지 않습니다)

등급 판정(rarity 안)

rareBst           등급 표시가 없는 포켓몬을 "희귀"로 올리는 종족값 합 (기본 500)
mythicalLabels    이 표시가 붙으면 환상 (기본 mythical)
legendaryLabels   이 표시가 붙으면 전설 (기본 legendary · ultra_beast · paradox)
names             등급 이름 (일반 / 희귀 / 전설 / 환상)
colors            등급 색 (#RRGGBB)

등급의 개수와 순서는 바꿀 수 없습니다. 확률표와 천장이 네 등급을 전제로 동작합니다.

없는 아이템 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. 설치하지 않은 인원은 상자 창으로 이용하게 되며, 문제없이 함께 플레이할 수 있습니다.

파일은 하나입니다. 서버와 클라이언트에 같은 .jar 를 넣습니다. 설치한 사람과 안 한 사람이 같은 서버에서 함께 뽑을 수 있고, 확률·천장·결과는 두 화면이 완전히 같습니다. (화면 모양만 다릅니다)

저장 실패에 대비해 .bak 백업을 함께 만들며, 파일이 손상되면 백업에서 자동으로 되돌립니다.

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• Cobblemon 이 없으면 모드가 로드되지 않습니다.
• 뽑기권과 캡슐은 표시가 붙은 일반 아이템입니다. 뽑기권을 설정에서 지워도 이미 나눠 준 아이템은 남아 있으며, 우클릭하면 "없어진 뽑기권입니다" 라고 알립니다.
• 캡슐은 기본적으로 몬스터볼을 바탕으로 합니다. 겉모습이 헷갈린다면 capsuleItem 을 다른 아이템으로 바꾸거나, 리소스팩을 쓰는 경우 capsuleCustomModelData 로 그림을 따로 지정할 수 있습니다.
• maxRarity 가 최종 판정입니다. weights 에 높은 등급을 적어도 maxRarity 를 넘으면 나오지 않습니다.
• 한 번에 너무 많이 뽑도록 설정하면 인벤토리가 넘칠 수 있습니다. 넘친 캡슐은 잃지 않지만, multiPull 은 10 정도를 권장합니다.
• 전용 화면은 클라이언트에도 설치한 인원에게만 보입니다. 설치하지 않은 인원은 상자 창으로 이용하며, 기능과 확률은 완전히 같습니다.
• 전용 화면의 모양을 바꾸려면 클라이언트 파일도 함께 교체해야 합니다. (확률·천장·뽑기권은 서버 설정만 고치면 됩니다)
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.