SigDrop

SigDrop 은 "Drop" 이 발생하는 모든 기능을 총괄하는 플러그인입니다. SigDrop 의 주 목적은 복합적인 확률을 요구로 하는 컨텐츠에서 config 가 너무 복잡해지지 않으면서 심도있는 레벨의 드롭 시스템을 제공하는 것에서 출발했습니다.

Commands & Permission

perm: dropadmin.op

/dropadmin reload : SigDrop reload

/dropadmin giveLoot (LOOT_ID) : (LOOT_ID) 을 스스로에게 지급
/dropadmin getAll (LOOT_ID) : (LOOT_ID) 에 있는 모든 element 획득
/dropadmin checkLoot (LOOT_ID) : (LOOT_ID) 에서 1개를 획득할 때 미리보기
/dropadmin checkAllLoot (LOOT_ID) : (LOOT_ID) 에 모두 획득할 때 미리보기 

/dropadmin getMobLoot (MOB_DROP_ID) : (MOB_DROP_ID) 에 해당되는 드롭 하나 emulate
/dropadmin getBlockLoot (BLOCK_DROP_ID) : (BLOCK_DROP_ID) 에 해당되는 드롭 하나 emulate


# SigDrop 에는 crate 기능이 내장되어 있습니다. 

crate 는 CHEST 와 Armor stand 를 지원하며 좌클릭 preview 우클릭 open 으로 설정되어 있습니다. 
crate 로 설정할 CHEST 또는 Armor stand 를 바라보며(마우스 포인트 위치) 설정해야 합니다. 

/dropadmin crate setItem (LOOT_ID) (KEY_ITEM_ID) : 바라보는 상자 또는 엔티티에서 (KEY_ITEM_ID) 아이템을 가지고 열 수 있는 (LOOT_ID) loot 를 주는 보급상자를 설정합니다.
/dropadmin crate del : 바라보는 crate 를 삭제합니다. 
/dropadmin create info : 바라보는 crate 정보를 확인합니다. 

create 정보는 해당 chest 또는 armor stand 에 그대로 저장되며, 블럭이 제거될 시 데이터도 함께 삭제됩니다. 하지만 좌클릭 삭제가 막혀 있기에 일반적인 방법으로는 삭제 할 수 없습니다.

Loot

loot.yml 에서 loot 를 설정 할 수 있습니다.

다양한 Type 에 대해 알아보기

아래 설명에서는 loot 에 가질 수 있는 Type 에 대해서 설명합니다.

$TYPE 종류

SIGREWARD : SigLib 의 SigReward 자체를 Drop 으로 설정 할 수 있습니다. 
ITEMSTACK : Default 설정이며 ItemStack 기반의 Drop 을 설정합니다. random range 및 sigdrop 만의 세부 설정을 할 수 있습니다. 
PERMISSION : Permission 을 드롭합니다. Permission 이 있을 시 on-duplicate 를 통해 중복 보상을 설정 할 수 있습니다.
CURRENCY : SigLib 이 설정되어 있는 모든 currency 를 지원합니다. 
SIG_DROP_LOOT : loot 안에 loot 를 넣을 수 있습니다 (nested loot) , 하위 세부 확률이 중요하지 않은 랜덤박스와 같은 컨텐츠 설정에 유용합니다. 
SEASON_POINT : Sigachievement 의 season point 을 Drop 으로 설정 할 수 있습니다 - 단 SIGREWARD Type 의 신설으로 이후 삭제될 가능성이 높습니다.** 

loot.yml 에서 TYPE: $TYPE 을 통해 설정 할 수 있습니다. 없을 시 Default 값인 Itemstack 이 사용됩니다.

EXAMPLE_1: # 
  localizedName: '이름' # (옵션) 해당 loot bag 의 이름 및 checkLoot 시 gui title 에 표시됩니다. 보급상자와 같이 유저가 내용물을 볼 수 있도록 해 놓은 loot 를 위한 기능입니다.
  icon: # (옵션)
    material: DIAMOND      # SIG_DROP_LOOT 인 경우 미리보기 화면에서 보여지는 것, 보통 설정할 필요X
    name: "EXAMPLE_1 name" # 이름
  requirement: # (옵션)
    offset: 10             # drop 을 통해 생성된 아이템일 경우, 해당 loot 를 획득하기 위해 필요한 최소 offset 입니다. chance 를 통해 loot 가 생성되었더라도 해당 requirement 를 맞추지 못하면 loot가 생성되지 않습니다.
    permission: 'my.perm'   # typical permissio requirement 
    biome:
      - 'PLAINS'
    placeholder:
      - 'INTEGER;{my_placeholder_1} > 10;보여지는 것 - 레벨 10이상'  
      - 'DOUBLE;{my_placeholder_2} < 50.2;보여지는 것 - 수치 50.2미만'
      - 'STRING;{my_placeholder_3} = test;보여지는 것 - test 달성 필요'

    # --------------- 아이템 예제 ( default )    
    
  CUSTOM_EXAMPLE:
    
    # 아이템 같은 경우 미리보기에서 아이템 그 자체가 보이게 됨.
    
    weight: 100            # 해당 Loot 이 뽑힐 가중치, 가중치 시스템에 대해 이해 필요
    element:
      item: 'CUSTOM SIGITEM_IDENTIFIER' # 아이템
      base-amount: 1                    # 기본 개수
      random-range: 2                   # 범위, base-amount ~ base-amount + random-range (옵션)
      per-level: 1                      # Loot 의 레벨당 올라가는 드롭 개수 (옵션)
      per-looting: 1                    # Looting 의 레벨당 올라가는 드롭 개수 (옵션)
    option:
      message:
        - "이 메세지는 드롭을 획득한 플레이어에게만 보임"
      broadcast:
        - "이 메세지는 동일한 서버 내 플레이어에게만 보임"
      bungee_broadcast:
        - "이 메세지는 번지코드 내 모든 플레이어에게 보임"

  # --------------- 퍼미션 예제!

  PANDA_HAT: 
    weight: 10
    type: PERMISSION
    element:
      name: "판다 모자"
      permission:         # 주어지는 퍼미션
        - "cosmeticscore.user.cosmetics.wear.panda_hat"
      on_duplicate:       # 해당 퍼미션을 보유하고 있을 시 주어지는 것 
        
        # 여기 아래는 SigLib 의 Reward format 이 모두 작동함. SigLib 참조할 것
        
        commands:
          - "cosmeticadmin getDuplicateCosmeticReward {player}"
          
      icon: # 미리보기에서 보이는 것 
        # PERMISSION 은 아이템이 없기 때문에 미리보기를 사용한다면, 유저가 식별 가능하도록
        # ICON 을 각각 지정해 줘야 함. DEFAULT 는 그냥 PAPER 
        material: coal
        name: "판다 모자"
        customModelData: 100082

  # --------------- 재화 예제!
  
  COIN:
    
    # 재화는 SigLib 에서 지원하는 모든 재화 가능
    
    weight: 100
    type: CURRENCY
    element:
      type: COIN          # 재화 ID 와 정확히 일치시킬 것, SigLib 참조할 것
      min: 50000          # 최소 amount 
      max: 100000         # 최대 amount

  # --------------- SIGREWARD 예제!
  
    # SigReward configuration 에 대해서는 SigLib readme 를 참조해 주세요

  SIGREWARD_DIRECT:
    weight: 100
    type: SIGREWARD
    element:
      currencies:
        COIN: 1000
      commands:
        - 'cmi broadcast {player} test'

Loot 의 사용법

정확히 어떤 방식으로 반드시 사용해야만 하는 규칙은 정해져 있지 않지만 다음과 같은 개발 방향성을 염두에 두고 설계되었습니다. 

용어 정리
- Loot.yml 에서 최상단에 위치하는 Key 는 Loot bag 라고 부릅니다.
- Loot bag 안에는 여러개의 loot element 가 존재합니다. 

Loot bag
- 같은 bag 안에 있는 loot element 는 보통 동일한 희귀도를 가지게 설정하는 것이 권장됩니다. ( loot 가 drop 또는 mobdrop 을 통해 generate 될 시 )
- 같은 bag 안에 있는 element 끼리는 다른 조건 없이 순수히 weight 을 통한 확률로만 결정됩니다. 이 방식은 일반적으로 생각하는 클래식 확률이며, 가차 등의 컨텐츠에 적합합니다. 

Requirement and Lootbag options

아래 옵션들은 loot bag 에 해당되는 옵션들이며 각 loot element 에 적용되는 옵션이 아닙니다. Loot bag 과 loot element 의 개념에 대해 숙지한 이후 아래 추가 옵션들에 대해 읽어보십시오.

EXAMPLE_1: 

  localizedName: '이름' #(OPTIONAL) 해당 loot bag 의 이름 및 checkLoot 시 gui title 에 표시됩니다. 보급상자와 같이 유저가 내용물을 볼 수 있도록 해 놓은 loot 를 위한 기능입니다.
  
  icon: # SigLib 의 IconButton 에 대한 설명을 참조하십시오.
    material: DIAMOND
    name: "EXAMPLE_1 name"
  
  requirement: #(OPTIONAL)
    
    offset: 10              # drop 을 통해 생성된 아이템일 경우, 해당 loot 를 획득하기 위해 필요한 최소 offset 입니다.
                            # chance 를 통해 loot 가 생성되었더라도 아래 requirement 중 하나 이상을 통과하지 못하는 경우 loot가 생성되지 않습니다.
                            # Drop 또는 MobDrop 을 통해 loot가 생성되는 경우를 상정하고 사용하는 기능입니다. 
    
    permission: 'my.perm'   # loot 를 획득한 player 이 다음 permission 을 소유하고 있어야 합니다. 
    
    biome:                  # loot 를 획득한 player 이 다음 biome 중 하나에 위치하고 있어야 합니다. 
                            # loot 는 항상 block 또는 entity 에서 생성되는 것이 아니므로 player 의 위치에 기반합니다. 
      - 'PLAINS'
    
    placeholder:            # papi placeholders 를 지원합니다. 
    
      # 데이터는 semi-colon(;) 을 통해 구분되며 
      # 첫번째는 INTEGER,DOUBLE,LONG 을 지원합니다.
      # 두번째는 boolean 을 return 할 수 있는 logical statement 여야 합니다. 
      # 세번째는 플레이어가 해당 loot preview 를 할 수 있을때 이 requirement 에 대한 설명입니다. 하지만 보통은 설정할 필요가 없습니다.
    
      - 'INTEGER;{my_placeholder_1} > 10;레벨 10이상' 
      - 'DOUBLE;{my_placeholder_2} < 50.2;수치 50.2미만'

Loot Tier

$LootTier 종류

    UNDEFINED
    COMMON
    UNCOMMON
    RARE
    EPIC
    LEGENDARY
    MYTHIC

  # tier 은 loot element 각각에 적용 할 수 있습니다. 
  # sigdrop 은 tier 을 제공하는 역할만 하며 다른 기능을 제공하지 않습니다. 실질적 컨텐츠 구현은 SigDrop 을 활용하면 다른 플러그인의 역할입니다. 
  # tier 이 붙어있지 않는 경우에는 지정되지 않음(UNDEFINED) 으로 설정되어 있습니다.

  FOREST_ESSENSE:
    tier: UNCOMMON # 이렇게 붙일 수 있습니다. 
    weight: 100
    element:
      item: 'CUSTOM FOREST_ESSENSE'
      base-amount: 1

Exp

  # exp 은 loot element 각각에 적용 할 수 있습니다. 
  # sigdrop 는 exp 를 제공하는 역할만 하며 다른 기능을 제공하지 않습니다. 실질적 컨텐츠 구현은 SigDrop 을 활용하면 다른 플러그인의 역할입니다. 

  FOREST_ESSENSE:
    exp: 5 # 이렇게 붙일 수 있습니다. 
    weight: 100
    element:
      item: 'CUSTOM FOREST_ESSENSE'
      base-amount: 1

Drop 시스템애 대한 기본적인 이해

Drop 시스템을 이해하기 위해서는 기본적인 정규분포(Normal Distribution) 에 대한 이해가 필요합니다.

모든 드롭은 mean 값 100, standard deviation(sd) 값 10의 정규분포를 따릅니다.
베어타운에서 mean 값은 절대 변하지 않으며 무조건 100으로 유지됩니다.
베어타운에서 sd 값은 변할 수 있으며 추가되는 보너스에 따라 변합니다.

1. drop 에서 숫자가 높아질수록 드롭 확률이 낮은 것을 뜻합니다.
2. sd = 10 + ( 보너스 값 * sensitivity ) , 단 (보너스값*sensitivity) < max-increment

Drop 수치에 대한 이해

https://onlinestatbook.com/2/calculators/normal_dist.html
사이트를 이용해 그래프를 그려 보면 이해가 쉽습니다.

아래 "20" 을 예로 들어 비수학적인 방법으로 설명한다면 다음과 같습니다.
-> 중간값(100) 에서 20보다 크거나 작을 확률 

다시 말해 그래프에서 80보다 작거나 120보다 큰 값들의 적분값이며
mean=100, sd=10, outside <80 , >120 을 넣고 0.0455 가 나오면 성공입니다.

즉 해당 Drop 이 발생했을 때 아래 Loot들이 주어질 가능성은 4.55% 입니다.

정규분포의 특성상 sd 값이 높아질수록 극단값으로 갈 가능성이 높아집니다.
SigDrop 의 희귀도 조정은 기본적으로 시스템을 활용하여 돌아갑니다.
보너스가 주어지면 플레이어가 Loot 를 획득할 떄 sd 값이 추가되며, 이에 더 높은 숫자에 위치한 Loot 가 주어질 확률이 높아집니다.
이 확률은 Loot 가 위치한 희귀도에 따라, 그리고 보너스 양에 따라 달라지므로 단순하게 드롭률n% 상승 으로 말하기 어렵습니다. 
이것이 인게임 드롭률에 대해 정확히 공지하기 어려운 이유입니다.

하지만 Loot.yml 자체에 있는 Loot 을 바로 준다면 weight 에 따라 값이 고정되어 있습니다.
유료재화 관련 컨텐츠는 이 시스템을 사용하며 각 구성에 대한 확률이 자동으로 계산되어 산출됩니다.
그렇기에 정확한 확률을 유저들께 고지 할 수 있습니다. 

drop.yml

STONE: # Bukkit Material 명과 정확히 일치해야 함 
  invocation: 1.0
  sensitivity: 0.05
  max-increment: 10
  drop:
    20:
      loot:
        - 'LAND_STAIN'
    30:
      loot:
        - 'LAND_ESSENSE'
    40:
      loot:
        - 'LAND_CORE'

MobDrop.yml

# !-- VANILLA MOB 예제

BAT: # ENTITYTYPE 과 정확히 일치해야 합니다.
  level: -1     # 드롭의 레벨입니다. 베어타운에서는 활용되지 않습니다.
  experience: -1    
  # 드롭되는 경험치입니다. 바닐라 경험치가 될 수도 있지만 현재 베어타운에서는 직업과 연동되어 있습니다. 
  
  sensitivity: 0.05   # 보너스에 따른 sd 증가량 , 별도의 지시 없이 건들지 말 것
  max-increment: 5    # sd 보너스 최대 값 , 별도의 지시 없이 건들지 말 것
  drop:
    20:               # 위에 설명함
      loot:
        - 'SOUL_STAIN'  # Loot.yml 에서 정의한 Loot 의 이름입니다.
    30:
      loot:
        - 'SOUL_ESSENSE'
    35:
      loot:
        - 'BAT_RARE'
    40:
      loot:
        - 'SOUL_CORE'
  
# ! -- MYTHICMOBS 예제 

Snail: # MYTHICMOBS ID 와 정확히 일치해야 함
  tier: 'NORMAL' # 'NORMAL' , 'BOSS' , 퀘스트를 위해 존재 현재 활발히 사용하고 있지는 않음
  experience: 10
  sensitivity: 0.1
  max-increment: 5
  drop:
    0:
      loot:
        - 'LIBRE_COMMON_DROP'
    20:
      loot:
        - 'LIBRE_UNCOMMON_DROP'
    35:
      loot:
        - 'LIBRE_RARE_DROP'
  

SigDropAPI 사용

Custom events