Alignments

Alignments

Alignments is a reputation and morality tracker for Paper servers. It watches real gameplay behaviour and assigns each player a living alignment based on protection, saves, healing, cooperation, PvP aggression, retaliation, and betrayal.

The displayed format is:

• {core_trait} {lawful_axis} {moral_axis}

If both axes are neutral, the display becomes:

• {core_trait} True Neutral

Core traits:

• Selective
• Cunning
• Compassionate
• Steadfast
• Ruthless

Features

• Tracks hostile mob protection and save-style moments.
• Tracks splash potion healing and reliable lingering healing clouds.
• Tracks unprovoked PvP damage.
• Tracks player kills, with lighter scoring for recent retaliation.
• Tracks betrayal when a player attacks someone they recently helped.
• Tracks cooperative nearby activity for active survival and adventure players.
• Records recent alignment history for staff review.
• Supports confidence levels: Unproven, Developing, Established, and Deeply Established.
• Supports alignment decay towards neutral over time.
• Includes configurable score thresholds, score bounds, action weights, disabled worlds, PvP-disabled worlds, hostile mob lists, and message text.

Integrations

• Lifesaver: uses LifesaverProtectionEvent for stronger protection and save detection.
• Teamwork: uses TeamworkCooperationEvent for trusted teammate cooperation.
• StormEconomy: can reward players when AlignmentChangeEvent reports a new alignment milestone.

Alignments also registers AlignmentsApi, allowing other plugins to query profiles, calculate current alignments, check storage health, and record custom alignment actions.

Commands

Main command aliases:

• /alignment
• /align
• /alignments

Common commands:

• /alignment
• /alignment <player>
• /alignment history
• /alignment history <player>
• /alignment top
• /alignment status
• /alignment save
• /alignment backup
• /alignment reload
• /alignment reset <player>
• /alignment set <player> <trait> <lawful|neutral|chaotic> <good|neutral|evil>

Permissions

• alignments.command
• alignments.view.self
• alignments.view.other
• alignments.history
• alignments.status
• alignments.save
• alignments.backup
• alignments.reload
• alignments.set
• alignments.reset
• alignments.admin

Storage and Security

Alignments stores player profiles by UUID. YAML storage works out of the box, and SQLite, MySQL, and MariaDB are supported for larger servers.

Security-focused storage behaviour includes:

• Secure MySQL and MariaDB JDBC examples using certificate or hostname verification.
• JDBC credential redaction in diagnostics and status output.
• Credential-like JDBC query parameters stripped before database connections are opened.
• Atomic YAML saves where supported by the filesystem.
• Corrupt YAML data is backed up before fresh data is loaded.
• Database save failures are reported instead of silently ignored.

Notes

Alignments is observational. It does not auto-punish players, modify combat damage, freeze users, ban users, or require NMS.