https://github.com/rfizzle/tribulation
A comprehensive difficulty overhaul for Minecraft 1.21.1 Fabric.
https://github.com/rfizzle/tribulation
Last synced: 23 days ago
JSON representation
A comprehensive difficulty overhaul for Minecraft 1.21.1 Fabric.
- Host: GitHub
- URL: https://github.com/rfizzle/tribulation
- Owner: rfizzle
- License: mit
- Created: 2026-05-17T00:43:30.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-05-26T03:55:05.000Z (about 1 month ago)
- Last Synced: 2026-05-26T05:27:42.874Z (about 1 month ago)
- Language: Java
- Homepage: http://tribulation.rfizzle.com/
- Size: 30.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A comprehensive difficulty overhaul for Minecraft 1.21.1 Fabric.
Tribulation transforms Minecraft's flat difficulty curve into an escalating gauntlet. Mobs grow stronger as you play longer, venture further from spawn, and delve deeper underground. Beyond raw stat scaling, the mod layers in tier-gated mob abilities, opt-in permanent death penalties, and inventory risk mechanics — all configurable, all formula-driven, zero external dependencies.
**[Documentation](https://tribulation.rfizzle.com)** | **[Releases](https://github.com/rfizzle/tribulation/releases)**
---
## Core Systems
### Mob Scaling (3 Axes)
Every hostile mob's stats are computed from three independent factors at spawn time:
- **Time** — Your cumulative playtime advances a per-player level (0–250, 1 hour per level). Higher level = stronger mobs near you.
- **Distance** — Beyond 1000 blocks from world spawn, mobs gain bonus health, damage, armor, and toughness (caps at +150%).
- **Height** — Deviation from sea level (Y=62) in either direction adds threat (caps at +50%).
21 vanilla mob types have individually tuned scaling rates and caps. Modded hostile mobs get conservative fallback scaling automatically.
### Tier-Gated Abilities
At 5 level thresholds (50/100/150/200/250), mobs unlock special behaviors:
| Tier | Level | Examples |
|------|-------|----------|
| 1 | 50 | Zombie reinforcements, Creeper shorter fuse |
| 2 | 100 | Skeleton sword switch, Spider web placing |
| 3 | 150 | Zombie door-breaking, Wither Skeleton sprint |
| 4 | 200 | Skeleton flame arrows, Vindicator damage resistance |
| 5 | 250 | Zombie sprinting, Creeper charged (25%), Spider leap attack |
### Death Penalties
- **Death Relief** — Lose 2 levels on death (rubber-band mechanic, configurable)
- **Shatter Shards** — Rare mob drops (0.5%) that reduce your level by 5 on use
- **Hardcore Hearts** *(opt-in)* — Permanently lose max health on each death; restore with Heart Fragments
- **Soul Inventory** *(opt-in)* — Inventory destroyed on death unless items have the Soulbound enchantment
### Additional Features
- Special zombie variants (Big Zombie, Speed Zombie) with distinct stat profiles
- Boss scaling with separate, gentler formula (Ender Dragon, Wither, tagged bosses)
- Bonus XP proportional to mob difficulty (up to 2x)
- Per-mob toggle switches for granular control
- Full compatibility with modded mobs via namespace exclusion and per-entity overrides
---
## Installation
**Requirements:** Minecraft 1.21.1, Fabric Loader 0.16.10+, Fabric API, Java 21
Drop the jar into `mods/` on both server and client. Config generates at `config/tribulation.json` on first launch — tune everything with `/tribulation reload`.
---
## Commands
| Command | Perm | Description |
|---------|------|-------------|
| `/tribulation info` | 0 | Your level, tier, and progress |
| `/tribulation hearts` | 0 | Your heart penalty status |
| `/tribulation set ` | 2 | Set a player's level |
| `/tribulation reload` | 2 | Hot-reload config |
| `/tribulation debug ` | 2 | Full scaling breakdown |
| `/tribulation inspect` | 2 | Inspect the mob you're looking at |
[Full command reference →](https://tribulation.rfizzle.com/commands.html)
---
## Configuration
Every value is tunable without restart. Key sections: `general`, `timeScaling`, `distanceScaling`, `heightScaling`, `statCaps`, `deathRelief`, `shards`, `hardcoreHearts`, `soulInventory`, `scaling` (per-mob), `bosses`, `tiers`, `abilities`.
[Full config reference →](https://tribulation.rfizzle.com/config.html)
---
## Building from Source
```sh
./gradlew build # produces build/libs/tribulation-.jar
./gradlew test # runs unit tests
./gradlew runGametest # runs Fabric gametest suite
```
### Releasing
```sh
make release BUMP=patch # bumps version, tags, and pushes (triggers CI release)
make release BUMP=minor NO_PUSH=1 # local only
```
---
## Migrating from Other Mods
If you previously used a mob scaling mod, remove it before installing Tribulation. This mod provides a unified system with formula-driven scaling, per-player progression, and opt-in death penalty mechanics in a single jar with zero external dependencies.
---
## License
MIT