라공

커뮤니티 '퀘스트' 확장팩

40,000원

라공에디션자캐커뮤커뮤니티팩확장팩series:community_kit퀘스트의뢰

"의뢰판이 있는 자캐 커뮤니티를 만들고 싶어!"
"NPC가 부탁하는 의뢰, 분기 선택지, 일일·주간 반복 퀘스트가 필요해."
"수락 / 제출 / 보상 흐름을 자동으로 굴리고 싶은데."

의뢰 / 퀘스트로 콘텐츠 흐름을 만들고 싶은 분!

의뢰판 · 수락 · 제출 · 분기 의뢰 · 자동 보상
캐릭터별 퀘스트 흐름, 한 팩에.


핵심 기능 한눈에

의뢰판 수락 → 제출 흐름 일일 / 주간 / 상시 무제한 반복 퀘스트 그룹 배타 세트 (분기) 아이템 · 타입 · 카테고리 요구 포인트 · 아이템 · EXP 보상 진행도 자동 집계 완료 목록 그룹화 등급 · 진영 제한 수락 한도 감사 로그 관리자 CRUD

퀘스트 등록부터 그룹 · 배타 세트 설정까지 관리자 페이지에서 클릭만으로 끝나요.
코드를 열 필요 없이 의뢰판 한 장으로 콘텐츠 흐름이 만들어집니다.


의뢰판 — 캐릭터별 가능 퀘스트 노출

community/quest.php 한 장이 의뢰판이 돼요.

로그인한 캐릭터에게 지금 수락 가능한 퀘스트, 진행 중인 퀘스트, 완료한 퀘스트가 한 화면에 정리됩니다.

캐릭터 단위로 동작

한 계정에 캐릭터가 여러 명이어도 각자 따로 진행돼요. 메인 캐릭터를 바꾸면 의뢰판도 그 캐릭터 기준으로 갱신됩니다.

가능한 것만 보여주기

등급 · 진영 · 공개 기간 · 수락 한도 · 그룹 배타성을 모두 반영해서, 지금 그 캐릭터가 받을 수 있는 의뢰만 의뢰판에 띄웁니다.

NPC 이름 / 이미지 노출

퀘스트마다 NPC 이름과 이미지를 지정할 수 있어요. 의뢰판이 단순한 목록이 아니라 NPC가 부탁하는 게시판처럼 보입니다.

일일 · 주간 한도 표시

오늘 수락한 횟수, 이번 주 수락한 횟수가 헤더에 핀처럼 붙어요. 남은 의뢰 수를 한눈에 확인합니다.

clipboard_1778144729254.png

진행 중 · 완료 · 현황   / 수락 가능 패널이 양쪽으로 분리된 보드 레이아웃


수락 → 제출 흐름

캐릭터가 의뢰판에서 수락하면 진행 중 패널로 이동하고, 조건이 만족되면 제출하는 단순한 흐름이에요.

제출 시점에 락이 걸려서, 동시에 클릭해도 보상이 중복 지급되지 않아요.

의뢰판에서 수락 → 조건(아이템·횟수) 만족 → 제출 클릭 → 자동 차감 + 보상 지급

의뢰.gif
어떤 식으로 수락하고 제출하는지 흐름을 이미지로 첨부!
*운영 커뮤니티 전용 레이아웃으로, 다른 이미지와 차이가 있는 점 참고 바랍니다.

제출 조건을 세 가지 방식으로 걸 수 있어요

아이템 — 특정 아이템 N개

가장 직관적인 방식. "토끼 가죽 5개를 가져오세요" 같은 의뢰에 사용해요.

타입 — 같은 it_type 아이템 합산

"약초 종류 아무거나 3개" 처럼 타입이 같은 아이템을 묶어서 받을 수 있어요. 유저가 인벤토리에서 어떤 약초로 낼지 직접 선택합니다.

카테고리 — 같은 분류 합산

"장신구 카테고리 아이템 2개" 처럼 카테고리 단위로도 가능. 자유도 높은 의뢰 설계에 좋아요.

다중 요구 (JSON)

한 퀘스트에 여러 줄을 걸 수 있어요. "토끼 가죽 5개 + 약초 3개 + 장신구 1개"도 한 번의 제출로 처리됩니다.

귀속 우선 차감!
제출 시 귀속 아이템부터 우선 소모됩니다. 거래 가능한 아이템은 보존되도록 자동 처리돼요.


퀘스트 그룹 — 묶어서 관리

여러 퀘스트를 그룹으로 묶을 수 있어요.

시즌별, 챕터별, 진영별로 그룹을 나누면 운영이 훨씬 깔끔합니다.

그룹별 정리

"1챕터 의뢰", "겨울 시즌 의뢰", "도적 길드 의뢰" 같이 묶음 단위로 관리할 수 있어요. 관리자 페이지에서 그룹 생성 → 퀘스트에 그룹 지정만 하면 끝!

그룹 자체 켜고 끄기

그룹 단위로 사용 여부를 토글할 수 있어요. 시즌 종료 시 그룹 하나만 비활성화하면 그 안의 퀘스트 전체가 의뢰판에서 빠집니다.


배타 세트 — 분기 의뢰

같은 배타 세트에 묶인 그룹들 중 한 그룹만 선택할 수 있게 만드는 시스템.

"이번 주는 도적 길드 의뢰만 받을지, 기사단 의뢰만 받을지 골라!" 같은 진영 분기에 딱이에요.

배타성 3가지 — 운영 콘셉트에 맞게 선택

active — 동시 진행 불가

한 그룹의 퀘스트가 진행 중일 때, 다른 그룹의 퀘스트는 수락할 수 없어요. 한쪽을 완료(또는 포기)하면 다른 그룹으로 넘어갈 수 있습니다.

cycle — 사이클당 택1

이번 주기(일일/주간) 동안 한 그룹만 받을 수 있어요. 다음 주기가 오면 다시 자유롭게 선택 가능. 주간 분기 의뢰에 적합합니다.

once — 영구 선택

한번 선택한 그룹의 퀘스트를 완료하면 다른 그룹은 영영 받을 수 없어요. 진영 선택 같은 돌이킬 수 없는 분기에 사용합니다.

clipboard_1778145377226.png

완료 시 상대 그룹 자동 정리
once 타입 세트에서 한 그룹 퀘스트를 완료하면, 같은 캐릭터가 상대 그룹에서 진행 중이던 active 퀘스트를 자동으로 정리하고 로그에 기록합니다. (enforce_quest_group_exclusivity())


상시 퀘스트 (무제한 반복)

일일 / 주간 외에 상시(permanent) 주기가 있어요.

상시 + 반복 모드로 설정하면 매 제출마다 완료 처리되어 완료 기록에 남고, 즉시 다시 수락할 수 있어요. 무제한 반복 의뢰가 깔끔하게 굴러갑니다.

cycle_key 기반 분리

매 수락마다 perm_타임스탬프 키로 새 진행 레코드가 생겨요. 같은 퀘스트라도 매번 다른 사이클로 기록되어 완료 이력이 그대로 누적됩니다.

반복 한도(qst_repeat_limit) 설정

0이면 무제한 반복, 양수를 넣으면 누적 제출 횟수가 그 한도까지만 가능해요. 운영자가 원하는 만큼만 풀 수 있습니다.

일일 / 주간 한도 자동 계산
일일 초기화 시간은 00시, 주간 시작 요일은 월요일 입니다.

clipboard_1778145611189.png
clipboard_1778145740171.png

상시 의뢰와 주간 정량 의뢰

clipboard_1778145546540.png

의뢰 추가/수정 시 설정 화면


진행 상태 추적 / 완료 그룹화

진행 중 / 완료 패널에서 캐릭터별 진행 상황을 한눈에 볼 수 있어요.

진행 중 — 실시간 진행도

요구 아이템별 보유량 표시

각 요구 아이템마다 "보유 X개 / 필요 Y개"가 표시돼요. 타입·카테고리 모드에선 인벤토리 합산값으로 자동 계산됩니다.

반복 의뢰 누적 진행도

반복 모드 퀘스트는 누적 제출 횟수와 진행률(%)이 함께 표시돼요. "5/10회 (50%)" 처럼 직관적으로 확인됩니다.

기간 만료 자동 정리

공개 종료일이 지난 퀘스트는 진행 중 목록에서 자동으로 빠져나가요. 만료된 의뢰가 인벤토리를 갉아먹는 일이 없습니다.

clipboard_1778145918620.png

완료 — 같은 퀘스트는 그룹화

총 완료 횟수 집계

같은 퀘스트의 완료 기록은 한 줄로 묶이고, 총 완료 횟수와 총 제출 횟수, 최근 완료일이 함께 표시돼요. 100번 반복한 의뢰가 100줄로 도배되지 않습니다.

최근 30건까지 노출

의뢰판 완료 탭에는 최근 30개 퀘스트가 노출돼요. 더 자세한 이력은 관리자 로그에서 전부 볼 수 있습니다.

clipboard_1778145938043.png

보상 시스템 — 포인트 · 아이템 · EXP

제출이 완료되는 순간 보상이 자동으로 들어가요. 관리자가 따로 지급할 필요 없습니다.

포인트 보상

기본팩의 give_point_direct()로 즉시 지급. 그누보드 포인트 시스템과 그대로 연동됩니다.

아이템 보상 (다중)

여러 아이템을 한번에 줄 수 있어요. 반복 모드에선 제출 횟수에 비례해서 자동으로 곱해집니다.

경험치 보상 (전투팩 연동)

전투 확장팩이 설치되어 있으면 give_character_exp()로 EXP가 자동 지급돼요. 없으면 자동으로 건너뜁니다.

중복 지급 방지

제출 처리에 트랜잭션 + FOR UPDATE 락이 걸려 있어서, 동시에 두 번 클릭해도 보상이 한 번만 지급됩니다.

보상 메시지 자동 조합
제출 완료 시 "보상: 100P, 토끼 가죽 x3, 경험치 50" 같은 문자열이 자동으로 만들어져 캐릭터에게 안내됩니다.


퀘스트 로그

모든 수락 / 제출 / 완료 / 포기 / 강제 정리 내역이 community_quest_log에 기록돼요.

관리자 페이지에서도 확인할 수 있어요.

로그에 남는 정보

액션 종류

accept 수락 / submit 제출 / complete 완료 / abandon 포기 — 4가지 액션이 모두 기록됩니다.

상세 JSON

제출 수량, 요구/보상 아이템 내역, 보상 포인트/EXP, 완료 여부가 JSON으로 저장돼요. 분쟁이 생겨도 정확히 무엇을 주고받았는지 그대로 확인할 수 있습니다.

IP · 시각 기록

접속 IP와 시각이 함께 남아 운영 추적에 도움이 돼요.

clipboard_1778146019598.png

관리자 — CRUD + 설정

관리자 > 커뮤니티 관리 > 퀘스트 탭에서 모든 작업을 합니다.

관리자가 할 수 있는 것

퀘스트 등록 / 수정 / 삭제

이름, 설명, 주기 유형, 모드(정량/반복), 요구 아이템(아이템·타입·카테고리 다중), 보상(포인트·아이템·EXP), NPC 이름·이미지, 등급/진영 제한, 공개 기간까지 한 폼에서 설정해요.

퀘스트 그룹 등록

그룹명, 설명, 사용 여부를 설정. 등록한 그룹은 퀘스트 폼의 그룹 셀렉트에 자동 노출됩니다.

배타 세트 등록

세트명, 설명, 배타성(active / cycle / once) 3가지 중 선택. 만든 세트에 그룹들을 배치하면 분기 의뢰 구조가 완성돼요.

전역 설정 — 한도 · 리셋 시간

일일 수락 한도, 주간 수락 한도, 일일 초기화 시간, 주간 시작 요일을 관리자 설정에서 조정할 수 있어요. 퀘스트 기능 전체를 토글하는 사용 여부 옵션도 있습니다.


설치법

기본팩이 설치되어 있다는 전제로 설명할게요.

압축 해제 → FTP /html에 드래그 앤 드랍 → 관리자 > 커뮤니티 관리 진입 (테이블 자동 생성) → 메뉴에 의뢰판 추가

의존성: 기본팩

커뮤니티 기본 확장팩
▼ 기반
퀘스트 확장팩 (이 상품)

꼭 필요한 것

커뮤니티 기본팩이 먼저 설치되어 있어야 해요. 캐릭터 · 포인트 · 아이템 · 인벤토리 시스템 위에서 동작합니다.

있으면 더 풍성해지는 것

전투 확장팩이 있으면 경험치 보상(EXP)이 자동으로 동작해요. 없어도 포인트 · 아이템 보상은 그대로 작동합니다.

라공 에디션이 먼저 설치되어 있어야 해요.


묶어 사면 더 저렴해요!

퀘스트에 융합을 사용하실 예정이라면, 묶음으로 사는 쪽이 이득입니다.

베이직팩

커뮤니티 기본 확장팩 298,000원
융합 확장팩 30,000원
퀘스트 확장팩 40,000원
정가 합계 368,000원
번들 5% 할인 368,000원   349,600원

18,400원 절약 · 구성품을 모두 새로 구매할 때의 절약액입니다.

이미 구매한 팩이 있어도 번들 할인을 받을 수 있나요?

기존 구매 상품도 번들 구성에 포함돼요.

로그인 후 기존의 유효한 구매 상품과 이번에 구매할 상품으로 번들 구성을 모두 갖추면, 이번에 새로 구매하는 구성품에만 번들 할인이 적용돼요.

번들 할인과 시리즈 할인은 중복 적용되지 않으며, 이번 결제에 적용 가능한 할인 중 더 유리한 쪽을 적용합니다. 과거 결제 금액을 다시 계산하거나 차액을 환급하지는 않아요.

위 번들 가격은 구성품을 모두 새로 구매할 때의 금액이며 쿠폰·포인트 적용 전입니다. 실제 결제 금액은 주문 화면에서 확인해 주세요.


신뢰 · 안정성

즉시 다운로드 · 영구 사용

구매 즉시 ZIP 파일을 받아 그대로 설치할 수 있어요. 펀딩이나 일정에 묶이지 않습니다.

동시성 · 보상 정합성

제출 처리에 BEGIN / FOR UPDATE / COMMIT 흐름이 들어가 있어, 동시 클릭에도 아이템 차감과 보상 지급이 어긋나지 않게 처리됩니다.

구매 전 확인사항

· 커뮤니티 기본팩이 먼저 설치되어 있어야 작동합니다.
· 의뢰판 메뉴는 관리자 메뉴 페이지에서 직접 추가해주세요.
· 스타일 커스텀, 기능 추가 요청은 답변드리기 어렵습니다.

## 포함 파일
adm/
└── community/
    ├── install/
    │   └── quest.sql
    ├── quest/
    │   └── quest.php
    └── tabs/
        └── quest.php
community/
├── lib/
│   └── quest.lib.php
├── quest.php
└── quest_action.php
extend/
└── quest_config.php

**총 7개 파일**

등록된 리뷰가 없습니다.


궁금한 사항이 해결되지 않으셨나요? QnA 게시판에서 문의하실 수 있습니다.

완료

기본팩과 함께 업데이트해 주세요.

  • 퀘스트 관리의 설정에서 "퀘스트 기능 사용"을 끌 수 있습니다. 끄면 의뢰판 화면과 수락·제출이 모두 막힙니다. 일일 초기화 시각과 주간 시작 요일(월·일)도 정할 수 있습니다.
    기본값은 '사용'이라 업데이트해도 달라지는 것은 없습니다. 끄면 모든 회원의 의뢰판과 수락·제출이 막힙니다.
  • 퀘스트 제출 확인창에 소모되는 재료가 표시됩니다. 반복 제출이면 횟수만큼 곱한 재료를 보여 줍니다.
  • 퀘스트 관리에서 제출 재료 없이 반복 한도를 0(무제한)으로 둔 퀘스트에 경고 표시가 붙고, 저장 전에 "보상을 끝없이 받을 수 있다"는 확인을 받습니다. 저장 자체는 막지 않습니다.
  • 퀘스트 목록의 "요구 아이템" 칸 이름이 "제출"로 바뀌고, 그룹·세트는 별도 칸 대신 이름 아래에 표시됩니다.
  • 퀘스트 등록·수정에서 NPC 이미지 미리보기가 표시됩니다.
  • 퀘스트 화면의 알림이 확인창 대신 화면 위 토스트로 표시됩니다. (기본팩과 함께 쓸 때)
  • 퀘스트 수락이 동시에 눌릴 때 같은 퀘스트가 두 번 수락되거나 인원 제한을 넘어 수락되던 문제를 수정했습니다.
  • 보상 아이템을 지급할 수 없는 상태(삭제됐거나 사용 중지, 소지 한도 초과)에서 제출하면 재료만 사라지던 문제를 수정했습니다. 이제 제출이 취소되고 제출한 아이템은 그대로 남습니다.
    보상을 받을 자리가 모자라면 제출이 거절됩니다. 소지품을 비운 뒤 다시 제출하면 됩니다.
  • 포인트·경험치 보상 지급에 실패했는데 받은 것처럼 표시되던 문제를 수정했습니다. 지급되지 않은 보상은 안내 문구로 알려 줍니다.
  • 수락 이후 사용 중지되거나 공개 기간이 끝난 퀘스트도 제출할 수 있던 문제를 수정했습니다.
  • 정량 퀘스트는 한 번에 1회만, 반복 퀘스트는 한 번에 최대 100회(반복 한도가 있으면 그 남은 횟수)까지만 제출되도록 했습니다.
  • 상시 퀘스트의 인원 제한이 제대로 세어지지 않던 문제와, 같은 순간 수락한 상시 퀘스트의 기록이 겹치던 문제를 수정했습니다.
  • 진영이 없는 캐릭터가 진영 제한 퀘스트를 수락할 수 있던 문제를 수정했습니다.
  • 연말연시 주간 퀘스트의 새 주기가 어긋나던 문제를 수정했습니다.
  • 퀘스트 처리 중 오류가 나면 서버 오류 내용이 그대로 보이던 문제를 수정했습니다. 이제 한국어 안내가 표시되고, 제출 도중 오류가 나면 진행 중이던 처리를 되돌립니다.
  • 퀘스트 관리에서 이름·설명에 따옴표가 들어가면 앞에 역슬래시가 붙어 저장되던 문제를 수정했습니다.
  • 퀘스트 관리에서 주기·방식·기간 값이 잘못 들어와 조용히 저장에 실패하던 문제를 수정했습니다.
  • 퀘스트를 삭제해도 처리 기록(로그)은 남도록 했습니다. 삭제 확인창에 이 내용을 안내합니다.
  • 아이템 이름·재료 이름에 타인이 심은 코드가 그대로 실행될 수 있었던 문제를 수정했습니다.
  • 퀘스트의 요청 확인을 보완했습니다.
  • 배타 세트가 "사이클 내 택1"일 때 상시 퀘스트를 받은 이력이 배타 조건으로 인식되지 않던 문제를 수정했습니다.
  • 설치 직후 관리자 화면을 한 번 열기 전에는 퀘스트 화면이 "비활성화"로 막히던 문제를 수정했습니다. 이제 기본값인 "사용"으로 동작합니다.
  • 퀘스트 관리를 퀘스트·그룹/배타 세트·기록·설정 네 개 보기로 나누고 공통 헤더로 통일했습니다. 저장 버튼은 상단 바로 모았습니다. (기본팩과 함께 쓸 때)
  • 퀘스트 수정 폼을 기본 정보, 제출 요구/획득 보상, 제한 조건/NPC 세 구획으로 나눴습니다. 비어 있는 재료·보상, 퀘스트가 하나도 없을 때의 안내를 붙였습니다.
  • 퀘스트 목록의 유형·방식이 "일간·주간·상시", "반복 비례·정량 1회"로 표시되고, 그룹·배타 세트 화면도 정리했습니다.
  • 퀘스트 관리의 저장·삭제 결과가 성공이면 화면 위 안내 문구로, 실패하면 토스트로 표시됩니다. (기본팩과 함께 쓸 때)
  • 퀘스트 패널 탭에서 밑줄 강조가 따라 움직입니다. (에디션 2.2.0과 함께 쓸 때)
  • 퀘스트 포기를 그 자리에서 확인하고 되돌릴 수 있습니다. (에디션 2.2.0과 함께 쓸 때)
완료

퀘스트 수락 횟수 설정 추가

  • 관리자 퀘스트 설정에서 캐릭터별 일일·주간 퀘스트 수락 횟수를 조정할 수 있도록 추가했습니다.
  • 수락 횟수를 0으로 설정하면 제한 없이 이용할 수 있습니다.
  • 상시 퀘스트는 일일·주간 수락 횟수 제한에서 제외됩니다.
완료
  • 필드 확장팩이 없는 환경에서 퀘스트의 등급 제한과 진영 제한이 적용되지 않던 문제를 수정했습니다.
완료
  • 전체 커뮤니티 키트 점검 기준에 맞춰 다운로드 파일을 오늘 기준 패키지로 교체했습니다.
완료
  • 인터랙션 캐릭터 스킨을 프로필 기본값으로 선택하였을 경우 캐릭터 생성 시 경로 조정
×