Configuration

⚙️ Configuration

Almost every gameplay value in Fairy Tales is tunable. Settings live in a plain, hand-editable JSON file — no config library, no in-game menu required.

File: config/fairytales.json (created automatically on first launch)

• Edit it with any text editor, then restart (or rejoin) to apply.
• Missing or removed fields are refilled with defaults on load, so a mod update tops the file up without wiping your changes.
• Invalid values are clamped to something safe.

🖧 Server-authoritative & synced

On a dedicated server, the server's config is the source of truth — it's sent to each client on join, so HUD readouts and client-side features match the server's rules. In single-player, the file is simply your own. Great for modpacks: ship one config and everyone plays by it.

---

progression

Key	Default	Meaning
magicPerSecond	1	Base Magic gained each second at neutral conditions.
tierThresholds	[0, 600, 1800, 4500, 9000]	Magic needed to reach Tiers I–V. Must be five ascending values (Tier I is always 0).

conditions

Multipliers applied to Magic gain based on surroundings (see thriving vs. sulking).

Key	Default	Meaning
thrivingMultiplier	3.0	Gain multiplier when the fairy thrives.
neutralMultiplier	1.0	Gain multiplier when neutral.
sulkingMultiplier	0.0	Gain multiplier when sulking (0 = growth stops).

attunement

Key	Default	Meaning
settlingSeconds	20	Delay before a newly-equipped fairy's abilities switch on.
swapCooldownSeconds	30	Wait after equipping before you can attune a different fairy.
blockedInCombat	true	Whether you're blocked from attuning while in combat.
combatSeconds	5	How recently you must have fought to count as "in combat".

connectionTable

Key	Default	Meaning
basePointsPerTick	10	Attunement points a scroll gains per tick at a bare (1×) table.
baseInGameDays	3	In-game days a bare table takes to finish a scroll.
maxEnvironmentMultiplier	6.0	The best a lush, on-theme shrine can multiply connection speed.

abilities

Key	Default	Meaning
minActiveTier	3	Tier at which a fairy's active (keybind) ability unlocks.
cooldownEmberwispSeconds	5.0	Emberdash cooldown.
cooldownBrambleknotSeconds	6.0	Vine Grapple cooldown.
cooldownNettleshadeSeconds	6.0	Shadowstep cooldown.
cooldownRimebellSeconds	9.0	Frost Leap cooldown.
cooldownCogmiteSeconds	5.0	Steam Jump cooldown.

features

Key	Default	Meaning
autoSmelt	true	Emberwisp's ore auto-smelting.
oreSense	true	Cogmite's exposed-ore outline.
oreSenseRadius	10	How far (blocks) Ore Sense scans.
oreSenseColor	"FFFFC24A"	Ore outline color, 8-digit ARGB hex (alpha first).
caveLight	true	Cogmite's cave light aura.
caveLightMinTier	1	Tier at which the cave light unlocks.
caveLightMaxSkylight	4	How dark it must be (max sky light) for the light to appear.

fairies

Master switch per fairy — a disabled fairy can't be attuned.

Key	Default
emberwisp	true
brambleknot	true
nettleshade	true
rimebell	true
cogmite	true

---

Example Tweaks

Slower, grindier progression (roughly double the time to max):

"progression": { "magicPerSecond": 1, "tierThresholds": [0, 1200, 3600, 9000, 18000] }

Sulking still trickles Magic instead of fully stopping:

"conditions": { "thrivingMultiplier": 3.0, "neutralMultiplier": 1.0, "sulkingMultiplier": 0.25 }

Faster connection (bare table finishes in ~1 in-game day):

"connectionTable": { "basePointsPerTick": 10, "baseInGameDays": 1, "maxEnvironmentMultiplier": 6.0 }

Free, instant swapping (no cooldown, allow combat swaps):

"attunement": { "settlingSeconds": 0, "swapCooldownSeconds": 0, "blockedInCombat": false, "combatSeconds": 5 }

Disable a fairy (e.g. remove Nettleshade from your pack):

"fairies": { "emberwisp": true, "brambleknot": true, "nettleshade": false, "rimebell": true, "cogmite": true }

Re-color Ore Sense to cyan:

"features": { "oreSense": true, "oreSenseRadius": 12, "oreSenseColor": "FF33E0FF" }

---

Full Default File

{
  "progression": {
    "magicPerSecond": 1,
    "tierThresholds": [0, 600, 1800, 4500, 9000]
  },
  "conditions": {
    "thrivingMultiplier": 3.0,
    "neutralMultiplier": 1.0,
    "sulkingMultiplier": 0.0
  },
  "attunement": {
    "settlingSeconds": 20,
    "swapCooldownSeconds": 30,
    "blockedInCombat": true,
    "combatSeconds": 5
  },
  "connectionTable": {
    "basePointsPerTick": 10,
    "baseInGameDays": 3,
    "maxEnvironmentMultiplier": 6.0
  },
  "abilities": {
    "minActiveTier": 3,
    "cooldownEmberwispSeconds": 5.0,
    "cooldownBrambleknotSeconds": 6.0,
    "cooldownNettleshadeSeconds": 6.0,
    "cooldownRimebellSeconds": 9.0,
    "cooldownCogmiteSeconds": 5.0
  },
  "features": {
    "autoSmelt": true,
    "oreSense": true,
    "oreSenseRadius": 10,
    "oreSenseColor": "FFFFC24A",
    "caveLight": true,
    "caveLightMinTier": 1,
    "caveLightMaxSkylight": 4
  },
  "fairies": {
    "emberwisp": true,
    "brambleknot": true,
    "nettleshade": true,
    "rimebell": true,
    "cogmite": true
  }
}