๐ฅ Mage Flame
Mage Flame is a small mod that adds the ability to create dynamic light sources that follow you wherever you go. This is done with scrolls crafted from ingredients you find in the world. No mana, no spell points, no mage classes, no levels. Just craft and use.
No more swapping between your shield and a torch. Read a scroll and a flame floats beside you, lighting the way through caves, tunnels and long nights.
This is the Hytale version of the Minecraft mod of the same name.
๐ The Scrolls
Right-click a scroll to read it. A flame appears and follows you. The scroll is used up only if the flame actually appears.
| Scroll | Light | Lasts | Recipe |
|---|---|---|---|
| ๐ Mage Flame | Warm orange, a little dimmer than a torch | 10 minutes | 2 Fibre, 1 Tree Sap, 1 Crude Torch (pocket crafting or Workbench) |
| ๐ข Lesser Revelation | Green, a wider glow than Mage Flame | 15 minutes | Mage Flame scroll, Green Crystal, Life Essence (Workbench) |
| ๐ต Greater Revelation | Blue, brighter than a torch | 30 minutes | Lesser Revelation scroll, Blue Crystal, Void Essence (Arcane Bench) |
| ๐ซง Bubble Flame | Warm, inside a translucent bubble. Follows you under water | 20 minutes | Mage Flame scroll, 3 Cyan Crystal (Workbench) |
Each flame upgrades from the one before it: the better scroll is crafted from the lower one. The Arcane Bench itself is the gate for the Greater Revelation.
You can also find scrolls in chests out in the world: cheaper scrolls in the first zones, Greater Revelations deeper in.
๐ธ Screenshots

Greater Revelation, Mage Flame and Bubble Flame, with the lifespan panel at the top-left.

A Lesser Revelation flame in the rain.
โจ Features
- ๐ Hands-free light. The flame keeps up with you at a run, hovers higher in the open and lower in tunnels, and catches up if you outrun it or turn a corner underground.
- โณ Lifespan display. A small panel at the top-left lists each flame with the time it has left and a progress bar that drains as it burns down.
- ๐ง Water puts flames out. Mage Flame and the two Revelations go out in water, with a hiss and a puff of smoke. The Bubble Flame carries its own air and keeps burning.
- ๐พ Flames come back. Log out or stop the server and your flames are saved. They return with their remaining time when you join again. Time does not run while you are away.
- ๐ข Limits. By default one flame per player; reading another scroll replaces the oldest flame. The limit is configurable.
- ๐ Survive death. After you die, your flames catch up with you when you respawn (this can be turned off).
โ๏ธ Configuration
MageFlame.json, created in the mod's data folder the first time it runs:
| Setting | Default | What it does |
|---|---|---|
MaxSummonedEntitiesPerPlayer |
1 | How many flames a player can have at once (1 to 4) |
EnableLifespanDisplay |
true | Show the lifespan panel and its progress bars |
MageFlameLifespanSeconds |
600 | Default lifespan, for flames not listed below |
LifespanSecondsByType |
Lesser 900, Greater 1800, Bubble 1200 | Lifespan per flame. 0 or less means the flame never expires |
PersistFlames |
true | Save flames when you leave and bring them back when you join |
DespawnOnOwnerDeath |
false | Remove your flames when you die, instead of letting them follow you after respawn |
Restart the server after changing it.
๐ฌ Commands
Everyone can use healthcheck. The others are for operators (they need the command's permission), so players cannot skip the scrolls.
| Command | Who | What it does |
|---|---|---|
/mageflame healthcheck |
Everyone | Check that the mod is running |
/mageflame summon [--type=Mage_Flame] |
Operators | Summon a flame without a scroll (testing and admin) |
/mageflame dispel |
Operators | Remove all flames in the world |
/mageflame status |
Operators | List flames with their distance from their owner |
๐ฆ Installing
- Download
MageFlame-1.0.0.jarand put it in your HytaleUserData\Modsfolder (or themodsfolder of your server). - For a local world, open the world's
config.json(inUserData\Saves<your world>) and enable the mod:
"Mods": {
"gottsch:MageFlame": { "Enabled": true }
}
- Start the world. Craft a Mage Flame scroll, or use
/give Scroll_Mage_Flame.
Requires Hytale server 0.7.4 or newer in the 0.7 line.
โ ๏ธ Good to know
- Use survival or adventure mode. In creative mode, flames do not follow the player.
- Chest loot. To add scrolls to chests, Mage Flame replaces a few of the game's shared chest loot tables (
Zone1_Encounters_Tier1toTier4,Zone2_Encounters_Tier1toTier4, andZone3_Encounters_Tier2toTier4) with copies that include the scrolls. Another mod that changes the same tables will conflict with this one (only one can win), and a game update that changes them needs a Mage Flame update to follow. - Multiplayer. Everything was tested solo. Please report anything odd with several players.
๐ฎ Coming later
Winged Torch, Ember Hound and Glowglob (all in the Minecraft version) are planned for a later release.
๐ Links
- ๐ป Source code: GitHub
- ๐ Issues and suggestions: GitHub issues
- ๐ฌ Discord
- โ Support the mod: Ko-fi or PayPal
Licensed under the LGPL 3.0.