게시 2026년 7월 16일 · Kevin BK

Joi Database Editor란? 실제 용도와 파일 구조

Joi Database라는 이름이 혼동되는 이유

프로젝트의 공식 표기는 joi이며 “Joy Database”가 아닙니다. 저장소 이름, Java 패키지, 도움말, 내보낸 파일 이름이 모두 같은 표기를 사용합니다. 검색에서는 JavaScript 검증 라이브러리 Joi와 Joy라는 이름의 관계없는 서비스도 함께 나타납니다.

가장 확실한 식별 자료는 The joi Database Editor GitHub 저장소입니다. 설명에는 The joi Database용 joi를 만드는 편집기라고 적혀 있고, 주제는 JavaFX 편집기와 게임 수정 도구로 분류합니다.

따라서 실시간 분석, 멀티 모델 데이터 관리, 머신러닝 커넥터, 초당 수백만 이벤트 같은 주장은 이 프로젝트와 맞지 않습니다. 저장 서버, 쿼리 언어, 네트워크 프로토콜, 공식 성능 시험이 코드나 문서에 없기 때문입니다.

확인되는 기능과 확인되지 않는 주장

구조화된 내용을 JSON으로 저장한다고 모든 프로그램이 데이터베이스 관리 시스템이 되는 것은 아닙니다. 데이터베이스와 디렉터리의 차이를 보면 쿼리 엔진, 파일 구조, 카탈로그, 편집 화면을 구분할 수 있습니다. 이 편집기의 JSON은 게임이 읽는 콘텐츠를 표현합니다.

프로젝트를 장면과 연결로 구성하는 방식

내장된 시작 안내서는 장면을 기본 컨테이너로 설명합니다. 작업 공간에서 각 장면은 노드로 나타나며, 노드를 연결해 순차 진행이나 분기를 만듭니다.

이 구조는 데이터베이스 관리 화면보다 분기형 이야기 편집기에 가깝습니다. 장면을 열면 대사, 기본 이미지, 동작, 다음 장면을 지정할 수 있습니다.

1. 프로젝트를 만듭니다. 작업 폴더와 언어를 선택합니다.
2. 장면을 추가합니다. 장면은 흐름의 노드가 됩니다.
3. 노드를 연결합니다. 기본 진행과 분기 목적지를 정합니다.
4. 내용을 편집합니다. 글, 이미지, 타이머, 선택지, 전환을 넣습니다.
5. 메타데이터를 작성합니다. 제목, 고유 ID, 게임 버전, 언어, 사용 기능을 기록합니다.
6. 내보내고 시험합니다. 파일이나 ZIP을 만든 뒤 대상 게임에서 결과를 확인합니다.

마지막 시험이 필요한 이유는 편집기 화면과 게임의 실제 표시가 다를 수 있다고 도움말이 경고하기 때문입니다. 미리 보기 버튼을 요청하는 이슈도 아직 열려 있어 완전한 재생 기능이 이미 있다고 가정할 수 없습니다.

장면에 넣을 수 있는 내용

장면 편집기 도움말은 일반 동작, 타이머, 대화 선택지, 전환을 설명합니다. 소스에는 변수, 조건, 산술 연산, 그룹 구성 요소도 있습니다.

글과 이미지

일반 동작에는 문장과 스타일을 저장합니다. 장면마다 기본 이미지를 둘 수 있고, 특정 줄에서만 다른 이미지를 잠시 표시할 수도 있습니다. 도움말은 이미지 높이 900~1,080픽셀을 권장하며 게임 화면은 1,920×1,080을 기준으로 언급합니다.

타이머와 시간 지정

타이머는 장면 길이를 정하고 특정 초에 글이나 이미지를 연결합니다. 콘텐츠 연출을 제어하는 기능이지 데이터베이스 스케줄러처럼 반복 쿼리를 실행하는 기능이 아닙니다.

선택지, 전환, 조건

대화 선택지는 버튼과 새 연결 지점을 만듭니다. 전환은 두 장면 사이에 짧은 문장을 넣을 수 있습니다. 변수와 조건은 상태에 따라 진행 방향을 바꾸고, 산술 노드와 그룹은 복잡한 흐름을 정리합니다.

릴리스 기록을 보면 변수와 조건은 버전 9, 산술 노드와 그룹화는 버전 13, GIF 지원과 아이콘 제작기는 버전 14에서 소개됐습니다. 이슈에 적힌 제안은 코드나 릴리스에서 확인되기 전까지 완성된 기능으로 볼 수 없습니다.

JSON과 이미지 파일의 구성

패키지 관리자는 언어마다 joi_text_<language>.json과 info_<language>.json을 찾습니다. 프로젝트에는 joi_icon.png와 장면에 쓰는 이미지도 포함될 수 있습니다.

본문 JSON은 JOI라는 배열에 구성 요소를 담습니다. 장면, 변수 변경, 조건, 산술 노드, 그룹, 그룹 연결 요소가 들어갑니다. 내보낼 때 파일을 따로 유지하거나 ZIP으로 묶을 수 있습니다.

정보 JSON은 패키지를 식별하고 게임에서 필터링하는 데 쓰입니다. 도움말은 제목, 고유 식별자, 게임 버전, 언어, 선언된 기능을 기록한다고 설명합니다. 콘텐츠와 메타데이터를 분리하므로 하나의 JSON만으로 끝나지 않습니다.

프로그래밍 없이 JSON 읽는 법에서 객체, 배열, 키, 중첩 값을 익히면 편집 전후의 내보내기 결과를 비교하기 쉽습니다.

요구 환경, 공개 버전, 다운로드 확인

Maven 설정은 Java 8 대상 프로젝트임을 보여 줍니다. JSON 처리에는 JSON-java를 사용하고 JavaFX 검사 관련 의존성으로 Scenic View가 포함됩니다. 라이선스는 MIT입니다.

GitHub Releases에서 2026년 7월 16일 확인한 최신 바이너리는 2021년 5월 9일의 버전 14입니다. 소스 설정에는 버전 15가 있지만 버전 15 배포 파일이 공개됐다는 뜻은 아닙니다.

• 관리자가 연결한 Releases 페이지에서 받습니다.
• 원본 ZIP을 보관하고 운영체제의 보안 도구로 검사합니다.
• 패키지가 요구하는 Java 런타임을 확인합니다.
• 기존 프로젝트는 다른 버전에서 열기 전에 복사합니다.
• 먼저 시험용 복사본을 내보내 JSON과 이미지를 비교합니다.
• 작업과 관련된 공개 이슈를 읽습니다.
• 별, 다운로드 수, 오픈 소스 라이선스를 보안 감사로 오해하지 않습니다.

이 점검은 공개 파일과 프로젝트 기록을 바탕으로 한 것이며 직접 설치했다는 체험담이 아닙니다. 모든 최신 환경과의 호환성을 보장하지도 않습니다.

프로젝트 상태와 알맞은 사용처

저장소는 2019년 6월에 만들어졌습니다. 공개 패키지는 2019년 11월 버전 6부터 2021년 5월 버전 14까지입니다. 이후 커밋은 있지만 더 최신 배포 파일은 목록에 없습니다.

오래됐다는 사실만으로 사용할 수 없다고 단정할 수는 없습니다. 다만 운영체제, Java, 현재 게임 버전과의 호환성을 직접 확인해야 합니다. 열린 요청에는 더 많은 도움말, 가중치 무작위 처리, 그룹 간 노드 이동, 긴 작업의 진행 표시가 포함됩니다.

The joi Database용 패키지를 살펴보거나 제작하려는 사람에게는 맞을 수 있습니다. SQL, 원격 접속, 분산 저장소, 업무 분석, 범용 데이터베이스가 필요하다면 다른 도구를 선택해야 합니다.

자주 묻는 질문

Joi Database와 Joy Database 중 어느 표기가 맞나요?

저장소, 코드, 파일은 “joi”를 사용합니다. “Joy Database”는 관계없는 결과가 섞입니다. The joi Database Editor라는 전체 이름으로 찾는 것이 정확합니다.

실제 데이터베이스 서버인가요?

공개된 1차 자료에 따르면 아닙니다. 게임용 JSON 콘텐츠를 만드는 데스크톱 편집기입니다. SQL, 서버 프로세스, 복제, 클라우드 배포는 문서화되지 않았습니다.

어떤 파일을 만드나요?

joi_text_en.json과 info_en.json 같은 쌍, 이미지, 선택적 아이콘을 사용하며 ZIP으로 묶을 수 있습니다.

여러 언어를 지원하나요?

설정에는 영어, 프랑스어, 러시아어, 독일어, 체코어, 스페인어, 이탈리아어가 있으며 언어마다 본문과 정보 파일을 읽습니다.

어디에서 다운로드하나요?

GitHub Releases에서 날짜와 설명을 확인하세요. 목록의 최신 바이너리는 2021년 5월 버전 14입니다.

확인한 자료

• The joi Database Editor 저장소
• 공개 릴리스
• 내장 시작 안내서
• 장면 편집기 도움말
• 패키지 관리자 코드
• 프로젝트 이슈