KHistoryQuiz

마인크래프트에서 특정 시간마다 모든 플레이어에게 한국사 문제를 표시하는 플러그인

Important

이 플러그인을 유튜브와 같은 영상 플랫폼에 사용할 경우 플러그인 링크와 다음의 출처를 남겨주세요.

아이디어: 나포키

제작자: naforky-dev

License

이 플러그인은 GNU의 GPL-3.0 라이선스 하에 배포됩니다.

실행 환경

PaperMC 1.21.11

Java 25 temurin(Oracle의 최신 Java 버전)

Usage

/khistoryquiz <command>

<command>:

• start - 문제 디스플레이 타이머를 시작
• pause - 타이머 일시정지
• stop, reset - 타이머 정지, 문제 카운터와 점수, 죽은 횟수 등 리셋
• loaddefaults - config.yml을 무시하고 기본 설정을 불러오기 (questions.yml은 일반적으로 로드됩니다)
• set - 런타임 설정값 변경 (config.yml에 저장되지 않음)

config.yml - /plugins/KHistoryQuiz 경로에 생성 가능한 설정 파일(서버 새로고침, 재시작 시 설정 리셋 방지)

questions.yml - /plugins/KHistoryQuiz 경로에 생성 가능한 문제 세트 파일(기본 문제 세트 외 다른 문제 추가)

설정 파일

Note

config.yml 파일을 아래의 방법 또는 구조와 다르게 생성할 경우 기본값이 로드됩니다. 서버 로그에서 설정이 적용되었는지 확인할 수 있습니다.

# KHistoryQuiz 플러그인 설정
# question-set-filter: questions.yml의 문제들 중 특정 범위 또는 특정 문제들을 제외합니다.
# 예시: (문제들의 번호를 사용, 필터링을 하지 않는 경우 값을 none으로 입력)
question-set-filter: none

# interval: 게임 내에서 플러그인을 시작한 경우 문제가 나오는 시간 간격을 변경
# 'random' 또는 ms 단위의 시간 단위로 입력, random일 경우 플러그인이 4분(240000)마다 문제를 표시합니다.
# 1초 = 1000ms(밀리초)
interval: 240000

# question-timeout: 각 문제가 표시되는 시간을 초 단위로 설정합니다.
# 기본값: 10초
question-timeout: 10

런타임 설정 변경

/khistoryquiz set를 사용하여 게임 중에 설정을 변경할 수 있습니다. 이렇게 변경한 값은 config.yml에 저장되지 않으며, 서버를 재시작하면 원래의 설정값으로 돌아갑니다.

사용법:

/khistoryquiz set <key> <value>

예시:

/khistoryquiz set interval 120000        # 2분마다 문제 표시
/khistoryquiz set question-timeout 15    # 문제당 15초 표시

가능한 키:

• interval - 문제가 표시되는 시간 간격 (밀리초 단위, 기본값: 240000)
• question-timeout - 각 문제가 표시되는 시간 (초 단위, 기본값: 10)

Note

설정값 변경은 다음 문제가 표시될 때부터 반영됩니다.

기본 옵션

Note

아래의 설정은 위의 config.yml 파일이 없거나 잘못 작성된 경우 플러그인이 기본적으로 로드하는 설정입니다.

question-set-filter: none
interval: 240000

questions.yml (문제 세트 파일)

Note

questions.yml 파일을 아래의 방법 또는 구조와 다르게 생성할 경우 일부 또는 모든 문제가 표시되지 않을 수 있습니다.

## KHistoryQuiz 문제 세트 파일 예시
## Format:
## questions:
##   1:
##     question: "대한민국의 건국 연도는?"
##     answer: "1948"
##   2:
##     question: "한글을 창제한 왕은 누구인가요?"
##     answer: "세종대왕"

questions:
  1:
    question: "샘플 질문: 대한민국의 건국 연도는?"
    answer: "1948"

---

(c) 2026 나포키(naforky), naforky-dev. All rights reserved.