Messages

EasySell provides full customization of all plugin messages. This page explains every message option in messages.yml.

Message Structure

Each message has three properties:

message-key:
  enabled: true          # Whether to show this message
  message: 'Your text'   # The message content
  type: CHAT             # How to display the message

Message Types

Type	Description
CHAT	Standard chat message
ACTIONBAR	Action bar (above hotbar)
TITLE	Large center-screen title
SUBTITLE	Smaller text below title
BOTH	Chat + Action bar

All Messages

no-permission

Shown when a player lacks permission for a command.

no-permission:
  enabled: true
  message: '&cYou do not have permission to do that!'
  type: BOTH

---

items-sold-title

Main title shown when items are sold successfully.

items-sold-title:
  enabled: true
  message: '#7dfb03+$%total%'
  type: TITLE

Placeholders:

• %total% - Total money earned (formatted)

---

amount-sold-subtitle

Subtitle with additional sale details.

amount-sold-subtitle:
  enabled: false
  message: '&aYou sold &e%items% &aitems for &e%total% &ato the shop!'
  type: SUBTITLE

Placeholders:

• %items% - Number of items sold

• %total% - Total money earned

---

no-items-to-selling

Shown when the sell GUI is closed with no valid items.

no-items-to-selling:
  enabled: false
  message: '&cYou sold no items!'
  type: ACTIONBAR

---

item-not-sellable

Shown when an item cannot be sold (price is 0 or not configured).

item-not-sellable:
  enabled: false
  message: '&cYou can not sell this item!'
  type: ACTIONBAR

---

item-worth

Shown when using the /worth command.

item-worth:
  enabled: true
  message: '&aYou can sell %item% for &e%worth%!'
  type: ACTIONBAR

Placeholders:

• %item% - Item name

• %worth% - Item's sell value

---

worth-display-disabled

Shown when a player tries to use a feature while worth display is off.

worth-display-disabled:
  enabled: true
  message: '&cWorth display is disabled!'
  type: ACTIONBAR

---

worth-display-enabled

Confirmation when worth display is enabled.

worth-display-enabled:
  enabled: true
  message: "&aWorth display enabled!"
  type: ACTIONBAR

Color Codes

Legacy Colors

Code	Color
&0	Black
&1	Dark Blue
&2	Dark Green
&3	Dark Aqua
&4	Dark Red
&5	Dark Purple
&6	Gold
&7	Gray
&8	Dark Gray
&9	Blue
&a	Green
&b	Aqua
&c	Red
&d	Light Purple
&e	Yellow
&f	White

Formatting Codes

Code	Effect
&l	Bold
&o	Italic
&n	Underline
&m	Strikethrough
&k	Obfuscated
&r	Reset

Hex Colors

Use #RRGGBB format for custom colors:

message: '#7dfb03This is green!'
message: '#ff6b6bThis is coral red!'
message: '#4ecdc4This is teal!'

Example Configurations

Minimal Messages

no-permission:
  enabled: true
  message: '&cNo permission!'
  type: CHAT

items-sold-title:
  enabled: true
  message: '&a+$%total%'
  type: ACTIONBAR

amount-sold-subtitle:
  enabled: false
  message: ''
  type: SUBTITLE

no-items-to-selling:
  enabled: false
  message: ''
  type: ACTIONBAR

item-not-sellable:
  enabled: false
  message: ''
  type: ACTIONBAR

item-worth:
  enabled: true
  message: '&7Worth: &e%worth%'
  type: ACTIONBAR

Detailed Messages

no-permission:
  enabled: true
  message: '&c&l[!] &cYou don''t have permission to use this command!'
  type: BOTH

items-sold-title:
  enabled: true
  message: '#55ff55&lSOLD!'
  type: TITLE

amount-sold-subtitle:
  enabled: true
  message: '&f%items% items for &a$%total%'
  type: SUBTITLE

no-items-to-selling:
  enabled: true
  message: '&eNo items were sold. Put items in the GUI first!'
  type: CHAT

item-not-sellable:
  enabled: true
  message: '&cThis item cannot be sold!'
  type: ACTIONBAR

item-worth:
  enabled: true
  message: '&6[Worth] &f%item% &7sells for &a$%worth%'
  type: CHAT

Tips

1. Disable unused messages - Set enabled: false for cleaner experience

2. Use appropriate types - Titles for important info, action bar for quick feedback

3. Keep it concise - Short messages are easier to read

4. Test colors - Join the server to verify colors look correct

5. Escape quotes - Use '' for single quotes in YAML

---