Configuration

Configuration

RunelessRPG has three config files in the config folder:

File	Side	Content
runelessrpg-server.toml	server (sent to clients)	Mana values, casting rules, costs, channeled spells, overcharge, leech, Spell Infinity, potions
runelessrpg-common.toml	client and server	Brewing ingredients
runelessrpg-client.toml	client only	Mana display and mana number

• The server config is read by the server and sent to every client when it logs in and again whenever the file changes, so tooltips and the cast check on the client always use the server's values. Changes apply while the game runs; base values are applied to all online players right away.
• The common config is read on both sides when the brewing recipes are built; changes need a restart of server and clients, and both should have the same values.
• The client config applies as soon as the file is saved. Most of it can be changed with the layout editor (see Mana HUD); Mods → RunelessRPG → Config → Edit Config Values... opens NeoForge's config screen for the options in game.

Every option has a comment and a valid range in the file.

Server: runelessrpg-server.toml

[mana]

Option	Default	Range	Meaning
baseMaxMana	20.0	0 – 100000	Base value of runelessrpg:max_mana for every player
baseManaRegen	0.5	−1000 – 1000	Base value of runelessrpg:mana_regen (mana per second)

[casting]

Option	Default	Range	Meaning
manaMode	FULL_COST	FULL_COST, DEBT, DEBT_LIMIT	What happens when the mana is too low, see Spell costs
maxDebtPercent	50.0	0 – 10000	DEBT_LIMIT: lowest mana after a cast, in percent of that spell's cost
creativeFreeCasting	true		Creative players cast for free and are never blocked
minManaCostPercent	50.0	0 – 1000	Floor of the runelessrpg:mana_cost attribute in cost calculations

[costs]

Option	Default	Range	Meaning
tierCosts	[4, 5, 7, 10, 14, 18]	numbers ≥ 0	Base cost per spell tier (index = tier); higher tiers use the last value, negative tiers the first
spellsEnabled	true		Spells that cost runes, plus #runelessrpg:cost/spells
spellsMultiplier	1.0	0 – 1000	Multiplier for the tier cost of spells
classSkillsEnabled	true		Class skills in #runelessrpg:cost/class_skills
classSkillsMultiplier	0.75	0 – 1000	Multiplier for class skills
weaponSkillsEnabled	true		Weapon skills in #runelessrpg:cost/weapon_skills
weaponSkillsMultiplier	0.5	0 – 1000	Multiplier for weapon skills
itemAbilitiesEnabled	false		Item abilities in #runelessrpg:cost/item_abilities
itemAbilitiesMultiplier	1.0	0 – 1000	Multiplier for item abilities

A disabled category is left to Spell Engine (runes again); see Spell costs.

[channel]

Option	Default	Range	Meaning
channelCostMode	DRAIN	DRAIN, START, END	How channeled spells are paid, see Spell costs
channelStartPercent	0.0	0 – 100	DRAIN: share of the total cost paid when the channel starts
cooldownOnChannelAbort	true		An interrupted channel (item switch, new spell, death, logout) gets the cooldown of releasing it at that point

[overcharge]

Option	Default	Range	Meaning
overchargeDamageFactor	0.5	0 – 10	Damage / healing bonus = overcharge × this factor
overchargeAffectsHealing	true		Overcharge also increases spell healing
overchargeAffectsSummons	true		Summons, spell clouds and spell-placed entities keep the bonus they were paid with

[mana_leech]

Option	Default	Range	Meaning
manaLeechExtraTargetPercent	25.0	0 – 100	Weapon leech: share for every further target in the same tick (0 = first target only)
spellManaLeechExtraTargetPercent	25.0	0 – 100	Spell leech: share for every further target in the same tick
leechCapAtTargetHealth	true		Count at most the target's health + absorption before the hit (no mana from overkill)

[spell_infinity]

Option	Default	Range	Meaning
mode	REDUCE_COST	REDUCE_COST, NONE	Effect of spell_engine:spell_infinity on the held item
costReductionPercent	20.0	0 – 100	Counts as this many percent less Mana Cost
floorReductionPercent	20.0	0 – 100	Lowers minManaCostPercent by this many points (never below 0)

[potions]

Option	Default	Range	Meaning
manaPotionPercentPerLevel	25.0	0 – 1000	Mana Restoration: percent of max mana per level
magicalStabilityManaCost	0.15	0 – 10	Magical Stability: mana_cost −this value per level
magicalStabilityDurationSeconds	180	1 – 86400	Duration of the Potion of Magical Stability
longMagicalStabilityDurationSeconds	480	1 – 86400	Duration of the long Potion of Magical Stability
borrowedPowerDurationSeconds	30	1 – 86400	Duration of the Potion of Borrowed Power
borrowedPowerDebtPercent	50.0	0 – 1000	Borrowed Power: spells may take mana down to −(this % of max mana)
backlashDamagePer10Percent	2.0	0 – 1000	Backlash damage per 10 % of max mana in debt
backlashMaxDamage	10.0	0 – 100000	Maximum backlash damage

Common: runelessrpg-common.toml

[brewing]

Option	Default	Recipe
manaIngredient	minecraft:lapis_lazuli	Awkward Potion → Potion of Mana
strongManaIngredient	minecraft:glowstone_dust	Potion of Mana → Potion of Mana II
magicalStabilityIngredient	minecraft:amethyst_shard	Potion of Mana → Potion of Magical Stability
longMagicalStabilityIngredient	minecraft:redstone	Potion of Magical Stability → long version
borrowedPowerIngredient	minecraft:fermented_spider_eye	Potion of Mana → Potion of Borrowed Power

An empty value disables the recipe; an invalid id disables it with a warning.

Client: runelessrpg-client.toml

[hud] (mana display)

Option	Default	Range	Meaning
visible	true		Show the mana display
anchor	MIKI_RIGHT	see Mana HUD	Screen anchor
offsetX	0	−10000 – 10000	Horizontal offset in GUI pixels (positive = right)
offsetY	0	−10000 – 10000	Vertical offset in GUI pixels (positive = down)
scale	1.0	0.25 – 4	Size; at the level anchors MIKI and THIN only get thicker, up to 2.5
style	AUTO	AUTO, THIN, MIKI, VERTICAL, MIKI_DIAMOND, MIKI_BAND	Look, see Mana HUD
bandWidth	7	3 – 16	Width of MIKI_BAND in GUI pixels
bandGap	2	0 – 8	Gap between MIKI_BAND and Miki's diamond
animatedFill	true		Moving, shimmering fill (MIKI_DIAMOND, MIKI_BAND, MIKI)
animationSpeed	1.0	0.1 – 3	Speed of the moving fill
fillColor	#3A7BFF	#RRGGBB	Fill color
debtColor	#B02020	#RRGGBB	Color of negative mana
drawBehindMikiHud	true		Draw behind the hotbar and Miki's HUD (false: in front)
hideInCreative	true		Hide in creative mode
hideInSpectator	true		Hide in spectator mode

[text] (mana number)

Option	Default	Range	Meaning
visible	true		Show the number
attachToBar	true		Positioned relative to the display (false: own anchor)
anchor	BOTTOM_CENTER	screen or Miki anchors	Anchor when not attached
offsetX	0	−10000 – 10000	Offset from the default place (attached) or from the anchor
offsetY	0	−10000 – 10000	Same, vertical
scale	1.0	0.25 – 4	Size; snaps to sharp sizes. Attached with offset 0 and scale 1 the number is fitted automatically
textMode	CURRENT	NONE, CURRENT, CURRENT_MAX, PERCENT	Text, from 1000 shortened ("1.5k")
textFont	VANILLA	VANILLA, PIXEL	Minecraft font or own pixel digits
textOutline	true		Dark outline (false: drop shadow)
textVisibility	ALWAYS	ALWAYS, ON_CHANGE	Always, or for 2 s after a noticeable change

[flash]

Option	Default	Meaning
flashOnInsufficientMana	true	Flash the display when a spell fails for lack of mana
flashColor	#FF3030	Flash color