BuzzBuild-NpcDialog — 설치

서버 플러그인과 클라이언트 모드를 함께 설치합니다. 버전은 지원 환경을 기준으로 맞춥니다.

설치 파일과 위치

0.1.0 배포본의 설치 위치입니다. 경로는 서버 또는 게임 인스턴스 기준 상대 경로입니다.

대상	파일	위치
서버	BuzzBuild-NpcDialog-Paper-0.1.0.jar	plugins/
서버	BuzzBuild-Framework Paper 플러그인	plugins/
클라이언트	BuzzBuild-NpcDialog-Fabric-0.1.0.jar	mods/
클라이언트	BuzzBuild-Framework Fabric 모드	mods/
클라이언트	고정 버전에 맞는 Fabric API	mods/

클라이언트는 Fabric Loader로 실행하는 Minecraft 26.1.2 인스턴스여야 합니다. 서버는 Java 25와 해당 Minecraft 버전의 Paper를 사용합니다. 일반 사용자는 shared/API JAR을 별도로 설치하지 않습니다.

Citizens 또는 MythicMobs는 해당 NPC 바인딩을 이용할 때만 필요합니다. NPC를 만드는 작업은 각 NPC 담당자가 진행합니다.

최초 활성화 시 생성되는 파일

운영자가 정한 서버 기동 절차로 플러그인이 활성화되면 다음을 생성·로드합니다.

plugins/BuzzBuild-NpcDialog/
├── config.yml
├── dialogs/
│   └── example_ariana.yml
└── progress.yml

• config.yml은 없는 경우 기본 리소스에서 생성합니다.
• dialogs/example_ariana.yml은 없는 경우 생성합니다. 삭제한 샘플은 다음 활성화 때 다시 생성될 수 있습니다.
• dialogs/*.yml을 읽어 대화를 등록합니다.
• progress.yml은 기존 파일을 읽으며, 없는 경우 메모리에서 빈 진행도로 시작하고 저장 요청 시 파일을 씁니다.
• 교환·상점·던전 연동 예제는 자동 설치되지 않습니다.

기존 설정을 새 기본값으로 덮어쓰지 않으므로 업데이트 후 필요한 키는 설정 문서와 비교합니다.

최초 확인 절차

1. 서버와 클라이언트 양쪽에 Framework 및 NpcDialog를 설치합니다.
2. 운영자의 관리 절차로 서버와 클라이언트를 실행합니다.
3. 서버 로그에서 NpcDialog 활성화 및 대화 스크립트 로드 수를 확인합니다.
4. 관리자 계정으로 /bbnpcdialog list를 실행합니다.
5. /대화 example_ariana로 대화창 표시를 확인합니다.
6. 자체 대사를 작성하고 NPC·서비스를 연결합니다.

샘플의 “마을로 이동한다” 선택지는 안내 명령이며 실제 워프 목적지를 연결하지 않습니다.

설정 및 배포본 적용

변경 대상	적용 방법	영향
config.yml, dialogs/*.yml	관리자 /bbnpcdialog reload	활성 대화를 닫고 설정·스크립트를 다시 읽음
Paper 플러그인 JAR	운영자의 서버 재시작 절차	YAML 갱신 명령으로 새 Java 코드를 로드할 수 없음
Fabric 모드 JAR·내장 폰트·텍스처	클라이언트 재실행	실행 중인 모드 코드를 YAML 명령으로 변경할 수 없음
진행도 초기화	`/bbnpcdialog reset <dialogId	*>`

업데이트 전에 기존 JAR·설정·진행도를 보관하고 서버와 클라이언트의 NpcDialog를 함께 교체합니다. 구형 토큰 없는 클라이언트의 선택 요청은 거절됩니다. 서버 전체 /reload 대신 해당 플러그인의 설정 갱신 명령을 사용합니다.

이 문서 작성 중 서버 시작·중지·재시작·전체 reload 및 배포는 실행하지 않았습니다.

확인 범위

2026-10-05 소스와 기본 리소스를 확인했습니다. 이전 로컬 시연의 플러그인 활성화·클라이언트 접속·대화 표시만 확인되었습니다. 기존 운영 서버의 업데이트 적용과 실제 NPC·외부 서비스의 게임 내 동작은 미검증입니다.