Algorithm mod

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 — 3×3 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

1. Install Fabric Loader 0.16.0+
2. Download Fabric API for 1.21.1
3. 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.