Milestones

Milestones are long term goals grouped in categories: mine a million blocks, reach prestige 1, earn a billion. Each one has rewards claimed from the menu or automatically.


Configuration	`milestones.yml`
Menus	`menus/milestones.yml` (categories), `menus/milestone-category.yml` (milestones)
Command	`/milestones` (aliases `/milestone`, `/logros`)
Module	`milestones`

Configuration

yaml

settings:
  check-seconds: 30        # how often online players are checked
  show-rewards: true       # message with reward-display on claim

categories:
  mining:
    enabled: true
    name: "@milestones.names.mining"
    icon: DIAMOND_PICKAXE
    slot: 11
    milestones:
      blocks-1k:
        name: "@milestones.names.blocks-1k"
        description: "@milestones.names.blocks-description"
        icon: COBBLESTONE
        type: blocks-mined
        goal: 1000
        rewards:
          - "[give] tokens 500"
          - "[sound] UI_TOAST_CHALLENGE_COMPLETE 1 1"
        reward-display: "&e500 tokens"
      blocks-50k:
        icon: IRON_ORE
        type: blocks-mined
        goal: 50000
        requires:
          - blocks-1k
        rewards:
          - "[give] tokens 25000"
        reward-display: "&e25,000 tokens"
      pickaxe-25:
        icon: GOLDEN_PICKAXE
        type: pickaxe-level
        goal: 25
        auto-claim: true
        rewards:
          - "[give] tokens 5000"
        reward-display: "&e5,000 tokens"

Option	Does
`type` · `goal`	What is measured and the value to reach
`rewards`	Actions on claim, with `{player}` and `{milestone}`
`reward-display`	Reward text in the menu and in the `milestones.received` message
`requires`	Milestones that must be claimed first (`id` or `category.id`)
`auto-claim`	Claimed automatically when reached

Types

Type	Measures
`blocks-mined`	Blocks mined with the pickaxe
`pickaxe-level`	Pickaxe level
`level:<track>`	Level of a `levels.yml` track
`prestige` · `rebirth`	Prestiges or rebirths
`balance:<currency>`	Current balance
`currency-earned:<currency>`	Total earned since the system was installed
`enchant-level:<enchant>`	Level of an enchant
`private-mine-stage`	Private mine stage
`autominer-blocks`	Blocks mined by the autominer
`profile:<key>`	Any number in the player profile
`placeholder:<%papi%>`	Any numeric PlaceholderAPI placeholder

With placeholder: you can measure anything from another plugin: votes, hours played, bosses killed.

How they are claimed

Every check-seconds online players are checked. A ready milestone is announced once, and auto-claim ones claim themselves. The rest are claimed by clicking in the menu.

Commands

Command	Permission	Does
`/milestones`	everyone	Category menu
`/milestones reset <player> [category.milestone]`	`pulseprison.milestones.admin`	Resets one or all
`/milestones reload`	`pulseprison.milestones.admin`	Reloads `milestones.yml`