We did a complete code review and changed the way how you can extend HeliumBalloon with other elements, behaviors and balloon types. See the Wiki at Github for a detailed documentation.

Furthermore we changed the codebase to maven and Java 17 and use minecraft 1.19 as base.
Please use HeliumBalloon 1.9 for an older version of minecraft.

Watchout for our "Custom Heads for HeliumBalloon" comming soon.

What's new

• Improved Pet movement
• Fixed a bug that sometimes Walls and Rotators are not loaded at startup
• Complete API Redesign (see Wiki on Github)
• New command action: dumpconfig
• New Rule-Attributes: startMoveAtDeviation and oscillatorHint
• New config-Param: startup/placingDelay
• Added a lot of API examples on Github

Java
This is the last version compiled with Java 1.8
The next version will use Java1.16
You still can use Spigot 1.16.5, but you must start your Spigot-Server with Java 1.16

Attention

• The stye of the config has changed. Please delete the old config-file and message-file so that the new configuration can take effect on next restart. Existing configs from version 1.7 and before will not work any longer.
• Permission has changed. Because of the separation from templates and pets, the permission balloon.template.* does not work any more. You must use balloon.pet.* instead

What's new

• Big configfile redesign, separating templates and pets. Please read our wiki for more information.
• Multiple sets of allowed worlds for different templates where they can be summoned ("worldset"), see wiki.
• A pet can contain different templates for different worlds (separate them by space).
• Improved GUI protection to prevent inadvertently deposing other items in the GUI inventory
• Permissions are now granted on pets instead of templates (wiki)
• New permission to let the player opens the GUI by entering "/balloon" without any parameters
• Multiple ConfigSections, so other plugins can inject templates, pets etc. on the fly (wiki)
• New Startup-Parameter "loadLocalConfig" to select if you want to load the configuration from HeliumBalloon's local config.yml
• New feature "warnOnWrongPurpose" to detect on load if you use a template which is not fully compatible with the desired use (pet, wall etc.)

Notes
We are still adding new features, and therefore sometimes we need to change existing parameters in the API or config.
They will be finalized with the release of version 2.

Whats's new

• Added rotation as a new balloon purpose (next to pet and wall). Balloons can now spin (See our Wiki for more information).
• Fixed a bug that causes a java exception during player login on some servers
• A pet should only be an optical feature, so we have disabled all interactions with it (e.g. breeding)
• Fixed a bug that a minecart pet was to slow to follow the player

Attention
Please delete the old config so that the new configuration can take effect.

What's new

• Revised movement synchronization between different parts of a balloon pet
• Added new role parameters to adjust delay for Blocks, Entities and Minecart (see Wiki chapter "roles")
• Removed a bug when different balloon walls are placed in different worlds
• Fixed some more messed-up display messages
• The template with the lowest string now sets the base for compound synchronizing (before it was not defined)
• And some more bugfixes

Attention
Please delete the old config (in particular the messages.yml) so that the new configuration can take effect.

What's new

• Use Minecarts (with loading)
• Professions for villagers
• Renamed "animal" to "living" to give villagers more respect
• Villagers cannot be bound by a leash
• You can now use any material as a GUI item, not only blocks
• Solved bug when a GUI item has no title or description
• Solved display error in GUI for demo-pets with non-german language

The synchronizing (e.g. oscillator swing) between Minecarts and other parts of the balloon pet will follow in the next release.

Attention
Please delete the old config so that the new configuration demos can take effect.

Notes
We are still adding new features, and therefore sometimes we need to change existing parameters in the API or config.
They will be finalized with the release of version 2.

Bugfix

• Boolean Parameter "false" in configuration is now working as expected (e.g. in rules or templates)

What's new

• Added more customization for blocks (e.g. stairs, door hinge)
• Swinging pets: blocks and animals are now synchronized
• Walls can now swing
• BlockDelay is now customizable (for synchronizing Falling Blocks with Living Entities)

Config Changes
Due to adding new config options to Falling Block Elements, we had to rename some config params:

• half => bisectedHalf
• slab => slabType
• face => blockFace

Attention
Please delete the old config so that the new configuration options can take effect.

Notes
We are still adding new features, and therefore sometimes we need to change existing parameters in the API or config.
They will be finalized with the release of version 2.

What's new

• A balloon can now oscillate up and down (swinging in the wind)
• Improved performance

Oscillator (swing)
A balloon can swing up and down following a sinus curve. Therefore we have add two new rule parameters:
oscillatorPeriod: 100
oscillatorAmplitude: 0.1
To enable the oscillator (swing) you must set the following flag in the template:
oscillating: true
You can find more information about this in the Wiki, or see our example demo2.
Swinging is currently only avail for pets. We will add support for walls and optimize the swinging for animals in the next release.


Performance
As soon as the balloon stands still, the balloon goes to sleep, which means there is no movement calculation or validity check.
So a sleeping balloon consumes almost no CPU load (except micecraft's own entity handling).
The balloon wakes up if it detects a player action e.g. player move. A balloon with an oscillator (swing) associated cannot goto sleep.


Other improvements
We have found a strange behaviour in minecraft: If a Falling Block is positioned at y=64 and has another Falling Block on top of it,
the Falling Block gets invalid after est. 3 Ticks. To prevent this, we have added a warning in the config loader
which prohibits positioning walls at this height. You can turn off the warning by setting the following rule parameter:
enableWarnY64Walls: false


Attention
Please delete the old config so that the new configuration demos can take effect.

Attention
Please delete the old config so that the new configuration demos can take effect. The old config generate a syntax error because the name of a config element had to be changed.

Whats new

Pets (animals)

• Added customization for more animals (other than cats). See Wiki.
• Pitch for Illager (Illagers move their head up and down following the player)
• Added new animal config option "tamed" (needed for some visual effects)
• MaxDistance is now customizable (the max. distance a balloon can be away from the player before the balloon wasrecreated)

API / Commands

• Reload also updates active pets (manual "assign" is no longer needed)

Behind the screens

• New ConfigCompound to make ConfigTemplate less complex
• Reorganized animal spawn and FallingBlock spawn for better customization

Changes

• In Config renamed color => collarColor (for animals of type CAT)

Bugfix

• The player is now protected from getting damage from his animal balloon (yeah Killerkarnickel)
• The cat collar is now visible

Notes
We are still adding new features, and therefore sometimes we need to change existing parameters in the API or config. They will be finalized with the release of version 2.

Whats new

Bugfix

• If the pet contains a monster, and the player stands too close to the pet, a java exception was raised

GUI

• Added a "deassign" item into the GUI to remove you current pet

Config

• Added new Subsection "deassign" into "gui"-section
• Parameters (Key Names) are now case-insensitive in "Rules" and "Templates" (except subsection names).
• Stated clear that GDPR parameters are only read at startup

API

• SpawnModifier now can modify BlockData
• Consolidating HeliumModifier and SpawnModifier Interfaces
• Renamed "CreateItemStack" to "CreateTemplateItemStack"
• New function "createDeassignItemStack"

Behind the screens

• Better Syntax Check in config
• Reorganized Code

Please delete the old config so that the new configuration options can take effect.