Kobase Traders

kobasetraders · 제작 dkosin · 라이선스 MIT

v1.0.2Minecraft 1.20.1 이상 1.21 미만Forge 47.2 이상클라이언트 + 서버

원하는 그대로의 상인: 생명체, 플레이어 스킨, 주민 중 어떤 외형이든, 나만의 거래, 상점 구역, 경로와 영업시간까지 – 모두 게임 안에서 상인 지팡이로 설정합니다.

개요

상인 지팡이로 원하는 곳에 상인을 세우고, 네 개의 탭 – 외형, 거래, 행동, 프리셋 – 이 있는 편집기에서 설정합니다. 오른쪽에서는 3D 미리보기가 회전하며, 모든 변경이 미리보기와 월드의 상인에 바로 반영됩니다.

거래는 Minecraft의 평범한 거래 화면에서 이루어집니다. 지불, Shift 클릭, 가득 찬 인벤토리 모두 주민과 똑같이 동작합니다.

어떤 외형이든

바닐라와 모드의 모든 생명체(검색과 실시간 미리보기, 많은 동물의 색과 변형 포함), 이름이나 UUID로 지정하는 플레이어 스킨, 또는 생물 군계·직업·배지를 갖춘 주민. 크기 0.5~2, 이름과 칭호 줄도 설정할 수 있습니다.

나만의 거래

가격, 두 번째 가격, 상품을 자유롭게 – 개수와 NBT(마법 부여, 이름)까지. 거래마다 재고 또는 무제한, 상인 경험치, 가격 배수, 수요, 특별 가격, 거래 레벨을 정합니다.

재고 보충과 레벨

재고는 보충하지 않음, 매일 정해진 시각, n분마다, 또는 주민식으로 보충됩니다. 원하면 거래가 레벨별로 하나씩 열립니다.

행동

제자리에서 플레이어 바라보기, 집 주변 구역 돌아다니기, 또는 웨이포인트 경로 따라가기(순환 또는 왕복, 대기 시간 포함).

영업시간

시작~종료, 자정을 넘겨도 됩니다. 영업시간 밖에는 "닫힘 · 08:00 개점"을 표시하고, 집으로 가거나 집에 가서 잡니다. 최대 4줄 인사말을 카드, 채팅 또는 둘 다로 표시합니다.

프리셋과 템플릿

나만의 프리셋을 JSON으로 저장·불러오기·공유. 기본 역할 템플릿: 대장장이, 제빵사, 농부, 사서, 지도 제작자, 은행, 보석상, 동물 상인, 떠돌이 상인 믹스, Kobase Shop.

서버에서도 안전

무적에 사라지지 않음(설정 가능), 밀리지 않습니다. 서버가 모든 입력을 검사합니다: 권한, 한도, 아이템·모델 금지 목록, NBT 크기.

이미지

월드의 상인들 – 주민 대장장이, 말, 철 골렘, 플레이어 스킨, 눈 여우, 문 닫은 상인과 자는 상인. 모두 이름과 칭호가 있습니다. — **월드의 상인들** – 주민 대장장이, 말, 철 골렘, 플레이어 스킨, 눈 여우, 문 닫은 상인과 자는 상인. 모두 이름과 칭호가 있습니다.개발 버전의 실제 스크린샷 (게임 언어: 영어)

외형: 주민 – 생물 군계 종류, 직업, 배지. 오른쪽은 이름·칭호·크기가 있는 회전 가능한 3D 미리보기. — **외형: 주민** – 생물 군계 종류, 직업, 배지. 오른쪽은 이름·칭호·크기가 있는 회전 가능한 3D 미리보기.개발 버전의 실제 스크린샷 (게임 언어: 영어)

외형: 생명체 – 모든 생명체(바닐라와 모드) 검색과 준비된 변형, 여기서는 말의 털색과 무늬. — **외형: 생명체** – 모든 생명체(바닐라와 모드) 검색과 준비된 변형, 여기서는 말의 털색과 무늬.개발 버전의 실제 스크린샷 (게임 언어: 영어)

거래 – 가격, 두 번째 가격, 상품, 재고, 경험치, 가격 배수, 수요, 레벨, 구매 시험. 위쪽에 재고 보충과 레벨.개발 버전의 실제 스크린샷 (게임 언어: 영어)

행동 – 고정, 구역 또는 웨이포인트 경로, 집 위치, 영업시간, 인사말과 속성.개발 버전의 실제 스크린샷 (게임 언어: 영어)

프리셋 – 대장장이, 은행, 동물 상인 같은 역할 템플릿과 공유하기 쉬운 JSON 파일 프리셋. — **프리셋** – 대장장이, 은행, 동물 상인 같은 역할 템플릿과 공유하기 쉬운 JSON 파일 프리셋.개발 버전의 실제 스크린샷 (게임 언어: 영어)

Minecraft의 평범한 거래 화면에서 거래하기, 위에는 상인의 인사말 카드. — Minecraft의 평범한 거래 화면에서 **거래하기**, 위에는 상인의 인사말 카드.개발 버전의 실제 스크린샷 (게임 언어: 영어)

영업 종료 – 영업시간이 끝나면 이 상인은 집으로 가서 잠을 잡니다("Zzz"). — **영업 종료** – 영업시간이 끝나면 이 상인은 집으로 가서 잠을 잡니다("Zzz").개발 버전의 실제 스크린샷 (게임 언어: 영어)

조작

입력	효과
상인 지팡이로 블록 우클릭	새 상인을 세우고 편집기 열기 (권한 필요)
지팡이를 들고 `웅크리기` + 상인 우클릭	편집기 열기
상인 우클릭	거래하기
편집기 → 행동 → 경로 → 기록	편집기가 닫히고, 블록을 우클릭하면 웨이포인트 추가, `웅크리기` + 허공 우클릭으로 기록 종료
편집기 → 행동 → 집 지팡이로	다음에 클릭한 블록이 집 위치가 됨
편집기: 적용 / 완료 / 취소	서버로 보내기 / 보내고 닫기 / 버리기

누가 상인을 세우고 편집할 수 있는지는 서버가 정합니다(기본값은 관리자와 크리에이티브 모드 플레이어, 상인을 세운 사람은 언제나 편집 가능). 무적 상인은 편집기나 /kill로만 없앨 수 있습니다.

아이템 및 조합법

조합법

상인 지팡이 – 1× 철 주괴, 2× 막대기철 주괴는 오른쪽 위, 막대기 두 개는 그 아래 대각선으로. — **상인 지팡이** – 1× 철 주괴, 2× 막대기
철 주괴는 오른쪽 위, 막대기 두 개는 그 아래 대각선으로.제작대 · 게임 텍스처로 렌더링

설정

모든 옵션은 게임 안에서 바꿀 수 있습니다: Mods → Kobase Traders → Config (Kobase Core). 서버 옵션은 모든 플레이어에게 적용되고, 클라이언트 옵션은 각자 정합니다. 잠금 가능 표시된 옵션은 서버가 모두에게 고정할 수 있습니다.

옵션	설명	기본값
상인 편집 권한 `permissions.edit` SERVER	관리자: 관리자만. 크리에이티브: 관리자와 크리에이티브 모드 플레이어.	크리에이티브 관리자 / 크리에이티브
소유자 편집 허용 `permissions.allowOwnerEdit` SERVER	상인을 만든 플레이어는 언제나 편집할 수 있습니다.	켬
상인 생성 권한 `permissions.spawn` SERVER	관리자, 크리에이티브(관리자 + 크리에이티브 모드 플레이어) 또는 모두.	크리에이티브 관리자 / 크리에이티브 / 모두
플레이어당 상인 수 `spawn.maxPerPlayer` SERVER	관리자가 아닌 플레이어 한 명이 소유할 수 있는 상인 수(0 = 무제한).	0 범위 0 – 1000
시작 템플릿 `spawn.defaultTemplate` SERVER	새로 만든 상인의 역할 템플릿.	없음 (거래 없음) 없음 (거래 없음) / 대장장이 / 제빵사 / 농부 / 사서 / 지도 제작자 / 은행 / 보석상 / 동물 상인 / 떠돌이 잡화 / Kobase Shop
새 상인 무적 `defaults.invulnerable` SERVER	/kill로만 제거할 수 있습니다.	켬
새 상인 상주 `defaults.persistent` SERVER	절대 사라지지 않습니다.	켬
새 상인 밀림 `defaults.pushable` SERVER	플레이어와 몹이 밀 수 있습니다.	끔
기본 재고 보충 `restock.defaultMode` SERVER	안 함, 매일, 일정 간격 또는 주민처럼(하루 2번).	주민처럼 안 함 / 매일 / 간격 / 주민처럼
보충 간격(분) `restock.defaultMinutes` SERVER	간격 모드에서 재고 보충 사이의 시간(분).	20 범위 1 – 1440
매일 보충 시각 `restock.defaultHour` SERVER	매일 재고 보충의 게임 내 시각(6 = 해돋이).	6 범위 0 – 23
최대 거래 수 `limits.maxTrades` SERVER	상인 하나당 최대 거래 수.	32 범위 1 – 128
최대 NBT 크기 `limits.maxNbtBytes` SERVER	거래 아이템이나 모델 변형의 최대 NBT 크기(바이트).	8192 범위 256 – 262144
최대 경유지 수 `limits.maxWaypoints` SERVER	경로 하나의 최대 경유지 수.	32 범위 1 – 256
최대 구역 반경 `limits.maxRadius` SERVER	상점 구역의 최대 반경(블록).	32 범위 1 – 128
최대 경로 거리 `limits.maxRouteDistance` SERVER	거점에서 경유지까지의 최대 거리.	128 범위 8 – 1024
금지 아이템 `limits.itemDeny` SERVER	판매할 수 없는 아이템(ID 또는 #tags).	minecraft:command_block, minecraft:chain_command_block, minecraft:repeating_command_block, minecraft:command_block_minecart, minecraft:structure_block, minecraft:structure_void, minecraft:jigsaw, minecraft:barrier, minecraft:light, minecraft:debug_stick, minecraft:spawner, minecraft:knowledge_book, minecraft:bedrock
금지 모델 `limits.appearanceDeny` SERVER	상인 모델로 쓸 수 없는 개체 유형(또는 modid:*).	minecraft:ender_dragon
관리자는 금지 목록 무시 `limits.opsBypassDeny` SERVER	관리자는 금지된 아이템과 모델을 사용할 수 있습니다.	켬
생성 알 허용 `limits.allowSpawnEggs` SERVER	관리자가 아닌 편집자도 생성 알을 판매할 수 있습니다.	끔
칭호 표시 `display.showTitles` CLIENT잠금 가능	상인 이름 위에 칭호 줄을 표시합니다.	켬
'영업 종료' 푯말 표시 `display.showClosedSign` CLIENT잠금 가능	영업시간이 아닌 상인 위에 표시합니다.	켬
인사말 카드 `display.greetingCard` CLIENT잠금 가능	거래 화면 위에 인사말을 표시합니다.	켬
이름 표시 거리 `display.nameRange` CLIENT잠금 가능	상인 이름이 표시되는 거리.	24 범위 4 – 64
미리보기 회전 `editor.autoRotate` CLIENT	편집기에서 모델을 천천히 회전합니다.	켬

호환성

Minecraft	1.20.1
모드 로더	Forge 47.2 이상
Kobase Core	모드 jar에 포함됨(1.0.2 이상 2.0.0 미만) – 따로 설치할 필요 없음
설치	서버와 모든 클라이언트에 설치 (양쪽 모두 같은 jar, Kobase Core 내장).
모드팩	CJ_SimpleMod · Modpack D+J

다른 모드용: API(de.kobase.traders.api.TraderApi)로 코드나 JSON에서 상인을 만들고 설정하며 편집기를 열 수 있습니다. TraderClientApi는 편집기를 디자인 대화상자로 제공합니다. Kobase Traders는 선택적 의존성으로 남습니다.

버전

v1.0.0 첫 출시: 외형이 자유로운 상인, 직접 만드는 거래, 재고 보충, 레벨, 구역, 경로, 영업시간, 프리셋과 역할 템플릿, Kobase Core 설정, 12개 언어.
v1.0.1 번역: 모드와 설정의 모든 텍스트를 13개 언어로 제공, Kobase Core 1.0.3 포함.
v1.0.2 설정: 누락된 툴팁과 이름을 모든 언어에 추가.