[👥] NPC Manager(매니저) v1.3.1 - 캐릭터 저장 모듈

STANDALONE
NPC Manager
v1.3.1
1.2.x 이하 버전 사용중인 챗붕은 업데이트 적극
x100
권장
Chat NPC 추적 · 저장 · 수정 · 상태창 모듈
별도 라이트보드 백엔드 없이 단독으로 작동
원작:
[
라이트보드] NPC-LIST 4.2.3
Q. 머하는 모듈임?
이야기에 나왔던 주요 NPC들을
'챗 로어북'
에 따로 저장하고, 과거를 기록해주는
'히스토리'
들을 저장함.
이로 인해 복잡한 구조 관계 없이 RisuAI의 기본 '로어북' 기능을 활용하는 형태.
이 모듈의 가장 큰 특징은
'로어북 없는 NPC'
의 로어북까지 대신 생성해줘.
왜냐면 NPC의 기본 정보 외에 다른 추가 정보들도
'불명'
같은 게 아니라 전부 임의로 생성해서 고정시키기 때문임.
더해서 NPC를 본인의 입맛대로 수정할 수 있음!
(예: 바니걸 -> UFC 선수)
->
Q. 굳이 써야하는 이유는?
무조건 쓸 이유는 없음.
다만 NPC들이 많은 시뮬/깡봇에서는 사소한 내용들을 모델이 까먹는 경우가 태반임.
이 모듈을 사용하면 어느정도 그 부분을 안정성 있게 개선함!
외형/체형, 그 외 사소한 정보 묘사까지 모델이 잘못 표현할 때가 있는데
이런 걸 일관성 있게 잡아주는 역할도 할 수 있어.
Q. 보조모델 뭐 써야함?
왠만하면 비추천 모델은 쓰지 않는 걸 권장함.
가격 대비 Claude와 GPT까지는 이 모듈에선 필요가 없어.
또한 해당 모듈만 그런지 모르겠지만...
GLM은 추론이 매우 과해서 시간이 다른 모델에 비해 5배 이상 늘어남.
추천 모델:
Gemini 3.0/3.6 Flash, DeepSeek V4 Flash
비
추천 모델
:
GLM(과추론), Claude(비용), GPT(비용)
초기 세팅
1.
NPC Manager 모듈 불러오기.
2.
토글 설정에서 보조 모델/버튼 작동으로 설정.
3.
그 외에 표시 설정/표시 필터를 자기 취향에 맞게 켜거나 끄기.
4.
맨 마지막 채팅에 'NPC Manager' 불러오기 버튼을 클릭해서 작동되는지 확인하기!
전체 토글 설명
— 클릭해서 펼치기
1. 기본 설정
사용 모델
OFF / 메인 모델 / 보조 모델. NPC 생성 요청에 사용할 모델. OFF면 생성 호출이 중단됨. 선택한 모델이나 프로바이더에서 추론 기능을 켜면 NPC 생성과 자체 압축도 추론을 사용해 오래 걸릴 수 있으며, NPC Manager가 Lua 요청에서 추론만 따로 강제로 끌 수는 없음.
작동 조건
즉시 작동
은 RisuAI 본문 응답마다 NPC 상태를 자동 생성하고, 본문 리롤이 끝날 때까지 확정 대기로 둠. 해당 본문으로 다음 입력 또는 생성을 시작하면 저장을 확정함.
버튼 작동
은 사용자가 불러오기나 새로고침을 눌렀을 때만 갱신함.
2. 유저 캐릭터
유저 캐릭터 변경
{{user}} 대신 직접 입력한 이름을 관계 판단 기준으로 사용.
캐릭터 이름
유저 캐릭터 변경이 켜졌을 때 사용할 이름. 비워두면 현재 유저 이름을 사용.
유저 캐릭터 포함
유저 또는 지정 캐릭터도 NPC 목록에 포함.
3. 언어·표시 설정
작동 언어
한국어 / 영어 / 일본어. NPC 설명값의 생성 언어.
테마 모드
심플 / 홀로그램 / 벚꽃 / 양피지. 기능 차이 없이 상태창 외형만 변경.
정렬 형식
상세 정보를 접힌 카테고리로 볼지 한 번에 나열할지 변경.
속마음 표시
현재 장면에 존재하는 NPC의 속마음 필드를 생성·표시.
평판 표시
주변 인물에게 알려진 평가, 별명, 소문을 표시.
호감도 표시
유저 기준 관계값을 -100~100 범위로 생성·표시.
NPC 상태 표시
활동, 사망, 실종, 부상, 불명 상태를 관리.
장소 표시
NPC가 마지막으로 확인된 장소를 표시.
소속/세력 표시
학원, 길드, 가문, 회사 등 소속 정보를 표시.
4. 표시 필터
외형 포함
머리, 눈, 체형, 복장 정보를 생성·표시.
특징 (특징/성격/말투)
신체 특징, 성격, 말투 정보를 생성·표시.
기타 표시
생일, 기호, 혈액형, 패션 취향, 꿈, 취미 같은 부가 정보 표시.
히스토리 (사건 기록)
관계 변화와 전개에 영향을 주는 주요 사건을 누적.
히스토리 기록 방식
상세 기록
은 서로 다른 주요 사건을 가능한 한 나누어 기록함.
핵심 요약
은 이어지는 사건과 결과를 묶어 짧게 정리함. 두 방식 모두 의미 없는 대화나 사소한 행동은 기록하지 않음.
상세 시간 표시
히스토리의 시간 정보를 상태창에도 표시. 히스토리가 꺼지면 효과 없음.
목록 미리 열기
NPC Manager 상태창을 처음부터 펼쳐 표시.
5. 저장 설정
변수 저장 모드
NPC Manager가 만든 챗 로어북을 사용하지 않고, 정리된 NPC 내용을 채팅 변수에 저장함. 기존에 NPC Manager가 만든 로어북은 꺼 두고, 저장된 변수 내용은 일반 RisuAI 본문 요청마다 시스템 메시지로 넣음. 벡터 DB 재생성 충돌을 피하고 싶을 때 사용할 수 있음. 이 모드에서는 챗 로어북 영어 재작성, 활성화 키 언어, 챗 로어북 배치 순서가 적용되지 않음.
챗 로어북 영어 재작성
로어북용 내용만 추가 LLM 요청으로 영어로 다시 작성함. 바뀐 NPC 중 최대 입력 안에 들어가는 만큼을 한 요청으로 처리하고, 끝낸 NPC는 저장해 두므로 다음 저장에서 남은 NPC부터 이어감. 일부만 끝났을 때는 한글과 영어가 섞인 로어북을 만들지 않고 기존 로어북을 유지함. 상태창에
영어 일부
가 보이면 저장 버튼을 다시 누르면 됨. 같은 NPC에서 계속 멈추면 해당 NPC 하나도 입력 상한에 들어가지 않는 것이므로 최대 입력값이나 NPC 데이터 양을 조정해야 함. 변수 저장 모드에서는 사용하지 않음.
활성화 키 언어
영어+한국어 / English / 한국어 / 日本語. 개별 NPC 로어북을 부를 이름 키의 언어 구성을 정함. 선택한 언어와 별개로, 실제 NPC 이름과 정확히 일치하는 키를 안전 키로 항상 함께 유지함. 변수 저장 모드에서는 사용하지 않음.
챗 로어북 배치 순서
챗 로어북 삽입 순서. 값이 클수록 뒤쪽에 배치하며, 비워두면 100으로 적용. 변수 저장 모드에서는 사용하지 않음.
6. 동작 설정
히스토리 최대 수
빈칸 또는 0이면 개수 제한 없음. 양수를 넣으면 NPC별로 똑같은 기록을 먼저 한 번만 남긴 뒤,
가장 최근 기록 N개만 보존
함. 이 설정 자체는 오래된 기록을 요약하지 않고 상한 밖의 기록을 제거함. 내용을 줄여 다시 쓰고 싶다면 상태창의
히스토리 요약
버튼을 사용해야 함.
최근 채팅 수(압축 X)
입력 한도를 맞출 때도 압축하지 않고 원문 그대로 보존할 최신 채팅 개수. 빈칸 기본 8. 이 채팅들까지 넣을 공간이 부족하면 몰래 빼지 않고 입력 한도 오류를 표시.
최대 입력 토큰
NPC Manager가 모델에 한 번 요청할 때 보낼 수 있는
입력 메시지 본문
의 상한. 지침, 이전 NPC 데이터, 기억, 채팅 등 NPC Manager가 보내는 각 메시지의 본문을 합쳐 RisuAI 토크나이저로 계산하며 빈칸 기본 65,536. 모델이 생성할 출력 토큰과 프로바이더가 역할·요청 형식에 덧붙이는 분량은 계산하지 않음. 모델의 실제 한도보다 낮게 두고 출력 분량만큼 여유를 남겨야 안전함.
챗 인덱스 범위
한 번의 NPC Manager 작업에서 직접 확인할 수 있는 원본 채팅 메시지 수의 상한. 빈칸 기본 8,192. 모델에 보내는 토큰 수나 메시지 위치 번호가 아니라,
최신 원문 준비, 저장된 기억 확인, 새 압축 내용 준비 과정에서 직접 읽는 메시지 수를 모두 합친 값
임. 같은 메시지는 한 작업 안에서 다시 읽지 않으며, 과거 전체 불러오기는 확인을 끝낸 위치를 저장하고 다음 작업에서 이어감. 필요한 최근 채팅을 찾기 전에 이 범위에 닿으면 내용을 몰래 빼지 않고 오류로 알려줌.
7. 메모리 연동/압축
RisuAI가 하이파 처리와 프롬프트 조립을 마친 단계에서 하이파 메모리 내용이 확인되면 그 내용을 먼저 사용함.
하이파 메모리를 사용할 수 없을 때는 NPC Manager 자체 기억이 대신 오래된 대화를 정리함. 어느 쪽이든 최대 입력 토큰 안에 모두 들어가면 줄이거나 압축하지 않고, 한도를 넘을 때만 필요한 만큼 맞춤.
사용 안 함
NPC Manager 자체 기억만 비활성화. RisuAI의 하이파 메모