SocialCredit

Turn your minecraft server into a Communist eutopia - API access, Support, Addons

SocialCredit

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

Identifier: `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

Permissions

SocialCredit 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 Department - `socialcredit.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 player - `socialcredit.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.admin` is the primary admin permission. - `socialcredit.state.use` is enabled for all players by default. - `socialcredit.state.manage` allows limited system control without full admin. - Some granular admin nodes exist but are currently grouped under `socialcredit.admin` in 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 <player> <amount> /socialcredit remove <player> <amount> /socialcredit check <player>

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.

SocialCredit

SocialCredit

PlaceholderAPI

Permissions

Core admin access

State Department

Audit / Heat controls

Debug

Default values

Example (LuckPerms)

Quick reference

Notes

Versions