사용자 정의 코스튬

사용자 정의 코스튬을 제작하고 게임에 적용하는 방법을 설명합니다. (버전 1.7.0 이상)

목차

1. 예제 코스튬 다운로드

2. 코스튬 적용 방법

3. 코스튬을 수정하기

4. 코스튬 능력치 목록

-----
Uploading Costumes to the Workshop
https://steamcommunity.com/sharedfiles/filedetails/?id=3038434110

창작마당에 코스튬 업로드 하기
https://steamcommunity.com/sharedfiles/filedetails/?id=3038395214

Create a custom costume
https://steamcommunity.com/sharedfiles/filedetails/?id=3032557716

1. 예제 다운로드

사용자 정의 코스튬을 게임에 적용하기 위해서는 이미지 파일을 준비하고 메타데이터를 만들어야 합니다.

[예제][drive.google.com]

예제에는 두 타입의 코스튬 예시 이미지가 준비되어 있습니다.
1. AdventurerOverride : 기존 모험가 코스튬을 대체합니다.
2. NewCostume : 새로운 코스튬을 추가합니다.


예제별 파일 구성은 다음과 같습니다.
1. metadata.json 파일
2. CharIdle0~4.png : 캐릭터의 대기 애니메이션 이미지
3. CharRun0~7.png : 캐릭터의 달리기 애니메이션 이미지
4. CharJump0.png : 캐릭터의 점프 애니메이션 이미지
5. CharDie0.png : 캐릭터의 죽음 애니메이션 이미지
3. CharHand.png : 손 이미지
4. Icon.png : 아이콘 이미지

*이미지는 png 확장자만을 지원합니다.
*각 애니메이션(Idle, Run, Jump, Die)에 사용될 이미지 파일명은 0부터 순차적으로 번호가 기입되어야 합니다.

2. 코스튬 적용하기

예제 코스튬 폴더를 아래 경로에 배치하고 게임을 실행하면 자동으로 적용됩니다.
* AddOns 폴더와 Costume 기본적으로 존재하지 않습니다. 경로가 없다면 폴더를 새로 만드세요.

Windows : 던그리드 설치 폴더\Dungreed_Data\AddOns\Costumes

Mac : 던그리드 설치 폴더\Dungreed .app\Contents\AddOns\Costumes

Linux : 던그리드 설치 폴더\Dungreed_Data\AddOns\Costumes

의상실 UI에서 F5키를 누르면 현재 코스튬 정보를 새로고침할 수 있습니다.
불러오기 실패 시 오류 메시지를 제공하여 조금 더 편하게 코스튬 제작 작업을 진행할 수 있습니다.

3. 코스튬을 자유롭게 수정하기

캐릭터의 애니메이션, 손 모양, 능력치 등을 원하는대로 변경하기 위해서는
"metadata.json"파일의 값을 수정해야 합니다.

해당 섹션에서는 metadata.json 파일의 구조를 설명합니다.

id

시스템에서 사용될 코스튬의 고유 번호입니다.
0으로 설정 시 모험가의 기본 코스튬 이미지가 덮어씌워집니다.
(모험가 기본 코스튬만 덮어씌울 수 있으며 다른 코스튬은 덮어씌울 수 없습니다)
새로운 코스튬을 만들기를 희망한다면 1000 이상 임의의 다른 값을 지정하세요.

name_korean, english, ..., portuguese

description_korean, english, ..., portuguese

각 언어 별 코스튬의 이름과 설명을 정의합니다.

stats

캐릭터의 기본 능력치를 정의할 수 있습니다.
(4번 섹션 참조)

filename_icon

의상실 UI에서 볼 캐릭터의 아이콘 이미지 파일명을 기입합니다.

filename_hand

캐릭터의 손으로 사용할 이미지의 파일명을 기입합니다.

ppu_hand

Pixel Per Unit을 의미합니다. 숫자가 커질수록 게임 내에서 표현되는 캐릭터의 픽셀 단위가 작아집니다. 캐릭터의 기본 PPU는 16입니다.

pivot_hand

이미지의 중심점 입니다.
x가 0일수록 왼쪽, 1일수록 오른쪽입니다. (0.5는 중심)
y가 0일수록 아래쪽, 1일수록 위쪽입니다. (0.5는 중심)

hideDefaultMainHand

값이 true라면 무기를 들지 않았을 때의 주무기 손이 지워집니다.
값이 false라면 기존대로 손이 표시됩니다.

hideDefaultOffHand

값이 true라면 무기를 들지 않았을 때의 보조무기 손이 지워집니다.
값이 false라면 기존대로 손이 표시됩니다.

startingItems

시작 아이템의 배열입니다.
(지정할 시작 아이템의 목록은 섹션 5 참조)

"startingItems" : [
15,
16,
17
]

idle, run, jump, die

동작별 애니메이션 정의입니다.

scene

애니메이션 이미지의 갯수입니다.

fps

애니메이션의 속도입니다. 값이 높을수록 빠르게 움직입니다.
값이 1이면 1초에 한 번 다음 씬으로 전환됩니다.
값이 10이면 1/10초에 한 번 다음 씬으로 전환됩니다.
값이 20이면 1/20초에 한 번 다음 씬으로 전환됩니다.

filename

애니메이션 파일명을 입력합니다.
파일명의 끝에는 숫자 0부터 애니메이션 이미지 갯수만큼 이미지가 필요합니다.

ppu

Pixel Per Unit을 의미합니다. 숫자가 커질수록 캐릭터의 픽셀 단위가 작아집니다.
모험가 캐릭터의 기본 PPU는 16입니다.

pivot

이미지의 중심점 입니다.
x가 0일수록 왼쪽, 1일수록 오른쪽입니다. (0.5는 중심)
y가 0일수록 아래쪽, 1일수록 위쪽입니다. (0.5는 중심)

loop

애니메이션의 반복 여부를 정합니다. true가 기본 값입니다.
false : 반복하지 않음 (1회재생 후 마지막에서 멈춤)
true : 반복

runFootstepFrame

달리기 애니메이션이 실행되는 도중
이 요소에 정의된 씬 번호에 맞춰 발자국소리와 먼지가 생성됩니다.[/previewimg]

4. 능력치 목록

metadata.json 내 "stats"항목에 기입할 수 있는 능력치의 목록을 서술합니다.

텍스트에 값 타입이 "1"로 표시된 항목은 오로지 정수만 입력이 가능합니다.
텍스트에 값 타입이 "1.1"로 표시된 항목은 실수도 입력이 가능합니다.

호환성 이슈가 있을 수 있으므로 코스튬에 지정할 능력은 최대 4개까지만 사용하는 것을 권장합니다.

Value Text	Description
POWER/1	위력 1 증가
TRUE_DAMAGE/1	고정 대미지 1 증가
DAMAGE/1.1	무기 대미지 1.1 증가
DAMAGE_MIN/1.1	무기 최소 대미지 1.1 증가
DAMAGE_MAX/1.1	무기 최대 대미지 1.1 증가
NORMAL_ENEMY_BONUS/1	약한 적에게 입히는 대미지 1% 증가
BOSS_ENEMY_BONUS/1	보스 및 엘리트 적에게 입히는 대미지 1% 증가
IGNORE_DEFENSE/1	방어 관통 1%
POWER_WEAPONSWING/1	직접 공격 시 위력 증가 +1 (대쉬 공격 등에는 적용 안됨)
DEFENSE/1.1	방어력 1.1 증가
TOUGHNESS/1	강인함 1 증가
MELEE_RESIST/1.1	근접 공격으로부터 대미지 감소 1.1% (제한 : 최대 75%)
BULLET_RESIST/1.1	원거리 공격으로부터 대미지 감소 1.1% (제한 : 최대 75%)
FINALATK_PERCENT/1	최종 공격력 1% 증가
FINALDEF_PERCENT/1	최종 방어력 1% 증가
HP/1	최대 체력 1 증가
HP_PERCENT/1	최대 체력 1% 증가
EVASION/1	회피 1 증가
BLOCK/1	막기 1 증가
CRITICAL/1	크리티컬 1 증가
CRITICAL_DAMAGE_RATE/1	크리티컬 대미지 1% 증가
GOLD_DROP/1	골드 드롭 1% 증가
GOLD_DAMAGE/1	2000 골드 당 대미지 +1%
MOVE_SPEED/1	이동 속도 1% 증가
ATTACK_SPEED/1	공격 속도 1% 증가
RELOAD_SPEED/1	재장전 속도 1% 증가
ADD_SHOT_ON_DASH/1	대쉬시 총알 1발 장전됨
DASH/1	대쉬 횟수 1 증가
DASH_ATTACK_DAMAGE/1	대쉬 대미지 1% 증가
DASH_RESTORE_SPEED/1	대쉬 회복속도 1% 증가
ADD_DASH_ON_KILL/1	적 처시 시 대쉬 획득 +1
BURN	직접 공격 시 화상
POISON	직접 공격 시 중독
STUN	직접 공격 시 기절
SHOCK	직접 공격 시 감전
CHILL	직접 공격 시 추위
BURN_ADDITIONAL_DAMAGE/1	화상 대미지 1 증가
BURN_OVERLAP/1	화상 중첩 상한 1회 추가
BURN_SPEED/1	화상 공격 주기가 1% 더 빨라짐
BURN_DURATION/1	화상 지속시간 1% 증가
POISON_ADDITIONAL_DAMAGE/1	중독 추가 대미지
POISON_OVERLAP/1	중독 중첩 상한 1회 추가
POISON_SPEED/1	중독 공격 주기가 1% 더 빨라짐
CHILL_DECREASE_SPEED/1	추위 감속 +1%
CHILL_DURATION/1	추위 지속시간 1% 증가
SHOCK_DURATION/1	감전 지속시간 +1%
STUN_DURATION/1	기절 지속시간 +1%
IMMUNE_BURN	화상 면역
IMMUNE_POISON	중독 면역
IMMUNE_STUN	기절 면역
IMMUNE_SHOCK	감전 면역
IMMUNE_CHILL	추위 면역
PRECISION/1	조준 정확도 +1%
FULL_SWING/1	근접무기 공격 범위 +1%
FAST_CHARGE/1	충전형 무기 충전속도 +1%
JUMP_POWER/1	점프력 +1
FAST_SKILL_COOLDOWN/1	스킬 쿨다운 회복 속도 +1%

[실험정 기능] 조건 추가

'?' 키워드를 사용하여 스탯에 조건을 추가할 수 있습니다.
조건 추가는 실험적 기능이므로 계속 개발 중입니다.
버전 1.7.1+ 부터 사용할 수 있습니다.

조건 값	설명
KATANA	카타나 태그 아이템 장비 시
HANDGUN	권총 태그 아이템 장비 시
SPEAR	창 태그 아이템 장비 시
FRIEND	친구 태그 아이템 장비 시
BOW	활 태그 아이템 장비 시
ARMOR	갑옷 태그 아이템 장비 시
RING	반지 태그 아이템 장비 시
WING	날개 태그 아이템 장비 시
MAINHANDED	한손 주무기 장비 시
OFFHANDED	한손 보조무기 장비 시
TWOHANDED	양손무기 장비 시
NOWEAPON	아무런 무기도 장착하지 않았을 때
MELEEWEAPON	근접 주무기를 장착했을 때
RANGEDWEAPON	원거리 주무기를 장착했을 때

숫자와 함께 사용 가능한 조건

아래 조건은 게임 내의 여러 수치들과 비교할 수 있는 조건 목록입니다.
아래 조건과 비교기호를 함께 사용해야 합니다.

조건 값	설명	예시
GOLD	현재 소지금	GOLD=0 : 골드가 0골드일 때
ACCESSORYCOUNT	액세서리 장착 갯수	ACCESSORYCOUNT<=2 : 장착한 액세서리 갯수가 2개 이하일 때
SATIETY	현재 포만감	SATIETY>50 : 현재 포만감이 50을 초과할 때
ITEM	현재 장착하고 있는 특정 아이템의 ID	ITEM=15 : "초록박쥐"를 장착하고 있을 때 ※ 주의 : ITEM 조건은 등호(=)만 사용이 가능합니다

5가지의 비교 기호를 함께 이용할 수 있습니다.

• < (미만)
  
• <= (이하)
  
• = (같음)
  
• >= (이상)
  
• > (초과)

조건을 어떻게 사용하나요?

스탯 뒤에 ?을 붙이고 조건을 입력하세요.
아래 샘플을 참고하세요.

POWER/10?KATANA	카타나 태그 아이템 장착 시, 위력 +10
RELOAD_SPEED/30?HANDGUN	권총 태그 아이템 장착 시, 재장전 속도 +30%
MOVE_SPEED/66?NOWEAPON	아무런 무기도 장착하지 않았을 때, 이동속도 66% 증가
DASH/2?SATIETY<50	현재 포만감이 50 미만일 때, 대쉬 횟수 +2
DEFENSE/15?GOLD=0	현재 소지금이 0골드일 때, 방어력 15 증가
ATTACK_SPEED/-20?ITEM=15	초록박쥐를 장착하고 있을 때, 공격속도 20% 감소

5. 시작 아이템

코스튬에 시작 아이템을 최대 6개까지 부여할 수 있습니다.
시작 아이템의 목록은 다음과 같습니다.
metadata.json 파일에 시작 아이템의 ID를 입력해야 합니다.
(섹션 3 참조)

[지정 가능한 시작 아이템 목록][docs.google.com]




끝.

[TOGA0199]

형님 시작 아이템 목록에 채찍이 없습니다

[SeirLS]

마을에서 던전으로 들어갈 때 게임이 멈추는 문제가 발견되었습니다

[geoom]

이키나곰처럼 게임 안에서 특정 조건을 달성시 도트가 바뀌는 코드를 추가해보고싶습니다

[LEON]

이런 글 써주셔서 정말 감사합니다!
혹시 이키나곰 같이 캐릭터 고유의 조건을 만족하면 특별한 능력이 발동되는 액티브 스킬 관련
스크립트도 추가할수 있나요?

[SeirLS]

전혀 다른 이야기지만 카를로비나 훈련장에 dps 측정기같은거 만들어 주실수 있나요

[Yasamu]

가능한데 버그인건지 적용은 안되더라고요

[먼지0]

특정 무기만 사용시 능력 업 되게 가능한가요, 우주검 들었을때 기준 능력치 대폭 증가같은거 넣고 싶은데

[Yasamu]

부정은 없지만 평소에 -100위력으로 해놓고 조건 상황에 위력 100추가하면 원하는게 됩니다

[Hyeok]

FRIEND 태그가 작동하지 않는 것 같습니다.

[tai7780]

?부정처리 추가해주실 수 있나요? 가령 "조건 ? 미달시 위력 -100"같은 처리를 하고 싶습니다.