Alignments

Alignments

Tracks player morality and reputation from observable gameplay behaviour, with history, decay, and integrations.

Alignments is a standalone Paper plugin that watches real gameplay behaviour and assigns each player a living alignment based on protection, saves, healing, cooperation, PvP aggression, retaliation, betrayal, and village conduct.

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 Accolades protection and save events when Accolades is installed.
• 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.
• Tracks trusted Teamwork cooperation when Teamwork is installed.
• Tracks village-focused behaviour such as villager healing, villager attacks, village defence, raid victories, zombie villager cures, protected block damage, and village golem damage.
• 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, confidence thresholds, decay, action weights, disabled worlds, PvP-disabled worlds, hostile mob lists, village action settings, and message text.
• Emits AlignmentChangeEvent when an applied action changes a player's alignment result.
• Registers AlignmentsApi for other plugins.

Alignment Logic

Alignments tracks three visible parts of a player's reputation:

• Core trait
• Lawful, Neutral, or Chaotic axis
• Good, Neutral, or Evil axis

The moral axis is influenced by actions such as protection, saves, healing, aggression, killing, betrayal, and village harm.

The lawful axis is influenced by conduct such as unprovoked PvP, village damage, theft-style behaviour, and steady village support.

The core trait reflects the strongest behavioural pattern among Selective, Cunning, Compassionate, Steadfast, and Ruthless.

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

Every permission defaults to operator access.

Grant all Alignments permissions:

• alignments.admin

Or assign individual permissions:

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

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.

Supported storage modes:

• yaml
• sqlite
• mysql
• mariadb

Security-focused storage behaviour includes:

• SQLite paths are kept inside the plugin data folder.
• Secure MySQL and MariaDB JDBC examples use certificate or hostname verification.
• JDBC credentials are redacted from status and diagnostics.
• Credential-like JDBC query parameters are stripped before database connections are opened.
• YAML saves are atomic where supported by the filesystem.
• Corrupt YAML data is backed up before fresh data is loaded.
• Database load failures disable saves until reload instead of silently overwriting data.
• Database save failures are reported instead of silently ignored.
• /alignment backup can export current in-memory profiles before maintenance.

Optional Integrations

Alignments works with other Thunder plugins while still remaining fully standalone.

• Accolades can provide polished protection and save events through AccoladeEvent. Alignments ignores non-reputation Accolades events such as sharpshooter, shutdown, hot streak, and avenger.
• Teamwork can provide trusted cooperation evidence through TeamworkCooperationEvent, allowing established nearby teamwork to influence Steadfast and Selective scores.
• StormEconomy can listen for AlignmentChangeEvent and pay configurable rewards when players reach alignment milestones.
• Other plugins can use AlignmentsApi to query profiles, calculate current alignments, check storage health, and record custom alignment actions.

These hooks are optional. If the other plugins are not installed, Alignments keeps working normally with its own tracking, commands, storage, and native scoring.

Anti-Abuse

Alignments is designed to measure repeated behaviour, not single isolated moments.

Default safeguards include:

• Per actor-target cooldowns.
• Hourly positive and negative score caps.
• Minimum damage thresholds.
• Disabled world lists.
• PvP-disabled world lists.
• Hostile mob memory expiry.
• Same-mob credit cooldowns.
• Creative, spectator, and vanished player filtering.
• Optional preference for Accolades and Teamwork events to avoid double-scoring the same gameplay.
• Periodic cleanup of temporary tracking data.

Notes

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