AssetEditor - hpf3/dungeon-generator-release GitHub Wiki

Asset Editor without a pack loaded

Overview

The Asset Editor is where you can modify existing user-created packs or create new ones. It shares much of its UI and layout with the Asset Manager, so if you haven’t checked that page yet, consider reading it first for the basics.

Interface

While the general layout and appearance match the Asset Manager, here are the key differences and additional features:

1. Pack Loading

  • User Packs Only
    • Unlike the Asset Manager, the pack dropdown here only shows packs found in user://packs/.
    • If you haven’t created any user packs yet, you may see an empty list.

2. Pack Creation

  • Create New
    • Click this button to open a dialog where you can name and create a new, empty pack folder.
    • Because the folder name is derived from what you enter, certain special characters may be disallowed.

3. Refresh Cards

  • Refresh Cards
    • Scans the cards/start/, cards/general/, and cards/end/ subfolders in your pack directory for loadable images.
    • Any new images are added as new cards; removed images cause cards to be deleted.
    • Important: Refreshing reloads the pack data in memory, meaning unsaved changes to connections or weights will be lost. Save before refreshing if you don’t want to lose your edits.

Open File Browser
Launches your system’s file manager at the current pack folder. This makes it easy to add, remove, or modify card images.

4. Cell Size

  • The Cell Size field is purely informational.
  • Once the generator finishes creating a dungeon, you can use a slider to scale the entire dungeon (i.e., effectively resize the final image). The Cell Size is multiplied by that scale value to show how large each “grid cell” is in your final output, ie. a 60px cell size will be shown as 30px when the Card Size is set to 50%

5. Card Editing

example of the card editor

  • Card Path

    • Shows the relative path of the card image within the pack folder (read-only).

  • Weight

    • A numerical weight determining how frequently this card is chosen relative to other cards in the same category.

  • Dimensions

    • Displays the detected width and height of the card.
    • Known Bug: If you replace an image with a different resolution, this might not update automatically. You must save and then Load Pack again (rather than just refreshing) to see the correct dimensions.

  • Connection Lists (One for each direction: up, down, left, right)

    • Each list displays a set of offsets where connections can attach.
    • The midpoint values are calculated based on the first and last non-transparent pixels in the image, which may not be the exact geometric center if the card has transparent edges.
    • Clicking Add Connection adds a new offset (in pixels). Remember that 0 is at the top-left corner.

Notes

  • Reload Actions
    • Any action that reloads or changes the pack (e.g., Load Pack, Refresh Cards) will discard unsaved changes. Always save first if you want to keep your edits.
  • Changing Card Image Sizes
    • As noted above, changing a card’s image resolution requires saving and then using Load Pack again to properly refresh dimensions.
  • Leaving Cell Size at 0
    • This won’t cause errors; it’s just a reference value for your own convenience.

That’s it for the Asset Editor! If you need help actually generating dungeons using your edited or newly created pack, head over to the Generator.