with one click
Schema and rules for creating items
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill itemsCopy and paste this command into Claude Code to install the skill
Schema and rules for creating items
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill itemsCopy and paste this command into Claude Code to install the skill
| name | items |
| description | Schema and rules for creating items |
| context | fork |
| agent | items |
Edit tabs/items.json.
| Field | Requirement |
|---|---|
name | Must match object key exactly |
category | Must be in itemSettings.itemCategories (armor, consumable, etc.) |
description | Brief flavor text describing the item's appearance and nature |
bonuses | Array of bonuses - use [] if item is not equipable |
| Field | When to Include |
|---|---|
slot | Required for equippable items |
mediaContent | Required for readable items - the text content to display |
Omit these fields (calculated at runtime):
uuid, quantity, equippedSlotcategory: "Consumable", no slotbonuses: []category: "Currency", no slotitemSettings.currencyName for stackingbonuses: []category: "Readable", no slotmediaContent with the text to displaybonuses: []Array of stat modifications applied when item is equipped.
{ type: "stat", variable: "damage", value: 5 } // +50% damage
{ type: "stat", variable: "armor", value: 100 } // 10% incoming damage reduction
{ type: "attribute", variable: "strength", value: 2 } // +2 to attribute
{ type: "skill", variable: "stealth", value: 1 } // +1 to skill
{ type: "resource", variable: "health", value: 10 } // +10 max health
Format: { type: "stat" | "attribute" | "skill" | "resource", variable: string, value: number }
For type: "stat", only damage and armor are valid variable values. Armor reduces incoming damage by value / 1000 (capped at 90%).
interface ItemDefinition {
name: string
category: string
description: string
bonuses: ItemBonus[]
slot?: string
mediaContent?: string
}
interface ItemBonus {
type: 'resource' | 'stat' | 'attribute' | 'skill'
variable: string
value: number
}
For detailed documentation, see items-reference.md.
Schema and rules for creating abilities
Schema and rules for editing AI instructions
Check character counts and limits for Voyage World config files. Use when checking how much space is used, before adding large content, or when approaching size limits.
Schema and rules for creating locations
Schema and rules for creating NPCs
Schema and rules for creating regions