# Asset Library Manager - poradnik bez ogonkow

Ten poradnik opisuje widok:

```text
/admin/tools/asset-library.html
```

Uzywaj go po pracy w Animation Builderze albo po wrzuceniu nowych plikow do `assets/vendor`.

---

## Po co to jest

Asset Library Manager sprawdza, czy grafiki, animacje i mappingi nie sa popsute.

Najprosciej:

```text
Animation Builder tworzy spriteId.
Map Builder uzywa spriteId.
Asset Library sprawdza, czy to wszystko sie zgadza.
```

---

## Standardowy flow

1. Ktos wrzuca nowe pliki graficzne na serwer do:

```text
assets/vendor/...
```

2. Otwierasz:

```text
/admin/tools/asset-library.html
```

3. Klikasz:

```text
Odswiez assets/vendor
```

4. Otwierasz Animation Builder i tworzysz animacje.

5. Zapisujesz spriteId do:

```text
data/assets/sprite-mapping.json
```

6. Wracasz do Asset Library i klikasz:

```text
Odswiez raport assetow
```

7. Sprawdzasz, czy nie ma czerwonych bledow.

---

## Co oznaczaja problemy

### SPRITE_MISSING

Obiekt na mapie uzywa `spriteId`, ktorego nie ma w `sprite-mapping.json`.

Naprawa:

```text
- sprawdz czy spriteId jest dobrze napisany
- sprawdz czy zapisales animacje/sprite w Animation Builderze
- jesli trzeba, wybierz inny spriteId w Map Builderze
```

### ANIMATION_MISSING

Obiekt uzywa animacji, np. `running`, ale sprite nie ma takiej animacji.

Naprawa:

```text
- otworz Animation Builder
- wczytaj spriteId
- dodaj animacje o tej nazwie
- zapisz do sprite-mapping.json
```

### STATE_ANIMATION_MISSING

Drzwi albo obiekt maja mapowanie stanu na animacje, ale animacja nie istnieje.

Przyklad:

```text
open -> open
closed -> closed
```

Jesli sprite nie ma animacji `open`, pojawi sie ostrzezenie.

### TILESET_MISSING

Sprite wskazuje na `tilesetId`, ktorego nie ma w manifestach assetow.

Naprawa:

```text
- kliknij Odswiez assets/vendor
- sprawdz czy plik graficzny istnieje na serwerze
- sprawdz czy tilesetId nie ma literowki
```

### EMPTY_ANIMATION

Animacja istnieje, ale nie ma zadnej klatki.

Naprawa:

```text
- otworz Animation Builder
- kliknij klatki animacji
- zapisz ponownie
```

### UNUSED_SPRITE

Sprite jest w mappingu, ale nie jest uzyty na zadnej mapie.

To nie musi byc blad. Moze to byc sprite przygotowany na pozniej.

---

## Jak uzywac filtrow

Wyszukiwarka pozwala znalezc:

```text
- spriteId
- nazwe mapy
- ID obiektu
- animacje
```

Filtr typow:

```text
Wszystkie
Animowane
Statyczne
Uzywane
Nieuzywane
```

Filtr problemow:

```text
Wszystkie
Bledy
Ostrzezenia
Info
```

---

## Kiedy to odpalac

Odpal Asset Library:

```text
- po wrzuceniu nowych assetow
- po zrobieniu animacji
- po zmianie sprite-mapping.json
- po budowie mapy
- przed testem scenariusza
- przed warsztatem
```

---

## Prosta zasada

Przed warsztatem czerwone bledy powinny byc naprawione.

Ostrzezenia sprawdz.

Info typu `UNUSED_SPRITE` moze zostac, jesli wiesz, ze sprite jest przygotowany na pozniej.