Broadcast System

The strengthen broadcast system notifies nearby or all online players the first time you strengthen an item to a configured star

Configuration

Broadcast rules are configured in config.yml:

# Local broadcast radius
local_broadcast_radius: 48

broadcast:
  # Send a nearby broadcast when reaching these stars
  local_stars:
    - 8
  # Send a server-wide broadcast when reaching these stars
  global_stars:
    - 10
    - 12

Fields

Field	Type	Required	Default	Range	Description
local_broadcast_radius	integer	No	48	≥ 1 (below 1 becomes 1)	Local broadcast radius in blocks. It sits at the config root, not inside the broadcast node
broadcast.local_stars	list<integer>	No	[8]	positive integers (≤0 entries are dropped)	Stars that trigger a local broadcast
broadcast.global_stars	list<integer>	No	[10, 12]	positive integers (≤0 entries are dropped)	Stars that trigger a server-wide broadcast

Example: add +9 to nearby broadcasts and widen the radius to 64 blocks:

local_broadcast_radius: 64

broadcast:
  local_stars:
    - 8
    - 9

Trigger rules

• It fires only the first time an item reaches that star. The item state records the set of stars already reached, so repeats never broadcast again
• A local broadcast goes to every player in the same world within local_broadcast_radius of the player
• A global broadcast goes to every online player on the server
• Local and global are two independent lists, each matched separately; a star listed in both sends two separate broadcasts

Broadcast messages

Broadcast messages are configured in the language files (lang/*.yml):

Message key	Purpose
strengthen.broadcast.local_reach	Local broadcast text
strengthen.broadcast.global_reach	Global broadcast text

Supported variables:

Variable	Description
%player%	Player name
%star%	Star reached
%show_item%	Hoverable display text of the result item

Bundled English text:

strengthen:
  broadcast:
    local_reach: "<aqua>%player%</aqua> <yellow>strengthened %show_item% to <gold>+%star%</gold>.</yellow>"
    global_reach: "<aqua>%player%</aqua> <yellow>successfully strengthened %show_item% to <gold>+%star%</gold>.</yellow>"

Design notes

• Use local broadcasts for mid-tier achievements (such as +8) to build local atmosphere
• Use global broadcasts for high achievements (such as +10 and +12) to create scarcity
• Keep broadcast frequency low to avoid chat spam
• For a stronger sense of occasion, add titles, sounds, or particles in that star's actions.success