# Arcane Lens

A spellcasting mod built around the Magic Lens: learn spells, explore an old library dungeon, take down a sleeping god for its power, and earn the favor (or attention) of something that's begun to watch you.

## Core spellcasting

- **[Magic Lens](@arcanelens:magic_lens)** — the central item; equip up to 5 spells at once, cast and cycle through them with keybinds.
- A mana system with capacity that grows as you merge lenses together, up to a 5x merge tier.
- [17 unique spells]($spells) spanning offense, utility, and support — from Fireball and Chain Lightning to Heal, Blink, and Invisibility.
- **[Ancient Spell Books](@arcanelens:ancient_spell_book)**, found in the dungeon, to learn new spells.
- The **[Diamond Engraver](@arcanelens:diamond_engraver)** and **[Inscription Workbench](@arcanelens:inscription_workbench)** for duplicating or customizing a lens's spell loadout.
- A **[Lens Combiner](@arcanelens:lens_combiner)** to merge two lenses into one, raising max mana and slot count.

## Mana infrastructure

- **[Soul Pedestal](@arcanelens:soul_pedestal)** — burns soul sand and items to generate mana.
- **[Lens Pedestal](@arcanelens:lens_pedestal)** — charges a placed lens automatically, linked to nearby Soul Pedestals.
- **[Soul Feeder](@arcanelens:soul_feeder)** — auto-feeds items into a linked Soul Pedestal so you don't have to restock by hand.

## Exploration

Read the full writeup in [Dungeon and Bosses]($dungeon_and_bosses):

- A library with an entrance to a multi-room dungeon full of tunnels, treasure rooms, and dangers.
- A standalone Faith Shrine structure.
- A sunken boss chamber holding **The One Who Sleeps**.

> [!TIP]
> Pick up a copy of the in-game **[Arcane Guide](@arcanelens:arcane_guide)** (a Patchouli guide book) — it covers every system in the mod and is always obtainable via crafting, the creative inventory, or `/give`.

<details>
<summary>Spoilers — what comes after the boss</summary>

- **[Faith and the Hunger]($faith_and_hunger)** — burn items at Faith Altars for Faith, with diminishing returns to discourage bulk-farming a single item; a watching presence begins after The One Who Sleeps falls, scaling with Faith and repeat kills.
- **[The Skill Tree]($skill_tree)** — unlocked through the Hunger's Pact, spending Arcane Ink on nodes like Mana Boost, Cost/Cooldown Reduction, the Pocket Dimension spell, Networked Storage, and the Arcane Assembler.
- **[Networked Storage](@arcanelens:storage_network)** — Living Chests, Storage Connectors, and Living Terminals for a shared, searchable item network.
- **[The Overload Ritual](@arcanelens:overload_core)** — push a storage network to capacity to tear open a portal to the Warped Hollow, a whole second dimension with its own boss, **Broken Vessel** — see [Dungeon and Bosses]($dungeon_and_bosses).
- **[The Pantheon]($pantheon)** — pledge your faith to one of five gods (Hunger, Florian, Aurelia, Quetzera, or Janus), each granting its own permanent perk track.

</details>

## Lore

Read the full story in [Lore]($lore) — the Sleeping God, the Warping, the Hunger, and the Pantheon, told in the order you're meant to uncover it.

## Add-ons

- **Endless Dungeon** — a separate add-on that requires Arcane Lens: a truly endless, real-time procedurally-generated dungeon dimension.