Quota

일/월/시간 별로 구매/판매 수량을 제한하는 기능입니다.

Feature

TimedQuota

TimedQuota는 TimeType 별로 유저에게 할당된 판매 수량 데이터를 저장합니다. TimedQuota 의 기본 데이터 형식은 다음과 같습니다.

QUOTA:
  TYPE: DAILY
  BUY: 2
  SELL: 3

ShopItem은 Quota Id를 찾은 후 없을 경우 일반적인 로드를, 있을 경우 ID를 읽어 TimedQuotaConfig(quota.yml)에서 Quota 데이터를 로드합니다.

QUOTA:
  ID: "TEST_QUOTA_ID"

TimedQuotaConfig

TEST_QUOTA_ID:
  TYPE: DAILY
  BUY: 2
  SELL: 3

TimedQuotaConfig의 포맷은 위와 같습니다.

Quota Modifier

sigshop.quota.modifier.buy.{item_id}.100 // 1.0x
sigshop.quota.modifier.sell.{item_id}.200 // 2.0x

해당 Permission을 가지고 있을 경우 최종 quota 값에 반영됩니다. {item_id}는 소문자여야 합니다.

SigRequirement Extension

SigRequirementApi.getInstance().register("BUY_QUOTA", BuyQuotaRequirement::new);
SigRequirementApi.getInstance().register("SELL_QUOTA", SellQuotaRequirement::new);

현재 두개의 SigRequirement Extension이 존재합니다.

두개의 Extension 모두 messages에 다음 placeholder를 사용할 수 있습니다.

• {type}: TimeType 종류

• {max}: 최대 구매 가능한 갯수

SellQuotaRequirement

type: SELL_QUOTA, 1개라도 판매가 가능한지 여부를 나타냅니다.

requirement:
  type: "SELL_QUOTA"

BuyQuotaRequirement

type: BUY_QUOTA, 1개라도 구매가 가능한지 여부를 나타냅니다.

requirement:
  type: "BUY_QUOTA"