Better Beacon Range

Features

- Dynamic beacon range depending on pyramid blocks - More expensive blocks = higher range - Mix and match block types to get the most out of your beacon - Beacon effects can also be applied to mobs! (configurable) - Applies to tamed pets by default (horses, dogs, etc.) - Tinted glass above an active beacon will hide the beam - Completely configurable!

Notes

- extra range may get cut off. Configuring the plugin for higher ranges, or running it on a server with a smaller view distance, means that extra range may get cut off.

Commands and Permissions

| Command | Description | Permission | Default | |-----------|-------------------------------------|---------------------|----------| | /bbrReload| Reloads the config file | `BetterBeaconRange.reload` | OP | | /bbrGetRange| Gets the range of the beacon you're looking at | `BetterBeaconRange.getRange` | everyone |

Example beacons:

<table> <thead> <tr> <th colspan="9">Full Iron Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/40KXK4Rm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.2</td> <td>x</td> <td>3.0</td> <td>=</td> <td>5.4</td> <td rowspan="4"><pre>33.3</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.2</td> <td>x</td> <td>2.0</td> <td>=</td> <td>10</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.2</td> <td>x</td> <td>1.0</td> <td>=</td> <td>9.8</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.2</td> <td>x</td> <td>0.5</td> <td>=</td> <td>8.1</td> </tr> </tbody> </table> <table> <thead> <tr> <th colspan="9">Full Gold Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/qMYoiTXm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.3</td> <td>x</td> <td>3.0</td> <td>=</td> <td>8.1</td> <td rowspan="4"><pre>49.95</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.3</td> <td>x</td> <td>2.0</td> <td>=</td> <td>15</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.3</td> <td>x</td> <td>1.0</td> <td>=</td> <td>14.7</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.3</td> <td>x</td> <td>0.5</td> <td>=</td> <td>12.15</td> </tr> </tbody> </table> <table> <thead> <tr> <th colspan="9">Full Emerald Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/cJkvLpZm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.4</td> <td>x</td> <td>3.0</td> <td>=</td> <td>10.8</td> <td rowspan="4"><pre>66.6</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.4</td> <td>x</td> <td>2.0</td> <td>=</td> <td>20</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.4</td> <td>x</td> <td>1.0</td> <td>=</td> <td>19.6</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.4</td> <td>x</td> <td>0.5</td> <td>=</td> <td>16.2</td> </tr> </tbody> </table> <table> <thead> <tr> <th colspan="9">Full Diamond Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/0TZuEFfm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.6</td> <td>x</td> <td>3.0</td> <td>=</td> <td>16.2</td> <td rowspan="4"><pre>99.9</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.6</td> <td>x</td> <td>2.0</td> <td>=</td> <td>30</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.6</td> <td>x</td> <td>1.0</td> <td>=</td> <td>29.4</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.6</td> <td>x</td> <td>0.5</td> <td>=</td> <td>24.3</td> </tr> </tbody> </table> <table> <thead> <tr> <th colspan="9">Full Netherite Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/OjwkOydm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.9</td> <td>x</td> <td>3.0</td> <td>=</td> <td>24.3</td> <td rowspan="4"><pre>149.85</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.9</td> <td>x</td> <td>2.0</td> <td>=</td> <td>45</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.9</td> <td>x</td> <td>0.9</td> <td>=</td> <td>44.1</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.9</td> <td>x</td> <td>0.5</td> <td>=</td> <td>36.45</td> </tr> </tbody> </table> <table> <thead> <tr> <th colspan="9">Mixed Beacon Range (Using default config values)</th> </tr> </thead> <tbody> <tr> <td rowspan="5"><img src="https://i.imgur.com/cC7ZonKm.png" width="320" height="250"></td> <td>Blocks per Level</td> <td>x</td> <td>Type Range</td> <td>x</td> <td>Level Multiplier</td> <td>=</td> <td>Level Range</td> <td>Total Range</td> </tr> <tr> <td>3x3 = 9</td> <td>x</td> <td>0.6</td> <td>x</td> <td>3.0</td> <td>=</td> <td>16.2</td> <td rowspan="4"><pre>79.3</pre></td> </tr> <tr> <td>5x5 = 25</td> <td>x</td> <td>0.4</td> <td>x</td> <td>2.0</td> <td>=</td> <td>20</td> </tr> <tr> <td>7x7 = 49</td> <td>x</td> <td>0.3</td> <td>x</td> <td>0.9</td> <td>=</td> <td>14.7</td> </tr> <tr> <td>9x9 = 81</td> <td>x</td> <td>0.2</td> <td>x</td> <td>0.5</td> <td>=</td> <td>8.1</td> </tr> </tbody> </table> <p><a style="font-size: 100%;" href="https://discord.frogperson.dev" rel="nofollow"><img src="https://discordapp.com/api/guilds/891552178278387732/widget.png?style=banner2" alt="" width="320" height="76" /></a></p>

Config

```yml

----------------------------------------------- Entity Types ----------------------------------------------- #

Note: these categories are not mutually exclusive, and may contain overlapping mobs.

For example, enabling Animals will also include all Tamables, whether you have Tamables enabled or not!

Apply beacon effects to tamables https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Tameable.html

ApplyEffectsToTamables: false

Apply beacon effects to tamables, but ONLY IF TAMED

ApplyEffectsToPets: true

Apply beacon effects to Villagers https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/AbstractVillager.html

AppyEffectsToVillagers: false

Apply beacon effects to WaterMobs https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/WaterMob.html

AppyEffectsToWaterMobs: false

Apply beacon effects to Animals https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Animals.html

ApplyEffectsToAnimals: false

Apply beacon effects to Enemies https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Enemy.html

ApplyEffectsToEnemies: false

Apply beacon effects to Raiders https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Raider.html

ApplyEffectsToRaiders: false

Need finer control? Enable specific entities here https://jd.papermc.io/paper/1.20/org/bukkit/entity/EntityType.html

ApplyEffectsToSpecificEntities:

- ALLAY

- SHEEP

---------------------------------------------- Range Features ---------------------------------------------- #

Blocks in the way of the bean that will not disable the beacon

NOTE: THESE BLOCKS WILL STILL VISUALLY HIDE THE BEAM!

AllowedBeamBlocks: - TINTED_GLASS

Enables the block type range and level multiplier features (set to false for vanilla range mechanics)

EnableBetterRangeFeatures: true

Range multiplier per level

LevelOneMultiplier: 3.0 LevelTwoMultiplier: 2.0 LevelThreeMultiplier: 1.0 LevelFourMultiplier: 0.5

Beacon base blocks and range added per type

Blocks must be formatted in Spigot Material format: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

THIS DOES NOT ADD VALID BEACON_BASE_BLOCKS! This is to configure the range for beacon_base_blocks added via another method such as a datapack.

Here's a datapack for copper: https://mc.voodoobeard.com/#copper_beacons

BeaconBlocks: #- <MATERIAL>: <Range> - COPPER_BLOCK: 0.1 # Requires extra datapack, see note above - EXPOSED_COPPER: 0.1 # Requires extra datapack, see note above - WEATHERED_COPPER: 0.1 # Requires extra datapack, see note above - OXIDIZED_COPPER: 0.1 # Requires extra datapack, see note above - CUT_COPPER: 0.1 # Requires extra datapack, see note above - EXPOSED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - WEATHERED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - OXIDIZED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_COPPER_BLOCK: 0.1 # Requires extra datapack, see note above - WAXED_EXPOSED_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_WEATHERED_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_OXIDIZED_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_EXPOSED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_WEATHERED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - WAXED_OXIDIZED_CUT_COPPER: 0.1 # Requires extra datapack, see note above - IRON_BLOCK: 0.2 - GOLD_BLOCK: 0.3 - EMERALD_BLOCK: 0.4 - DIAMOND_BLOCK: 0.6 - NETHERITE_BLOCK: 0.9 ```