우편함

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

기능은 완전히 같습니다. 클라이언트에 설치하지 않은 인원도 그대로 이용할 수 있습니다. 다만 우편 작성 화면(가방을 펼쳐 놓고 여러 개를 한 번에 담는 화면)은 클라이언트에 설치한 사람에게만 뜹니다. 설치하지 않았다면 /우편보내기 로 보냅니다.

• 접속하지 않은 사람에게도 보냅니다. 한 번이라도 서버에 들어온 적이 있으면 됩니다.
• 아이템과 돈을 함께 보낼 수 있습니다.
• 인벤토리가 가득 차도 아이템이 사라지지 않습니다. 못 받은 것은 우편함에 보관되고, 10분 안에 여러 번 넘치면 한 통으로 합쳐집니다.
• 자리가 모자라면 받을 수 있는 만큼만 받고 나머지는 우편에 남습니다. (한 통에 수십 종이 들어와도 영영 못 받는 일이 없습니다)
• 전체발송: 한 벌만 등록해 두면 조건이 맞는 사람이 각자 한 번씩 받습니다. 100명에게 우편을 100통 만들지 않습니다.
• 프리셋: 신규 지급 세트처럼 자주 보내는 묶음을 저장해 두고 반복 발송합니다.
• 관리자 조회: 남의 우편함을 열어 봅니다. 받아갈 수는 없고 회수만 됩니다.
• 접속하면 받을 우편이 있는지 알려 줍니다. (설정에서 끌 수 있습니다)
• 새 우편 · 확인함 · 받음이 색과 아이콘으로 갈립니다. 받을 수 있는 칸은 반짝입니다.
• 창에서는 아무것도 꺼낼 수 없습니다. 첨부를 받는 길은 [첨부 받기] 단추 하나뿐이라 아이템이 새지 않습니다.
• 받지 않은 우편은 지울 수 없습니다. 실수로 보상을 버릴 길을 막아 두었습니다.
• 클라이언트에도 넣으면 전용 화면이 뜹니다. 필터 레일 + 목록 + 상세로 된 우편함과, 가방을 펼쳐 놓고 여러 개를 한 번에 담는 우편 작성 화면입니다. (OP 는 작성 화면에서 서버의 모든 아이템을 검색해 지급할 수 있습니다)

이 모드 하나만 넣어도 우편함은 전부 동작합니다. 아래는 덤입니다.

다른 pang 모드가 준 아이템도 우편으로 갑니다

뽑기 상자·출석 보상·은행 출금은 인벤토리가 가득 차면 바닥에 떨어뜨립니다. 바닥에 떨어진 것은 5분 뒤 사라지고 용암 위에서는 즉시 잃습니다. "받았는데 없다" 가 되는 유일한 경로입니다.

이 모드를 함께 넣으면 그것이 전부 우편함으로 옵니다. 서로 설정할 것은 아무것도 없습니다. 같은 서버에 넣어 두기만 하면 됩니다.

반대로, 이 모드를 빼면 예전처럼 바닥에 떨어집니다. 아이템이 갇히거나 사라지지 않습니다. 우편함이 없는 서버에는 애초에 우편을 쌓아 두지 않습니다.

돈은 /지갑 하나로 이어집니다. 우편으로 받은 돈을 상점·슬롯에서 바로 씁니다.

┌ 우편함 (1/2) ────────────────────────────────┐
│ [우편][우편][우편][우편] …                    │  ← 한 쪽에 45통
│                                              │
│ [◀][ ][모두 수령][ ][현황][ ][도움말][ ][▶]  │
└──────────────────────────────────────────────┘
             ↓ 우편을 누르면
┌ 우편 (상세) ───────────────────────────────┐
│ [첨부][첨부][첨부] …                        │  ← 들어 있는 아이템
│                                            │
│ [◀뒤로][첨부 받기][정보][목록에서 지우기]    │
└────────────────────────────────────────────┘

• 칸에 찍힌 숫자가 첨부 종류 수입니다. 격자만 봐도 알맹이가 있는지 보입니다.
• 마우스를 올리면 보낸 이 · 내용 · 도착 시각 · 남은 기한이 그대로 나옵니다.
• 받지 않은 우편이 항상 위에 옵니다.

storageDays 를 짧게 줄이지 마세요. 며칠 못 들어온 사람이 보상을 통째로 잃는 유일한 경로입니다. 0 으로 두면 무기한입니다.

서버를 한 번 실행하면 config/pang_mailbox.json 이 자동으로 생성됩니다.

storageDays           받지 않은 우편이 사라지기까지의 일수 (0이면 무기한 · 기본 30)
claimedDays           받은 우편이 목록에 남는 일수          (기본 7)
maxPerPlayer          한 사람의 우편 수 상한               (기본 120)
notifyOnJoin          접속했을 때 받을 우편을 알릴지         (기본 true)
overflowMergeMinutes  넘친 아이템을 한 통에 합치는 시간(분)  (기본 10 · 0이면 매번 새 통)
queueDrainSeconds      다른 모드가 넘긴 것을 옮기는 간격(초) (기본 20 · 0이면 접속·기동 때만)
defaultSender         보낸 이를 안 적은 우편에 쓸 이름       (기본 "서버")
playerSend            플레이어끼리 보낼 수 있는지            (기본 true)
sendFee               플레이어 1회 발송 비용                (기본 1000 · 0이면 공짜)
sendCooldownSeconds   연달아 보내기 최소 간격(초)           (기본 30)
allowSelfSend         자기 자신에게 보낼 수 있는지           (기본 false)
maxSendMoney          한 통에 실을 수 있는 돈의 상한         (기본 1000000 · 0이면 무제한)
skin.*                화면에 쓰는 아이템 id (아래)

화면 아이템을 바꿀 수 있습니다. skin 안에서

new        새 우편          (기본 writable_book)
viewed     확인한 우편       (기본 book)
claimed    받은 우편         (기본 gray_stained_glass_pane)
notice     공용 우편         (기본 knowledge_book)
broken     읽지 못한 아이템   (기본 barrier)
claim      첨부 받기 단추     (기본 chest)
claimAll   모두 수령 단추     (기본 ender_chest)
delete     지우기 단추       (기본 lava_bucket)
revoke     회수 단추         (기본 hopper)
back/prev/next   이동 단추   (기본 arrow)
info/help  안내 칸          (기본 paper / oak_sign)
filler     빈자리를 메우는 판 (기본 black_stained_glass_pane · 비우면 빈 칸)

(없는 아이템 id 를 적으면 종이로 대신합니다. 서버가 죽지 않습니다)

설정을 고친 뒤에는 /우편관리 리로드 로 다시 읽습니다. 화폐 이름은 config/pang_wallet.json 의 name 으로 바꿉니다 (기본값 코인).

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

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

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

전용 화면(우편 작성 포함)까지 사용하는 경우

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

우편함을 연 뒤 우측 위 [우편 쓰기] 를 누르면 작성 화면이 열립니다. 받는 사람 칸에는 영문 계정 이름을 적습니다. 마인크래프트 입력칸에는 한글을 칠 수 없기 때문입니다. 한글 닉네임으로 보내려면 /우편보내기 를 쓰세요.

모든 파일은 저장 직전에 .bak 을 남기고 한 번에 교체합니다. 저장 도중에 서버가 죽어도 내용이 잘리지 않습니다.

설치만 하면 자동으로 이어집니다. 설정할 것이 없습니다. 없으면 이 모드가 자기 잔고(world/pang_wallet/balances.json)를 씁니다. 그것만으로도 문제없이 돌아갑니다.

저희 pang_ 모드를 여러 개 쓰신다면 돈은 하나로 이어집니다. 상점에서 쓴 돈, 슬롯에서 딴 돈, 은행에 넣은 돈이 같은 지갑입니다.

• world/pang_mailbox/*.json 을 고치려면 서버를 끄세요. 켜 있는 동안 고치면 메모리 내용으로 덮어씁니다.
• 한 번도 서버에 들어온 적 없는 사람에게는 보낼 수 없습니다. 이름 조회에 외부 통신을 하지 않기 때문입니다 (하면 명령 한 줄에 서버 전체가 멈춥니다).
• 모드를 뺀 채로 그 모드의 아이템이 든 우편을 열면 붉게 표시되고 수령이 막힙니다. 파일에서 지우지는 않으므로, 모드를 다시 넣으면 그대로 받을 수 있습니다.
• 관리자 회수는 되돌릴 수 없습니다. 아이템은 아무에게도 가지 않고 로그에 남습니다.
• 전체발송을 회수해도 이미 받은 사람의 아이템은 그대로입니다.