Blessed Codex Mod Introduction

Blessed Codex is a pet/minion enhancement mod centered on "blessings". Players can right-click non-player entities with the Blessed Codex to grant them one of 9 different blessings. All values are driven by a server-side JSON configuration with hot reload support.

Core Features

• Independent of vanilla equipment and Curios: All blessing data is stored in a custom entity Capability, without interference.

• 9 Major Blessings:

  • Hero of Purgation (weapon attack bonus)

  • Melodious Destruction (positive/negative life manipulation)

  • Cosmic Observer (global amplification)

  • Septic Shrink / The Wyrmwitch / Frigid Necromancer (elemental attachment and enhancement)

  • Shaman King (multi-element automatic counterattack)

  • Gilded Autocrat (void damage)

  • Omniscient Kaiser (non-physical damage reduction/immunity)

• Unique ownership: Each blessed entity is bound to only one player UUID, preventing theft by others.

• Echo Card: When a blessed entity dies, its data is passed to the owner as a "card" or dropped as a glowing entity, which can be inherited by a new entity.

• Flexible configuration: All blessing material mappings and values are defined in config/blessed_codex/pact_materials.json, freely adjustable for balance.

Design Philosophy

With the Blessed Codex as the core interaction, materials in the player's hands are converted into permanent entity buffs, avoiding conflicts with vanilla equipment slots. Through an independent Capability and cached calculations, it achieves an efficient and easily expandable mod ecosystem.

Blessed Codex 模组简介

Blessed Codex 是一个以“祝福”为核心的宠物/随从强化模组。玩家可通过 祝福圣典 右键非玩家实体，为其赋予 9 种不同的祝福效果，所有数值均由服务端 JSON 配置驱动，支持热重载。

核心特性

• 独立于原版装备与 Curios：所有祝福数据存储于实体自定义 Capability，互不干扰。

• 9 大祝福：

  • 肃清英雄（武器攻击加成）

  • 天籁毁灭（正负生命操控）

  • 万物见证者（全局增幅）

  • 凋零·脓缩 / 龙息·龙巫 / 冻结·冰霜亡灵（元素附加与增强）

  • 星之王（多元素自动反击）

  • 混沌支配者（虚空伤害）

  • 霸瞳皇帝（非物理伤害减免/免疫）

• 唯一归属：每个受祝福实体只绑定一个玩家 UUID，他人无法抢夺。

• 遗响卡片：受祝福实体死亡后，数据以“卡片”形式传递给主人或掉落为发光实体，可传承给新实体。

• 配置灵活：所有祝福的材料映射与数值均在 config/blessed_codex/pact_materials.json 中定义，可自由调整平衡。

设计理念

以“祝福圣典”为核心交互，将玩家手中的材料转化为实体永久增益，同时避免与原版装备栏冲突。通过独立的 Capability 和缓存计算，实现高效且易于扩展的模组生态。