트레이너 레벨

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

새 아이템도, 새 블록도 추가하지 않습니다. 클라이언트에 이 모드가 없어도 접속이 끊기지 않습니다.

원하신다면 클라이언트에도 같은 파일을 넣을 수 있습니다. 그러면 전용 트레이너 카드 화면과 경험치 막대가 함께 뜹니다. 넣지 않은 인원은 상자 창으로 이용하게 되며, 한 서버에서 섞여 있어도 아무 문제가 없습니다. (아래 「적용 방법」 참고)

• 경험치가 네 곳에서 들어옵니다. 야생 포켓몬 처치 · 포획 · 트레이너(NPC) 전투 승리 · 레이드 클리어. 원천마다 값어치를 따로 정할 수 있고, 상대의 레벨과 등급(일반/희귀/전설/환상)에 따라 달라집니다.
• 레벨이 오르면 세 가지가 좋아집니다. 재화 추가 획득 · 포켓볼 포획 확률 · 레이드 포획 확률. 1레벨에서 0, 만렙에서 최대치까지 고르게 오릅니다.
• 칭호가 붙습니다. 레벨 구간마다 칭호가 바뀌고, 바뀌는 순간 서버 전체에 알립니다. (칭호 이름과 구간은 전부 직접 정합니다)
• 레벨 차이 패널티: 내 파티가 상대보다 지나치게 강하면 야생 처치·포획 경험치를 깎습니다. 없으면 만렙 파티로 약한 야생을 무한 반복하는 것이 최고 효율이 되어 버립니다. 깎였으면 알림에 그대로 적습니다. 조용히 깎으면 "버그인가" 하게 됩니다. (트레이너전·레이드·처음 잡는 종에는 걸지 않습니다. 상대를 고를 수 없거나, 도감 수집을 벌하게 되기 때문입니다)
• 레벨 보상: 정해진 레벨에 닿으면 아이템을 받을 수 있습니다. 손에 든 아이템을 그대로 등록하므로 이름·인챈트·NBT 가 붙은 아이템도 그대로 나옵니다. 자동으로 주지 않습니다. 알리기만 하고, 받는 것은 플레이어가 직접 합니다.
• 인벤토리가 가득 차도 아이템을 잃지 않습니다. 우편 기능이 있으면 우편으로, 없으면 바닥으로 보내고 반드시 안내합니다. 못 받았으면 수령 처리하지 않아 나중에 다시 받습니다.
• 경험치가 어디서 왔는지 실측합니다. /트레이너정보 가 원천별 비중을 %로 보여줍니다. "우리 서버는 트레이너전이 너무 세네" 를 짐작이 아니라 숫자로 볼 수 있습니다.
• 상자 창에서 아이템을 꺼낼 수 없습니다. 모든 클릭이 차단되어 있습니다.

이 모드는 플레이어의 레벨을 world/pang_level/levels.json 에 내놓습니다. 같은 제작자의 다른 모드가 그 파일을 읽어 레벨 조건을 걸 수 있습니다.

 슬롯머신 (pang_slot)   →  "트레이너 레벨 20부터 이용할 수 있습니다"
 개인 집 (pang_home)    →  레벨 20 · 35 에 집 자리가 하나씩 열립니다

모드를 따로 받아야 하는 것이 아닙니다. 각 모드는 혼자서도 완전히 동작하고, 이 모드가 함께 있을 때만 레벨 조건이 살아납니다. 이 모드가 없으면 그 조건들은 통째로 건너뜁니다. 설정에 레벨 제한을 적어 두었더라도 아무도 막히지 않습니다. (레벨을 알 수 없을 때 막아 버리면 "아무도 못 들어가는" 상태가 되기 때문입니다)

레벨이 바뀌면 다른 모드에는 약 2초 안에 반영됩니다.

(포켓몬을 잡거나 쓰러뜨린다)  →  채팅에 [레벨 업] 이 뜬다
/트레이너                     →  상자 창으로 레벨·특전·기록·파티를 본다
[성장 단계]                   →  어느 레벨에 무엇이 열리는지, 보상은 무엇인지
/레벨보상                     →  받을 수 있는 보상을 전부 받는다

설정 없이 켜자마자 동작합니다. 레벨 보상만 비어 있으므로, 주고 싶은 아이템을 손에 들고 /레벨보상추가 <레벨> 로 채우면 됩니다.

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

config/pang_trainerlevel.json

레벨 곡선

maxLevel          최고 레벨 (기본 50)
curve.base        다음 레벨까지 필요한 경험치 = base × (현재레벨 ^ exponent)
curve.exponent     0.1만 바꿔도 만렙 도달 시간이 수십 시간 움직입니다

경험치 (xp 안): wildKill / capture / trainerWin / raidClear

base              상대 포켓몬 '한 마리당' 기본값
                   전투 1회당이 아닙니다. 6마리를 끌고 나오는 트레이너는 6번 받습니다
perLevel          상대 레벨 1당 더해지는 값
rare / legendary / mythical    등급별 배율

newSpeciesMultiplier   처음 잡아 보는 종의 포획 경험치 배율 (기본 2배)
wildMoneyPerLevel      야생 수입 하한 (기본 0 = 끔): 아래 설명

wildMoneyPerLevel 은 기본이 0(꺼짐)입니다. 0보다 크게 하면 야생 전투의 수입이 진 야생 포켓몬 레벨 합 × 이 값 밑으로 내려가지 않도록 모자란 만큼 채워 줍니다.

켜면 돈이 새로 생깁니다. 쓰는 화폐 모드의 지급 공식이 야생에 지나치게 인색할 때만 켜 주세요. (예: 지급액이 마릿수와 레벨의 제곱에 비례해 저레벨 야생이 몇 코인밖에 안 되는 경우)

특전 (perks 안)

maxMoneyBonus       만렙에서의 재화 추가 획득 (기본 0.5 = +50%)
maxCatchBonus       만렙에서의 포켓볼 포획 확률 (기본 0.125 = +12.5%)
maxRaidCatchBonus   만렙에서의 레이드 포획 확률 (기본 0.15 = +15%)

세 값을 함께 보세요. 하나만 올리면 특전 사이 균형이 깨집니다.

재화 추가 획득은 "전투로 실제로 들어온 돈"에 비율로 붙습니다. 금액을 지어내지 않으므로, 전투로 돈을 주는 모드가 하나도 없는 서버에서는 아무 일도 하지 않습니다.

레벨 차이 패널티 (levelGap 안)

enabled           끄려면 false
tolerance         이 레벨 차이까지는 깎지 않습니다 (기본 15)
decayPerLevel     그 위로 1레벨마다 깎는 비율 (기본 0.03 = 3%)
floor             아무리 차이가 나도 이 배율 밑으로는 안 내려갑니다 (기본 0.15)

등급 판정 (rarity 안)

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

칭호 (titles 안): "레벨": "칭호" 형식이며 개수 제한이 없습니다. 해당 레벨 이하 중 가장 큰 값이 그 레벨의 칭호가 됩니다.

화면 아이템 (items 안): 상자 창에 쓰는 아이콘 14종입니다.

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

값이 범위를 벗어나도 멈추지 않습니다. 안전한 값으로 되돌리고 경고 한 줄만 남깁니다.

설정을 고칠 때는 서버를 끄거나, 고친 뒤 /트레이너리로드 를 실행해 주세요.

곡선을 바꿔도 이미 오른 레벨은 그대로입니다. 다음 레벨부터 새 곡선을 탑니다.

없어도 레벨은 오르고 카드는 열립니다. 없는 모드는 서버 로그에 한 줄로 알려 드립니다. "cobblemonraiddens 가 없습니다. 레이드 클리어 경험치와 레이드 포획 특전은 꺼 둡니다."

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

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

1. 서버의 mods 폴더에 제공받은 .jar 파일을 넣습니다.
2. 서버를 실행하면 적용이 완료됩니다.
3. 접속하는 인원은 아무것도 설치하지 않아도 이용할 수 있습니다.
4. 트레이너 카드는 바닐라 상자 창으로 열리고, 경험치는 채팅으로 알려 드립니다.

전용 카드 화면과 경험치 막대까지 사용하는 경우

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

설치한 인원에게는 이런 것이 더 보입니다.

• 전용 트레이너 카드: 왼쪽에 프로필(스킨·레벨·경험치 막대·보유 포켓몬 3D), 오른쪽에 특전 · 기록 · 성장 단계 탭
• 포켓몬에 마우스를 올리면 타입·특성·성격·체력·친밀도·개체값·기술이 보입니다
• 경험치 막대: 경험치를 얻을 때마다 화면 아래(핫바 위)에 막대가 차오르고, 레벨이 오르면 LEVEL UP 배너가 뜹니다

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

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• Cobblemon 이 없으면 모드가 로드되지 않습니다.
• PvP 전투는 경험치와 보상에서 제외됩니다. 둘이 번갈아 져 주면 무한히 벌 수 있기 때문입니다.
• 포획으로 끝난 전투는 처치 경험치를 주지 않습니다. 포획 경험치가 따로 나가므로 두 번 주게 됩니다.
• 레벨 보상은 처음에 비어 있습니다. 어떤 아이템이 그 서버에서 값어치가 있는지는 서버마다 다르기 때문입니다. /레벨보상추가 로 채워 주세요.
• 레벨 보상을 등록한 뒤 그 아이템의 모드를 빼면 그 보상만 조용히 빠집니다. 파일에서는 지우지 않으므로 모드를 다시 넣으면 되살아납니다.
• maxLevel 을 낮추면 그보다 높던 플레이어는 새 상한으로 내려갑니다.
• 트레이너 카드는 상자 창이라 열어 둔 동안에는 내용이 갱신되지 않습니다. 보상을 받으면 그 자리에서 다시 그립니다.
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.