Add a guide on how to create a basic actor & assign the default attributes

Oliver 2026-05-06 16:37:35 -06:00
parent f19603ebb2
commit a408043582
5 changed files with 101 additions and 0 deletions

@ -0,0 +1,101 @@
When playing TTRPGs, you'll often have characters that share the same
groups of attributes, this can be very tedious if you find that you're
making the same things over and over again.
## Step 1: Create the Attributes
In the Items <img src="images/sidebar/items.webp" width="20"> sidebar tab of Foundry:
1. Click "Create Item"
2. Enter a name
3. Change the "Type" to "Attribute"
4. (Optional) Choose a folder to put the attribute in
5. Click "Create Item"
6. Edit the attribute for how you want it
7. Repeat for all attributes you want
This will open the Attribute editing form, which looks like this:
<img src="images/attribute-item-sheet.png" width="300">
The important parts of this sheet are:
<table>
<thead>
<tr>
<td>Label</td>
<td>Description</td>
</tr>
</thead>
<tbody>
<tr>
<td>Minimum</td>
<td>
The smallest value that the "Current Value" can be. If this
is left empty and there is a "Maximum Value", the minimum will
be inferred to be <code>0</code>
</td>
</tr>
<tr>
<td>Current Value</td>
<td>
The value of the attribute, this is the primary part of
attributes that is editable throughout the system. If there
is a minimum or a maximum, this value will be forcefully kept
between those two numbers.
</td>
</tr>
<tr>
<td>Maximum</td>
<td>
The largest value that the "Current Value" can be.
</td>
</tr>
<tr>
<td>Identifier</td>
<td>
This is how you will access this attribute in rolls from chat or
macros. This defaults to a modified version of the name you
created the attribute with.
</td>
</tr>
<tr>
<td>Always Visible</td>
<td>
This is used to determine if the attribute shows up above the
list of tabs on the actor sheet, or in the "Attributes" tab
of the actor sheet.
</td>
</tr>
<tr>
<td>Group</td>
<td>
<i>Only visible when "Always Visible" is off</i>. This is used to
categorize multiple attributes to make the tab easier to read.
</td>
</tr>
<tr>
<td>Macro to Execute</td>
<td>
This is a UUID of the Macro that you want to have linked to in
the actor sheet to run with a single click.
<hr />
Additional information about how to add automation to attributes
be learned about on the wiki page:
<a href="./Attribute-and-Item-Automation">Attribute and Item Automation</a>
</td>
</tr>
</tbody>
</table>
## Step 2: Create The Actor
In the Actors <img src="images/sidebar/actors.webp" width="20" > sidebar tab of Foundry:
1. Click "Create Actor"
2. Swap back to the Items <img src="images/sidebar/items.webp" width="20" > sidebar tab
3. Drag and drop all of your desired attributes on to the actor sheet
4. (Optional) In the header of the actor sheet, click the three dot menu (1), and then select "Save Attributes as Defaults"(2), this will save all of the attributes on the actor to be created on brand new actors as well. <img src="images/actor-sheet-set-default-attributes.png">
5. Go back to the Actors <img src="images/sidebar/actors.webp" width="20" > sidebar tab and create a new actor.
If you didn't save the attributes as defaults, you can still add the
attributes to new actors by dragging and dropping the same item onto
the new actor!

Binary file not shown.

After

Width:  |  Height:  |  Size: 227 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

BIN
images/sidebar/actors.webp Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

BIN
images/sidebar/items.webp Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 KiB