@malib/gear 0.15.1 → 1.0.0-next.0

package/dist/lib/GearReq.d.ts

@@ -0,0 +1,72 @@
+import { GearReqData } from './data';
+/**
+ * 장비 착용 제한
+ */
+export declare class GearReq implements GearReqData {
+    /**
+     * 장비 착용 제한 정보
+     */
+    data: GearReqData;
+    /**
+     * 장비 착용 제한 정보를 참조하는 장비 착용 제한 인스턴스를 생성합니다.
+     */
+    constructor(data: GearReqData);
+    /**
+     * 착용 가능 레벨
+     */
+    get level(): number;
+    /**
+     * 착용 가능 STR
+     */
+    get str(): number;
+    /**
+     * 착용 가능 DEX
+     */
+    get dex(): number;
+    /**
+     * 착용 가능 INT
+     */
+    get int(): number;
+    /**
+     * 착용 가능 LUK
+     */
+    get luk(): number;
+    /**
+     * 착용 가능 직업 분류
+     * */
+    get job(): number;
+    /**
+     * 착용 가능 직업
+     */
+    get class(): number;
+    /**
+     * 초보자 및 전 직업 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    beginner(): boolean;
+    /**
+     * 전사 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    warrior(): boolean;
+    /**
+     * 마법사 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    magician(): boolean;
+    /**
+     * 궁수 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    bowman(): boolean;
+    /**
+     * 도적 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    thief(): boolean;
+    /**
+     * 해적 착용 가능 여부를 계산합니다.
+     * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+     */
+    pirate(): boolean;
+}

package/dist/lib/data/GearAttributeData.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 장비 속성 정보
+ */
+export type GearAttributeData = {
+    /** 고유 아이템 */
+    only?: boolean;
+    /** 교환 가능 여부 */
+    trade?: GearTrade;
+    /** 고유장착 아이템 */
+    onlyEquip?: boolean;
+    /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
+    share?: GearShare;
+    /** 황금망치 사용 불가 */
+    blockGoldenHammer?: boolean;
+    /** 슈페리얼 */
+    superior?: boolean;
+    /** 강화불가 */
+    cannotUpgrade?: boolean;
+    /** 추가 옵션 설정 가능 여부 */
+    canAddOption?: AddOptionCan;
+    /** 잠재능력 설정 가능 여부 */
+    canPotential?: PotentialCan;
+    /** 에디셔널 잠재능력 설정 가능 여부 */
+    canAdditionalPotential?: PotentialCan;
+    /** 스페셜 아이템 여부 */
+    specialGrade?: boolean;
+    /** 착용 레벨 증가 */
+    reqLevelIncrease?: number;
+    /** 카르마의 가위 사용 가능 여부 */
+    cuttable?: GearCuttable;
+    /** 가위 사용 가능 횟수 */
+    cuttableCount?: number;
+    /** 쉐어 네임 텍을 사용 가능 여부 */
+    accountShareTag?: boolean;
+    /** 럭키 아이템 */
+    lucky?: boolean;
+    /** 장착 시 획득 경험치 */
+    incline?: Partial<GearIncline>;
+    /** 보스 드롭 여부 */
+    bossReward?: boolean;
+    /** 성장 경험치 */
+    growthExp?: number;
+    /** 성장 레벨 */
+    growthLevel?: number;
+    /** 장비 유효 기간(KST) */
+    dateExpire?: string;
+};
+export declare const enum GearTrade {
+    /** 교환 가능 */
+    Tradeable = 0,
+    /** 교환 불가 */
+    TradeBlock = 1,
+    /** 장착 시 교환 불가 */
+    EquipTradeBlock = 2
+}
+export declare const enum GearShare {
+    /** 없음 */
+    None = 0,
+    /** 월드 내 나의 캐릭터 간 이동 가능 */
+    AccountSharable = 1,
+    /** 월드 내 나의 캐릭터 간 1회 이동 가능 (이동 후 교환불가) */
+    AccountSharableOnce = 2
+}
+export declare const enum AddOptionCan {
+    /** 없음 (장비 분류를 따름) */
+    None = 0,
+    /** 설정 가능 */
+    Can = 1,
+    /** 설정 불가 */
+    Cannot = 2
+}
+export declare const enum PotentialCan {
+    /** 없음 (장비 분류를 따름) */
+    None = 0,
+    /** 설정 가능 */
+    Can = 1,
+    /** 설정 불가 */
+    Cannot = 2,
+    /** 재설정 불가 */
+    Fixed = 3
+}
+export declare const enum GearCuttable {
+    /** 없음 */
+    None = 0,
+    /** 카르마의 가위 또는 실버 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+    Silver = 1,
+    /** 플래티넘 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+    Platinum = 2
+}
+export type GearIncline = {
+    /** 카리스마 */
+    charisma: number;
+    /** 통찰력 */
+    insight: number;
+    /** 의지 */
+    will: number;
+    /** 손재주 */
+    craft: number;
+    /** 감성 */
+    sense: number;
+    /** 매력 */
+    charm: number;
+};

package/dist/lib/data/GearData.d.ts

@@ -0,0 +1,130 @@
+import { AddOptionGrade, AddOptionType } from '../enhance/addOption';
+import { GearAttributeData } from './GearAttributeData';
+import { GearOption } from './GearOption';
+import { GearType } from './GearType';
+import { PotentialData } from './PotentialData';
+import { PotentialGrade } from './PotentialGrade';
+import { SoulSlotData } from './SoulSlotData';
+/**
+ * 장비 정보
+ */
+export type GearData = {
+    /** 장비 메타데이터 */
+    meta: GearMetadata;
+    /** 장비명 */
+    name: string;
+    /** 장비 아이콘 */
+    icon?: string;
+    /** 장비 설명 */
+    desc?: string;
+    /** 장비 외형 */
+    shapeName?: string;
+    /** 장비 외형 아이콘 */
+    shapeIcon?: string;
+    /** 장비 분류 */
+    type: GearType;
+    /** 장비 착용 제한 */
+    req: GearReqData;
+    /** 장비 속성 */
+    attributes: GearAttributeData;
+    /** 장비 기본 옵션 */
+    baseOption?: Partial<GearBaseOption>;
+    /** 장비 추가 옵션 */
+    addOption?: Partial<GearAddOption>;
+    /** 장비 주문서 강화 옵션 */
+    upgradeOption?: Partial<GearUpgradeOption>;
+    /** 장비 스타포스 옵션 */
+    starforceOption?: Partial<GearStarforceOption>;
+    /** 업그레이드 횟수 */
+    scrollUpgradeCount?: number;
+    /** 복구 가능 횟수 */
+    scrollResilienceCount?: number;
+    /** 업그레이드 가능 횟수 */
+    scrollUpgradeableCount?: number;
+    /** 황금 망치 재련 적용 */
+    goldenHammer?: number;
+    /** 강화 단계 */
+    star?: number;
+    /** 최대 강화 단계 */
+    maxStar?: number;
+    /** 놀라운 장비 강화 주문서 사용 여부 */
+    starScroll?: boolean;
+    /** 소울 웨폰 정보 */
+    soulSlot?: SoulSlotData;
+    /** 잠재능력 등급 */
+    potentialGrade?: PotentialGrade;
+    /** 잠재능력 목록 */
+    potentials: [
+        PotentialData | null,
+        PotentialData | null,
+        PotentialData | null
+    ];
+    /** 에디셔널 잠재능력 등급 */
+    additionalPotentialGrade?: PotentialGrade;
+    /** 에디셔널 잠재능력 목록 */
+    additionalPotentials: [
+        PotentialData | null,
+        PotentialData | null,
+        PotentialData | null
+    ];
+    /** 장비 익셉셔널 옵션 */
+    exceptionalOption?: Partial<GearExceptionalOption>;
+    /** 익셉셔널 강화 횟수 */
+    exceptionalUpgradeCount?: number;
+    /** 익셉셔널 강화 가능 횟수 */
+    exceptionalUpgradeableCount?: number;
+};
+/**
+ * 장비 메타데이터
+ *
+ * 사용자는 메타데이터에 커스텀 속성을 추가할 수 있습니다.
+ * 커스텀 속성은 해당 라이브러리가 임의로 변경하지 않습니다.
+ * 충돌을 방지하기 위해 커스텀 속성명은 하나의 `_`으로 시작해야 합니다.
+ */
+export type GearMetadata = {
+    /** 아이템 ID */
+    id: number;
+    /** 장비 정보 버전 */
+    version: 1;
+    /** 추가 옵션 적용 기록 */
+    add: [AddOptionType, AddOptionGrade][];
+};
+/**
+ * 장비 착용 제한 정보
+ */
+export type GearReqData = {
+    /** 착용 가능 레벨 */
+    level?: number;
+    /** 착용 가능 STR */
+    str?: number;
+    /** 착용 가능 LUK */
+    luk?: number;
+    /** 착용 가능 DEX */
+    dex?: number;
+    /** 착용 가능 INT */
+    int?: number;
+    /** 착용 가능 직업 분류 */
+    job?: number;
+    /** 착용 가능 직업 */
+    class?: number;
+};
+/**
+ * 장비 기본 옵션
+ */
+export type GearBaseOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 추가 옵션
+ */
+export type GearAddOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 주문서 옵션
+ */
+export type GearUpgradeOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 장비 스타포스 옵션
+ */
+export type GearStarforceOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 장비 익셉셔널 옵션
+ */
+export type GearExceptionalOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower'>;

package/dist/lib/data/GearOption.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 장비 옵션
+ */
+export type GearOption = {
+    /** STR */
+    str: number;
+    /** DEX */
+    dex: number;
+    /** INT */
+    int: number;
+    /** LUK */
+    luk: number;
+    /** STR(%) */
+    strRate: number;
+    /** DEX(%) */
+    dexRate: number;
+    /** INT(%) */
+    intRate: number;
+    /** LUK(%) */
+    lukRate: number;
+    /** 최대 HP */
+    maxHp: number;
+    /** 최대 MP */
+    maxMp: number;
+    /** 최대 HP(%) */
+    maxHpRate: number;
+    /** 최대 MP(%) */
+    maxMpRate: number;
+    /** 공격력 */
+    attackPower: number;
+    /** 마력 */
+    magicPower: number;
+    /** 공격력(%) */
+    attackPowerRate: number;
+    /** 마력(%) */
+    magicPowerRate: number;
+    /** 방어력 */
+    armor: number;
+    /** 방어력(%) */
+    armorRate: number;
+    /** 이동속도 */
+    speed: number;
+    /** 점프력 */
+    jump: number;
+    /** 보스 공격 시 데미지 증가(%) */
+    bossDamage: number;
+    /** 몬스터 방어율 무시(%) */
+    ignoreMonsterArmor: number;
+    /** 올스탯(%) */
+    allStat: number;
+    /** 데미지(%) */
+    damage: number;
+    /** 착용 레벨 감소 */
+    reqLevelDecrease: number;
+    /** 크리티컬 확률(%) */
+    criticalRate: number;
+    /** 크리티컬 데미지(%) */
+    criticalDamage: number;
+    /** 재사용 대기시간 감소 (초) */
+    cooltimeReduce: number;
+    /** 캐릭터 기준 9레벨 당 STR */
+    strLv: number;
+    /** 캐릭터 기준 9레벨 당 DEX */
+    dexLv: number;
+    /** 캐릭터 기준 9레벨 당 INT */
+    intLv: number;
+    /** 캐릭터 기준 9레벨 당 LUK */
+    lukLv: number;
+};

package/dist/lib/data/GearType.d.ts

@@ -0,0 +1,220 @@
+export declare const enum GearType {
+    /** 모자 */
+    cap = 100,
+    /** 얼굴장식 */
+    faceAccessory = 101,
+    /** 눈장식 */
+    eyeAccessory = 102,
+    /** 귀고리 */
+    earrings = 103,
+    /** 상의 */
+    coat = 104,
+    /** 한벌옷 */
+    longcoat = 105,
+    /** 하의 */
+    pants = 106,
+    /** 신발 */
+    shoes = 107,
+    /** 장갑 */
+    glove = 108,
+    /** 망토 */
+    cape = 110,
+    /** 반지 */
+    ring = 111,
+    /** 펜던트 */
+    pendant = 112,
+    /** 벨트 */
+    belt = 113,
+    /** 훈장 */
+    medal = 114,
+    /** 어깨장식 */
+    shoulder = 115,
+    /** 포켓 아이템 */
+    pocket = 116,
+    /** 뱃지 */
+    badge = 118,
+    /** 안드로이드 */
+    android = 166,
+    /** 기계 심장 */
+    machineHeart = 167,
+    /** 방패 */
+    shield = 109,
+    /** 엠블렘 */
+    emblem = 119,
+    /** 파워소스 */
+    powerSource = 119020,
+    /** 샤이닝 로드 */
+    shiningRod = 1212,
+    /** 튜너 */
+    tuner = 1213,
+    /** 브레스 슈터 */
+    breathShooter = 1214,
+    /** 소울 슈터 */
+    soulShooter = 122,
+    /** 데스페라도 */
+    desperado = 123,
+    /** 에너지소드 */
+    energySword = 124,
+    /** ESP 리미터 */
+    espLimiter = 126,
+    /** 체인 (카데나) */
+    chain = 127,
+    /** 매직 건틀렛 */
+    magicGauntlet = 128,
+    /** 부채 (호영) */
+    ritualFan = 129,
+    /** 한손검 */
+    ohSword = 130,
+    /** 한손도끼 */
+    ohAxe = 131,
+    /** 한손둔기 */
+    ohBlunt = 132,
+    /** 단검 */
+    dagger = 133,
+    /** 블레이드 */
+    katara = 134,
+    /** 케인 */
+    cane = 136,
+    /** 완드 */
+    wand = 137,
+    /** 스태프 */
+    staff = 138,
+    /** 두손검 */
+    thSword = 140,
+    /** 차크람 */
+    chakram = 1404,
+    /** 두손도끼 */
+    thAxe = 141,
+    /** 두손둔기 */
+    thBlunt = 142,
+    /** 창 */
+    spear = 143,
+    /** 폴암 */
+    polearm = 144,
+    /** 활 */
+    bow = 145,
+    /** 석궁 */
+    crossbow = 146,
+    /** 아대 */
+    claw = 147,
+    /** 너클 */
+    knuckle = 148,
+    /** 건 */
+    gun = 149,
+    /** 삽 */
+    shovel = 150,
+    /** 곡괭이 */
+    pickaxe = 151,
+    /** 듀얼 보우건 */
+    dualBowguns = 152,
+    /** 핸드캐논 */
+    handCannon = 153,
+    /** 대검 */
+    heavySword = 156,
+    /** 태도 */
+    longSword = 157,
+    /** 건틀렛 리볼버 */
+    gauntletRevolver = 158,
+    /** 에인션트 보우 */
+    ancientBow = 159,
+    /** 소울실드 */
+    soulShield = 1098,
+    /** 포스실드 */
+    demonShield = 1099,
+    /** 마법화살 */
+    magicArrow = 135200,
+    /** 카드 */
+    card = 135210,
+    /** 메달 */
+    medallion = 135220,
+    /** 로자리오 */
+    rosary = 135221,
+    /** 쇠사슬 */
+    ironChain = 135222,
+    /** 마도서 (불,독) */
+    magicBook1 = 135223,
+    /** 마도서 (얼음,번개) */
+    magicBook2 = 135224,
+    /** 마도서 (비숍) */
+    magicBook3 = 135225,
+    /** 화살깃 */
+    arrowFletching = 135226,
+    /** 활골무 */
+    bowThimble = 135227,
+    /** 단검용 검집 */
+    daggerScabbard = 135228,
+    /** 부적 */
+    charm = 135229,
+    /** 오브 */
+    orb = 135240,
+    /** 용의 정수 */
+    dragonEssence = 135250,
+    /** 소울링 */
+    soulRing = 135260,
+    /** 매그넘 */
+    magnum = 135270,
+    /** 리스트밴드 */
+    wristBand = 135290,
+    /** 조준기 */
+    farSight = 135291,
+    /** 화약통 */
+    powderKeg = 135292,
+    /** 무게추 */
+    mass = 135293,
+    /** 문서 */
+    document = 135294,
+    /** 마법구슬 */
+    magicMarble = 135295,
+    /** 화살촉 */
+    arrowhead = 135296,
+    /** 보석 (시그너스) */
+    jewel = 135297,
+    /** 화약통 2 */
+    powderKeg2 = 135298,
+    /** 컨트롤러 */
+    controller = 135300,
+    /** 여우구슬 */
+    foxMarble = 135310,
+    /** 체스피스 */
+    chessPiece = 135320,
+    /** 무기 전송장치 */
+    transmitter = 135330,
+    /** 장약 */
+    charge = 135340,
+    /** 매직윙 */
+    magicWing = 135350,
+    /** 패스 오브 어비스 */
+    pathOfAbyss = 135360,
+    /** 렐릭 */
+    relic = 135370,
+    /** 선추 */
+    fanTassel = 135380,
+    /** 브레이슬릿 */
+    bracelet = 135400,
+    /** 웨폰 벨트 */
+    weaponBelt = 135401,
+    /** 노리개 */
+    ornament = 135402,
+    /** 헥스시커 */
+    hexSeeker = 135403,
+    /** 펫장비 */
+    petEquip = 180,
+    /** 메카닉 엔진 */
+    machineEngine = 161,
+    /** 메카닉 암 */
+    machineArms = 162,
+    /** 메카닉 레그 */
+    machineLegs = 163,
+    /** 메카닉 프레임 */
+    machineBody = 164,
+    /** 메카닉 트렌지스터 */
+    machineTransistors = 165,
+    /** 드래곤 모자 */
+    dragonMask = 194,
+    /** 드래곤 펜던트 */
+    dragonPendant = 195,
+    /** 드래곤 날개장식 */
+    dragonWings = 196,
+    /** 드래곤 꼬리장식 */
+    dragonTail = 197
+}

package/dist/lib/data/PotentialData.d.ts

@@ -0,0 +1,8 @@
+import { GearOption } from './GearOption';
+export type PotentialData = {
+    /** 장비에 표시되는 이름 */
+    title: string;
+    /** 잠재능력 옵션 */
+    option: Partial<PotentialOption>;
+};
+export type PotentialOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'armor' | 'armorRate' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'damage' | 'criticalRate' | 'criticalDamage' | 'cooltimeReduce' | 'strLv' | 'dexLv' | 'intLv' | 'lukLv'>;

package/dist/lib/data/PotentialGrade.d.ts

@@ -0,0 +1,7 @@
+export declare const enum PotentialGrade {
+    Normal = 0,
+    Rare = 1,
+    Epic = 2,
+    Unique = 3,
+    Legendary = 4
+}

package/dist/lib/data/SoulSlotData.d.ts

@@ -0,0 +1,39 @@
+import { GearOption } from './GearOption';
+/**
+ * 소울 웨폰 정보
+ */
+export type SoulSlotData = {
+    /** 소울 아이템 */
+    soul?: SoulData;
+    /** 소울 충전량 */
+    charge?: number;
+    /** 소울 충전 옵션 */
+    chargeOption?: Partial<SoulChargeOption>;
+};
+/**
+ * 소울 정보
+ */
+export type SoulData = {
+    /** 소울 명 */
+    name: string;
+    /** 소울 스킬 명 */
+    skill: string;
+    /** 소울 옵션 */
+    option: Partial<SoulOption>;
+    /** 소울 충전 옵션 배율 */
+    chargeFactor?: 1 | 2;
+};
+/**
+ * 소울 정보 (읽기 전용)
+ */
+export type ReadonlySoulData = Readonly<Omit<SoulData, 'option'> & {
+    option: Readonly<SoulOption>;
+}>;
+/**
+ * 소울 충전 옵션
+ */
+export type SoulChargeOption = Pick<GearOption, 'attackPower' | 'magicPower'>;
+/**
+ * 소울 옵션
+ */
+export type SoulOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'maxHp' | 'maxMp' | 'criticalRate' | 'ignoreMonsterArmor' | 'bossDamage'>;

package/dist/lib/data/index.d.ts

@@ -0,0 +1,7 @@
+export * from './GearAttributeData';
+export * from './GearData';
+export * from './GearOption';
+export * from './GearType';
+export * from './PotentialData';
+export * from './PotentialGrade';
+export * from './SoulSlotData';