CNPC+ Health Bars Addon — Changelog

Complete changelog for CNPC+ Health Bars Addon for Minecraft 1.7.10 + CustomNPC+.

Current Version: 0.3.2
Requires: CustomNPC+
Minecraft: 1.7.10

---

0.3.2 — Tooltips, Per-NPC Colors & Smooth Healing

Added

• Added short tooltips to the configuration GUIs.
• Tooltips use the native CustomNPC+ hover system for better visual consistency.
• Added a new HP Color option directly to the NPC Display screen.
• Added two per-NPC color modes:
  • Faction
  • Custom
• Added an Edit button when an NPC uses custom colors.
• Added a dedicated per-NPC color editor.
• Individual NPC colors use the same presets available for factions.
• Per-NPC palettes can customize:
  • Primary Health
  • Damage Trail
  • Healing
  • Background
  • Border
  • Shield
• Added persistent per-NPC palette settings.
• Added client/server synchronization for individual NPC colors.
• Added new BossBarAPI methods for per-NPC color customization.

Changed

• Completely reworked the healing animation.
• Recovered health now smoothly grows from the previous health value to the new value.
• Newly recovered health temporarily uses the configured Healing color.
• The Healing highlight gradually fades into the normal health color.
• Improved Damage Trail interpolation.
• Damage Trail now uses smoother easing.
• Consecutive hits during an active Damage Trail animation now continue from the current interpolated position.
• Improved the visual depth of:
  • Health
  • Damage Trail
  • Healing
  • Shield
• Added subtle highlights and shadows to reduce the flat-color appearance.
• Improved readability of color buttons.
• Health bar styles remain limited to:
  • Default
  • Modern

Per-NPC Color API

BossBars.setNpcColorMode(npc, "FACTION");
BossBars.setNpcColorMode(npc, "CUSTOM");

BossBars.setNpcColorPreset(npc, "CRIMSON");

BossBars.setNpcPrimaryColor(npc, 0xC9363E);
BossBars.setNpcDamageColor(npc, 0xF0A45D);
BossBars.setNpcHealColor(npc, 0x70E28A);
BossBars.setNpcBackgroundColor(npc, 0x171313);
BossBars.setNpcBorderColor(npc, 0x080808);
BossBars.setNpcShieldColor(npc, 0x60B9FF);

BossBars.clearNpcColors(npc);

HP Color: Custom overrides only the NPC's color palette.

The NPC can still inherit the following settings from its faction:

• Style
• Scale
• Maximum Distance
• Fade Length
• Position
• HP Text
• Damage Trail settings
• Animation settings

Compatibility

• All public API methods from 0.3.1 remain available.
• Existing faction settings remain supported.
• Custom Boss Bars remain supported.
• Recolored Minecraft-style Boss Bars remain supported.
• Existing scripts remain compatible.
• No Mixins.
• No Coremod.
• No ASM Class Transformer.

---

0.3.1 — Custom BossBar, GUI Fixes & Improved Interpolation

Added

• Added a fourth explicit state to the native CustomNPC+ BossBar option:
  • Hide
  • Show
  • Show while attacking
  • Custom
• Custom became a normal selectable BossBar option.
• Added configurable colors for the original Minecraft-style Boss Bar.
• Added the following vanilla Boss Bar color presets:
  • Purple
  • Crimson
  • Green
  • Blue
  • Gold
  • White
  • Custom RGB
• Added BossBarAPI support for recoloring the original Boss Bar.
• Added explicit CUSTOM Boss Bar mode support through scripting.

Changed

• Removed the previous right-click requirement for opening Custom Boss Bar settings.
• Selecting Custom now directly uses the addon Boss Bar system.
• Purple keeps the original Minecraft/CustomNPC+ Boss Bar renderer.
• Non-purple colors use the addon's recolored Minecraft-sized Boss Bar renderer.
• Reduced world-space health bar styles to:
  • Default
  • Modern
• Reduced Custom Boss Bar styles to:
  • Default
  • Modern
• Reworked HP text positioning.
• HP values are now centered inside the health bar.
• Large HP values can automatically scale down to fit inside the available space.
• Damage Trail interpolation was changed to use real render time.
• Health bar rendering now supports floating-point positioning for smoother animation.

Fixed

• Fixed configuration GUIs extending beyond the CustomNPC+ menu background.
• Fixed detached bottom panels appearing under some configuration screens.
• Fixed the Custom Boss Bar GUI layout.
• Fixed HP text appearing above or outside the health bar.
• Fixed Damage Trail movement appearing as integer-pixel jumps.
• Reduced animation behavior that appeared tied to Minecraft's 20 TPS update rate.

Vanilla Boss Bar Color API

BossBars.setVanillaBossColorPreset(npc, "PURPLE");
BossBars.setVanillaBossColorPreset(npc, "CRIMSON");
BossBars.setVanillaBossColorPreset(npc, "GREEN");
BossBars.setVanillaBossColorPreset(npc, "BLUE");
BossBars.setVanillaBossColorPreset(npc, "GOLD");
BossBars.setVanillaBossColorPreset(npc, "WHITE");

BossBars.setVanillaBossColor(npc, 0x33AAFF);

BossBars.resetVanillaBossColor(npc);

Custom Boss Bar Mode

BossBars.setBossMode(npc, "CUSTOM");

Compatibility

• Public API from 0.3.0 preserved.
• Faction presets preserved.
• Boss phases preserved.
• Shields preserved.
• On Target preserved.
• Fade settings preserved.
• Damage feedback preserved.
• Healing feedback preserved.
• NPC caching preserved.

---

0.3.0 — Major Visual & Interface Rework

This version introduced the current project name:

CNPC+ Health Bars Addon

The addon was previously known as DAD NPC Health Bars.

Added

• New official mod name:
  • CNPC+ Health Bars Addon
• Dedicated per-NPC Custom Boss Bar system.
• Dedicated Custom Boss Bar configuration GUI.
• Built-in color presets.
• Full RGB color customization.
• HP text rendered directly inside health bars.
• Expanded health bar visual system.
• Healing Highlight.
• Hit Flash.
• Large Damage Pulse.
• Integrated Shield display.
• Configurable:
  • Scale
  • Maximum Distance
  • Fade Length
  • Vertical Position
  • On Target Hold Time
• Custom Boss Bar configuration for:
  • Style
  • Width
  • Height
  • Screen Y
  • HP Text
  • Phase display
  • Shield display
  • Damage Trail
  • Damage Trail Delay
  • Damage Trail Speed
  • Colors
• Dedicated NPC Boss Bar configuration separate from faction settings.
• Expanded BossBarAPI.

Color Presets

Added multiple built-in health bar palettes:

• Classic Green
• Crimson
• Blood
• Azure
• Arcane Purple
• Poison
• Golden
• Ice
• Dark
• Undead
• Custom

Each palette can define:

• Primary
• Damage Trail
• Healing
• Background
• Border
• Shield

Changed

• Completely redesigned the faction health bar configuration GUI.
• Configuration options were reorganized into multiple pages.
• Preview rendering was moved inside a dedicated section of the GUI.
• Faction categories were changed to:
  • Normal
  • Elite
  • Mini-Boss
• Boss was removed as a faction-level Boss Bar configuration.
• Boss Bars became exclusive to individual NPCs.
• Boss Bar configuration no longer belongs to a faction.
• Damage Trail behavior was redesigned around delayed smooth movement.
• HP text moved inside the health bar.
• Shield display was visually integrated into the health bar system.
• Custom Boss Bar became a separate renderer from world-space health bars.

Boss Bars

Boss Bars became an NPC-only feature.

The addon expanded the existing CustomNPC+ BossBar system while keeping the native Display screen integration.

Custom Boss Bars support:

• Custom Width
• Custom Height
• Screen Position
• HP Text
• Boss Phases
• Shields
• Damage Trail
• Custom Colors
• Color Presets

Performance

• Nearby NPCs are cached.
• NPC lists refresh periodically instead of every rendered frame.
• Avoids scanning every loaded entity on every frame.
• Distance checks happen before more expensive rendering work.
• Resolved health bar configuration data is reused whenever possible.

Migration

• Legacy faction Boss category settings no longer create a top-screen Boss Bar.
• Old Boss-category faction bars are treated as Mini-Boss world-space bars.

Compatibility

• Existing BossBarAPI functionality preserved where possible.
• No Mixins.
• No Coremod.
• No ASM Class Transformer.
• Designed specifically for Forge 1.7.10 and CustomNPC+.

---

0.2.0 — Advanced Configuration, Categories & Script API

This version was still released under the old name:

DAD NPC Health Bars

Added

• Added NPC health bar categories:
  • Normal
  • Elite
  • Mini-Boss
  • Boss
• Added top-screen Boss Bar support for Boss-category NPCs.
• Added On Target visibility mode.
• Visibility modes included:
  • Show
  • Hide
  • On Hit
  • On Target
• Added advanced faction configuration.
• Added configurable Scale.
• Added configurable Maximum Distance.
• Added configurable Fade Length.
• Added configurable Vertical Offset.
• Added HP text modes:
  • Off
  • Percent
  • Current
  • Current / Max
• Added configurable colors for:
  • Primary
  • Damage Trail
  • Background
  • Border
  • Shield
• Added configurable Damage Trail delay.
• Added configurable Damage Trail speed.
• Added damage visual feedback.
• Added healing visual feedback.
• Added Boss Bar configuration for:
  • Width
  • Height
  • Y Position
  • Phase Text
  • Shield
• Added live health bar preview inside the faction configuration GUI.
• Added the first public version of BossBarAPI.
• Added Nashorn-friendly scripting support.

Script API

The API introduced scripting control over:

• Categories
• Boss Phases
• Phase Names
• Shields
• Colors
• Scale
• Visibility
• Visual Flash
• Script Override Reset

Example:

var BossBars = Java.type("com.dad.npchealthbars.api.BossBarAPI");

BossBars.setCategory(event.npc, "BOSS");

BossBars.setPhase(
    event.npc,
    2,
    3,
    "Corrupted Form",
    0x8A2BE2
);

BossBars.setShield(
    event.npc,
    500,
    500
);

Boss Phases

Bosses could dynamically change their presentation through scripts.

Example:

BossBars.setPhase(
    npc,
    2,
    3,
    "Corrupted Form",
    0x8A2BE2
);

Shields

Added visual shield state:

BossBars.setShield(npc, 500, 500);
BossBars.clearShield(npc);

The Shield system is visual only.

NPC scripts remain responsible for determining how damage absorption or shield mechanics work.

Performance

• Added cached NPC lists.
• Nearby NPC cache refreshes periodically.
• Reduced unnecessary configuration object creation during rendering.
• Added distance culling before expensive rendering operations.
• Default Maximum Distance:
  • 24 blocks
• Default Fade Length:
  • 6 blocks

Data & Migration

• Legacy 0.1 faction data remained readable.
• New advanced faction configuration was stored separately.
• Existing world settings could continue to be used after updating.

Compatibility

• CustomNPC+ required.
• No Mixins.
• No Coremod.
• No ASM Class Transformer.

---

0.1.0 — Initial Release

First public version of the addon.

Original project name:

DAD NPC Health Bars

Added

• World-space health bars above CustomNPC+ NPCs.
• Integration with the CustomNPC+ NPC Display screen.
• Per-NPC visibility overrides.
• Faction default health bar configuration.
• Initial visibility modes:
  • Faction / Inherit
  • Show
  • Hide
  • On Hit
• Initial health bar styles:
  • Default
  • Modern
• Initial vertical position options:
  • Low
  • Default
  • High
• Initial color themes:
  • Classic
  • Ember
  • Azure
  • Violet
  • Custom
• Custom faction colors.
• Health bar preview inside the faction configuration GUI.
• Current / Maximum HP display.
• Basic delayed damage indicator.
• Persistent faction health bar settings.
• Server-to-client configuration synchronization.
• Integration through standard Forge events.

Architecture

From the first version, the project worked as a standalone Forge addon for CustomNPC+.

It does not require modifying the CustomNPC+ .jar.

---

General Compatibility Notes

Requirements

• Minecraft 1.7.10
• Minecraft Forge
• CustomNPC+

CustomNPC+ is required.

---

Multiplayer

For multiplayer, install the same version of CNPC+ Health Bars Addon on:

• The server
• Every connecting client

Do not keep multiple versions of the addon installed at the same time.

---

Script API

The API can be imported into a CustomNPC+ Nashorn script with:

var BossBars = Java.type(
    "com.dad.npchealthbars.api.BossBarAPI"
);

The project aims to preserve compatibility with scripts created for previous versions whenever possible.

---

Version Name History

Version	Project Name
0.1.0	DAD NPC Health Bars
0.2.0	DAD NPC Health Bars
0.3.0	CNPC+ Health Bars Addon
0.3.1	CNPC+ Health Bars Addon
0.3.2	CNPC+ Health Bars Addon

---

Future Updates

Future versions will be added to this changelog when they are publicly released.

Planned, experimental, or unfinished features are intentionally not listed as available features until they are included in an official build.