Skip to content

Weapons, Armor & Gear ​

The best way to learn the item sheet is to build something with it. On this page you will build a Flaming Longsword from scratch: an ordinary longsword that deals 1d8 + Strength slashing damage, plus an extra 1d6 fire damage. Along the way you will meet every part of the sheet: the item kinds, weapon properties, armor, consumables, and charges.

Learn from the compendium

Every weapon, armor piece, and magic item that ships with the system is built with exactly the tools described here. When in doubt, open something similar from the Items or Magic Items compendium and look at how it is configured. Duplicating a compendium item and editing the copy is often faster than starting blank.

Step 1: Create the item ​

In the Items tab of the sidebar, click Create Item, name it Flaming Longsword, and pick the Object type. "Object" is the catch-all type for physical gear: weapons, armor, shields, potions, torches, wands, and anything else a character can carry.

The item sheet opens with five tabs:

  • Description: the text players read, in three flavors (more below).
  • Config: what the item is, covering kind, price, inventory size, and weapon properties.
  • Activation: what happens when a player uses the item, such as rolls, damage, saves, and conditions. See Item Activations & Effects.
  • Rules: passive effects the item applies just by being carried and equipped. See Rules Builder Basics.
  • Macro: an advanced scripting slot; see Macros.

A freshly created Object item, with the five tab icons visible on the sheet edge

Step 2: Choose the kind of object ​

On the Config tab, the Object Type row offers five kinds. The choice changes what the rest of the sheet shows and how the item behaves in the inventory:

KindWhat it unlocks
WeaponA whole Weapon Configuration section with weapon properties (see step 3).
ArmorNo extra fields. Protection is added on the Rules tab (see the armor section below). In the inventory, the item gets a shield-shaped equip toggle.
ShieldSame as armor. Carrying a shield also lets rules elsewhere in the system detect "this character has a shield".
ConsumableBehaves like other items, but healing effects on consumables benefit from any "healing potion bonus" rules the drinker has.
MiscellaneousEverything else: tools, trinkets, wands. A wand is just a miscellaneous object with an activation.

For the Flaming Longsword, pick Weapon.

Below the object type you will find fields shared by every kind:

  • Identifier: a machine-friendly name used by rules and formulas. You can usually leave it blank.
  • Price: a number plus a coin denomination (cp, sp, or gp).
  • Object Size Type controls how the item occupies inventory space:
    • Slots required: the item takes a fixed number of inventory slots. Set Inventory Slots below it; the compendium longsword uses 2, and potions use 0.5. Slots When Stowed sets a different cost for while the item is not equipped. The rulebook puts worn armor at 1 slot and unworn armor at 2, so the compendium's armor carries 1 and 2. Leave it blank and the item costs the same whether it is in use or packed away. An object inside a container is never equipped, so it always pays the stowed cost.
    • Stackable: multiple copies merge into stacks. Set Stack Size (minimum 2). Dropping another copy onto a character increases the quantity instead of creating a duplicate.
    • Small: small items counted by quantity rather than slots.

Containers ​

A Container section sits below the shared fields. Tick This Object Is A Container and the object can hold others: boxes, chests, pouches, backpacks, bags, quivers, saddlebags. Players drag inventory items onto its row on the character sheet and the contents appear nested under it.

A container always costs its own inventory slots. Stored Object Slot Cost decides what the objects inside cost their carrier:

  • Normal slot cost: nothing changes. This is the mundane case of a chest, a backpack or a belt pouch, where the container organises the sheet and that is all. It is the default, and the only one the Nimble rulebook describes.
  • Ignore slot cost: stored objects cost nothing. The container takes its own slots and what is inside takes none.
  • Half slot cost: stored objects count for half. Halves are added up before the total is rounded, so two one-slot items inside share a single slot.
  • Reduce slot cost: stored objects cost their own slots minus Slots Reduced By, never less than zero.

The last three are system options rather than Nimble rules. They exist so you can build a magical container of your own, or port one from another game: Nimble is meant to run alongside D&D 5th edition material, and a bag that carries more than it should is the usual shape that takes.

The Nimble rulebook groups "small, related items" into one slot, giving Camping Supplies as the example. The system applies that to every small item a character carries, related or not: they all share a single slot. Only Ignore slot cost takes stored small items out of that shared slot. Halving or reducing leaves them in it.

Containers themselves are a system feature. The rulebook describes inventory slots and what fills them, not bags that hold other things, so everything in this section, the slot cost modes, capacity, allowed object types, the equipped-only switch, the ban on nesting one container in another, and the rule that a stored object cannot be equipped, is the system's own design rather than Nimble content.

Three more fields limit what the container will take:

  • Capacity: how many slots' worth of objects fit inside, measured at the objects' own slot cost rather than the reduced one. Small items share one slot of it between them, the way they share one slot of the inventory. Leave it blank for no limit. A drop that would overflow is refused with a message, and so is raising a stored stack's quantity past the limit.
  • Allowed Object Types: select one or more types and only those may be stored, so a quiver holds weapons and nothing else. Select none to allow anything.
  • Only Apply While Equipped: the container's rule applies only while it is equipped. Stowed, it still holds its contents but they cost their full slots. Use it for a harness or bandolier that only helps while worn.

Some worked settings. Only the first row is Nimble content; the rest are homebrew examples, and the magical bags are the kind of 5th edition item people most often bring across:

ContainerStored Object Slot CostOther settings
Chest, crate, backpack, belt pouch, quiverNormal slot costNo additional settings
Homebrew bag of holding or portable holeIgnore slot costA Capacity if you want the bag to have a stated limit
Homebrew handy haversackIgnore slot costCapacity for the compartment total
Bandolier that only holds weaponsNormal slot costAllowed Object Types set to Weapon
Harness worn over armorWhatever you decide it grantsOnly Apply While Equipped ticked

A homebrew bag of holding is the shortest worked example: leave the bag itself at one inventory slot, set Stored Object Slot Cost to Ignore slot cost, and everything dropped into it stops counting against the carrier. A suit of plate armor inside costs nothing; the bag still costs its one slot.

Containers cannot be nested inside one another, so an object that is already stored cannot be turned into a container until it is taken out. Deleting a container that still holds something asks for confirmation first, then leaves its contents in the inventory, back at their own slot cost. Unticking This Object Is A Container does the same without asking: the contents come back out rather than being left pointing at a bag that no longer holds anything.

Two more consequences worth knowing:

  • A stored object cannot be equipped. It is packed away. Dragging an equipped weapon or suit of armor into a container asks for confirmation first, then unequips it, which also switches off any rules that item was granting. Stored rows show a quantity field instead of an equip toggle.
  • Stacks stay separate per container. A bundle dropped onto a container joins the stack inside it; one dropped anywhere else joins the loose pile. The rulebook's own advice is not to track ammo at all ("If you have a quiver, you have enough arrows"), so this matters only in a game that has chosen to count it.

The compendium's Large Sack ships as a container on Normal slot cost. The rulebook says nothing about a sack reducing what you carry, so it organises the sheet without changing the numbers. Copies already in a world are not changed; drag a fresh one out of the compendium, or tick This Object Is A Container on the copy you have.

Quiver & Ammo deliberately does not ship as a container. The rulebook says "In most games, there's no need to track ammo. If you have a quiver, you have enough arrows." Tick This Object Is A Container on your own copy if your table has chosen to count arrows.

Step 3: Weapon properties ​

With Weapon selected, a Weapon Configuration section appears with a row of toggleable properties: Concentration, Light, Load, Range, Reach, Thrown, 2-Handed, and Vicious. What each property means in play is a game-rules question (see the Nimble rulebook), but some of them unlock extra fields on the sheet:

  • Range adds a range configuration section.
  • Reach adds a reach configuration section.
  • 2-Handed adds a Strength Requirement field, plus a checkbox for "Strength Requirement Overrides 2-Handed" (for weapons a strong character can wield in one hand).
  • Thrown adds a Thrown Range field.

For the Flaming Longsword, toggle 2-Handed, set the Strength Requirement to 2, and tick the override box, matching the ordinary longsword from the compendium.

The Config tab of a weapon with the Weapon Configuration section expanded, 2-Handed selected, and the Strength Requirement fields visible

Step 4: Damage (the Activation tab) ​

You may have noticed there is no "damage" field on the Config tab. Damage is part of what happens when the weapon is used, so it lives on the Activation tab, in the Effects sub-tab.

The short version for our sword:

  1. On Activation → Core, set the Activation Cost to 1 Action.
  2. On Activation → Targets, describe the targeting (target count, restrictions).
  3. On Activation → Effects, add a Damage effect: formula 1d8+@strength, damage type Slashing, with Can Miss and Can Crit ticked.
  4. Add a second Damage effect for the magic: formula 1d6, damage type Fire.

That second damage entry is the whole "flaming" part. When a player clicks the sword, the chat card shows both the slashing roll and the fire roll, each with its own apply button. The Activation tab has much more depth (nested on-hit effects, saving throws, conditions), and it is covered step by step on Item Activations & Effects.

Formula references

Formulas can reference the wielder's statistics: @strength, @dexterity, and friends are ability modifiers, @level is character level, and @key is the highest key ability of the character's class. See Formulas & References.

An alternative way to add the fire damage is a Damage Bonus rule on the Rules tab. Rules are the right tool when the bonus should be conditional ("only against undead", "only while raging") or should apply to other attacks the character makes. See Rules Builder Basics and the bonuses reference.

Crits and weapon proficiency

A weapon can carry a weapon type (for example "Longsword") in its data. If it does, a wielder whose class does not grant proficiency with that type can still attack, but cannot score critical hits. Weapons with no weapon type set skip this check entirely, so anything you create by hand works for everyone unless you copy an item that has a type set.

Armor and shields ​

Armor protection is not a number typed on the armor's sheet. It is a rule. A character's armor starts at their Dexterity modifier ("unarmored"), and every equipped item with an Armor Class rule adds its contribution on top, or overrides the value entirely.

Open the Chain Shirt from the compendium and look at its Rules tab: one Armor Class rule with the formula 9 + min(@dexterity,2)-@dexterity and mode add. Combined with the Dexterity base, this produces the classic "9 + DEX (max 2)". A rule can instead use mode override to replace the base value, or multiply.

To build your own armor:

  1. Create an Object and set the Object Type to Armor (or Shield).
  2. On the Rules tab, click Open Rules Builder and add an Armor Class rule with your formula and mode.

Equipping matters: the equip toggle in the character's inventory switches all of an item's rules on or off. Unequipped armor protects no one.

The Rules tab of the Chain Shirt compendium item, showing the Armor Class rule card

Consumables and charges ​

A consumable is an object that does something when used and is expected to run out. The compendium Healing Potion is the template to copy: Object Type Consumable, size 0.5 slots, and an activation with a single Healing effect of 2d4+4 costing 1 Action. When a player drinks it with no target selected, the healing is applied to their own token by default.

Quantity is yours to manage

Activating a consumable does not automatically reduce its quantity. Have players adjust the quantity field in their inventory, or delete the item, when a consumable is spent.

For items with limited uses that recharge, such as wands and once-per-rest trinkets, use charges instead of quantity:

  • A Charge Pool rule (Rules tab) gives the item a pool: a maximum (which can be a formula), a starting value, and recovery entries such as "refill on safe rest".
  • A Charge Consumer rule makes every activation of the item automatically spend charges from a pool.
  • Alternatively, a Pool effect on the Activation tab can spend, fill, or clear a pool only when the item is used in a particular way.

A Charge Pool on its own never spends anything: activating an item that only has a pool leaves its charges untouched. If the item should pay a charge each time it is used, add a Charge Consumer rule (or a Pool effect) alongside the pool.

Both rule types are documented in the resources reference. Once an item has a charge pool, its owner can open a charge window from the character sheet showing each pool as a card with plus/minus buttons, a click-to-edit current value, and Max / Empty shortcuts. Saving the changes posts a chat message recording the adjustment, so the table can see the wand tick down.

The charge configuration window showing a pool card with plus/minus buttons and Max/Empty shortcuts

Descriptions ​

The Description tab holds three separate texts:

  • Description: what everyone sees.
  • Unidentified: shown on the item's chat card in place of the real description while the item is flagged as unidentified. The item also carries an "unidentified name" used the same way.
  • Secret Notes: GM-only notes.

Whether the description is printed on the chat card at all is controlled by the "Output item description on activation" checkbox on the Activation → Core tab.

Descriptions support inline roll buttons, so you can embed clickable dice and condition labels directly in the text.

Finishing the Flaming Longsword ​

Write a description, drop the sword onto a test character, equip it, and click it in the inventory. You should get a roll window, then a chat card with a slashing roll and a fire roll. If you want the sword to do more (burn the target with a condition on a critical hit, spend charges, boost its wielder), the next stops are the Activation tab and the Rules Builder.

Released under the MIT License.