한글 상점

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

둘 다 같은 상품·같은 가격·같은 한도를 씁니다. 설치하지 않은 인원도 그대로 이용할 수 있습니다.

한 서버에 설치한 인원과 설치하지 않은 인원이 섞여 있어도 괜찮습니다.

전용 화면에 다른 모드는 필요하지 않습니다. 서버에 넣는 것과 똑같은 파일 하나를 클라이언트에도 넣으면 됩니다.

상품을 넣고 빼고 값을 바꾸는 일을 접속한 채로 할 수 있습니다. 고치는 즉시 저장되고, 상점을 열어 두고 있던 인원의 화면도 그 자리에서 바뀝니다. 서버를 껐다 켜지 않아도 됩니다.

이 명령어는 서버에만 설치해도 전부 사용할 수 있습니다.

아이템은 손에 들고 지정합니다. 아이템 id 를 외우거나 입력할 필요가 없고, 이름이 붙어 있거나 특수 효과가 붙은 아이템도 들고 있는 모습 그대로 등록됩니다.

분류는 번호로 고릅니다. /상점편집 을 입력하면 번호가 붙은 분류 목록이 나오고, <kbd>Tab</kbd> 키를 누르면 번호와 함께 분류 이름이 제안됩니다. (마인크래프트 채팅창은 한글 입력을 지원하지 않기 때문에, 분류 이름을 직접 입력하지 않아도 되도록 번호 방식으로 만들었습니다)

/상점편집                                          쓰는 법과 분류 목록을 봅니다
/상점편집 추가 <분류번호> <구매가> [판매가] [한도]     손에 든 아이템을 넣습니다
/상점편집 가격 <분류번호> <구매가> [판매가] [한도]     손에 든 아이템의 값을 고칩니다
/상점편집 삭제 <분류번호>                            손에 든 아이템을 뺍니다
/상점편집 순서 <분류번호> <위|아래>                   진열 순서를 한 칸 옮깁니다
/상점편집 분류추가 <이름>
/상점편집 분류삭제 <분류번호>
/상점편집 분류이름 <분류번호> <새이름>
/상점편집 분류순서 <분류번호> <위|아래>

판매가를 안 적으면     구매가 × defaultSellPercent (기본 50%) 로 자동 계산합니다
'가격' 에서 한도를     지금 한도를 그대로 둡니다. 한도를 풀려면 0 을 적습니다
  안 적으면

분류를 지우면 그 안의 상품도 함께 사라집니다. 명령어는 몇 개가 사라졌는지 알려 주고, 편집 화면은 한 번 더 확인을 받습니다. 마지막 분류 하나는 지워지지 않습니다. (분류가 0개가 되면 상점이 통째로 비어 버리기 때문입니다)

한글 이름이 필요할 때는 서버 콘솔에서 입력하거나 설정 파일에 적고 /상점리로드 하세요. 마인크래프트는 한글 입력기(IME)를 지원하지 않아 게임 안의 채팅창과 입력칸에서는 한글을 입력할 수 없습니다. (한글 입력을 지원하는 클라이언트 모드를 함께 쓰면 게임 안에서도 입력할 수 있습니다)

클라이언트에도 모드를 넣은 OP 는 /상점 화면 위쪽의 ✎ 편집 단추로 마우스만으로 상품표를 고칠 수 있습니다.

• 상품 카드를 누르면 구매가 · 판매가 · 하루 한도 입력칸과 저장 · 삭제 · 순서 옮기기(◀ ▶) 가 나옵니다.
• 상품 목록 맨 끝의 + 손에 든 것 으로 지금 들고 있는 아이템을 바로 넣습니다.
• 왼쪽 분류 목록 맨 끝의 + 분류, 그리고 분류마다 붙은 ✎(이름·순서)와 ✕(삭제).
• 삭제는 한 번 더 확인을 받습니다. 분류를 지울 때는 몇 개가 사라지는지 알려 줍니다.
• 편집 중에는 상품이 설정 파일에 적힌 순서 그대로 나열되어, 순서를 옮기는 것이 눈에 그대로 보입니다. (평소에는 가격이 싼 순서로 정렬됩니다)

편집 단추는 OP 에게만 보이고, 권한은 서버가 다시 확인합니다. 클라이언트를 조작해 편집 요청을 보내더라도 서버가 거부하고 로그에 남깁니다.

편집 화면은 덤입니다. 위의 명령어만으로 상품표를 처음부터 끝까지 짤 수 있으므로 서버에만 설치한 경우에도 불편함이 없습니다.

• 상품과 가격을 전부 직접 정합니다. 분류·아이템·구매가·판매가·하루 한도를 설정 파일에서, 또는 게임 안에서 명령어·편집 화면으로 자유롭게 짤 수 있습니다.
• 분류와 쪽 넘기기를 제공하여 상품이 수백 개여도 정리되어 보입니다.
• 하루 구매 한도를 상품마다 걸 수 있습니다. (귀한 아이템이 하루에 무한정 풀리는 것을 막습니다)
• 되팔기를 껐다 켤 수 있습니다. 끄면 사기만 됩니다. (기본값은 꺼짐)
• 되팔기로 돈이 늘어나는 것을 자동으로 막습니다. 판매가가 구매가의 일정 비율을 넘으면 그 선까지 낮춰서 적용하고 서버 로그에 경고합니다.
• 한 번에 살 개수를 화면에서 1·8·16·32·64 로 바꿀 수 있습니다. (개수 목록도 설정 가능) (상자 창과 전용 화면이 같은 값을 씁니다)
• 서버에 없는 아이템은 자동으로 감춥니다. 설정 파일에서 지우지는 않으므로, 해당 모드를 다시 넣으면 상품이 그대로 돌아옵니다.
• 인벤토리가 가득 찼을 때 구매한 아이템을 잃지 않습니다. (우편함 모드가 함께 있으면 우편으로 갑니다)
• 자체 화폐를 제공하므로 별도 경제 모드가 필요 없습니다.

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

처음에는 바닐라 아이템으로 된 본보기 상품 14종이 들어 있습니다. 이것을 지우고 서버의 상품으로 바꿔 주세요.

config/pang_koreanshop.json

enabled                    상점 사용 여부
sellEnabled                되팔기 허용 여부 (기본 false)
defaultSellPercent         판매가를 안 적은 상품의 판매가 (구매가 대비 %)
maxSellPercent             판매가 상한 (구매가 대비 %)   아래 주의사항 참고
maxQuantity                한 번에 사고팔 수 있는 최대 개수
maxCategoryNameLength      분류 이름의 최대 글자 수 (기본 20)
quantityPresets            화면의 '수량' 단추가 돌아가는 값 목록
hideCobbleDollarsMerchant  CobbleDollars 상인 NPC 를 치울지 (기본 false)
skin                       상자 화면에 쓰는 아이템 id
categories                  상품 목록

상품은 이렇게 적습니다.

"categories": [
  {
    "name": "재료",
    "items": [
      { "id": "minecraft:iron_ingot", "buy": 120, "sell": 40 },
      { "id": "minecraft:diamond",    "buy": 1500, "sell": 500, "daily": 8 }
    ]
  }
]

id      아이템 id (다른 모드의 아이템도 됩니다)
buy     구매가.  0 이면 살 수 없습니다 (팔기 전용 상품)
sell    판매가.  0 이면 팔 수 없습니다. 안 적으면 defaultSellPercent 로 자동 계산
daily   하루 구매 한도. 없거나 0 이면 무제한 (구매에만 적용됩니다)

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. /상점 을 입력하면 전용 상점 화면이 열립니다.
8. 설치하지 않은 인원은 상자 창으로 이용하게 되며, 문제없이 함께 플레이할 수 있습니다.

전용 상점 화면에서 할 수 있는 것

• 왼쪽 분류 목록에서 분류를 고르고, 오른쪽 위 칸에서 이름으로 검색합니다.
• 상품이 카드로 늘어서고, 살 수 없는 상품은 이유가 함께 표시됩니다. (금액 부족 · 오늘 마감 · 팔 아이템 없음)
• 카드를 누르면 상세 화면이 열려 설명·보유 수량·총 가격을 확인하고, 수량을 조절한 뒤 구매·판매합니다. 아래에 내 인벤토리가 함께 보입니다.
• 위쪽 구매 / 판매 토글로 방향을 바꿉니다. (되팔기가 꺼져 있으면 판매는 비어 있습니다)
• 사고팔면 화면 왼쪽 위에 획득·판매 알림이 뜹니다.
• OP 라면 위쪽 ✎ 편집 단추로 상품표를 그 자리에서 고칠 수 있습니다.

모든 파일은 저장 실패에 대비해 .bak 백업을 함께 만듭니다.

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• 되팔기를 켤 때는 반드시 확인해 주세요. 판매가가 구매가보다 같거나 높은 상품이 하나라도 있으면, 사서 되파는 것만으로 재화가 무한히 늘어납니다. 이 모드는 maxSellPercent 로 자동으로 막고 경고를 남기지만, 그 값을 100 이상으로 올리면 막히지 않습니다.
• 상점 상품 목록은 곧 서버의 경제입니다. /상점편집 을 포함한 관리 명령과 편집 화면은 OP 에게만 열려 있으며, 편집 요청이 올 때마다 서버가 권한을 다시 확인합니다.
• 마인크래프트는 한글 입력기(IME)를 지원하지 않습니다. 게임 안의 채팅창·입력칸에서 한글을 입력할 수 없으므로, 한글 분류 이름은 서버 콘솔이나 설정 파일에서 지정해 주세요.
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.