Interactive Enchanted Books

Using an Enchanted Book shows information about the enchantments. This includes a detailed description, the list of mutually exclusive enchantments, the comparator signal and the list of supported items.

Besides the enchantment details, the book screen also includes information panels showing the requirements for spawning particles and for cloning Enchanted Books. These panels are only shown if the mod is also installed on the server

Intentions/Reasoning

• Seeing the enchantment details without having to leave the game.
• In comparison to other similar mods the book menu is more diegetic than simply showing the enchantment details in the tooltip of the item.

Enchanted Books can be placed in lecterns. Opening the lectern will show the same interface as opening the book regularly.

Intentions/Reasoning

• Parity with written books
• Allows for the other features related to Enchanted Books in lecterns

---

The enchantments are separated into groups, each emitting a different comparator signal strength. This signal strength is also shown in the book screen.

List of all comparator signal strengths

Power	Description	Enchantments
1	Cover page
2	Universal	Mending Unbreaking
3	Curses	Curse of Binding Curse of Vanishing
4	Universal armor	Protection Blast Protection Fire Protection Projectile Protection
5	Helmets	Aqua Affinity Respiration
6	Chestplates	Thorns Not chestplate exclusive Ensures category has one entry
7	Leggings	Swift Sneak
8	Boots	Depth Strider Feather Falling Frost Walker Soul Speed
9	Mining tools	Efficiency Fortune Silk Touch
10	Melee weapons damaging	Sharpness Smite Bane of Arthropods Impaling Density Breach
11	Melee weapons utility	Fire Aspect Sweeping Edge Knockback Looting Wind Burst Lunge
12	Ranged weapons damaging	Power
13	Ranged weapons utility	Punch Infinity Flame Multishot Quick Charge Piercing Channeling Loyalty Riptide
14	Other tools	Lure Luck of the Sea
15	None/unused

Intentions/Reasoning

• Enables basic sorting of Enchanted Books based on their enchantments
• Allows encoding of a redstone signal strength sequence based on the enchantments of the book

---

Lecterns emit particle effects based on the enchantments of the currently selected page. If the cover page is selected, the particles will cycle randomly through the contained enchantments.

The particle lifetime is based on the count of books contained in nearby chiseled bookshelves. If there is no bookshelf or it is empty, no particles will be emitted.

Mending	Feather Falling
Frost Walker	All 3 particles

List of all particle textures

Admittedly most of the particle textures can be seen as programmer art

Texture	Name	Texture	Name	Texture	Name
	Aqua affinity		Bane of arthropods		Blast protection
	Breach		Channeling		Curse of Binding
	Curse of Vanishing		Density		Depth strider
	Efficiency		Feather falling		Fire aspect
	Fire protection		Flame		Fortune
	Frost walker		Impaling		Infinity
	Knockback		Looting		Loyalty
	Luck of the sea		Lunge		Lure
	Mending		Multishot		Piercing
	Power		Projectile protection		Protection
	Punch		Quick charge		Respiration
	Riptide		Sharpness		Silk touch
	Smite		Soul speed		Sweeping edge
	Swift sneak		Thorns		Unbreaking
	Wind burst

Intentions/Reasoning

• Allows an easy way of spawning a variety of particle effects.
• The other redstone related features enabling a dynamic way of changing particle textures and lifetime.

---

Disable with: /gamerule interactive_enchanted_books:hopper_interacts_with_lectern false

Hoppers are able to place written or Enchanted Books in lecterns. Additionally they are able to remove the active book of a lectern.

Intentions/Reasoning

• Parity with other block entities and behaviour. Not being able to place books in lecterns using hoppers seems like an oversight in vanilla
• Allows for greater control over the enchantment particles of this mod

---

Disable with: /gamerule interactive_enchanted_books:signal_changes_lectern_page false

Sending a redstone signal to the lectern increments the shown page. If the last page is reached, the lectern will loop back to the first page. This disables the default behaviour of page changes emitting a redstone signal. Observers will still detect the page change

Intentions/Reasoning

• As lecterns with Enchanted Books emit particles based on the current page, changing the page with a redstone signal allows dynamic control over which particle is currently shown
• In combination with the chiseled bookshelves, this allows for flexible particle effects

---

Disable with: /gamerule interactive_enchanted_books:craftable_enchantment_echo false

The Enchantment Echo clones the enchantments of the original item without destroying it and can be interacted with just as a regular Enchanted Book (see previous features). Combining the Enchantment Echo with an Echo Shard converts it into an Enchanted Book.

Intentions/Reasoning

• The Enchantment Echos allow easier usage of the other mod features, such as comparator signal and particles, without having to combine multiple Enchanted Books
• The ability to create an Enchantment Echo from an already enchanted item enables easier insight into the enchantment details. When playing a modpack it's easy to find items with tons of enchantments without knowing most of them. Enchantment Echos provide an easy way to preview the details in game
• The conversion to a real Enchanted Book is intended to reduce the need for villagers while not being too overpowered, as Echo Shards are a finite end game resource.

---

See the example repository for more details on how to integrate custom enchantments.