Documentation home
Nation Core
System
Reference
On this page
Defines every research project a nation can pursue and the tuning knobs for
balancing them.
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
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
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
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
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
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 .
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
YAML
attack_exercise_i:
enabled: false
Turn the feature off entirely
YAML
research:
enabled: false
Text
/nc admin research set <nation> <research_id> <level>
/nc admin research reset <nation>