Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
MythicAchievements MythicAchievements
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 7
    • Issues 7
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • Packages & Registries
    • Packages & Registries
    • Package Registry
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • MythicCraft
  • MythicAchievementsMythicAchievements
  • Wiki
  • Usage

Usage · Changes

Page history
Create Usage authored Aug 16, 2022 by Ashijin's avatar Ashijin
Hide whitespace changes
Inline Side-by-side
Showing with 62 additions and 0 deletions
+62 -0
  • Usage.md Usage.md +62 -0
  • No files found.
Usage.md 0 → 100644
View page @ b50536b9
Custom achievements are created using simple `.yml` files, and anyone familiar with Mythic syntax should be able to pick up on how it works pretty quickly!
## File Locations
MythicAchievements will load achievements from 2 places:
* The `Achievements` folder in the MythicAchievements plugin directory
* Any `Achievements` folder in a Mythic pack (located in the MythicMobs plugin directory)
Inside these folders you can have as many `.yml` files as you want, including inside other folders, allowing you to organize it however you want. The plugin will read all the files to load everything.
## Syntax
First, here's an overview of all the options:
```
KEY:
Display: 'the display name'
Description: 'the description'
Category: [CATEGORY_KEY]
Parent: [PARENT_ACHIEVEMENT_KEY]
Frame: [CHALLENGE/GOAL/TASK]
Icon:
Material: [MATERIAL]
Criteria:
SOME_KEY_NAME_YOU_CHOOSE:
Type: [CRITERIA_TYPE]
#
# other criteria-related options
#
Reward:
Message: 'A message displayed when they complete it!'
Drops:
- [ a Mythic drop table]
Skills:
- [ some skills ran when the achievement is completed ]1
```
## Examples
In this example achievement, the player can earn it by killing 5 skeletons at night, but it's only available if they have completed the achievement `SOME_OTHER_ACHIEVEMENT`!
Upon completing, they will receive 50 cobblestone as a reward.
```
SKELETON_HUNTER:
Display: 'Skeleton Hunter'
Description: 'Kill 5 Skeletons at Night'
Category: SPECIAL
Parent: SOME_OTHER_ACHIEVEMENT
Frame: CHALLENGE
Icon:
Material: SKELETON_SKULL
Criteria:
KILL:
Type: KILL_MOB_TYPE
EntityType: SKELETON
Amount: 5
Conditions:
- night
Reward:
Message: 'You did it! You killed 5 skeletons at night!'
Drops:
- 50 cobblestone
Skills: []
```
\ No newline at end of file
Clone repository

Achievements

  • Home
  • Changelogs
  • Commands and Permissions
  • FAQ / Common Issues

Usage

  • Installation
  • Categories (Tabs)
  • Creating Achievements
  • Criteria
  • Rewards

New Mechanics

  • Achievement Mechanics
  • Achievement Conditions