Commands

Everything lives under 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
`/tribulation bloodmoon`	2	Show whether a Blood Moon is currently active
`/tribulation bloodmoon start`	2	Force-start a Blood Moon in the current world
`/tribulation bloodmoon stop`	2	End the active Blood Moon

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 (op 2)

/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 (op 2)

/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 (op 2)

/tribulation inspect

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

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. The first form works for any player; the rest require op 2.

Hot-reload config (op 2)

/tribulation reload

Reloads config/tribulation.json without restarting the server. New mobs use the updated values; existing mobs keep their current modifiers until they despawn.

Force a Blood Moon (op 2)

/tribulation bloodmoon
/tribulation bloodmoon start
/tribulation bloodmoon stop

Check whether a Blood Moon is active, or force-start and end one in the current world — handy for testing the event without waiting for a full-moon roll.

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 — viewing other players' data, modifying levels, reloading config, and the debug/inspect tools.

Permissions Mods

With a permissions mod (e.g. LuckPerms), nodes follow the pattern tribulation.command.<subcommand>.