UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Skill Settings

skillSettings

Global skill mechanics — XP costs for leveling, skill learning chance, maximum skill level, and the difficulty check thresholds that translate difficulty labels (Easy/Hard/etc.) into numeric bonuses.

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. Engine default 25; raise it to give skill investment more headroom.

skillXPRewards

Assigns XP gained per successful skill use by size category. Each skills[*] entry carries no numeric XP value itself — the XP amount is read from this table. Assign skills to size buckets: small for high-frequency combat skills, large or huge for skills used rarely. The effect is that rarely-used skills level faster per use, which compensates for fewer opportunities.

skillTypeDifficultyBonus

Flat bonus applied to all checks for skills of that type. Keys must match values in skills[*].type. Setting all to 0 means type has no mechanical effect beyond categorization. Non-zero values effectively make some skill types globally easier or harder regardless of the check's own difficulty.

baseChanceToLearnNewSkill

Probability of gaining a new skill the first time a character attempts it without having it. 0.1 = 10% 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. true keeps the prior behavior (new skills can be generated); false locks characters to the skills already defined in the world config. Required -- the editor rejects a config that omits it. (The per-attempt chance of learning a new skill is configured 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. Engine default 25; most worlds raise it so skill investment has room to matter.

startingXPToLevelUpSkill

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

xpFromNewSkill — XP granted when a character gains an entirely 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

Global modifier applied to skill bonuses. 1 leaves bonuses unchanged; higher values scale all skill bonuses up. Default 1.

skillLearningBonusModifier

Modifier that raises the chance of learning a new skill beyond baseChanceToLearnNewSkill. Set both this and baseChanceToLearnNewSkill 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.