Commands

All commands use the /tribulation root. Permission level 0 = any player, level 2 = operator.

Command Reference

Command	Perm	Description
`/tribulation info`	0	Show your own level, tier, and progress to next level
`/tribulation hearts`	0	Show your own heart penalty (Hardcore Hearts)
`/tribulation level <player>`	2	View another player's level and time to next
`/tribulation set <player> <level>`	2	Set a player's difficulty level (clamped to maxLevel)
`/tribulation reset <player>`	2	Reset a player to level 0
`/tribulation reload`	2	Hot-reload the config file without restarting
`/tribulation config`	2	Print a summary of the current configuration
`/tribulation debug <player>`	2	Show detailed scaling breakdown for a player's position
`/tribulation inspect`	2	Inspect the mob you're looking at (within 10 blocks)
`/tribulation hearts <player>`	2	View another player's heart penalty
`/tribulation hearts <player> restore <n>`	2	Restore lost half-hearts for a player
`/tribulation hearts <player> reset`	2	Clear all heart penalties for a player
`/tribulation inventory <player>`	2	Count soulbound items in a player's inventory

Usage Examples

Check your own status

/tribulation info

Output:

=== Tribulation: Steve ===
Level: 87 / 250 (tier 1)
Progress: 54000 / 72000 ticks (15m until next level)

Set a player's level

/tribulation set Alex 100

Sets Alex to level 100, immediately changing the difficulty of mobs near them. Useful for testing or catching up a player who joined late.

Debug scaling at a location

/tribulation debug Steve

Output:

=== Debug: Steve ===
Position: (1523.4, 34.0, -892.1) in minecraft:overworld
Player level: 87  Tier: 1
Distance from spawn: 1765.2 blocks  →  factor +0.255
Height offset: -28.0 blocks  →  factor +0.093
Time factors (reference mob: zombie):
  health       rate=0.0100 cap=2.50  →  time +0.870, +dist +0.255, +height +0.093
  damage       rate=0.0150 cap=3.75  →  time +1.305, +dist +0.255, +height +0.093
  speed        rate=0.0012 cap=0.30  →  time +0.104 (time only)
  follow_range rate=0.0100 cap=1.00  →  time +0.870 (time only)
  armor        rate=0.0320 cap=8.00  →  time +2.784, +dist +0.255, +height +0.093
  toughness    rate=0.0240 cap=6.00  →  time +2.088, +dist +0.255, +height +0.093

Inspect a mob

/tribulation inspect

Look at a mob within 10 blocks and run the command. Shows its type, HP, scaling factor, variant status, and all applied Tribulation modifiers.

Manage Hardcore Hearts

/tribulation hearts
/tribulation hearts Alex
/tribulation hearts Alex restore 4
/tribulation hearts Alex reset

Check, view, restore, or fully reset a player's permanent heart penalty.

Hot-reload config

/tribulation reload

Reloads config/tribulation.json without restarting the server. All new mobs will use updated values. Existing mobs keep their current modifiers until they despawn.

Permission Notes

Level 0 (Any Player)

info and hearts (self) are available to all players. They can only view their own data.

Level 2 (Operator)

All other commands require op level 2. This includes viewing other players' data, modifying levels, reloading config, and debug/inspect tools.

Permissions Mods

If you use a permissions mod (e.g., LuckPerms), the permission nodes follow the pattern tribulation.command.<subcommand>.