Algorithm Meter 🎯

Your gameplay is content. The algorithm is always watching.

Algorithm Meter turns your Minecraft session into a live "Audience Retention Score" (0–100%). Every action you take — fighting, mining, parkouring, exploring — either hypes up the algorithm or bores it. Keep the score high for powerful loot and buffs. Let it hit 0% and face the consequences.

🔥 How It Works

Your retention score starts at 50% and changes every second based on what you do. A boss bar at the top of the screen shows your current score, tier, and active combo multiplier.

Tiers

Score	Tier	Bar Color
90%+	VIRAL	Green
75%+	ON FIRE	Green
50%+	TRENDING	Yellow
33%+	WARM	Yellow
20%+	COOLING	Red
<20%	CANCELLED?	Red

⬆️ Gain Retention (Hype)

Action	Gain
Wind Charge launch	+15%
Critical hit on a mob	+8%
Killing a mob	+12%
Parkour jump (land a gap)	+5%
MLG water bucket clutch	+20%
Enemy combo (3+ hits on same mob)	+6% per hit
Mining ore	+2–10% (varies by ore)
Discovering new chunks	+10%
Clutch save (negate fatal fall damage)	+25%
Sprinting	+1% per second

Combos 🏆

Hype actions back-to-back build a combo multiplier (up to x3.5). The more you chain within ~6 seconds, the bigger your rewards. Getting bored resets your combo to zero.

⬇️ Lose Retention (Boredom)

Condition	Penalty
Standing still >10s	-1.5% per second
Strip-mining stone in place (>3 blocks)	-1% per extra block
Inside a chest/furnace/inventory >12s	-1% per second

Running, jumping, fighting, and exploring never count as idle.

🎯 Milestones

100% — "LIKED!"

Gold title + subtitle
Algorithm's Blessing: Speed II, Luck, Resistance for 60s
Rare loot drops at your feet (Heavy Core, enchanted books, golden apples, totems, netherite)
Score resets to 50% to restart the cycle
Server broadcast announces your achievement

Every 10% gained

Random mid-OP reward: OP bows, tridents, elytras, beacons, netherite tools, shulker boxes, enchanted apples, and more!

0% — "RETAIN!"

Warden heartbeat + sonic boom sounds
Dark red title + nausea + slowness
One random catastrophe strikes:

#	Catastrophe
1	Inferno — 3x3 fire beneath your feet + you catch fire
2	Creeper Swarm — 3 charged creepers spawn around you
3	Void Call — Levitation V + Blindness + Weakness
4	Lightning Storm — 6 bolts strike near you
5	Skeleton Patrol — 4 skeletons spawn in a circle
6	Poison Fog — Poison + Hunger + Weakness

Score resets to 30%
60-second catastrophe cooldown prevents spam
Comeback Bonus: climb back above 25% to get +10% retention + Regeneration + Speed

👑 Boss Kills

Kill the Wither, Ender Dragon, or Warden for ultra-OP rewards:

Full Netherite gear with Level 50 enchantments
Sharpness 50, Protection 50, Efficiency 50, Fortune 50
Mending, Unbreaking, Thorns, Feather Falling on everything
Plus Strength V + Resistance IV buffs
Server-wide announcement

⚙️ Commands

Command	Description
`/algorithm`	Show your retention score, tier, and combo
`/algorithm tiers`	List the retention tier ladder
`/algorithm config`	Show all current config values
`/algorithm config <key> <value>`	Change a setting live (saves to config file)

All settings are also editable in config/algorithmmod.json.

🎮 Passive Buffs

Stay hot for free passive effects:

Score	Buff
90%+	Regeneration
85%+	Speed
75%+	Haste
90%+	Glow effect (visible through walls)
95%+	Beacon beam particles

📦 Installation

Install Fabric Loader 0.16.0+
Download Fabric API for 1.21.1
Drop algorithmmod-1.0.0.jar into your mods/ folder

Works on dedicated servers — the core runs server-side. Players without the client mod will miss the inventory penalty feature but everything else works fine.

🔧 Configurable

Nearly every value is tweakable in config/algorithmmod.json or via /algorithm config:

All hype rewards and boredom penalties
Combo window, max level, and step size
Grace periods for idle/container/inventory
Catastrophe cooldown
Comeback bonus amount
Feature toggles for broadcasts, glow effect, beacon beam, boss bar, passive buffs, catastrophes, blessing, parkour, MLG, enemy combos, meter rewards, and boss rewards

📜 License

MIT — do whatever you want with it.