WoW CustomTutorials-2.0 addon Dragonflight/Wrath of the Lich King Classic 2023
wow addon CustomTutorials-2.0


Game Version: 4.0.3a
Total Downloads: 2,361
Updated: Jan 30, 2011
Created: Feb 28, 2010
download CustomTutorials-2.0Download Earlier Versions

Earlier Versions

Name Size Uploaded Game Version Downloads
5 release 3.51 KB Jan 30, 2011 4.0.3a 1,736 download CustomTutorials-2.0 5 releaseDownload
3 release 3.44 KB Jan 12, 2011 4.0.3a 142 download CustomTutorials-2.0 3 releaseDownload
2 release 3.42 KB Dec 28, 2010 4.0.3a 116 download CustomTutorials-2.0 2 releaseDownload
1 release 3.42 KB Nov 20, 2010 4.0.3 175 download CustomTutorials-2.0 1 releaseDownload
1 release 2.86 KB Mar 4, 2010 3.3.0 192 download CustomTutorials-2.0 1 releaseDownload



Share this:

This library makes easy the creation of custom tutorials for your addons. It provides the following API:

  • .RegisterTutorials(id, data)
  • .TriggerTutorial(id, index, force)
  • .ResetTutorials(id)
  • .GetTutorials(id)


The easiest way to access CustomTutorials methods is to embed them into your addon object:

local Tutorials = LibStub("CustomTutorials-2.0")

But you may also set CustomTutorials as a local variable and call the methods directly.

Tutorials.RegisterTutorials("MyTutorial", {
  -- data goes here


First of all, you must register the new tutorials for you addon:

  savedvariable = "MyAddon_TutorialsSavedVariable",
  title = "MyAddons",
  {  -- This is tutorial #1
    text = "Hello",
    image = "SomeImage",
  {  -- Tutorial #2
    text = "Bye",

Currently, these are the arguments supported for the registering table (General) and for each tutorial (all of them are optional):

General Arguments
savedvariable If set, CustomTutorials will memorize which tutorials the user has already seen between sessions and manage which to show for you
title If set, it is used as the default title when not provided for the tutorial itself
Tutorial Arguments
textX, textY
imageX, imageY
shine The frame to anchor the flashing "look at me!" glow
shineTop, shineBottom, shineLeft, shineRight
height CustomTutorials should be able to manage the window height most cases for you, but you can set it yourself.
anchor Which frame to anchor the tutorial window (defaults to UIParent)
point Which point to anchor the tutorial with (defaults to Center)
relPoint Which point to anchor the tutorial to (if not provided, will use point instead)
x, y


Finally, you need to tell CustomTutorials when you want the tutorials to be shown. If you provided the savedvariable argument, you won't have to worry about which ones the user has already seen neither to save that information. CustomTutorials will handle that for you:

-- Shows up to tutorial #3 if the user has not seen it already
-- Shows tutorial #3. Yeah, you forced it.
MyAddon:TriggerTutorial(3, true)


This example registers 3 tutorials; shows tutorial #1 when the user loads the addon for the first time; shows tutorials #2 and #3 when MyAddon_OnSomeEvent is called for the first time; and allows the user to see the tutorials again when MyAddon_OnHelpRequest is called.

MyAddon:RegisterTutorials( {
  savedvariable = "MyAddon_TutorialsState",
    text = "Welcome to MyAddon",
    shine = MyAddon,
    text = "This is helpfull",
    text = "I hope you enjoyed this tutorial example.",
    image = 'ByeImage',

function MyAddon_OnInitialize()
  -- Show welcome

function MyAddon_OnSomeEvent()
  -- Show #2 and unlock #3

function MyAddon_OnHelpRequest()
  -- Show tutorials again when the user asks
  MyAddon:TriggerTutorial(1, true)


Add a comment