CNPC+ Health Bars Addon 0.4.8

This release is a major update over the older 0.3.x API/build line, with a much broader health-bar system, redesigned Custom Boss Bars, new frames, better client configuration and substantial renderer/performance work.

Highlights since 0.3.2

General Health Bar API

• Added the new recommended HealthBars scripting entry point.
• Kept the legacy BossBarAPI for backwards compatibility.
• Expanded the API beyond boss-only controls to cover world-space NPC bars, styles, frames, HP text, visibility, animation overrides, colors, shields, phases and Custom Boss Bars.
• World appearance overrides are property-based, allowing untouched settings to continue inheriting from faction configuration.

World / NPC Health Bars

• Added independent frame selection.
• Current world-frame options:
  • None
  • Vanilla+
  • Astral
• Added configurable HP text modes inside the bar.
• Added per-NPC style, frame, render-distance, fade and vertical-offset controls.
• Added smooth Damage Trail, Healing Animation, Hit Flash and Large-Hit Pulse controls.
• Added configurable On Target hold time.
• Added full per-NPC color palettes while preserving faction inheritance for unrelated properties.

Custom Boss Bars

• Added Faction Boss Bar mode.
• Added independent Custom Boss Bar visibility:
  • Faction
  • Always
  • On Hit
  • On Target
  • While Attacking
• Added configurable On Target hold time.
• Added Boss HP number formatting:
  • Full
  • Compact K/M
• Added Boss name position:
  • Above
  • Below
• Added Boss frame selection.
• Current Custom Boss Bar frames:
  • None
  • Vanilla
  • Vanilla+
  • Astral
• Added explicit Boss shield layouts:
  • Off
  • Below
  • Overlay
• Added smooth shield-loss trail.
• Added Boss Damage Trail, Healing Animation, Hit Flash and Large-Hit Pulse controls.
• Added high-HP segmentation and a recent-damage position marker for large health pools.

Frames / Visual Polish

• Reworked health-bar frames around a cleaner pixel-art language.
• Rebuilt frame channels so the HP fill sits inside the frame instead of being visually covered by it.
• Removed the old animated center ornaments from the final frame set for a cleaner presentation.
• Simplified the final frame family to the most readable designs.
• Added the restrained Vanilla Custom Boss Bar frame.
• Fixed Vanilla Boss Bar endcaps and removed isolated tinted edge pixels.
• Cleaned Vanilla+ and Astral top-center pixels.
• Improved adaptive frame sizing for small world bars.

Client Configuration

Added and expanded:

config/CNPC-Health-Bars-Addon-client.properties

The generated file now documents every option in English and preserves existing values when it is rewritten.

Configurable client-only options include:

• World/NPC HP text scale.
• World/NPC HP text X/Y offsets.
• World/NPC HP text RGB color.
• Custom Boss Bar HP text scale.
• Custom Boss Bar HP text X/Y offsets.
• Custom Boss Bar HP text RGB color.
• Boss NPC name scale.
• Boss NPC name X/Y offsets.
• Boss NPC name RGB color.
• Boss NPC name shadow.
• Shader Safe mode.
• Shader Safe emissive toggle.
• High-HP segmentation enable/disable.
• HP per segment.
• Maximum visible segments.
• Recent-damage marker enable/disable.

Performance / Renderer Lifecycle

• Removed the old repeated 5-tick full scan through WorldClient.loadedEntityList.
• Added an event-fed NPC cache.
• Added reconciliation when the client world changes.
• Added stale/dead/wrong-world NPC pruning.
• Added absolute renderer-state cleanup on world unload, dimension change and client disconnect.
• Added per-NPC cleanup when NPCs die or unload.

Shader Safe

• Added Shader Safe mode, enabled by default.
• Uses an opaque health-bar background in Shader Safe mode.
• Added stricter OpenGL state guards around health-bar render paths.
• Restores color/depth-mask/render state on guarded paths.
• Emissive rendering can be enabled separately.

GUI / UX

• Fixed addon previews rendering over the CustomNPC+ color picker.
• Added exact RGB swatches next to color controls.
• Improved HEX button readability.
• Reduced artificial color lightening so selected RGB values display closer to their real color.
• Added Edit buttons for Custom/Faction Boss Bar configuration and vanilla Boss Bar custom RGB.
• Reorganized the Custom Boss Bar editor for cleaner layout and previews.

Compatibility

• Minecraft 1.7.10.
• Requires Minecraft Forge and CustomNPC+.
• Legacy BossBarAPI scripts remain supported.
• Existing older frame names/slots are normalized or aliased where required for compatibility.
• Multiplayer clients and server should use the same addon version.

0.4.8

• Fixed the Vanilla Custom Boss Bar endcaps by removing the two isolated tinted accent pixels.
• Added client-configurable Boss NPC name layout:
  • bossNameScale
  • bossNameOffsetX
  • bossNameOffsetY
  • bossNameColor
  • bossNameShadow
• Boss name scaling preserves the centered anchor.
• Reworked client-properties generation so every option has an explanatory comment directly above it.
• Changed all generated config comments and section headers to English.
• Existing user property values are preserved when the config file is reformatted.

0.4.7

• Custom Boss Bar frame options became None, Vanilla, Vanilla+, and Astral.
• World/NPC frame options became None, Vanilla+, and Astral.
• Added independent HP-text layout controls for world NPC bars and Custom Boss Bars: scale, X/Y offsets and RGB color.
• HP text can now be scaled down to 0.25.
• Preserved Shader Safe, event-fed NPC cache, lifecycle cleanup, high-HP segmentation and recent-damage marker systems.

0.4.6

• Replaced repeated full NPC-list scanning with an event-fed cache.
• Added state cleanup on world unload, dimension change, disconnect and NPC removal.
• Added Shader Safe mode and stricter OpenGL state restoration.
• Added high-HP Custom Boss Bar segmentation.
• Added recent-damage position marker.
• Added initial client-only renderer configuration file.

0.4.5

• Added smooth delayed Shield Trail.
• Improved Boss Bar name/shield layout.
• Simplified and polished frame silhouettes.
• Added adaptive end-cap scaling for smaller world bars.

0.4.4

• Added BossBar: Faction.
• Added Custom Boss Bar visibility modes and On Target hold time.
• Added Full/Compact Boss HP number formatting.
• Added Boss name position Above/Below.
• Added Shield Off/Below/Overlay layouts.
• Improved GUI editing and RGB color workflow.
• Expanded both HealthBars and legacy BossBarAPI with the new Boss controls.

0.4.3

• Rebuilt world and Boss Bar frame structure.
• Improved frame silhouette, bevels and recessed HP channel readability.
• Improved Custom Boss Bar visual integration.

0.4.2

• Introduced the thinner unified pixel-art frame language.
• Added dedicated boss-frame accent/emissive assets and early center ornaments.
• Preserved API and legacy-script compatibility.