Knowledge base

Projects / Getting Started with WowAce


Creating a new project

Go to the home page and click "Create a new Project" near the top.

You'll see a big, scary form with lots of fields.

  • Name: Choose a name for your project. This can be anything. Try to be original but also declarative.
  • Short Name: This is a unique identifier for your project. This will be unique for all of WoW, including all projects on This is what shows up in all urls as well. Must be all lowercase letters, numbers, -, and _.
  • License: There are many open source licenses to choose from, as well as Public Domain and No license (All rights reserved). You may also specify a custom license. If you believe a custom license deserves to be standard, just report it or tell an admin.
  • Category: Choose up to 5 categories that your project falls under. Worst case scenario, go with Miscellaneous.
  • Localized Languages: Choose which languages that your addon has been translated into already. If your addon has no translations, just choose English.
  • Description: This is the description of your project. A feature list is good here. Do not state that your project is similar to another project without describing what it actually does.
  • Comments: Whether you want to have comments available on your project.
  • Bugtracker: Whether you want to use wowace's provided bug tracker.
  • Clonability: Whether a non-author can clone your project's mainline repository to do their own hacking. All open-source licenses require full clonability. For information on cloning, see Cloning.

Fill out all this information and you should be golden.

Our moderators will decide whether to approve your project or not, and if they do approve it, the general public will be able to view your project. For information on approval, see Project Acceptance Policy.

Claiming an existing project

If a project was yours before the new site transition and you are no longer the owner of it, go to the project page and click "Report Project" on the right. Fill out your details and a moderator will take care of the situation as soon as they can.

Editing an existing project

Go to the project page you want to go to, on the right-hand side, there will be "Edit Project".

You can change most of the same data as in creating a project.

There are two things that you can't change from this view:

  • Short name. Report your project or tell a moderator that you want your short name changed.
  • Description. On the project page, click "Edit Description" on the right. Also see Changing Descriptions

Setting up your repository

If your project was imported from the old wowace, your SVN repository should be set up and ready to go for you already.

Otherwise, go to your project, go to Repositories, click Edit Repository, set the type you want and any other details.

Set up your SVN password and/or SSH key. Go to Your Repository Authorization page.

See the Repository FAQ for more in-depth details.