Steam Community :: Guide :: Create a custom costume

Store Page

Dungreed

All Discussions Screenshots Artwork Broadcasts Videos Workshop News Guides Reviews

Dungreed > Guides > taehyun's Guides

39 ratings

Create a custom costume

By taehyun and 1 collaborators

Describes how to create custom costumes and apply them to your game. (Version 1.7.0 and later)

Contents

1. Downloading an example costume

2. How to Apply a Costume

3. Modifying a Costume

4. List of costume stats

5. Stats with a condition

6. Starting Items

---------------------------------
Uploading Costumes to the Workshop
https://steamproxy.com/sharedfiles/filedetails/?id=3038434110&snr=2_9_100003_

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

사용자 정의 코스튬
https://steamproxy.com/sharedfiles/filedetails/?id=3032563054

Award

Created by

MegurinE
Offline

taehyun
Offline

Category: Workshop

Languages: English

Posted

Updated

9 Sep, 2023 @ 4:54am

10 Oct, 2023 @ 3:59am

3,873	Unique Visitors
66	Current Favorites

Guide Index

Overview

1. Downloading an example costume

2. How to Apply a Costume

3. Modifying a Costume

4. List of costume stats

5. Stats with a condition

6. Starting Items

Comments

1. Downloading an example costume

To apply custom costumes to your game, you need to prepare image files and create metadata.

[Example][drive.google.com]

There are two types of costumes in the example.
1. AdventurerOverride: Overrides the adventurer's basic costume.
2. NewCostume: Adds a new costume.

The contained files each example is as follows
1. metadata.json
2. CharIdle0~4.png : Images of the character's idle animation
3. CharRun0~7.png: Images of the character's running animation
4. CharJump0.png: Character's jump animation image
5. CharDie0.png: Character's death animation image
3. CharHand.png: Hand image
4. Icon.png: Icon image

*Images only support PNG.
*The image filenames to be used for each animation (Idle, Run, Jump, Die) must be numbered sequentially from 0.

2. How to Apply a Costume

Place each example costume folder in the path below and run the game.
* The AddOns and Costumes folder don't exist by default; if the path doesn't exist, create a new folder.

Windows : Dungreed installed folderDungreed_DataAddOnsCostumes

Mac : Dungreed installed folderDungreed .appContentsAddOnsCostumes

Linux : Dungreed installed folderDungreed_DataAddOnsCostumes

In the Boutique UI, you can press F5 to refresh the current costume information.
If the load fails, the UI provides an error message to make your costuming experience a little easier.

3. Modifying a Costume

In order to customize the costume's animations, hand image, stats, you need to modify the "metadata.json" file.

This section describes the structure of the metadata.json file.

A unique number for the costume to be used in the system.
If set to 0, the adventurer's default costume image will be overrided.
(Only the adventurer's default costume can be overrided, no other costumes can be overrided)
If you want to create a new costume, specify any other number. (above 1000+ is recommended)

name_korean, english, ..., portuguese
description_korean, english, ..., portuguese

Define the name and description of the costume for each language.

stats

You can define the costume's base stats.
(See section 4)

filename_icon

The filename of the icon image for the costume to be viewed in the Boutique UI.

filename_hand

The filename of the image to use for the costume's hands.

ppu_hand

Pixel Per Unit. The higher the number, the smaller the pixels rendered in-game. The natural default PPU is 16.

pivot_hand

The center point of the hand image.
A value of 0 for x is left and 1 is right (0.5 is the center).
y is 0 to the bottom and 1 to the top. (0.5 is the center)

hideDefaultMainHand

If the value is 'true', the image of default main-hand(without any weapon) is hiding.
If 'false', the image of default main-hand is showing normally.

hideDefaultOffHand

If the value is 'true', the image of default off-hand(without any weapon) is hiding.
If 'false', the image of default off-hand is showing normally.

startingItems

The ID array for starting items.
You can check the item's ID on section 6.

"startingItems" : [
15,
16,
17
]

idle, run, jump, die

scene

The number of animated images.

fps

The speed of the animation; the higher the value, the faster it moves.
A value of 1 will switch to the next scene once per second.
A value of 10 will switch to the next scene once every 1/10th of a second.
A value of 20 will switch to the next scene once every 1/20th of a second.

filename

The filename of the animation.
The filename requires the number of images at the end, starting with the number 0 and ending with the number of scene. (if the scene value is 5, 0~4 animation images are required)

ppu

Pixel Per Unit. The higher the number, the smaller the pixels rendered in-game. The natural default PPU is 16.

pivot

The center point of the image.
A value of 0 for x is left and 1 is right (0.5 is the center).
y is 0 to the bottom and 1 to the top. (0.5 is the center)

loop

Determines whether the animation should repeat. true is the default value.
false : do not loop (plays once and stops at the end)
true : loop

runFootstepFrame

During "run" animation,
footsteps and dust are generated according to the scene number defined in this element.

4. List of costume stats

Describe the list of stats that can be entered in the "stats" in metadata.json.

Items with a value type of "1" in the text can only be entered as integers.
Items with a value type of "1.1" in the text can be entered as decimals.

Due to possible compatibility issues, it is recommended that you only use a maximum of four stats for a costume.

Value Text

Description

POWER/1

Power +1

TRUE_DAMAGE/1

True Damage +1

DAMAGE/1.1

Weapon's damage +1.1

DAMAGE_MIN/1.1

Weapon's minimum damage +1.1

DAMAGE_MAX/1.1

Weapon's maximum damage +1.1

NORMAL_ENEMY_BONUS/1

+1% increased damage against weak enemies

BOSS_ENEMY_BONUS/1

+1% increased damage against boss/elite enemies

IGNORE_DEFENSE/1

Ignore Defense +1%

POWER_WEAPONSWING/1

Bonus Power when direct attacking +1 (do not applied on dash attack)

DEFENSE/1.1

Defense +1.1

TOUGHNESS/1

Toughness +1

MELEE_RESIST/1.1

Block Melee Damage 1.1%
(Limit : Up to 75%)

BULLET_RESIST/1.1

Block Ranged Damage 1.1%
(Limit : Up to 75%)

FINALATK_PERCENT/1

Final Damage 1%

FINALDEF_PERCENT/1

Final Defense 1%

HP/1

Max HP +1

HP_PERCENT/1

Max HP +1%

EVASION/1

Evasion +1

BLOCK/1

Block +1

CRITICAL/1

Critical +1

CRITICAL_DAMAGE_RATE/1

Critical Damage Rage +1%

GOLD_DROP/1

Gold Drop +1%

GOLD_DAMAGE/1

Deals +1% Damage for every 2000 Gold owned

MOVE_SPEED/1

Movement Speed +1%

ATTACK_SPEED/1

Attacking Speed +1%

RELOAD_SPEED/1

Reloading Speed +1%

ADD_SHOT_ON_DASH/1

Dash Action <Add Shots> +1

DASH/1

Dash Chance +1

DASH_ATTACK_DAMAGE/1

Dash Attack Damage +1%

DASH_RESTORE_SPEED/1

Dash Rcovery Speed +1%

ADD_DASH_ON_KILL/1

Gain +1 Dash when killing enemies

BURN

When you attack, deals burn damage

POISON

When you attack, deals poison damage

STUN

When you attack, applies stun

SHOCK

When you attack, deals shock damage

CHILL

When you attack, deals cold damage

BURN_ADDITIONAL_DAMAGE/1

Burn Damage +1

BURN_OVERLAP/1

Max Burn Stack +1

BURN_SPEED/1

Burn attack interval time +1% faster

BURN_DURATION/1

Burn Duration +1%

POISON_ADDITIONAL_DAMAGE/1

Poison Damage +1

POISON_OVERLAP/1

Max Poison Stack +1

POISON_SPEED/1

Poison attack interval time +1% faster

CHILL_DECREASE_SPEED/1

Movement Speed Decrease During Cold +1%

CHILL_DURATION/1

Cold Duration +1%

SHOCK_DURATION/1

Electric Shock Duration +1%

STUN_DURATION/1

Stun Duration +1%

IMMUNE_BURN

Immune Burn

IMMUNE_POISON

Immune Poison

IMMUNE_STUN

Immune Stun

IMMUNE_SHOCK

Immune Shock

IMMUNE_CHILL

Immune Cold

PRECISION/1

Ranged weapon fire precision +1%

FULL_SWING/1

Melee weapon swing range +1%

FAST_CHARGE/1

Charged Weapon charging speed +1%

JUMP_POWER/1

Jump power +1

FAST_SKILL_COOLDOWN/1

Skill cooldowns are +1% faster

5. Stats with a condition

[Experimental Feature] Add a condition

You can add a condition on the stat with keyword '?'.
The condition is an experimental feature, we are still working at the feature.
You can use condition on version 1.7.1+.

condition Text

Description

KATANA

When equip a Katana tagged item

HANDGUN

When equip a Handgun tagged item

SPEAR

When equip a Spear tagged item

FRIEND

When equip a Friend tagged item

BOW

When equip a Bow tagged item

ARMOR

When equip a Armor tagged item

RING

When equip a Ring tagged item

WING (Be careful, the system keyword is "WING" (there's no S.. )

When equip a Wings tagged item

MAINHANDED

If equipped with a one-handed main weapon

OFFHANDED

If equipped with a off-handed sub weapon

TWOHANDED

If equipped with a two-handed weapon

NOWEAPON

If no weapons are equipped

MELEEWEAPON

If equipped with a melee main-weapon

RANGEDWEAPON

If equipped with a ranged main-weapon

A Condition with Numbers

Use the comparison symbols using the conditions below.
You can activate your abilities in more diverse ways.
Five comparison symbols can be used together.

< (Less than)
<= (Less than or equal to)
= (Equal to)
>= (Greater than or equal to)
> (Greater than)

Condition Text

Description

Remark

GOLD

Your Gold

GOLD=0 : If you have 0 gold

ACCESSORYCOUNT

Your equipped accessories count

ACCESSORYCOUNT<=2 : If your number of equipped accesories is less than or equal to 2

SATIETY

Current satiety

SATIETY>50 : If your satiety is greater than 50

ITEM

Your equipped items ID

ITEM=15 : If you equipped "Green bat"
※ You can only use the Equal(=) symbol in this condition

How to Use Condition?

To use a condition, you have to add postfix '?' and a condition keyword on each stat text.
Here are the samples.

POWER/10?KATANA

When equip a Katana tagged item, Power +10

RELOAD_SPEED/30?HANDGUN

When equip a Katana tagged item, Reload Speed +30%

MOVE_SPEED/66?NOWEAPON

If no weapons are equipped, Movement Speed +66%

DASH/2?SATIETY<50

If satiety is less than 50, Dash Count +2

DEFENSE/15?GOLD=0

If you have 0 Gold, Defense +15

ATTACK_SPEED/-20?ITEM=15

If you equipped "Green bat", Attack Speed -20%

6. Starting Items

You can add starting items for a custom costume.
The list of available starting items are below.
You have to specific the ID of starting items in "metadata.json"
(See section 3)

[Available item list][docs.google.com]

fin.

29 Comments

< >

A-List Gamer 27 Jan @ 10:11am

How do I do this if I'm using Plugin Manager?

Conga Lyne 21 Oct, 2023 @ 8:04pm

In the"How to Use Condition?" segment, "RELOAD_SPEED/30?HANDGUN" says "When equip a Katana tagged item" in the description

Mallathor 16 Oct, 2023 @ 6:35pm

Here are some of the extra stats that aren't mentioned in the guide:
"REGENERATION_HP/1" Adds passive hp regen.
"REGENERATION_HP_NOBATTLE/1" Same as above, but is only active when not in combat.
"AUTOMATIC_FIRE" Allows you to continuously attack when you hold down the button.
"INFINITY_SHOT" Grants infinite magazine.
"ADDITIONAL_SHOTS/1" Increases magazine capacity.
"SPREAD_SHOT/1" Adds Buckshot, turning your ranged weapon into a shotgun. (Higher number = more bullets.) However, this functions more like the Scatter Bullets and divides your damage across each projectile.

destinypurpley 30 Sep, 2023 @ 1:15am

I think moroe conditions could be useful, Like detecting if a stat is a certain level for an affect to happen (for example, If attack speed is less than 1 you apply stun)

Everyien 28 Sep, 2023 @ 10:11am

for some reason the AddOns folder doesn't exist where i have dungreed installed.

Czar Deval 25 Sep, 2023 @ 2:52am

Does anyone know the Condition text to auto attack

Кошарик 24 Sep, 2023 @ 1:07pm

walmir22dacs 21 Sep, 2023 @ 10:59am

as conquista são boas msm

GamerXP 21 Sep, 2023 @ 10:46am

Also, what is "decorations" array in the json file? It's not in the guide.

GamerXP 20 Sep, 2023 @ 11:39am

Also, can there be multiple conditions to the same effect? "And" type? Like, if you have specific weapon type and accessory equipped at the same time?

< >