Broadcast System

The strengthen broadcast system notifies nearby or all online players the first time a player strengthens 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	Default	Description
local_broadcast_radius	integer	48	Local broadcast radius in blocks. It sits at the config root, not inside the broadcast node.
broadcast.local_stars	list<integer>	[8]	Stars that trigger a local broadcast.
broadcast.global_stars	list<integer>	[10, 12]	Stars that trigger a server-wide broadcast.

Trigger rules

• Only fires the first time an item reaches that star. The item state records the set of stars already reached, so repeats do not broadcast again.
• A local broadcast is sent to every player in the same world within local_broadcast_radius of the player.
• A global broadcast is sent 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

• Local broadcasts suit mid-tier achievements (such as +8) and build local atmosphere.
• Global broadcasts suit high achievements (such as +10 and +12) and 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.