Skip to main content
  1. Skills/

Examples

·220 words·2 mins

Creating a New Skill
#

These snippets are illustrative examples for documentation. Treat them as patterns to adapt, not copy-paste-ready production data.
  1. Define the skill category (Gathering, Refining, Buffing, Combat)
  2. Create skill metadata (id, name, icon, description)
  3. Design action progression curve (levels 1-99)
  4. Define actions with appropriate requirements and rewards
  5. Set mastery levels and bonuses
  6. Balance timing and experience values

Complete Action Example: Mine Copper
#

{
  "id": "mine_copper",
  "name": "Mine Copper",
  "description": "Mine copper ore from a copper rock.",
  "skillId": "mining",
  "category": "gathering",
  "requiredLevel": 1,
  "requiredItems": [],
  "requiredEquipment": [
    {
      "slot": "tool",
      "type": "pickaxe",
      "minimumTier": "bronze"
    }
  ],
  "baseDuration": 2500,
  "experience": 10,
  "rewards": [
    {
      "itemId": "copper_ore",
      "quantity": 1,
      "chance": 1.0
    }
  ],
  "masteryXp": 5,
  "masteryRewards": [
    {
      "level": 1,
      "bonus": {
        "type": "outputPerLevel",
        "value": 0.01,
        "description": "+1% more copper ore per level"
      }
    },
    {
      "level": 5,
      "bonus": {
        "type": "actionSkillExperience",
        "value": 0.10,
        "description": "+10% mining experience from copper ore"
      }
    },
    {
      "level": 10,
      "bonus": {
        "type": "skillExperience",
        "value": 0.10,
        "description": "+10% mining experience from any ore"
      }
    }
  ]
}

Skill Definition Example: Mining
#

{
  "id": "mining",
  "name": "Mining",
  "category": "gathering",
  "icon": "⛏️",
  "description": "Extract ores and gems from the earth.",
  "experienceCurve": {
    "base": 100,
    "multiplier": 1.5
  },
  "masteryExperienceCurve": {
    "base": 100,
    "multiplier": 1.5
  },
  "actions": [
    "mine_copper",
    "mine_iron",
    "mine_gold",
    "mine_mithril",
    "mine_adamantite",
    "mine_rune"
  ]
}