Tablet Sage 2.1.1 - Manual Windows Installation
================================================

This package contains no installer program. It includes only TabletSage.dll
and these instructions.

Requirements
------------

- Windows 10 or Windows 11 (64-bit)
- Steam version of Sephiria
- BepInEx 5.4.23.5 (Windows x64)

Install BepInEx
---------------

If BepInEx 5.4.23.5 or newer is already installed for Sephiria, skip this
section.

1. Download BepInEx_win_x64_5.4.23.5.zip from the official BepInEx release:
   https://github.com/BepInEx/BepInEx/releases/tag/v5.4.23.5
2. In Steam, right-click Sephiria, then choose Manage > Browse local files.
3. Extract the contents of the BepInEx ZIP directly into that Sephiria folder.
   BepInEx files such as winhttp.dll must be beside Sephiria.exe.
4. Start Sephiria once, wait for the main menu, and close it. This creates the
   BepInEx folders.

Install Tablet Sage
-------------------

1. Close Sephiria.
2. Open Steam and find Sephiria in your Library.
3. Right-click Sephiria, then choose Manage > Browse local files. This opens
   the Sephiria folder containing Sephiria.exe.
4. Open the BepInEx folder, then open the plugins folder:

       Sephiria\BepInEx\plugins\

5. Copy TabletSage.dll from this package into the plugins folder.
6. Replace an existing TabletSage.dll if Windows asks.
7. Start Sephiria. Open the inventory and use the AUTO button.

Special Artifact Interactions
-----------------------------

AUTO models these special effects in addition to ordinary placement criteria:

- Giant Telescope: a planet in any of the eight adjacent slots counts as gaining
  2 effective artifact levels. The bonus applies once even if telescopes overlap.
- Harmony Crystal: each real artifact level in the eight adjacent slots is worth
  1% damage, plus another 1% when the crystal reaches level 1. AUTO may trade at
  most one total artifact level for a sufficiently stronger Harmony arrangement.
- Badge of Devotion: preserves the number of recognized allies on the badge's row,
  up to five. Allies are Golden Handbell, Mini Ballista, Heita's/Tero's/Amad's
  Soul Powder, and Mining Supervisor Armband.
- Kelsederny Key: preserves the original zero-based row number modulo 4.
- Scales of Conflict and Formula of Eternity: remain in their original horizontal
  half of the bag.
- North Golden Needle: keeps the artifact directly above it in that position.
- Raye's Stardust: keeps its adjacent spellbook immediately to its left.
- Shining Hourglass: keeps its adjacent spellbook immediately to its right.
- White Paper: keeps two artifacts with the required shared category immediately
  to its left and right; the formation may be reflected.
- Burden of Heart: does not gain artifact level from tablet empowerment and may
  absorb negative empowerment.
- Utility Belt: after total artifact level is maximized, prefers a fuller top row.

Artifact level here means tablet-contributed level capped by the artifact's level
limit; innate/enchantment levels are retained separately.
