Skip to main content

Achievements

info

There are two types of achievements:

  • CHALLENGE: Single tier
  • TIERED: Multiple tiers

The type is automatically determined by the number of tiers.

note

Achievements are located in the plugins/EpicAchievements/achievements/<category> folder.
You can have as many achievement files as you want in a category.

Required Fields​

type​

You can find all available task types here.

type: FISH

name​

The achievements's name, displayed in messages and menus.

name: "Lucky Catch"

description​

The achievement's description, displayed in messages and menus.

description:
  - "&fCatch an enchanted book"
  - "&fwhile fishing."

tiers​

A list of tiers, where each tier is identified by a unique number.
At least one tier is required.

  • required-amount: The amount of progress required to complete the tier.
  • rewards: A list of rewards for completing the tier. Click here for more information.
tiers:
  1:
    required-amount: 1
    rewards:
      - type: points
        amount: 5
  2:
    required-amount: 5
    rewards:
      - type: points
        amount: 10

Optional Fields​

weight​

The achievement's weight. Used to determine the default sorting order in menus.
Default: 1

weight: 5

permission​

A permission required to access the achievement.
Default: None

permission: "achievements.lucky-catch"

hidden​

If set to true, the achievement will be hidden from menus and kept secret.
Default: false

hidden: true

requirements​

Players must complete these achievements before they can access this achievement.
Default: None

Valid formats:

  • <id> - Requires all tiers of the achievement to be completed.
  • <id>:<tier> - Requires the specified tier of the achievement to be completed.
requirements:
  - "miner"
  - "farmer:3"

conditions​

A list of conditions that must be met in order to complete the achievement.
Click here for more information.

conditions:
  - type: game_modes
    game-modes:
      - SURVIVAL
  - type: items
    items:
      - ENCHANTED_BOOK

settings​

Additional settings for the achievement.

toast-message: Overrides the default toast message set in config.yml (Requires CrazyAdvancementsAPI)

  • icon: The icon displayed in the toast.
  • message: The message displayed in the toast.
  • type: You can choose between CHALLENGE, TASK or GOAL.
settings:
  toast-message:
    icon: ENCHANTED_BOOK
    message: "Custom toast message!"
    type: CHALLENGE

Example Configuration​

achievements/survival/challenges.yml
# Unique identifier. Don't modify it or players will lose their progress!
lucky-catch:
  type: FISH
  name: "Lucky Catch"
  description:
    - "&fCatch an enchanted book"
    - "&fwhile fishing."
  settings:
    toast-message:
      icon: ENCHANTED_BOOK
      message: "Custom toast message!"
      type: CHALLENGE
  conditions:
    - type: game_modes
      game-modes:
        - SURVIVAL
    - type: items
      items:
        - ENCHANTED_BOOK
  tiers:
    1:
      required-amount: 1
      rewards:
        - type: points
          amount: 5