Announcer

Overview

Announcer automatically sends messages when you perform various actions like breaking blocks, placing blocks, eating food, walking distances, or when players join/leave the server. It’s useful for flexing your client usage or just having fun on servers.

Features

Announces blocks broken, placed, eaten, and distance traveled
Welcomes/farewells players joining and leaving
Time-of-day messages (morning, noon, night, etc.)
Multiple message templates with randomization
Three output modes: Self, Chat, and Whisper
Configurable delay between actions

Settings

Mode

enum

default:"Self"

Where to send announcement messages

Self: Only you see messages (client-side)
Chat: Sends messages to public chat
Whisper: Whispers to nearest player

Break

boolean

default:"true"

Announce blocks broken

Place

boolean

default:"true"

Announce blocks placed

Eat

boolean

default:"true"

Announce food eaten

Walk

boolean

default:"true"

Announce distance traveled

Joins

boolean

default:"true"

Announce player joins/leaves

World Time

boolean

default:"true"

Announce time of day changes

Delay

number

default:"5"

Delay multiplier for announcements (1-15)Higher values = less frequent messages

Message Types

Break Messages

Announces after breaking multiple blocks:

"I just mined {amount} {name} thanks to Sn0w!"
"Я только что добыл {amount} {name} блока благодаря Sn0w!"

Triggers:

After breaking random amount (1-10) blocks
With delay of 300 * delay ticks
Resets counter after announcement

Example:

I just mined 7 Stone thanks to Sn0w!

Place Messages

Announces after placing multiple blocks:

"I just built a castle made out of {amount} {name} thanks to Sn0w!"
"Я только что построил замок из {amount} {name} благодаря Sn0w!"

Triggers:

After placing random amount (1-10) blocks
With delay of 150 * delay ticks
Only counts when using BlockItem

Example:

I just built a castle made out of 42 Cobblestone thanks to Sn0w!

Eat Messages

Announces after eating food:

"I just ate {amount} {name} thanks to Sn0w!"
"Я только что съел {amount} {name} благодаря Sn0w!"

Triggers:

After eating random amount (1-10) food items
With delay of 300 * delay ticks
Only counts food with FoodComponent

Example:

I just ate 3 Golden Apple thanks to Sn0w!

Walk Messages

Announces distance traveled:

"I just magically teleported {blocks} blocks thanks to Sn0w!"
"Я просто волшебным образом телепортировал {blocks} блоков благодаря Sn0w!"

Triggers:

Every 5000 * delay milliseconds
Calculates 3D distance traveled
Ignores distances < 1 block or > 5000 blocks

Example:

I just magically teleported 142.56 blocks thanks to Sn0w!

Join/Leave Messages

Welcomes or says goodbye to players:Join Messages:

"Welcome to %serverip% %name%!"
"Welcome to hell, %name%."
"Hey, %name%"
"Greetings, %name%"

Leave Messages:

"Goodbye %name%!"
"Cya %name%"
"Farewell, %name%"

Example:

Welcome to 2b2t.org Steve!
Goodbye Steve!

Time Messages

Announces at specific world times:

Time	Tick	Messages
Morning	0	”I survived another night!”, “Good Morning!”
Noon	4000	”Let’s go tanning!”, “Enjoy the sun outside!”
Afternoon	6000	”Good afternoon!”
Bedtime	13000	”BEDTIME NOW!!!”, “You may now sleep!”
Night	14000	”Let’s get comfy!”, “Netflix and chill!”
Sunset	16000	Time transition messages
Midnight	18000	”It’s so dark outside…”, “Its scary out there!”
Daylight	23000	”Good bye, zombies!”

Cooldown: 100 ticks between time messages

Output Modes

Self Mode

Messages only appear in your client chat:

Colored in aqua
No packets sent to server
Safe for all servers
Good for testing

ChatUtils.sendMessage(Formatting.AQUA + message);

Chat Mode

Messages sent to public chat:

Visible to all players
Queued with configurable delay
Waits delay * 1000 ms between messages
May trigger spam filters

ChatUtils.sendChatMessage(messages.poll());

Whisper Mode

Messages whispered to nearest player:

Finds target within 100 blocks
Sends as /w [player] [message]
Private messages
Requires whisper permission

LivingEntity entity = TargetUtils.getTarget(100);
ChatUtils.sendChatMessage("/w " + entity.getName().getString() + " " + messages.poll());

Technical Details

Message Queue System

To avoid spam detection, messages are queued:

// Located at: misc/Announcer.java:94-310
public Queue<String> messages = new LinkedList<>();

// Messages are added to queue
messages.add(message);

// Sent with delay
if (timer.isPassed(delay.getValue().intValue() * 1000L) && !messages.isEmpty()) {
    ChatUtils.sendChatMessage(messages.poll());
    timer.resetDelay();
}

Distance Calculation

3D Euclidean distance:

// Located at: misc/Announcer.java:270-294
if (lastPositionUpdate + (5000L * delay.getValue().intValue()) < System.currentTimeMillis()) {
    double d0 = lastPositionX - mc.player.getX();
    double d2 = lastPositionY - mc.player.getY();
    double d3 = lastPositionZ - mc.player.getZ();
    
    speed = Math.sqrt(d0 * d0 + d2 * d2 + d3 * d3);
    
    if (!(speed <= 1) && !(speed > 5000)) {
        String walkAmount = new DecimalFormat("0.00").format(speed);
        sendMessage(walkMessages[random.nextInt(walkMessages.length)].replace("{blocks}", walkAmount));
    }
}

Random Thresholds

Uses random thresholds to seem more natural:

int randomNum = ThreadLocalRandom.current().nextInt(1, 10 + 1);
if (blocksBroken > randomNum) {
    // Announce
    blocksBroken = 0;
}

Configuration Examples

Mode: Self
Break: true
Place: true
Eat: true
Walk: true
Joins: false
World Time: false
Delay: 5

→ All messages visible only to you
→ No spam in public chat
→ Good for testing

Message Variables

Messages support dynamic variables:

Variable	Replacement	Example
`{amount}`	Number of items	42
`{name}`	Item/block name	Stone
`{blocks}`	Distance traveled	123.45
`%name%`	Player name	Steve
`%serverip%`	Server address	2b2t.org
`Sn0w`	Client name	Sn0w (or custom)

Best Practices

Start with Self Mode

Test your configuration in Self mode before enabling public chat

Higher Delay on Servers

Use delay 8-15 on servers with spam filters

Disable in Combat

Turn off during PvP to avoid distraction

Custom Messages

Edit the source to add your own custom messages

Using Chat mode with low delay on strict servers may result in kick or mute for spam.

Known Limitations

Walk distance resets on module disable
Time messages require being in-game for 200 ticks
Whisper mode requires a player within 100 blocks
Some servers may block whisper commands

ChatSuffix: Adds suffix to all chat messages
AutoEZ: Automatically sends messages after kills
Spammer: Advanced chat spamming tool

Combat

Movement

Render

Misc

Player

Overview

Features

Settings

Message Types

Break Messages

Place Messages

Eat Messages

Walk Messages

Join/Leave Messages

Time Messages

Output Modes

Technical Details

Message Queue System

Distance Calculation

Random Thresholds

Configuration Examples

Message Variables

Best Practices

Start with Self Mode

Higher Delay on Servers

Disable in Combat

Custom Messages

Known Limitations

Build docs developers (and LLMs) love

Combat

Movement

Render

Misc

Player

​Overview

​Features

​Settings

​Message Types

​Break Messages

​Place Messages

​Eat Messages

​Walk Messages

​Join/Leave Messages

​Time Messages

​Output Modes

​Technical Details

​Message Queue System

​Distance Calculation

​Random Thresholds

​Configuration Examples

​Message Variables

​Best Practices

Start with Self Mode

Higher Delay on Servers

Disable in Combat

Custom Messages

​Known Limitations

​Related Modules

Build docs developers (and LLMs) love

Overview

Features

Settings

Message Types

Break Messages

Place Messages

Eat Messages

Walk Messages

Join/Leave Messages

Time Messages

Output Modes

Technical Details

Message Queue System

Distance Calculation

Random Thresholds

Configuration Examples

Message Variables

Best Practices

Known Limitations

Related Modules