Trustify

---

✨ Overview

Popularity helps server owners identify which players are trusted, friendly, helpful, suspicious, or dangerous.

Players can gain reputation by helping newcomers, behaving positively, receiving good ratings, answering questions, and contributing to the community. On the other hand, negative actions such as toxic chat, suspicious behavior, excessive player killing, scam reports, and harmful activity can reduce trust and karma.

This system is perfect for survival, SMP, economy, roleplay, and community-based servers that want to reward helpful players while protecting new players from risky interactions.

---

🌟 Core Features

Popularity System

Players gain popularity based on positive community actions such as helping new players, receiving good ratings, answering questions, and being active in a positive way.

Trust System

Each player has a trust level that shows how safe or risky they are. Trust can increase through helpful behavior and decrease from negative actions.

Karma System

Karma represents the overall behavior of a player. Good actions increase karma, while harmful actions reduce it.

Helpful Player Detection

Popularity can detect helpful actions such as assisting new players, giving useful items, answering questions, and supporting the community.

Chat Behavior Scanner

The plugin can scan chat behavior using configurable keyword rules to detect positive, toxic, spam, or suspicious messages.

Combat Trust Detection

Killing new players or repeatedly targeting the same player can reduce trust, while PvP arenas, duel zones, or ignored worlds can be excluded.

Player Rating System

Players can rate others through commands or GUI. Ratings can affect popularity, trust, and karma.

Leaderboards

Show top players based on popularity, trust, or karma.

PlaceholderAPI Support

Display player reputation data on scoreboard, tablist, chat, menus, holograms, and more.

Fully Configurable

Almost everything can be customized, including scores, status levels, GUI layouts, messages, rewards, modules, cooldowns, and performance settings.

---

🛡 Trust Status Examples

Players can be classified into different trust levels:

• 🟢 Trusted — Safe, helpful, and positive player
• 🔵 Friendly — Generally good and friendly
• ⚪ Neutral — Not enough data yet
• 🟡 Suspicious — Some negative behavior detected
• 🔴 Dangerous — Be careful when interacting with this player

---

📦 Commands

Player Commands

/popularity
/popularity <player>
/trust <player>
/karma <player>
/rate <player>
/top popularity
/top trusted
/top karma

Admin Commands

/popularityadmin reload
/popularityadmin set <player> popularity <amount>
/popularityadmin set <player> trust <amount>
/popularityadmin set <player> karma <amount>
/popularityadmin add <player> <type> <amount>
/popularityadmin reset <player>
/popularityadmin logs <player>
/popularityadmin debug <player>
/popularityadmin performance

---

🧩 PlaceholderAPI Placeholders

%popularity_score%
%popularity_status%
%popularity_trust_score%
%popularity_trust_status%
%popularity_karma_score%
%popularity_karma_status%
%popularity_rating_average%
%popularity_rating_count%
%popularity_helped_newbies%
%popularity_rank_popularity%
%popularity_rank_trust%
%popularity_rank_karma%

---

⚙ Performance First

Popularity is designed to be lightweight and optimized.

The plugin uses:

• Async database operations
• Cached player profiles
• Leaderboard cache
• Batch saving
• Cooldowns and daily limits
• Configurable performance modes
• Optional modules that can be enabled or disabled

Performance modes:

LIGHT
BALANCED
DETAILED

By default, the plugin is designed to run in a safe and balanced mode for most survival servers.

---

🔌 Supported Integrations

Popularity can work with:

• PlaceholderAPI
• Vault
• LuckPerms
• WorldGuard
• EssentialsX
• CombatLogX
• Lands
• GriefPrevention
• DiscordSRV

All integrations are optional and can be configured.

---

💾 Storage

Supported storage types:

SQLite
MySQL

SQLite is suitable for small to medium servers, while MySQL is recommended for larger networks.

---

🎁 Reward System

Server owners can reward players based on:

• High popularity
• Trusted status
• Weekly leaderboard position
• Karma milestones
• Helpful behavior

Rewards can run commands such as giving money, permissions, ranks, items, or cosmetics.

---

✅ Perfect For

Popularity is great for:

• Survival servers
• SMP servers
• Economy servers
• Roleplay servers
• Community servers
• Newbie-friendly servers
• Servers that want a safer social system

---

📌 Requirements

Minecraft: 1.21+
Java: 21+
Server Software: Paper recommended

Spigot compatibility may depend on enabled features and server environment.

---