Armor Points ++ / Health Stacking

Usually when playing minecraft, your armor bar will only consist of up to 10 silver armor icons.
These 10 icons allow minecraft to display up to 20 armor points.
But somethimes, when playing with mods or LuckyBlocks, displaying up to 20 points is simply not enough.
That's when ArmorPoints++'s colored icons come into place!
They allow up to 240 armor points to be displayed within your armor bar.
There are a total of 12 different colors your armor bar can have (including the vanilla one).
Below will be an overview of all the colors; you'll see ingame screenshots over at the screenshots-tab.

This icon looks like the vanilla one, because it is exactly that. No additional meaning, no hidden things, just up to 20 plain armor points as you're used to see.

Now it's getting interesting… When you see this icon in your armor bar, your armor exceeded the mark of 20 points.

And just like red, this one is just displaying a higher armor value. In this case, it is 41 – 60 points.

This icon tells you that you're reached the area of 61 – 80 armor points.

You've nearly reached the 100 points mark when you see this icon in your armor bar.

And now… now what? Does there even exist armor that gives you more than 100 points? Sadly yes, otherwise this mod would be pretty useless, wouldn't it?

I don't even know why we're here… 121 – 140 points is an incredible amount, right?

I think, I just did this color, to fill up some empty space in my texture file… but it also displays 141 – 160 points!

Now we're nearing the end of my icon pallete. 161 – 180 points! We've nearly done it! Just some more!

Ok, why are you even doing this now? Is there any point of having 181 – 200 armor points?

I think you're overdoing it a little… you already turned invincible at 25 points, but now… now you got over 200 of them!

At this point even I stopped doing more icons, because… which sane humen would create armor that gives you 221 – 240 points???

Yeah, when turned on and if you have the minecraft:resistance effect, you'll see a faint red border around your armor bar.
Each 2 icons surrounded by this border indicate one level of the effect, because… you really turn invincible at resistance 5!

Example for resistance 3 at 7 armor points. Note: How many icons get shown for a resistance of 1 can be set in the config.

Your very precious armor toughness will get shown as an overlay on top of your armor bar. Awesome!
Whenever you see two of these little icons, you know that you got 1 or 2 (rounded up) points of armor toughness.

Yeah. That's about it… not that spectacular, really. Note: How many icons get shown for a toughness of 1 can be set in the config.

These overlays will show the combined value of all types of protection (Fire Protection, Protection, etc.) on your armor items.
Similar to armor toughness, one icon shows a value of 1 or 2 (rounded up) of combined protection.

Quite shiny, isn't it? Note: How many icons get shown for a protection of 1 can be set in the config.

When playing minecraft, you sometimes get extra hp through the minecraft:health_boost effects or some other mod.
Those hearts then get displayed as an additional bar, if that gets filled up, a third bar gets added and so on.
Health stacking completely removes those additional health bars and replaces them with one single, colored one.
Using this feature of ArmorPoints++ will ensure that your screen is never cluttered with too many hearts.

Those hearts really are something! When you get a lot of these red little beasts, they usually clutter your screen. With this mod, you only get to see red hearts when you have 1 – 20 hp.

Orange hearts, much like the orange armor icon, show you that you have more hearts than usual. 21 – 40 in this case.

Yellow it is! You have now 41 – 60 hp.

Lime reminds me of life. And you have a lot of it [ 61 – 80 hp ].

Green seems a little boring after all those flashy colors… and still, it exists! [ 81 – 100 hp ]

'Turquoise'… what an odd name for a color… but it tells you that you have now more than 100 hp!

Good ol' cyan… how nice to have 121 – 140 hp.

Blue, like water, right? But you won't drown today, 'cause you got yourself 141 – 160 hp!

Another shade of blue, ha? Mabe you'll drown now, now that you've gone so deep into the water that you can't even see the sun anymore. [ 161 – 180 hp ]

Aaaah… purple… what a nice feeling to see nearly 200 hp in one health bar!

And now, well… there aren't any more colors left… more than 200 – 220 hp will be shown by this little pink heart 🙂

Do not worry, my friend, Your absorption hearts aren't gone!
They just moved.
You can now find them as a border around your hearts.
Each pixel of your heart border displays 4 absorption hp [ = 2 absorption hearts ], making it 80 absorption points per heart border or 800 [ = 400 absorption hearts ] for your entire health bar.

Some examples for absorption borders on vanilla hearts [ I won't put all of them here, making all those individual images took long enough ] Note: How many pixels get shown for one absorption heart can be set in the config.

Yeah. Your armor, health and absorption values get shown as text beneath their respective bar in your hud.
If you want to see this ingame, I recommend checking out the screenshots-tab.
Shhh! Let me tell you a secret: You can turn this off in the config if you don't like it, and you can even configure every color of the text!

Are you ready to see the config?
Really?
It's kinda ugly, you know…
But here it is anyways:
[ You can toggle all the features of ArmorPoints++ individually here. ]

# Configuration file

general {

B:debug=false

# Determines whether or not the numeric armor value should be shown beside the armorbar [default: true]
B:showArmorValue=true

# Determines whether or not the numeric health value should be shown beside the healthbar [default: true]
B:showHealthValue=true

# Determines whether or not the current resistance value should be shown as a border around armor values [default: true]
B:showResistanceBorder=true

# Determines whether or not the armorbar should be drawn when armor equals to zero [default: false]
B:showZeroArmor=false

# Determine which type of suffix should be used for number grouping (possibilities: SCI, GER, ENG) [default: SCI]
S:siSuffixType=SCI

# Determines whether one color-coded health bar (true) or the vanilla health bars (false) should be used [default: true]
B:stackHealth=true

# Determines whether or not the vanilla armor bar should be rendered instead of the custom one [default: false]
B:vanillaArmor=false

}

textcolors {

# The textcolor used for absorption hearts [default: 0xffc300]
S:absorptionColor=0xffc300

# The textcolor used when the armor value is equal to 25 [default: 0xff8811]
S:armorEqual25Color=0xff8811

# The textcolor used when the armor value is greater than 25 [default: 0xff3311]
S:armorGreater25Color=0xff3311

# The textcolor used when the armor value is smaller than 25 [default: 0x44ff11]
S:armorSmaller25Color=0x44ff11

# The textcolor used when resistance is greater than 5 [default: 0x4c0000]
S:fullResistanceColor=0x4c0000

# The textcolor used when the player is neither poisoned nor withered [default: 0x000000]
S:heartColor=0xff1313

# The textcolor used when the player is poisoned [default: 0x947818]
S:heartPoisonColor=0x947818

# The textcolor used when the player is withered [default: 0x2b2b2b]
S:heartWitherColor=0x2b2b2b

# The textcolor used when no armor is equipped [default: 0x3d3d3d]
S:noArmorColor=0x3d3d3d

# The textcolor used for separation characters [default: 0x3d3d3d]
S:valueSeparatorColor=0x3d3d3d

}

This one is the most pretty code-wise…
I quite like the forge 1.12 config system, to be honest.
[ You can toggle all the features of ArmorPoints++ individually here. ]

# Configuration file

debug {

# You don't want this to be on. Believe me
# Available: true, false [default: false]
B:debug=false

}

general {

# Enable custom armor bar
# Available: true, false [default: true]
B:enableArmorBar=true

# Enable custom health bar
# Available: true, false [default: true]
B:enableHealthBar=true

# Show absorption as border around health
# Available: true, false [default: true]
B:showAbsorption=true

# Show armor value text next to bar
# Available: true, false [default: true]
B:showArmorValue=true

# Show armor bar when armor is zero
# Available: true, false [default: false]
B:showArmorWhenZero=false

# Show health value text next to bar
# Available: true, false [default: true]
B:showHealthValue=true

# Show protection as overlay over armor
# Available: true, false [default: true]
B:showProtection=true

# Show resistance as border around armor
# Available: true, false [default: true]
B:showResistance=true

# Show toughness as overlay over armor
# Available: true, false [default: true]
B:showToughness=true

# Suffix type used for displaying armor values
# Available: SI, SCI, GER, ENG [default: SI]
S:suffix=SI

}

representative {

# Number of pixels to show an absorption of 1
# Available: 0.0 ~ 200.0 [default: 0.25]
# Min: 0.0
# Max: 200.0
D:absorption=0.25

# Number of icons to show a protection of 1
# Available: 0.0 ~ 10.0 [default: 0.5]
# Min: 0.0
# Max: 10.0
D:protection=0.5

# Number of icons to show a resistance of 1
# Available: 0.0 ~ 10.0 [default: 2.0]
# Min: 0.0
# Max: 10.0
D:resistance=2.0

# Number of icons to show a armor toughness of 1
# Available: 0.0 ~ 10.0 [default: 0.5]
# Min: 0.0
# Max: 10.0
D:toughness=0.5

}

textcolors {

# Color of absorption
# Available: 0x000000 ~ 0xffffff [default: %s]
S:absorption=0xffc300

# Color when armor = 0
# Available: 0x000000 ~ 0xffffff [default: %s]
S:armor0=0x3d3d3d

# Color when armor = 25
# Available: 0x000000 ~ 0xffffff [default: %s]
S:armorEQ25=0xff8811

# Color when armor > 25
# Available: 0x000000 ~ 0xffffff [default: %s]
S:armorGT25=0xff3311

# Color when armor < 25
# Available: 0x000000 ~ 0xffffff [default: %s]
S:armorLT25=0x44ff11

# Color normal status
# Available: 0x000000 ~ 0xffffff [default: %s]
S:heart=0xff1313

# Color when poisoned
# Available: 0x000000 ~ 0xffffff [default: %s]
S:heartPoison=0x947818

# Color when withered
# Available: 0x000000 ~ 0xffffff [default: %s]
S:heartWither=0x2b2b2b

# Color when resistance > 5
# Available: 0x000000 ~ 0xffffff [default: %s]
S:resistanceFull=0x4c0000

# Color of separator
# Available: 0x000000 ~ 0xffffff [default: %s]
S:separator=0x3d3d3d

}

As I support multiple versions of Minecraft and each version has it's own config system (why, forge :c), there's multiple of them…

So… here it is… the fabled 1.16+ configuration file, which can be used to toggle every single feature of ArmorPoints++.

[general]

# Show protection as overlay over armor
# Available: true, false [default: true]
showProtection = true
# Show toughness as overlay over armor
# Available: true, false [default: true]
showToughness = true
# Show absorption as border around health
# Available: true, false [default: true]
showAbsorption = true
# Show health value text next to bar
# Available: true, false [default: true]
showHealthValue = true
# Show armor value text next to bar
# Available: true, false [default: true]
showArmorValue = true
# Show armor bar when armor is zero
# Available: true, false [default: false]
showArmorWhenZero = false
#Available: SI, SCI, GER, ENG [default: SI]
suffix = "SI"
# Show resistance as border around armor
# Available: true, false [default: true]
showResistance = true
# Enable custom health bar
# Available: true, false [default: true]
enableHealthBar = true
# Enable custom armor bar
# Available: true, false [default: true]
enableArmorBar = true

[general.debug]

# You don't want this to be on. Believe me
# Available: true, false [default: false]
debug = false

[representative]

# Number of pixels to show an absorption of 1
# Available: 0.0 ~ 200.0 [default: 0.25]
#Range: 0.0 ~ 200.0
absorption = 0.25
# Number of icons to show a protection of 1
# Available: 0.0 ~ 10.0 [default: 0.5]
#Range: 0.0 ~ 10.0
protection = 0.5
# Number of icons to show a armor toughness of 1
# Available: 0.0 ~ 10.0 [default: 0.5]
#Range: 0.0 ~ 10.0
toughness = 0.5
# Number of icons to show a resistance of 1
# Available: 0.0 ~ 10.0 [default: 2.0]
#Range: 0.0 ~ 10.0
resistance = 2.0

[textcolors]

# Color when armor = 25
# Available: 0x000000 ~ 0xffffff [default: 0xff8811]
armorEQ25 = "0xff8811"
# Color when armor > 25
# Available: 0x000000 ~ 0xffffff [default: 0xff3311]
armorGT25 = "0xff3311"
# Color when poisoned
# Available: 0x000000 ~ 0xffffff [default: 0x947818]
heartPoison = "0x947818"
# Color when armor < 25
# Available: 0x000000 ~ 0xffffff [default: 0x44ff11]
armorLT25 = "0x44ff11"
# Color when withered
# Available: 0x000000 ~ 0xffffff [default: 0x2b2b2b]
heartWither = "0x2b2b2b"
# Color of absorption
# Available: 0x000000 ~ 0xffffff [default: 0xffc300]
absorption = "0xffc300"
# Color when resistance > 5
# Available: 0x000000 ~ 0xffffff [default: 0x4c0000]
resistanceFull = "0x4c0000"
# Color of separator
# Available: 0x000000 ~ 0xffffff [default: 0x3d3d3d]
separator = "0x3d3d3d"
# Color when armor = 0
# Available: 0x000000 ~ 0xffffff [default: 0x3d3d3d]
armor0 = "0x3d3d3d"
# Color normal status
# Available: 0x000000 ~ 0xffffff [default: 0xff1313]
heart = "0xff1313"

Why did you create this mod?
    Well… I was playing a lot of LuckyBlocks and I just couldn't find any good mods (in 1.8) for doing what Armorpoints++ does,
    so I created one myself. – I hope, you like it!

Why aren't there any versions before 1.1.1?
    So… about that… There was a lot of internal testing going on and I didn't name those test versions beta or so,
    so the first release just happened to be v1.1.1.

Why isn't <version> supported?
    I just so happen to be human and don't want to bother with too many different versions,
    so I'll mostly just update the 1.8 version and the releases for the latest version of Minecraft.
    [ 1.8 because this mod was created primarily to help with LuckyBlocks ]

    Well… since I released this mod, the main version shifted from 1.8 to 1.16…
    And forge 1.8 currently won't compile, so is the 1.8 version dead? Hopefully not!

Can you implement <feature>? [ Is there anyting missing you want to see in this mod? ]
    Open a new Issue here using the "Feature request"-Template, if the feature fits this mod, I'll happily implement it for all supported versions.

Can you port this mod to <version>?
    Head over to https://github.com/Cheos137/ArmorpointsPlusplus/projects/3 – if the version you'd like to see this mod ported to
    is not there (and not in the unsupported column), ask me 🙂
    I will answer you for sure, whether or not I'll make a port to the requested version.

I found a bug, what should I do?
    Open a new Issue here using the "Bug report"-Template, I'll then see what I can do.

Resource pack support?
    [< v2.0.0] If you're making a resourcepack that supports this mod, you'll have to override the
    armorplusplus:textures/gui/armor.png and the
    armorplusplus:textures/gui/health.png texture.

    [v2.0.0+] As of v2.0.0, both atlases mentioned above are merged into one single file:
    armorpointspp:textures/gui/icons.png
    I know this is not perfectly ideal, but I don't intend to overlay a color above the vanilla icons because it would limit my possibilities.

May I use this mod in my modpack?
    Yes, of course, I'd appreciate it;
    But please don't write me a dm or something like that. I don't like full inboxes. 😛