StarLight는 내장 저장소의 StarLight 폴더(/storage/emulated/0/StarLight)에 모든 데이터를 저장해요. 하위 폴더는 처음 필요할 때 만들어져요.
참고
Google Play 판은 같은 구조를 앱 전용 폴더(/storage/emulated/0/Android/data/dev.mooner.starlight/files)에 저장해요. 이 폴더는 앱을 지우면 함께 지워지므로, 아래에서 앱을 다시 설치해도 남는다고 적은 데이터(agent/ 등)도 지워져요. plugins/ 폴더는 쓰지 않아요.
StarLight/
├─ projects/ 프로젝트
│ └─ <이름>/
├─ plugins/ 플러그인
│ ├─ <ID>.slp
│ └─ <이름>(<ID>)/ 플러그인 데이터 (config-plugin.json)
├─ modules/ 여러 프로젝트가 함께 쓰는 모듈 (직접 만들어요)
├─ agent/ AI 탭의 대화와 첨부 파일
├─ logs/
│ └─ <날짜>/<시각>.log 앱 실행마다 하나씩
├─ config-general.json 앱 설정
└─ notification_rules_v2.json 패키지 규칙| 경로 | 설명 |
|---|---|
projects/ | 프로젝트마다 폴더가 하나씩 있어요. 아래에서 설명해요. |
plugins/ | 플러그인 파일과 플러그인별 데이터 폴더예요. 플러그인 설치와 관리를 보세요. |
modules/ | 앱이 만들지 않으니 직접 만들어요. 설정 → 프로젝트, 플러그인 → 전역 모듈 로드를 켜야 쓰여요. |
agent/ | AI 탭의 대화(conversations/)와 첨부·생성 파일(attachments/)이에요. 앱을 다시 설치해도 남아요. API 키는 여기 없어요. 다른 기기나 빌드로 옮기려면 AI 설정 → 대화 내보내기를 써요. |
logs/ | 앱 로그 파일이에요. 보관 기간은 설정 → 로그에서 정해요. |
config-general.json | 설정 탭의 값과 홈 위젯 배치예요. |
notification_rules_v2.json | 패키지 규칙 설정에서 만든 규칙이에요. |
STARTUP.info | 앱이 비정상 종료됐을 때 남는 오류 보고예요. |
프로젝트 폴더
projects/hello-bot/
├─ project.json 프로젝트 정보
├─ hello-bot.js 메인 스크립트
├─ config.json 프로젝트 설정 (언어 설정 포함)
├─ logs.json 프로젝트 로그 (최근 50개)
├─ .env 환경 변수 (직접 만들어요)
├─ AGENTS.md AI 에이전트가 이 프로젝트에 대해 적어 두는 메모 (선택)
├─ data/ DataBase API가 쓰는 파일
└─ debugroom/
└─ chats.json 디버그 룸 대화 기록메인 스크립트 말고도 모듈 파일이나 데이터 파일을 자유롭게 넣을 수 있어요. 에디터의 파일 서랍에서 만들거나, 파일 관리자로 복사해요.
AGENTS.md는 스크립트로 실행되지 않아요. AI 에이전트가 봇의 구조와 규칙을 적어 두고, 그 프로젝트로 대화를 시작할 때 다시 읽어요. 직접 고쳐도 돼요.
project.json
| 키 | 설명 |
|---|---|
id | 프로젝트의 고유 ID(UUID)예요. |
name | 프로젝트 이름이에요. 폴더 이름과 같아요. |
mainScript | 메인 스크립트 파일 이름이에요. |
languageId | 언어 ID예요. NeonJS는 js_neon, Rhino는 JS_RHINO예요. |
isEnabled | 켜져 있는지예요. |
isPinned | 즐겨찾기했는지예요. |
createdMillis | 만든 시각(밀리초)이에요. |
allowedEventIds | 받을 이벤트 항목(이벤트 ID, 와일드카드, ! 제외 항목)이에요. 프로젝트 설정의 받을 이벤트가 이 값을 고쳐요. |
packages | 프로젝트 정보 화면에 보이는 패키지 목록이에요. 메시지를 거르는 데 쓰이지는 않아요. |
주의
project.json을 직접 고칠 때는 앱을 끄고 고치거나, 고친 뒤 프로젝트 설정의 위험 → 프로젝트 정보 다시 로드를 누르세요. 특히 languageId를 바꾸면 프로젝트가 동작하지 않을 수 있어요.
백업과 옮기기
- 프로젝트 하나를 옮기려면
projects/<이름>/폴더를 통째로 복사하거나, zip 파일로 내보내고 가져와요. Google Play 판에서는 zip 파일을 쓰세요. - 앱 전체를 옮기려면
StarLight폴더를 통째로 복사해요. 새 기기에서 앱을 설치하고 권한을 허용한 뒤 폴더를 넣고, 앱을 다시 시작하세요.