1.0.0
Compatibility
Required content
Changes
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.jarinto yourmods/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.