Illumination

**Illumination** is the act or phenomenon of an Object becoming a Sentient Spirit.

## Random Illumination

Illumination can happen randomly on any Object without the rare `NotDoTongLing` tag. This includes Walls, which may break Rooms when Illuminated. When an Object turns into a Sentient Spirit, it receives a number of additional properties, and its Tier increases by 1.

It can be triggered by the following sources:

### Extreme Weather

When Weather of a certain type starts, there is a chance that a random Item, Building or Plant (1/3 chance each) found in the Player Sect is illuminated by the Weather. The chance of this occurring depends on the Weather type, and is either 30% or 100% for these Weather types (`fParam1` of all Events with type `EventWeather`).

### Cultivator Equipment

Any Gear, Artifacts, Talismans, and Tools equipped by a Cultivator can randomly become illuminated. These Objects are awakened with the "Awakening Energy" event, which has a fixed 0.01% chance of happening per equipped item per day.

### Cultivator in Cultivation

Nearby Objects, Clothing, and Gear of any Xiandao Cultivator in the process of Cultivation and has more than 300 base Attainment.

* Every in-game Day, the Cultivator's Illumination progress `LingPower` increases by a random number between 1 and base Attainment/50. If the Cultivator is a Hot NPC, the counter is multiplied by 5.
* When `LingPower` reaches the threshold, an Illumination attempt will occur after a delay of 0-600 seconds. The threshold is 1000 for the first Illumination and doubles every time an Illumination attempt occurs.
* A 50/50 roll is performed, which attempts to illuminate either one random Clothing or Gear currently equipped on the Cultivator, or one random Object on a randomly chosen Tile within a Square Range of 5 (11x11 tiles) around the Cultivator's current location.
	+ If the Cultivator has no Equipment, if there is no Object of any type (Item, Building or Plant) on the random Tile, or if the randomly chosen target cannot be Illuminated (for example due to it having the `NotDoTongLing` tag), Illumination fails, but LingPower remains unchanged.
	+ Successful Illumination sets the Cultivator's `LingPower` to zero.
	+ The Illumination counter increases by 1, doubling the `LingPower` required for the next Illumination.

### Wandering Sentient Spirit

Occasionally, already-illuminated objects (also known as Sentient Spirits) will wander onto the Player Sect map as part of an Event.

## Manual Illumination

It is possible to attempt to illuminate certain Objects using Miracles. If successful, the illuminated object's Tier increases by 1, and it gains Sentience.

* Darksoul Genesis (Xiandao Cultivation, for Items)
* Lifeforce Genesis (Xiandao Cultivation, for Buildings)
* Divine Mercy (Shendao Cultivation, for Plants)

**Note:** each of these costs a Primordial Soul Gem to cast, while not necessarily guaranteeing success.

## Reverse

The opposite of this is the Soul Chant Miracle, which can strip the sentience from an illuminated object, granting a Primordial Soul Gem in return. The object retains its increased Tier, however.

## Limitations

### Repeat

You **cannot** Illuminate something that has been previously Soul Chanted, presumably to stop "cheap" infinite Tier gain.

## References

1. ↑ `XiaWorld.TongLingMgr.SetItemTongLing`
2. ↑ `XiaWorld.TongLingMgr.SetItemLife`
3. ↑ `XiaWorld.WeatherMapData.BeginWeather`
4. ↑ `XiaWorld.EventDriver.EventWeather.Enter`
5. ↑ Settings\World\Events\EventList.txt
6. ↑ `XiaWorld.SpNpcMgr._EquipSpNpc`
7. ↑ 7.0 7.1 `XiaWorld.ThingMgr.EquptNpc`
8. ↑ `XiaWorld.NpcPractice.Step`