UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Skill Settings

skillSettings

Global skill mechanics: skill XP costs and rewards, the chance to learn a new skill, level caps, and the per-type bonus added to skill checks.

In the editor

"Skill system tuning"

Editor location
Files → Mechanics → Skill Settings
Editor type
Edit in Studio + View JSON
API endpoint
/sections/skillSettings.json/sections/skillSettings.md
Size limits

No character-length caps for this section.

Related

Schema

json
{
  "skillSettings": {
    "trainingCooldown": "number",
    "skillXPRewards": {
      "<key>": "number"
    },
    "skillBonusModifier": "number",
    "xpFromNewSkill": "number",
    "maxSkillLevel": "number",
    "maxSkillSuccessLevel": "number",
    "charXPPerSkillLevel": "number",
    "baseXPFromSkillUpgrade": "number",
    "additionalXPRequiredPerSkillLevel": "number",
    "startingXPToLevelUpSkill": "number",
    "baseChanceToLearnNewSkill": "number",
    "skillLearningBonusModifier": "number",
    "skillTypeDifficultyBonus": {
      "<key>": "number"
    },
    "newSkillGenerationEnabled": "boolean"
  }
}

Example

json
{
  "skillSettings": {
    "maxSkillLevel": 100,
    "maxSkillSuccessLevel": 100,
    "skillXPRewards": { "small": 40, "medium": 60, "large": 100, "huge": 150 },
    "startingXPToLevelUpSkill": 100,
    "additionalXPRequiredPerSkillLevel": 40,
    "skillBonusModifier": 1,
    "xpFromNewSkill": 200,
    "newSkillGenerationEnabled": true,
    "baseChanceToLearnNewSkill": 0.1,
    "skillLearningBonusModifier": 0.01,
    "trainingCooldown": 10,
    "charXPPerSkillLevel": 5,
    "baseXPFromSkillUpgrade": 125,
    "skillTypeDifficultyBonus": { "none": 0, "combat": 0, "utility": 0, "magic": 0 }
  }
}

Fields

maxSkillLevel

The highest level a skill can be trained to. Independent of maxSkillSuccessLevel, which caps how much a single source contributes to a check. Default 25.

skillXPRewards

Skill XP awarded per reward, keyed by reward size: small, medium, large, and huge. All four keys are required. Skills carry no XP value of their own; the amount always comes from this table.

skillTypeDifficultyBonus

Flat bonus added to every check made with a skill of that type, keyed by skills[*].type. A skill whose type has no entry here gets no type bonus. Setting every value to 0 leaves type as a label with no mechanical effect.

baseChanceToLearnNewSkill

Base chance, from 0 to 1, that a character learns a skill they don't have when they attempt to use it. The relevant attribute, multiplied by skillLearningBonusModifier, is added on top. 0.1 is a 10% base chance. Set both this and skillLearningBonusModifier to 0 to lock the skill set to character creation.

newSkillGenerationEnabled

Whether Voyage may invent entirely new skills during play. false limits characters to the skills defined in the world config. The chance of learning a skill is set separately by baseChanceToLearnNewSkill and skillLearningBonusModifier.

additionalXPRequiredPerSkillLevel

Additional XP required per level beyond the starting threshold. With startingXPToLevelUpSkill: 100 and additionalXPRequiredPerSkillLevel: 40: level 1 requires 100 XP, level 2 requires 140, level 3 requires 180, and so on. Higher values make later skill levels progressively harder to reach, which steepens the progression curve.

maxSkillSuccessLevel

Caps the absolute contribution any single skill, attribute, ability, random roll, or context modifier can add to a skill check. Independent of maxSkillLevel. Default 25.

startingXPToLevelUpSkill

XP required to reach the first skill level. Combined with additionalXPRequiredPerSkillLevel: with startingXPToLevelUpSkill: 100 and additionalXPRequiredPerSkillLevel: 40, level 1 costs 100 XP, level 2 costs 140, and so on.

xpFromNewSkill

Character XP granted when a character learns a new skill. Default 200.

charXPPerSkillLevel

Character XP awarded for each skill level a character gains. Default 5.

baseXPFromSkillUpgrade

Base XP applied when a skill is upgraded. Default 125.

skillBonusModifier

Multiplier applied to a skill's level when it contributes to a check. 1 adds the skill level as-is; higher values make each level count for more. Default 1.

skillLearningBonusModifier

Multiplied by the relevant attribute and added to baseChanceToLearnNewSkill when a character tries a skill they don't have. Set both to 0 to lock the skill set to character creation. Default 0.01.

trainingCooldown

Cooldown before the same skill can be trained again. Default 10.