Configuration · Great Sage

Great Sage has two config files, in the config folder of your instance (or server). The client file sets what you see and hear; the common file sets what the server decides for everyone — on a dedicated server, its file is the one that counts. Every option lives in a [general] section. What concerns the whole world (who hears announcements, progression, the birth scene…) goes through gamerules instead.

`greatsage-client.toml`

Announcements

Option	Default	Range	Effect
`enableVoice`	`true`	—	Plays the voice clips. False: visuals only.
`voiceWithoutNameClip`	`true`	—	Says the sentence even if no name in the announcement is recorded (missing names leave a gap). False: such an announcement stays silent.
`enableOverlay`	`true`	—	Shows the on-screen animation. The voice plays even when false.
`enableSfx`	`true`	—	Sound effects: the Sage showing up at the start, the impact on each name.
`volume`	`1.0`	0 – 2	Voice volume, multiplied by the game's master volume.
`darkenStrength`	`0.72`	0 – 1	How dark the screen gets during an announcement; 0 = none.
`showWithHiddenHud`	`false`	—	Keeps the announcement visible when the HUD is hidden with `F1`.
`compactSkillAnnounce`	`false`	—	Quiet mode: the Sage speaks in a bubble in the bottom right, without darkening. Ceremonies and evolutions always keep the full scene.
`compactTiers`	all six ranks	list	Ranks that go to the bubble when quiet mode is on; the others keep the full screen.
`announcedTiers`	all six ranks	list	Ranks that trigger an announcement: `resistance`, `intrinsic`, `common`, `extra`, `unique`, `ultimate`.
`tierOrder`	`extra, unique, ultimate, intrinsic, common, resistance`	list	Order of ranks in an announcement; an unlisted rank is spoken last.
`skillBlacklist`	empty	list	Skills never announced (e.g. `"tensura:self_regeneration"`). Right-clicking a skill in the menu adds or removes it.
`batchWindowTicks`	`10`	1 – 100	Grouping window: each acquired skill pushes it further, then a single announcement starts.
`maxQueued`	`4`	1 – 32	Announcements that can wait in line.
`ceremonyHoldTicks`	`40`	5 – 400	Silence (in ticks) after the last skill before a ceremony or an open announcement says its closing line. 40 = 2 s.
`worldVoice`	`true`	—	Hear the The Voice of the World when it speaks to the whole server.

The Sage and its remarks

Option	Default	Range	Effect
`enableTips`	`true`	—	Your Spontaneous remarks. The server has its own switch; both must agree.
`chimeClip`	`sfx.chime`	text	Short sound played before the Sage speaks. Empty: none.
`menuAmbience`	`sfx.ambience`	text	Quiet loop under the open menu. Empty: silence.
`repeatGuardMs`	`4000`	0 – 60,000	Time (ms) during which the same line is not repeated. 0: it repeats freely.
`menuSkills`	`tensura:great_sage`	list	Skills that give access to the menu. A Raphael always does, without adding it.
`assessWarnRatio`	`5.0`	1 – 1,000	EP ratio from which a target is flagged as dangerous in Assess Mode (red aura).
`battleSkills`	empty	list	Battle Mode skills. Filled by the menu's Battle Mode page, no need to edit it.
`lastSeenVersion`	empty	text	Last "What's new" page seen. Empty it to see it again.

Talking to the Sage

Option	Default	Range	Effect
`voiceInput`	`off`	`off`, `wake`, `pushToTalk`	`off`: nothing listens. `wake`: the mic waits for a wake word. `pushToTalk`: the mic only opens while the key is held.
`voiceLanguage`	`ask`	`en`, `fr`, `es`, `pt`, `tr`, `vi`, `ko`, `ask`	The language you speak. `ask` asks the first time you carry the Sage in a world (English until then). See Languages.
`wakeWords`	`great sage`, `wise one`, `sage`	list	Wake words (`wake` mode). They must exist in your language's model; in French and Spanish, grand sage and gran sabio are always added.
`listenWindowTicks`	`120`	40 – 400	Time to phrase your request after the wake word. 120 = 6 s.
`voiceFeedback`	`true`	—	Small sound when it starts listening.
`voiceConfidence`	`0.55`	0 – 1	How sure recognition must be before acting. Raise it if it does things you did not ask for.
`voiceAutoDownload`	`true`	—	Downloads the library (≈ 25 MB, once) and your language's model into `.minecraft/greatsage-voice/`, only if `voiceInput` is not `off`. Files are checked before loading. False: put them there yourself.

Magic Sense (0.0.7)

Option	Default	Range	Effect
`entityAura`	`true`	—	Draws every being's Magic Sense and auras while the sense is on. False: only the veil, the aimed being's name and EP, and the edge arrows.
`auraRange`	`40`	8 – 64	Maximum aura distance, in blocks.
`auraMaxEntities`	`24`	1 – 64	Maximum auras at once, closest first. Lower it if the game slows down.
`auraThroughWalls`	`true`	—	Hidden beings keep a paler aura (up to 24 blocks).
`auraIntensity`	`1.0`	0.2 – 1.5	Aura brightness.

`greatsage-common.toml`

Announcements and ceremonies

Option	Default	Range	Effect
`joinGraceTicks`	`100`	0 – 600	Silence after joining the world or respawning, while Tensura re-grants your race's kit. 100 = 5 s.
`announcedCeremonies`	all five	list	Milestones that get their announcement: `hero_egg`, `demon_lord_seed`, `harvest_festival`, `true_hero`, `true_demon_lord`.
`shieldedCeremonies`	`true_hero`, `true_demon_lord`	list	Ceremonies (classic rendering) during which you take no damage.
`ceremonyShieldTicks`	`400`	20 – 2,400	Duration of that protection. 400 = 20 s.

Analysis

Option	Default	Range	Effect
`analysisTicks`	`1200`	20 – 72,000	Base duration of an Skill analysis. 1200 = 1 min.
`analysisClassFactors`	`intrinsic=2`, `common=2`, `extra=3`, `unique=5`, `ultimate=8`	list	Duration multiplier per rank. 0 forbids analysing that rank. Resistances are not listed and cannot be added.
`analysisSkillTimes`	empty	list	Exact duration in ticks for one skill, `id=ticks` (e.g. `tensura:great_sage=72000`). Wins over the rank; 0 forbids it.
`analysisFailChance`	`0.25`	0 – 1	Chance an analysis fails at the very end (nothing learned, magicules lost). The tree's Precision branch lowers it; 0 disables failures.
`latentTimeFactor`	`3`	1 – 20	Duration multiplier for a skill you have not started to grasp (negative mastery). 1: no penalty.
`latentMagiculeExtra`	`0.75`	0 – 10	Extra magicule cost in the same case, as a fraction of the normal cost (0.75 = 175%).
`modeTimeExtra`	`0.5`	0 – 10	Extra time per locked mode (Sloth, Black Lightning…): 0.5 = +50% per mode.

Assess Mode and remarks

Option	Default	Range	Effect
`assessRange`	`48.0`	4 – 128	Maximum reading distance of a target, in blocks (before tree bonuses).
`assessEpRatio`	`10.0`	1 – 10,000	Beyond this EP ratio the target is unreadable and the analysis fails.
`assessNauseaRatio`	`8.0`	1 – 10,000	EP ratio from which being close makes you sick (level 3, level 4 if the gap is huge).
`enableTips`	`true`	—	Server switch for spontaneous remarks.
`tipQuietTicks`	`600`	20 – 24,000	Minimum silence between two remarks, whatever they are. 600 = 30 s.

Reincarnation

Option	Default	Range	Effect
`reincarnationErrorChance`	`0.03`	0 – 1	Chance, on the first wish, that the world grants the Unique's greater form. 0 disables it.
`reincarnationShuffle`	`PLAYER`	`PLAYER`, `WORLD`, `OFF`	Scope of the secret figure → gift draw: per player (and per life), per world, or fixed table.
`reincarnationAddonUniques`	`TENSURA_LIST`	`TENSURA_LIST`, `ALL`, `NONE`	Which addon Uniques the birth can give.
`reincarnationExcludedSkills`	`trnightmares:sentient`	list	Skills never given at birth (`mod:skill` or `mod:*`).

Details: Reincarnation.

Growth

Option	Default	Range	Effect
`growthContentShare`	`0.55`	0.05 – 1	Share of all the experience the installed mods offer that the last level of the Growth tree requires.
`growthXpMultiplier`	`1.5`	0.1 – 10	Multiplies every experience gain without stretching the curve. 1: the strict curve.
`growthAppraisal`	`true`	—	Appraisal: the first item of each kind entering your inventory gives 1, 3, 8 or 20 XP depending on rarity. False also removes items from the curve.