BioGrav

# 🌕 Biome-specific gravity **BioGrav** is a lightweight data pack that adds several categories controlled by biome tags which change mobs' gravity (and related attributes). Players experience these attribute changes smoothly: as a player gets closer to the biome, their gravity will change based on their proximity to the biome. Standing just on the border of a biome will not grant the player the full gravity change; to experience the full effect, a player must be surrounded by the biome by at least 4 blocks on all sides. For performance reasons, mobs other than the player do not have smooth transitions and instead receive attribute updates which apply either the full gravity effect or no gravity effect depending on whether or not they are in the biome. These updates are applied to all mobs once per second, or to mobs closer to a player more quickly but inconsistently. This can be changed by adding mobs to the `#biograv:smooth_transition` entity type tag, although this may cause excessive TPS lag. ## 🔧 Customization In the base data pack, all biome tags are empty, so no biomes will change mobs' gravity. This can be changed by applying the **BioGrav Defaults** data pack included in the version page, or by adding biomes to the following biome tags: <details> <summary>Biome tags</summary> <h3 id="-biograv-kind_of_low_grav-"><code>#biograv:kind_of_low_grav</code></h3> <blockquote> <p>Gravity: -60%<br> Step Height: +100% (1 block)<br> Safe Fall Distance: +200% (9 blocks)<br> Fall Damage Multiplier: -50%</p> </blockquote> <h3 id="-biograv-low_grav-"><code>#biograv:low_grav</code></h3> <blockquote> <p>Gravity: -83.3% (roughly the same gravity as the moon)<br> Step Height: +150% (1.25 blocks)<br> Safe Fall Distance: +500% (18 blocks)<br> Fall Damage Multiplier: -70%</p> </blockquote> <h3 id="-biograv-ultra_low_grav-"><code>#biograv:ultra_low_grav</code></h3> <blockquote> <p>Gravity: -90%<br> Step Height: +200% (1.5 blocks)<br> Safe Fall Distance: +900% (30 blocks)<br> Fall Damage Multiplier: -80%</p> </blockquote> <h3 id="-biograv-high_grav-"><code>#biograv:high_grav</code></h3> <blockquote> <p>Gravity: +50%<br> Jump Strength: +17.5% (jump height remains about the same)<br> Safe Fall Distance: -16.7% (2.5 blocks)<br> Fall Damage Multiplier: +100%<br> Movement Speed: -10%<br> Movement Efficiency: +0.025 (to make walking in soul sand less annoying)</p> </blockquote> <h3 id="-biograv-ultra_high_grav-"><code>#biograv:ultra_high_grav</code></h3> <blockquote> <p>Gravity: +100%<br> Jump Strength: +40% (jump height remains about the same)<br> Safe Fall Distance: -33.3% (2.5 blocks)<br> Fall Damage Multiplier: +200%<br> Movement Speed: -25%<br> Movement Efficiency: +0.1 (to make walking in soul sand less annoying)</p> </blockquote> ❗ While it is possible, adding a single biome to more than one biome tag is untested and unsupported, and may yield unpredictable results. (Have fun!) </details> ### ✨ Effects Data packs or operators can use commands to specify particles and sounds for when players enter or exit a low- or high-gravity biome. These effects can be set by running functions: <details> <summary>Config functions</summary> <h3 id="-function-biograv-_config-effects-low_grav-enter-particle-id-pos-delta-speed-1-0-count-1-viewers-"><code>/function biograv:_config/effects/low_grav/enter/particle {id: &quot;&quot;, pos: &quot;&quot;, delta: &quot;&quot;, speed: 1.0, count: 1, viewers: &quot;&quot;}</code></h3> <blockquote> <p><code>id</code>: Type of particle (e.g. <code>&quot;minecraft:happy_villager&quot;</code>)<br> <code>pos</code>: Position of particle, supports relative or local coordinates (e.g. <code>&quot;~ ~0.05 ~&quot;</code>, <code>&quot;^ ^ ^1&quot;</code>)<br> -- Relative coordinates are from the player&#39;s feet, local coordinates are from their eyes<br> <code>delta</code>: Coordinate range particles spawn in<br> <code>speed</code>: Speed of particles<br> <code>count</code>: Number of partices<br> <code>viewers</code>: Target selector for who can see the particles (e.g. <code>&quot;@s&quot;</code> for only the player entering/exiting the biome)</p> </blockquote> <h3 id="-function-biograv-_config-effects-low_grav-enter-sound-id-pitch-1-0-volume-1-0-"><code>/function biograv:_config/effects/low_grav/enter/sound {id: &quot;&quot;, pitch: 1.0, volume: 1.0}</code></h3> <blockquote> <p><code>id</code>: Sound event to play (e.g. <code>&quot;minecraft:block.stone.place&quot;</code>)<br> <code>pitch</code>: Pitch of sound<br> -- Pitch is higher or lower depending on the gravity change (<code>kind_of</code>, <code>ultra</code>)<br> <code>volume</code>: Volume of sound</p> </blockquote> <h3 id="-function-biograv-_config-effects-low_grav-enter-particle-particle-config-sound-sound-config-"><code>/function biograv:_config/effects/low_grav/enter {particle: {particle config}, sound: {sound config}}</code></h3> <blockquote> <p>Equivalent to running <code>.../particle</code> and <code>.../sound</code> functions with their r