LPC Pro · Features

Achievements

Documents LPC Pro 4.0.0 · mirrored from the product wiki, updated 2026-02-07 · GitBook version

The achievement system rewards players for chat milestones like message counts, mentions, replies, reputation, and poll participation. Configuration is in features/achievements.yml.

Commands

Command	Description	Permission
`/achievements`	Open the achievements GUI (aliases: `/achieve`, `/ach`)	`lpcpro.achievements`

Configuration

enabled: true
announce-to-server: false
show-title: true

unlock-sound: "UI_TOAST_CHALLENGE_COMPLETE"
unlock-sound-volume: 1.0
unlock-sound-pitch: 1.0

Setting	Type	Default	Description
`announce-to-server`	boolean	`false`	Broadcast achievement unlocks to all players
`show-title`	boolean	`true`	Show a title screen on unlock
`unlock-sound`	string	`UI_TOAST_CHALLENGE_COMPLETE`	Sound played on unlock

Achievement Types

Type	Tracks	Example
`MESSAGE_COUNT`	Total messages sent	"Send 100 messages"
`UNIQUE_MENTIONS`	Different players mentioned	"Mention 10 different players"
`REPLIES_SENT`	Reply messages sent	"Reply to 25 messages"
`REPUTATION`	Reputation score	"Reach 10 reputation"
`POLLS_VOTED`	Polls voted in	"Vote in 5 polls"

Default Achievements

Message Milestones

Achievement	Threshold	Reward Tag
First Words	1 message	`[Newbie]`
Chatterbox	100 messages	`[Chatterbox]`
Social Butterfly	500 messages	`[Social]`
Chat Veteran	1,000 messages	`[Veteran]`
Legendary Speaker	5,000 messages	`[Legend]`
Chat God	10,000 messages	`[God]`

Achievement	Type	Threshold
Friendly	UNIQUE_MENTIONS	10 players
Networker	UNIQUE_MENTIONS	50 players
Helpful	REPLIES_SENT	25 replies
Supporter	REPLIES_SENT	100 replies

Reputation Achievements

Achievement	Threshold	Reward Tag
Respected	10 rep	`[Respected]`
Beloved	50 rep	`[Beloved]`
Community Idol	100 rep	`[Idol]`

Poll Achievements

Achievement	Threshold
Voter	5 polls
Democratic	25 polls

Creating Custom Achievements

Add entries under achievements: in achievements.yml:

achievements:
  my_achievement:
    name: "Chat Master"
    description: "Send 2,500 messages"
    type: MESSAGE_COUNT
    threshold: 2500
    reward-tag: "<gradient:gold:yellow>[Master]</gradient>"
    reward-commands:
      - "give {player} diamond 5"
      - "eco give {player} 1000"

Achievement Properties

Property	Required	Description
`name`	Yes	Display name
`description`	Yes	Description text
`type`	Yes	Achievement type (see table above)
`threshold`	Yes	Value needed to unlock
`reward-tag`	No	MiniMessage-formatted tag granted on unlock
`reward-commands`	No	Commands to execute on unlock (`{player}` placeholder)

Placeholders

Placeholder	Description
`%lpcpro_achievements%`	Progress (e.g., "5/15")
`%lpcpro_achievements_unlocked%`	Unlocked count
`%lpcpro_achievements_total%`	Total achievements
`%lpcpro_achievements_percent%`	Unlock percentage (e.g., "33%")

Ready to run it? Get LPC Pro — AI moderation, MiniMessage, Discord, chat bubbles, games & more — one chat plugin.