Skip to content
Aithor Dev

Research Config

On this page

research.yml

Defines every research project a nation can pursue and the tuning knobs for balancing them.

Top-level keys

YAML
research:
  enabled: true
  cancel-refund-percent: 50
  types:
    ...
Key Default Description
enabled true Master switch. false disables the entire feature
cancel-refund-percent 50 Percentage of the paid cost refunded to the treasury when the leader cancels a project mid-progress. 0 = no refund, 100 = full refund

Per-project keys

YAML
research:
  types:
    agriculture_program_i:
      enabled: true
      cost: 25000
      cost-scaling: 1.0
      time-seconds: 600
      time-scaling: 1.0
      max-level: 5
      effect-per-level: 0.01
Key Description
enabled Whether this project appears and can be started
cost Base treasury cost for level 1
cost-scaling Multiplier applied per level (see the formula below)
time-seconds Base research duration for level 1
time-scaling Multiplier applied per level
max-level Maximum attainable level
effect-per-level Magnitude added per level. Interpretation depends on the project

Scaling formula

Text
cost at level N     = cost         Γ— cost-scaling ^ (N βˆ’ 1)
duration at level N = time-seconds Γ— time-scaling ^ (N βˆ’ 1)

With 1.0 every level costs and takes the same. Above 1.0 later levels get progressively more expensive and slower; below 1.0 they get cheaper and faster.

How effect-per-level is read

Project group Meaning of the value
Agriculture, Husbandry, Mining Probability per level that a "1–2 extra drops" bonus triggers. 0.01 = 1 % per level
Magic Education, Hunting Skill, Attack, Defensive, Archery Fractional bonus per level. 0.01 = +1 % (or βˆ’1 % for Defensive Tactic) per level
Health Expansion Extra max-HP points per level. 0.5 = half an HP point (a quarter heart) per level

The default catalogue

Economy β€” Era I

Id Cost Time Max level Effect per level
agriculture_program_i 25,000 600 s (10 min) 5 0.01
husbandry_boost_i 25,000 600 s (10 min) 5 0.01
mining_luck_i 25,000 600 s (10 min) 5 0.01

Technology β€” Era I

Id Cost Time Max level Effect per level
magic_education_i 35,000 1500 s (25 min) 5 0.01
health_expansion_i 48,000 1920 s (32 min) 5 0.5
hunting_skill_i 50,000 2100 s (35 min) 5 0.01

War β€” Era I

Id Cost Time Max level Effect per level
attack_exercise_i 100,000 600 s (10 min) 5 0.01
defensive_tactic_i 100,000 600 s (10 min) 5 0.01
archery_training_i 100,000 600 s (10 min) 5 0.01

Rules the plugin enforces

  • Research data is stored per nation, not server-wide.
  • Only the nation leader (or an admin) can start or cancel a project.
  • Effects apply to every member of the owning nation.
  • A nation can run one project at a time.

Common tasks

Slow the whole tree down

YAML
agriculture_program_i:
  time-scaling: 1.5

Level 2 now takes 1.5Γ— the base time, level 3 takes 2.25Γ—, and so on.

Make a project more valuable

YAML
health_expansion_i:
  effect-per-level: 1.0    # a full HP point (half a heart) per level
  max-level: 10

Remove a project

YAML
attack_exercise_i:
  enabled: false

Turn the feature off entirely

YAML
research:
  enabled: false

Admin commands

Text
/nc admin research set <nation> <research_id> <level>
/nc admin research reset <nation>

Search documentation

    Type to start searching.