rdw-archive / AltMastery

Account-wide tasks and goals/milestones management addon for World of Warcraft: Legion
0 stars 0 forks source link

AltMastery - Repeatable Tasks & Milestones Management

AltMastery is a flexible tool designed to help manage repeatable tasks, track long-time progress towards milestones and reach personal goals of many kinds. In other words, if you're looking for an addon to check off your daily TODO list - this is it.

It aims to be highly configurable and most importantly, automatic, allowing you to spend more time playing the game and achieving things rather than reserving mental capacities for and waste time on managing the organizational aspects of your ingame activities.

This is especially helpful for players with multiple alts (hence the name), but there's many ways to benefit from proper planning of your day-to-day for even just one character. If you're addicted to checking off boxes, chasing goals, and completing things you'll have much more freedom to do just that... and aren't we all? ;)

Features

The addon comes with three key features you should understand in order to use it efficiently. This basic design helps to keep things relatively simple and intuitive, but nevertheless having an idea of how to use each feature properly will allow you to adapt its functionality to your needs more easily.

Please understand that this document can only provide a brief overview. For a detailed list and explanation on how to use the more advanced features, feel free to browse the Wiki (currently a work-in-progress just a stub, so there's no point in checking out it yet).

Note: As the addon is still in the early phases of development, not all features are fully implemented yet! I decided to leave the design blueprint in here so everyone could give feedback and see what I've planned for the future. Features that aren't fully implemented yet are marked with a (NYI) tag for the time being.

Groups

Groups are the main structure used to organize your Tasks and Milestones. They can contain Tasks or other Groups, which means you get to customize the layout of your character's TODO lists in whichever way suits you best. A few of the things you can do with them are:

It should be said that Tasks and Groups are independent of each other; this means that Groups are used to organize tasks but they don't actually contain them. You can think of it more like containing a reference, so that Groups can be changed repeatedly and Tasks will not be deleted and can be re-used without difficulty, though they also need to be managed separately.

This extra step may seem unnecessary, but it makes restructuring Groups quite fast and responsive. It also enables you to add tasks you don't necessarily want to track right now, as they're stored in their own database and will be available for importing into groups whenever you wish to use them.

Tasks

Tasks are exactly what the name implies - some action you want to do or a goal you are trying to achieve, with Milestones being simply Tasks that track non-repeatable Criteria for each character. They may be organized in Groups and will be tracked and shown according to their respective Criteria. Some basic use cases:

Naturally, not all tasks need to be tracked - they're more like a menu of things you could track, from which you select those that you need to create your very own, delicious meals (the Groups).

If none are to your liking, you can always create new and custom solutions to track almost anything imaginable - even if it isn't supported out-of-the-box. Feel free to experiment!

Criteria

Critera are, simply put, conditions that need to be met before a group/task is being shown/hidden or (automatically) completed. They can consist of actual Lua code if you like to get fancy, but there are also numerous shortcuts and aliases installed for the most common tasks you might want to track, so that using them becomes fairly straight-forward.

Some currently implemented shortcuts (see Wiki for usage):

There are also meta-shortcuts, which allow interaction with the Tasks and Groups themselves:

More shortcuts will be added as they become necessary, such as:

Custom shortcuts are easily implemented; you can usually do it yourself (NYI: Will have to be done manually for now,a s there's no GUI for it yet). I am, however, open to adding something to the default criteria shipped with the addon if it makes sense. Just let me know if you think that something generally useful to most people is missing!

Slash Commands

Most things can easily be done using nothing but the provided Configuration interface (see below). ### Keybinds You may set a keybind to toggle the Tracker window for your convenience. This is found in the default Blizzard keybinding settings under Addons > AltMastery ### Configuration GUI The configuration GUI is implemented. However, there aren't too many settings at this point. ## Issues / Feature Requests While I try to monitor the comments on this page, I don't always get notified of them. Therefore, I kindly ask you to use the [Issue Tracker](https://wow.curseforge.com/projects/altmastery/issues) on the Project Site when appropriate (You can use the same Curse account you use to comment here for that). Alternatively, you can follow the addon's development on [GitHub](https://github.com/SacredDuckwhale/AltMastery), where a list of [Known Issues](https://github.com/SacredDuckwhale/AltMastery/issues) is available. The [Project Timeline](https://github.com/SacredDuckwhale/AltMastery/projects/1) allows you to see what is currently being worked on and when you can expect any given change to be implemented. ## Localization Localization will be added once the addon is ready for public distribution. There is little point in translating phrases while everything is still changing on a very frequent basis.