BetterBeaconRange

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

• This plugin requires Paper, and will not function properly on Spigot
• Beacons will only give effects to players if the beacon is in a loaded chunk. 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

Example beacons:

Full Iron Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.2	x	3.0	=	5.4	33.3
	5x5 = 25	x	0.2	x	2.0	=	10
	7x7 = 49	x	0.2	x	1.0	=	9.8
	9x9 = 81	x	0.2	x	0.5	=	8.1

Full Gold Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.3	x	3.0	=	8.1	49.95
	5x5 = 25	x	0.3	x	2.0	=	15
	7x7 = 49	x	0.3	x	1.0	=	14.7
	9x9 = 81	x	0.3	x	0.5	=	12.15

Full Emerald Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.4	x	3.0	=	10.8	66.6
	5x5 = 25	x	0.4	x	2.0	=	20
	7x7 = 49	x	0.4	x	1.0	=	19.6
	9x9 = 81	x	0.4	x	0.5	=	16.2

Full Diamond Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.6	x	3.0	=	16.2	99.9
	5x5 = 25	x	0.6	x	2.0	=	30
	7x7 = 49	x	0.6	x	1.0	=	29.4
	9x9 = 81	x	0.6	x	0.5	=	24.3

Full Netherite Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.9	x	3.0	=	24.3	149.85
	5x5 = 25	x	0.9	x	2.0	=	45
	7x7 = 49	x	0.9	x	0.9	=	44.1
	9x9 = 81	x	0.9	x	0.5	=	36.45

Mixed Beacon Range (Using default config values)
	Blocks per Level	x	Type Range	x	Level Multiplier	=	Level Range	Total Range
	3x3 = 9	x	0.6	x	3.0	=	16.2	79.3
	5x5 = 25	x	0.4	x	2.0	=	20
	7x7 = 49	x	0.3	x	0.9	=	14.7
	9x9 = 81	x	0.2	x	0.5	=	8.1

Config

# ----------------------------------------------- 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