SocialCredit
Turn your minecraft server into a Communist eutopia - API access, Support, Addons
SocialCredit | Server Reputation System & Social Experiment (v1.6) Turn your Minecraft server into a chaotic reputation-driven social experiment.
SocialCredit is not designed to sit quietly in the background. It is a gameplay system that changes how players behave toward each other.
Every player has a persistent Social Credit score.
Behave well, contribute to the State, and your score rises. Cause chaos… and the Ministry will notice.
Over time servers naturally develop rivalries, alliances, informants, and propaganda as players try to protect their reputation — or destroy someone else’s.
The result is a server that slowly evolves into its own political ecosystem.
PlaceholderAPI
## PlaceholderAPIIdentifier: socialcredit
%socialcredit_score%%socialcredit_score_formatted%%socialcredit_rank%%socialcredit_wanted%%socialcredit_jailed%%socialcredit_state_credits%%socialcredit_dailyreward_available%%socialcredit_status%%socialcredit_heat%%socialcredit_heat_rounded%%socialcredit_heat_percent%%socialcredit_heat_colored%%socialcredit_heat_rounded_colored%%socialcredit_heat_percent_colored%%socialcredit_heat_band%%socialcredit_raid_eligible%
Permissions Manager
## PermissionsSocialCredit supports standard permission managers such as LuckPerms.
Core admin access
socialcredit.admin— Full administrative access to all SocialCredit admin commands
Grants access to:
/socialcredit admin ...- Set player score
- Modify decrees
- Jail / unjail players
- Adjust jail mode
- Set Heat
- Force audits
- Access all state/admin subcommands
State Department
socialcredit.state.use— Allows players to use the State Resource Departmentsocialcredit.state.manage— Allows management of State systems
Grants access to:
- Using the state terminal (buy/sell)
- Setting/removing the terminal
- Reloading state config
- Managing state-related systems
Audit / Heat controls
socialcredit.admin.forceaudit— Allows forcing a Ministry audit on a playersocialcredit.admin.setheat— Allows manually setting a player’s Heat
Note: These are defined nodes, but current command access is primarily controlled via
socialcredit.admin.
Debug
socialcredit.debug— Allows generation of debug reports
Used for:
/socialcredit debug generate
Default values
| Permission | Default |
|---|---|
socialcredit.admin | OP |
socialcredit.state.use | TRUE |
socialcredit.state.manage | OP |
socialcredit.admin.forceaudit | OP |
socialcredit.admin.setheat | OP |
socialcredit.debug | OP |
Example (LuckPerms)
Grant State access:
/lp user <player> permission set socialcredit.state.use true
Grant State management:
/lp user <player> permission set socialcredit.state.manage true
Grant full admin:
/lp user <player> permission set socialcredit.admin true
Grant debug access:
/lp user <player> permission set socialcredit.debug true
Quick reference
socialcredit.admin
socialcredit.state.use
socialcredit.state.manage
socialcredit.admin.forceaudit
socialcredit.admin.setheat
socialcredit.debug
Notes
socialcredit.adminis the primary admin permission.socialcredit.state.useis enabled for all players by default.socialcredit.state.manageallows limited system control without full admin.- Some granular admin nodes exist but are currently grouped under
socialcredit.adminin command handling.
Join the SocialCredit Community Discord
The SocialCredit Discord isn’t just a support server — it’s an active development hub, testing ground, and slightly questionable state-controlled environment.
━━━━━━━━━━━━━━━━━━ For Server Owners ━━━━━━━━━━━━━━━━━━
• Direct Support & Setup Help Get help configuring SocialCredit, troubleshooting issues, or designing your server systems properly.
• Server Spotlight System Promote your server to the community and discover how others are using SocialCredit in the wild.
• Update Alerts Get notified instantly when new versions of SocialCredit or addons release.
• Real Use Cases See how other server owners are implementing: – Heat systems – BlackMarket economies – Inspection mechanics – Custom gameplay loops
• Community Feedback Test ideas, get opinions, and refine your server before going live.
━━━━━━━━━━━━━━━━━━ ⚙️ For Developers ━━━━━━━━━━━━━━━━━━
• API Support & Guidance Ask questions about the SocialCredit API and get real answers — not guesswork.
• Addon Development Hub Build your own modules and integrations with support from others doing the same.
• Code Help (Without the Ego) Post errors, stack traces, or concepts — get practical help quickly.
• Feature Voting System Suggest and vote on new features, systems, and future updates.
• Dev-Focused Channels Clear structure for: – Uploads – Debugging – API discussion – Addon ideas
━━━━━━━━━━━━━━━━━━ Extra Systems (Because Why Not) ━━━━━━━━━━━━━━━━━━
• Community Voting Systems Suggest features, vote on ideas, influence development.
• Monster Energy Rating Board Yes, this exists. Yes, it’s taken seriously.
• Role-Based Access Choose your roles (developer, tester, server owner, etc.) to customise your experience.
• Light “State” Roleplay Layer Occasional automated messages, inspections, and general nonsense to keep things interesting.
━━━━━━━━━━━━━━━━━━ ⚠ Final Note ━━━━━━━━━━━━━━━━━━
This server is not monitoring you.
Any suggestions otherwise are purely coincidental.
━━━━━━━━━━━━━━━━━━
Join here: https://discord.gg/Bx2swmENHd
Core Gameplay Concept SocialCredit introduces a persistent reputation system that tracks how players behave.
Players quickly begin to:
• Compete for the highest Social Credit • Sabotage rival players • Donate resources to the State • Attempt to avoid suspicion • Build reputations as heroes… or notorious criminals
Servers often develop unexpected player politics and social dynamics, which is exactly the point.
This plugin intentionally creates emergent gameplay.
Core Features Global Social Credit Score Every player on the server has a persistent Social Credit score.
Scores can increase or decrease depending on behaviour, server systems, or administrative decisions.
The entire server begins to react to reputation.
State Resource Department The State requires resources.
Players can donate materials to the government and receive State Credits in return.
These credits can then be used for rewards configured by the server owner.
This creates a simple but effective gameplay loop:
• Donate resources • Earn State Credits • Buy rewards • Compete to become the most valuable citizen
All items, exchange rates, and rewards are fully configurable via YAML.
Daily Join Rewards Players receive a Social Credit reward once every 24 hours when joining the server.
This encourages server activity and gives new players a starting boost.
Administrative Controls Server operators can directly modify Social Credit using commands.
Examples:
/socialcredit add
Moderators can reward positive behaviour or punish chaos.
Advanced Systems (v1.6) Heat System Suspicious behaviour now generates Heat.
Players who accumulate too much Heat may attract the attention of the State.
High Heat can lead to:
• inspections • investigations • raids • imprisonment
Heat is fully configurable and exposed through the plugin API.
Jail System Uncooperative citizens may enjoy temporary state accommodation.
Server owners can configure:
• jail duration • penalties • enforcement behaviour
Inspection & Raid Infrastructure The Ministry now has the ability to investigate suspicious activity.
These systems are designed as framework hooks that server owners and addons can expand.
PlaceholderAPI Support SocialCredit integrates with PlaceholderAPI so scores and status can be used in:
• scoreboards • chat formatting • holograms • GUIs • tab lists
Example placeholders:
%socialcredit_score% %socialcredit_rank% %socialcredit_state_credits% %socialcredit_status%
Configurable Feature System Most gameplay systems can be toggled in config.yml.
Server owners can make SocialCredit:
• a light reputation system • or a full chaotic political simulation
Built for Expansion SocialCredit is designed as a framework plugin.
The core system intentionally stays lightweight while allowing the ecosystem to grow through addons.
Example addon:
SocialCredit: BlackMarket
Adds:
• illegal player shops • contraband trading • inspections and informants • underground economies • propaganda announcements • Discord broadcasts
This creates a dynamic political economy layered on top of the SocialCredit system.
Performance • asynchronous operations where possible • lightweight core framework • modular systems • safe config handling
Designed for Paper / Spigot 1.20+ servers.
Support & Community Join the official SocialCredit Discord:
https://discord.gg/jaMGPKfGx7
Share server stories, suggest features, and report bugs.
The Ministry appreciates your cooperation.
Final Message from the State Remember:
Compliance is voluntary. Participation is mandatory.
