포켓몬 훈련

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

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

원하면 클라이언트에도 넣을 수 있습니다. 그러면 포켓몬 3D 모델이 보이는 전용 훈련 화면, 격자로 보는 전용 관리 화면, 포켓볼 아이템의 카드 툴팁이 뜹니다.

넣은 사람과 안 넣은 사람이 같은 서버에서 함께 플레이할 수 있습니다. 안 넣은 사람은 상자 창으로 보이고, 되는 일은 똑같습니다.

훈련

• 넣어 두면 자랍니다. 파티에서 고른 포켓몬을 훈련 칸에 넣으면 정해진 간격마다 포켓몬 경험치가 들어갑니다.
• 레벨에 상관없이 속도가 같습니다. 고정된 값을 주는 것이 아니라 "그 포켓몬이 다음 레벨까지 필요한 양의 몇 %" 를 줍니다. 그래서 1레벨에 걸리는 시간이 어느 레벨에서나 같습니다. (고정값으로 주면 레벨이 높을수록 몇십 배 느려집니다)
• 이용 시간을 씁니다. 훈련이 돌아간 만큼 시간이 줄고, 이용권으로 충전합니다. "켜 두면 무조건 이득" 이 아니라 언제 켤지를 고르게 됩니다.
• 시간이 떨어져도 칸은 풀리지 않습니다. 충전하면 그대로 이어집니다.
• 쌓아 둔 진행이 사라지지 않습니다. 59초까지 채우고 멈춰도 그 59초는 남아, 충전하면 1초만 더 하면 받습니다. 껐다 켜거나 뺐다 넣어서 더 빨리 받을 수는 없습니다.
• 기절한 포켓몬은 넣을 수 없고, 같은 포켓몬을 두 번 넣을 수도 없습니다.
• 트레이너 경험치는 오르지 않습니다. 방치로 성장하는 길을 열지 않기 위해서입니다.
• 이용권은 길이를 자유롭게 정합니다. 5분권·1시간권을 따로 만들 수 있고, 충전하면 그 이용권에 적힌 만큼 늘어납니다.

포획 규칙

• 몬스터볼을 전투 중에만 쓰게 합니다. 저레벨이 고레벨 야생에게 전투 없이 볼만 계속 던져 잡는 길을 막습니다. (포획 확률은 체력·상태이상으로 정해지는데, 전투를 건너뛰면 볼 개수만이 난이도가 됩니다)
• 튕길 때는 안내와 소리가 함께 납니다. (도배되지 않도록 간격을 둡니다)
• 설정 한 줄로 끌 수 있습니다.

그 밖

• /pb: 파티의 포켓몬을 그 포켓몬이 들어 있던 볼 아이템으로 만듭니다. 우클릭하면 되돌아오고, 아이템이라 남에게 건네줄 수 있습니다. (마지막 한 마리는 만들 수 없게 막습니다)
• /볼갈이: 잡힌 포켓볼을 손에 든 볼로 바꿉니다. 손에 든 볼 1개를 씁니다.
• /지닌도구: Cobblemon 은 PC 화면에서 도구를 뺄 수단을 주지 않습니다. 상자 화면에서 누르면 가방으로 돌아옵니다.
• /포켓몬회복: 파티 전체의 체력·PP·상태이상을 되돌립니다. (이미 건강하면 "회복할 것이 없었습니다" 라고 알려 줍니다)

관리자 기능

• 남의 인벤토리와 파티를 상자 창으로 봅니다. 접속 중이 아니어도 볼 수 있습니다.
• 칸을 눌러 가져오거나 비우고, 손에 든 아이템을 그대로 넣어 줄 수 있습니다.
• 포켓몬의 레벨·개체값·이로치를 바꾸고, 파티를 회복하고, 삭제할 수 있습니다. (포켓몬은 접속 중이 아니어도 고칠 수 있습니다)
• 삭제는 두 번 확인합니다. 명령어는 뒤에 확인 을 붙여야 실행됩니다.
• 모든 조작이 서버 로그에 남습니다. (누가 누구에게 무엇을 했는지)
• 인벤토리는 접속 중일 때만 고칠 수 있습니다. 저장 파일을 고치는 사이에 그 사람이 접속하면 조작이 조용히 사라지기 때문입니다. (왜 안 되는지 알려 줍니다)

공통

• 인벤토리가 가득 차도 아이템을 잃지 않습니다. 우편 기능이 있으면 우편으로, 없으면 바닥으로 보내고 반드시 안내합니다.
• 상자 창에서 아이템을 꺼낼 수 없습니다. 모든 클릭이 차단되어 있습니다.

/훈련권지급 플레이어이름 60 3      (1시간짜리 이용권 3장)
(플레이어)  /훈련  →  [충전하기]  →  [＋ 파티에서 넣기]  →  포켓몬 클릭

설치하면 바로 쓸 수 있습니다. 설정 파일은 서버를 한 번 켜면 자동으로 만들어집니다.

config/pang_pokemon.json

훈련

maxPerPlayer       한 사람이 쓸 수 있는 훈련 칸 수 (기본 6)
trainIntervalSec   경험치를 주는 간격(초) (기본 60)
trainXpRatio        다음 레벨까지 필요한 양의 몇 %를 주는가 (기본 0.05)
                     0.05 = 20회면 1레벨. 올리면 모든 레벨이 함께 빨라집니다
trainBaseXp        한 번에 주는 경험치의 하한 (기본 40)
                     저레벨은 필요량이 작아 비율만 쓰면 몇 점씩 들어옵니다
trainXpPerLevel    경험치 곡선을 읽지 못했을 때 쓰는 예비 계산식
trainMaxLevel      이 레벨을 넘으면 훈련으로 더 오르지 않습니다 (0 = 제한 없음)
requireOnline      접속 중일 때만 자랍니다 (기본 true)
                      끄면 "게임을 안 켜는 것이 최적" 이 됩니다

이용권

couponItem             이용권으로 쓸 아이템 id (기본 minecraft:clock)
couponCustomModelData  커스텀 텍스처 번호 (0 이면 쓰지 않습니다)
couponDefaultMinutes   기본 이용권 길이(분) (기본 5)
couponMaxMinutes       한 장에 담을 수 있는 최대 분 (기본 10080 = 7일)

포획 규칙

requireBattleToCatch   전투 중에만 몬스터볼이 통합니다 (기본 true)
catchTellCooldownMs    같은 사람에게 안내를 다시 내기까지의 간격 (기본 3000)
catchDenySound         거절 소리 (비워 두면 소리가 나지 않습니다)
catchDenyPitch         거절 소리의 높낮이 (기본 0.5)

그 밖

healSound          회복 소리 (비워 두면 무음)
pbEnabled          /pb 를 켤지 (기본 true)
pbKeepLast         마지막 한 마리는 아이템으로 못 만들게 (기본 true)
pbFallbackBall     잡힌 볼을 읽지 못했을 때 쓸 아이템
ballSwapConsume    볼갈이가 손에 든 볼을 소모할지 (기본 true)
adminGiveMax       관리자가 한 번에 줄 수 있는 최대 개수 (기본 6400)
icons              상자 화면 단추에 쓰는 아이템 id 19종

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

전용 화면에서 더 되는 것

• /훈련 - 포켓몬 3D 모델이 보이고, 파티에서 끌어다 칸에 놓습니다. 경험치 막대가 1초마다 차오르고, 다음에 들어올 몫이 미리 보입니다.
• /플레이어관리 - 사람 목록 · 검색이 생기고, 인벤토리 41칸을 격자로 봅니다. 레벨 · 개체값을 입력창으로 고칩니다. (상자 창에서는 명령어로 합니다)
• 포켓볼 아이템(/pb) 에 마우스를 올리면 그 포켓몬의 카드 툴팁이 뜹니다. (종족 · 레벨 · 능력치 · 기술 · 성격 · 특성)

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

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• Cobblemon 이 없으면 모드가 로드되지 않습니다.
• 훈련은 파티의 포켓몬만 대상으로 합니다. PC 에 맡긴 포켓몬은 넣을 수 없습니다. (PC 까지 넣을 수 있으면 박스 전체를 넣는 것이 최적이 되어 고르는 재미가 사라집니다)
• 훈련 중인 포켓몬을 PC 로 옮기면 그 칸은 남지만 경험치가 들어가지 않습니다.
• 이용권과 볼 아이템은 표시가 붙은 일반 아이템입니다. 겉모습이 헷갈린다면 couponItem 을 바꾸거나, 리소스팩을 쓰는 경우 couponCustomModelData 로 그림을 따로 지정할 수 있습니다.
• requireOnline 을 끄면 접속하지 않아도 포켓몬이 자랍니다. 서버 성격에 맞게 정해 주세요.
• 관리자 기능은 되돌릴 수 없습니다. 삭제는 두 번 확인하지만, 실행된 뒤에는 서버 로그 외에 복구 수단이 없습니다.
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.