The Watching World

Every player has a hidden karma score, and the world reacts to it. Helpful
actions raise it: planting, trading, taming, breeding, building. Cruel ones
lower it: killing animals (babies especially), hurting villagers, and stripping
the landscape. The higher your karma, the more the world helps you. The lower it
gets, the more it works against you.

What it does

Each player starts at 0 karma, stored in their player data and clamped to a
range you set in the config. Events move the number up or down. On a timer the
plugin checks each online player's tier and applies effects to match it.

High karma:

• Passive animals drift toward you.
• Gifts occasionally drop at your feet.
• Nearby monsters sometimes lose interest in you.
• You slowly regenerate in daylight.

Low karma:

• Monsters spot you from farther away and head toward you.
• Dark smoke particles follow you around.
• Crops near you grow more slowly.

Neutral: normal vanilla behavior, no effects either way.

When you move into a new tier you get a short message on the action bar.

Commands

Base command: /karma (aliases: /kma, /ledger)

| Command | Who | What |
|---|---|---|
| /karma | everyone | Show your own karma and standing. |
| /karma get [player] | self free; others need admin | Show a player's karma and tier. |
| /karma set <player> <n> | admin | Set a player's karma to n. |
| /karma add <player> <n> | admin | Add n (may be negative) to a player's karma. |
| /karma top | everyone | Leaderboard of the highest-karma online players. |
| /karma reload | admin | Reload config.yml. |

Permissions

| Node | Default | Grants |
|---|---|---|
| karma.check | everyone | View your own karma and tier; /karma, /karma top. |
| karma.admin | op | View others, set/add, reload. Includes karma.check. |

Configuration

config.yml is created on first run. It lets you set:

• karma.min, karma.max, karma.default: the clamp range and starting value.
• weights.*: how much karma each action gives or takes (set any to 0 to turn it off).
• natural-blocks: the blocks whose breaking lowers karma.
• tiers.high, tiers.low: the tier thresholds (high must be above low).
• judgment.interval-seconds, judgment.radius: how often the check runs and the effect radius around each player.
• effects.*: an on/off toggle for each high and low effect.
• gifts.*: high-karma gift frequency, item, and amount.

Edit it and run /karma reload to apply changes without restarting.

Compatibility

Paper, Spigot, Bukkit, and Purpur on Minecraft 1.21.1 through 1.21.11 and the
26.1.x line (verified on 26.1.2), Java 21. It only uses the Bukkit/Spigot API, so
it runs the same on all four server types.