New: Pre-Adjustment Oversight Protocol (API Expansion)
A new interception layer has been introduced to allow authorised external systems to review behavioural corrections before they are applied.

SocialCreditPreChangeEvent

This protocol allows approved integrations to:

• observe all pending Social Credit adjustments
• review the reasoning behind each correction
• amend the severity of the adjustment where deemed appropriate
• fully veto a correction before it is applied

If a correction is vetoed:

• no record is stored
• no adjustment is made
• no announcement is issued

This ensures that only fully sanctioned corrections are enacted.

Unauthorised interference remains impossible. Naturally.

Clarification: Post-Adjustment Reporting
The existing reporting system remains in place:

SocialCreditChangeEvent

• continues to fire after a correction is applied
• now functions strictly as a notification layer

This preserves compatibility with all previously approved integrations.

Correction: Public Announcement Accuracy
The Ministry has identified and resolved a discrepancy in public-facing reports.

Previously:

• announcements could display the intended correction value

Now:

• all announcements reflect the final, authorised adjustment

This ensures citizens receive messaging that is:

• accurate
• consistent
• beyond dispute

The Ministry regrets any confusion. Misinterpretation is not a valid defence.

Infrastructure Update: System Identification

• Core system versioning has been standardised
• Console output formatting has been refined for clarity
• Duplicate identification markers have been removed

The system now presents itself cleanly and without redundancy.

New: Ministry Startup Broadcast
Upon activation, the system now performs a formalised identity broadcast to the console.

This ensures:

• immediate recognition of active authority
• clear confirmation of system version
• appropriate atmosphere

Compliance begins at startup.

Operational Status
You are now operating under:
SocialCredit v1.6.4

All systems are functioning within expected parameters.

Remember:
Compliance is rewarded.
Deviation is corrected.
Observation is constant.

— The Ministr

Fix to API

Add listener event in API for social credit pre change event

SocialCredit v1.6.2
“The State Has Noticed You Not Being Noticed” Edition
Citizens,

Following a brief period of administrative confusion (classified), the Ministry is pleased to confirm that enforcement systems are now operating with renewed enthusiasm.

State Enforcement Now Fully Operational
Previously, certain high-risk individuals were able to reach concerningly high levels of Heat without… consequences.

This has been corrected.

• Players exceeding acceptable behavioural thresholds may now attract active enforcement attention
  
  
• The State may deploy investigation patrols (also known as “raids”)
  
  
• These are triggered dynamically based on your Heat level
  
  
• The higher your Heat, the more likely you are to be… noticed
  

Reminder: Being noticed by the State is not a reward.

Adaptive Suspicion Thresholds
The Ministry has refined its detection systems:

• Raid trigger thresholds now operate within a configurable range (default: 60–100 Heat)
  
  
• This ensures enforcement remains:
  
  • unpredictable
    
    
  • immersive
    
    
  • mildly unsettling
    

You will no longer know exactly when the State decides you are a problem.

This is intentional.

Improved Internal Messaging Stability
Certain internal communications previously appeared as:

“§cUnintelligible Ministry Noise”

This has been resolved.

• All broadcasts, audits, and warnings now display correctly
  
  
• The Ministry assures you the previous messages were not errors, but rather “early-stage linguistic optimisation”
  

Visual Clarity Improvements

• Heat display colours now behave correctly
  
  
• Citizens can once again clearly see:
  
  • when they are safe
    
    
  • when they are not
    
    
  • when it is already too late
    

⚖️ General Administrative Corrections

• Various behind-the-scenes inconsistencies have been resolved
  
  
• Systems now behave in a way that more closely aligns with official doctrine
  
  
• The illusion of control has been restored
  

️ Final Notice from the Ministry
“Compliance is not required. It is simply the most survivable option.”

Scoreboard Fix and Heat Decay

SocialCredit v1.6 — Ministry Enforcement Update
Citizens,

The Ministry of Communal Harmony is pleased to announce Version 1.6 of the SocialCredit system.
After a thorough internal audit (and several unfortunate disappearances), the State has implemented a number of improvements to ensure compliance and civic participation.

Key Improvements

• Heat System moved into the core engine
  Suspicious behaviour is now centrally tracked by the State.
  
  
• Heat API added for addons
  Third-party ministries and state departments can now interact with Heat directly.
  
  
• Heat PlaceholderAPI support
  Public displays may now broadcast citizen suspicion levels.
  
  
• Configurable Jail System
  Citizens who fail to cooperate may now enjoy state-funded accommodation.
  
  
• Inspection & Raid Infrastructure
  High-heat individuals may now attract the attention of field inspectors.
  
  
• Discord & Messaging Improvements
  Ministry announcements are now cleaner, clearer, and slightly more ominous.
  

Addon Ecosystem
This update prepares the framework for expanding state infrastructure such as:

• SocialCredit: BlackMarket
  
  
• future ministry departments
  
  
• community governance tools
  

The core plugin intentionally remains lightweight and extensible, allowing server operators to build their own version of the State.

⚠ Important
Config files from older versions may not contain new settings.
If new sections are missing, regenerate the config by deleting the old file.

Final Note from the Ministry
Remember:
Compliance is voluntary.
Participation is mandatory.

SocialCredit v1.5
Major Update – PlaceholderAPI + Configurable Features
This update focuses on server compatibility, configurability, and integration support, allowing server owners to enable/disable mechanics and integrate SocialCredit with other plugins.

New Features
PlaceholderAPI Support
SocialCredit now integrates with PlaceholderAPI.

Available placeholders:


%socialcredit_score%
%socialcredit_score_formatted%
%socialcredit_rank%
%socialcredit_wanted%
%socialcredit_jailed%
%socialcredit_state_credits%
%socialcredit_status%
%socialcredit_dailyreward_available%

This allows SocialCredit values to be used in:

• scoreboards
  
  
• chat formatting
  
  
• holograms
  
  
• GUIs
  
  
• tab lists
  
  
• external plugins
  

PlaceholderAPI is optional and automatically detected.

Feature Toggle System
Most gameplay mechanics can now be enabled or disabled from the config.

New features section in config.yml:


features:
join_reward: true
early_game: true
partial_tree_chop_warning: true
chest_hoarding: true
diamond_investigation: true
stalking_penalty: true
inspections: true
propaganda: true
audit_patrols: true

This allows server owners to customize how intrusive or lightweight the system is.

Improvements

• Cleaner service initialization
  
  
• Improved config safety checks
  
  
• Optional PlaceholderAPI soft dependency
  
  
• Better modular control of gameplay systems
  
  
• Improved compatibility with scoreboard/chat plugins
  

Internal Changes

• Placeholder expansion system added
  
  
• Feature flags integrated into listeners and services
  
  
• Versioning updated to 1.5
  
  
• Clean rebuild of plugin structure
  

Compatibility
Works with:

• Paper / Spigot 1.20+
  
  
• PlaceholderAPI (optional)
  

Upgrade Notes
Simply replace the jar file.

The new config options will generate automatically if missing.

Cleaning up the API and added a few other fun things.
Releasing at the same time as SocialCredit:BlackMarket

Corrected errors to the API.
Prepared the listeners ready for addon.
The next update will be after the SocialCredit: BlackMarket addon is released. (currently testing and in v0.8 dev)

This will not alter any in-game functionality.
The aim is to ensure your plugin is up-to-date and compatible with any addons to the framework.