[👥] NPC Manager(매니저) v1.2.3 - 캐릭터 관리 상태창

STANDALONE
NPC Manager
v1.2.3
Chat NPC 추적 · 저장 · 수정 · 상태창 모듈
별도 라이트보드 백엔드 없이 단독으로 작동
원작:
[
라이트보드] NPC-LIST 4.2.3
한 줄 요약
이야기에 실제로 등장한
이름 있는 NPC
의 외형, 성격, 말투, 관계, 위치, 상태와 사건 기록을 구조화된 데이터로 관리 보관해.
더하여 보기 쉬운 카드형 상태창과 챗 로어북으로 연결하는 모듈이야.
NPC를 새로 창작하는 모듈이 아님
지금까지 이야기 안에 등장한 인물을 찾아 따로 저장하고 갱신하는 모듈이야.
저장된 내용은 사용자가 직접 수정하거나 추가 지시로 고칠 수 있음.
다만 '로어북 없는 NPC'의 로어북을 생성한다는 기준에서는 새로 창작하는 게 맞음!!
Q. 머하는 모듈임?
대략 이런 구조라고 생각하면 됨
0. 이야기가 진행되던 채팅방에 들어감.
1. 생성 버튼 딸깍.
2. 현재 이야기 내 등장한 NPC 파악.
3. 파악한 NPC들을 별도 공간에 저장.
4. 해당 NPC들을 시각적인 상태창으로 표시.
5. 저장된 NPC는 사용자의 직접 개입/수정 가능.
Q. 장기기억 플러그인이랑 다름?
기본적으로 '기억을 유지'하는 면에서는 얼추 비슷하긴 함.
다만 상태창 모듈같은 낮은 접근성 느낌을 유지중.
성능과 효율적인 면에서 보면 플러그인 쪽이 더 유리하고 좋을 거야.
하지만 이 모듈이 제일 유리할때의 상황은 바로 '로어북 없는 NPC'의 로어북을 대신 생성해준다는 큰 장점이야!
그리고 이번에 NPC Manager로 넘어오면서 바뀐 점이 있음!
본인 입맛대로 직접 캐릭터 '개조'가 가능하게끔 수정 기능과 편의성을 넣어봤음
(하단 버튼 설명 참고)
Q. 그럼 사용량 많이 나감?
음...
이건 개인마다 차이가 클 것 같아.
직접 사용해본 뒤, 체감이 너무 크다 싶으면 사용하지 않는 걸 권장해.
추천 모델:
잼삼플/잼삼오플, 딥식v4 Flash
비
추천 모델:
GLM(과추론), Claude(비용), GPT(비용)
(클쟝이랑 짚쨩은 잠시 나가있어)
Q. 기존 NPC-LIST 쓰던 세션에서 호환 가능?
아쉽게도 호환되지 않음...
각각 따로 작동될 거라서 만약 해볼 거면 채팅 미리 복사해놓고 해보는 걸 추천!
(웬만하면 새 세션에서 하는 걸 적극 권장함)
Q. 어떻게 사용함?
모듈 다운로드 ➔ 토글 설정 ➔ 채팅 맨 아래에 생긴
'NPC Manager 불러오기'
클릭 ➔ 챗 로어북 확인해서 내용 잘 들어가있으면 성공!
최대 입력 토큰은 모델의 컨텍스트 크기를 늘리는 옵션이 아님.
NPC Manager가 한 번의 요청에 넣을 입력 상한을 정하는 값이므로, 실제 모델이 지원하는 컨텍스트보다 크게 잡으면 모델 쪽에서 실패할 수 있어.
설치와 사용
1.
해당 모듈 파일을 RisuAI 모듈로 가져오기
2.
설정 -> 모듈 탭에서 'NPC Manager' 활성화 (지구모양)
3.
사용 모델
을 메인 또는 보조 모델로 변경
4.
처음에는
버튼 작동
으로 두고 NPC Manager 불러오기 클릭
5.
결과를 확인한 뒤 필요한 표시·저장·메모리 옵션 조정
상태창 버튼 설명
버튼
기능
1. 전체 열기/닫기
접힌 NPC 상세 항목을 한꺼번에 열거나 닫음.
2. 목록 새로고침
현재 채팅 기준으로 NPC 데이터를 다시 생성·갱신함.
3. 내용 검토
누락이나 모순을 LLM에 검토시켜 전체 NPC 데이터를 보정함.
4. 히스토리 요약
각 NPC의 오래된 사건 기록을 압축하고 최근 기록을 남김.
5. 챗 로어북 생성
현재 NPC 데이터로 인덱스와 개별 챗 로어북을 다시 동기화함.
영어 재작성 사용 시 추가 LLM 호출이 발생함.
1. NPC 수정
이름, 외형, 성격, 관계, 상태 등 특정 필드를 직접 수정함.
2. 설정 추가
자연어로 추가할 설정을 입력하면 기존 데이터 구조를 유지한 채 LLM이 내용을 반영함.
전체 토글 설명
— 클릭해서 펼치기
1. 기본 설정
사용 모델
OFF / 메인 모델 / 보조 모델. NPC 생성 요청에 사용할 모델. OFF면 생성 호출이 중단됨.
작동 조건
즉시 작동은 응답마다 자동 갱신, 버튼 작동은 직접 불러올 때만 갱신.
2. 유저 캐릭터
유저 캐릭터 변경
{{user}} 대신 직접 입력한 이름을 관계 판단 기준으로 사용.
캐릭터 이름
유저 캐릭터 변경이 켜졌을 때 사용할 이름.
유저 캐릭터 포함
유저 또는 지정 캐릭터도 NPC 목록에 포함.
3. 언어·표시 설정
작동 언어
한국어 / 영어 / 일본어. NPC 설명값의 생성 언어.
테마 모드
심플 / 홀로그램 / 벚꽃 / 양피지. 기능 차이 없이 상태창 외형만 변경.
정렬 형식
상세 정보를 접힌 카테고리로 볼지 한 번에 나열할지 변경.
속마음 표시
현재 장면에 존재하는 NPC의 속마음 필드를 생성·표시.
평판 표시
주변 인물에게 알려진 평가, 별명, 소문을 표시.
호감도 표시
유저 기준 관계값을 -100~100 범위로 생성·표시.
NPC 상태 표시
활동, 사망, 실종, 부상, 불명 상태를 관리.
장소 표시
NPC가 마지막으로 확인된 장소를 표시.
소속/세력 표시
학원, 길드, 가문, 회사 등 소속 정보를 표시.
4. 표시 필터
외형 포함
머리, 눈, 체형, 복장 정보를 생성·표시.
특징 (특징/성격/말투)
신체 특징, 성격, 말투 정보를 생성·표시.
기타 표시
생일, 기호, 혈액형, 패션 취향, 꿈, 취미 같은 부가 정보 표시.
히스토리 (사건 기록)
관계 변화와 전개에 영향을 주는 주요 사건을 누적.
상세 시간 표시
히스토리의 시간 정보를 상태창에도 표시. 히스토리가 꺼지면 효과 없음.
목록 미리 열기
NPC Manager 상태창을 처음부터 펼쳐 표시.
5. 저장 설정
변수 저장 모드
챗 로어북 대신 채팅 변수에 NPC 데이터를 저장. 벡터 DB 재생성 충돌을 피하고 싶을 때 사용.
챗 로어북 영어 재작성
로어북용 텍스트만 추가 LLM 호출로 영어 정리. NPC 수와 작업량에 따라 비용·시간 증가.
활성화 키 언어
영어+한국어 / English / 한국어 / 日本語. 개별 NPC 로어북을 호출할 이름 키 구성.
챗 로어북 배치 순서
챗 로어북 삽입 순서. 값이 클수록 뒤쪽에 배치.
6. 동작 설정
히스토리 최대 수
NPC별 사건 기록이 지정 수를 넘으면 오래된 기록을 요약. 빈칸 또는 0이면 자동 요약 안 함.
최근 채팅 수(압축 X)
자체 압축 경로에서 원문 그대로 남길 최신 채팅 개수. 빈칸 기본 8.
최대 입력 토큰
NPC 생성 요청과 개별 압축 요청의 입력 상한. 빈칸 기본 65,536. 오래된 대화를 상한 적용 전에 통째로 토큰화하지 않으며, 고정 프롬프트만으로 초과하면 호출 전에 원인을 표시.
7. 메모리 연동/압축
RisuAI가 현재 요청에 넣은 하이파 기억을 저장해 버튼 작동과 즉시 작동에서도 그대로 사용함.
아직 저장된 하이파 결과가 없고 입력 상한을 넘을 때만 NPC Manager 자체 압축이 대신 작동함.
사용 안 함
NPC Manager 자체 압축만 비활성화. 하이파 메모리를 끄는 토글이 아님.
압축 모델
NPC 생성 모델 / 메인 모델 / 보조 모델. 오래된 채팅 요약에 사용할 모델.
압축 청크 토큰
오래된 대화를 요약할 묶음 크기. 빈칸 기본 6,000.
완료한 묶음은 바로 저장하므로 중단 후에도 이어서 사용하고, 수정된 묶음만 다시 생성.
압축 기억 비율(%)
남은 대화 예산 중 압축 기억에 배정할 비율. 빈칸 기본 20, 내부 상한 80.
8. 프롬프트 포함 내용
아래 항목은 기본적으로 포함됨. 체크한 항목만 제외하는 방식.
유저 페르소나 제외
현재 페르소나 이름과 설명을 NPC 생성 프롬프트에서 제외.
캐릭터 설명 제외
현재 메인 캐릭터 설명을 제외.
작가 노트 제외
현재 채팅의 작가 노트를 제외.
현재 활성 로어북 제외
RisuAI가 현재 요청에 활성화한 로어북 내용을 제외.
이전 NPC 데이터 제외
직전 NPC 상태를 갱신 기준에서 제외. 켜면 기존 정보 유지가 어려워질 수 있음.
하이파/압축 내용 제외
RisuAI 메모리 또는 NPC Manager 압축 기억을 프롬프트에서 제외.
최근 채팅 제외
원문 대화 컨텍스트를 제외. 현재 장면 파악이 약해질 수 있음.
9. JSON 자동 수정
JSON 자동 수정
1회 / 2회 / 사용 안 함