# Getting Started

This is the fastest way to get DawnCosmetics up and running.

## What You Need

### Required

* Minecraft `1.21.1`
* Java `21`
* Fabric Loader
* Fabric API

### Optional

* Polymer if you want `pack.mode = polymer`
* LuckPerms or Fabric Permissions API if you want permission nodes
* An economy mod if you want paid shop cosmetics

### Supported economy mods

* `Impactor`
* `BEconomy`
* `CobbleDollars`
* `UltraEconomy`

## Quick Install

{% stepper %}
{% step %}
Put `dawncosmetics-<version>.jar` in your server `mods/` folder
{% endstep %}

{% step %}
Start the server once
{% endstep %}

{% step %}
Open `config/dawncosmetics/`
{% endstep %}

{% step %}
Edit what you want
{% endstep %}

{% step %}
Run `/cosmetics reload`
{% endstep %}
{% endstepper %}

## First Check

Make sure these work:

{% stepper %}
{% step %}
Run `/cosmetics`
{% endstep %}

{% step %}
Open one category
{% endstep %}

{% step %}
Equip one cosmetic
{% endstep %}

{% step %}
Confirm it shows in game
{% endstep %}
{% endstepper %}

## First Setup Path

If you want the simple path, do this:

{% stepper %}
{% step %}
Open `config/dawncosmetics/config.json`
{% endstep %}

{% step %}
Leave the feature toggles on
{% endstep %}

{% step %}
Add one hat, backpack, or balloon in `config/dawncosmetics/cosmetics/`
{% endstep %}

{% step %}
Run `/cosmetics reload`
{% endstep %}
{% endstepper %}

If you want wardrobe too:

{% stepper %}
{% step %}
`/wardrobe create default`
{% endstep %}

{% step %}
`/wardrobe setview default`
{% endstep %}

{% step %}
`/wardrobe setleave default`
{% endstep %}

{% step %}
`/wardrobe setnpc default`
{% endstep %}
{% endstepper %}

If you want custom models and textures too:

{% stepper %}
{% step %}
Put assets in your pack source folder
{% endstep %}

{% step %}
Read [Pack Layouts And Assets](broken://pages/8b852341d1d4cf1a8438b04db3e463b4c6fd9c2e)
{% endstep %}

{% step %}
Run `/cosmetics reload pack`
{% endstep %}
{% endstepper %}

## Normal Player Flow

{% stepper %}
{% step %}
Player opens `/cosmetics`
{% endstep %}

{% step %}
Player picks a category
{% endstep %}

{% step %}
Player equips what they have access to
{% endstep %}

{% step %}
Sprays are placed with `/spray`
{% endstep %}

{% step %}
Particles can be changed in the menu or with `/particlecosmetic`
{% endstep %}
{% endstepper %}

## Updating The Mod

{% stepper %}
{% step %}
Replace the old jar
{% endstep %}

{% step %}
Start the server
{% endstep %}

{% step %}
Run `/cosmetics reload`
{% endstep %}

{% step %}
Run `/cosmetics reload pack` if assets changed
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Good to know**

Shop purchases unlock cosmetics

Shop purchases do not auto equip cosmetics
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dawnshade.gitbook.io/dawnshade-docs/docs/dawn-cosmetics/summary/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.