49
edits
| (45 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{uiaddonstudio}} | {{uiaddonstudio}}{{#vardefine:EDITION|2010}}<!-- | ||
'''AddOn Studio | {{NYR|Early {{#var:EDITION}}.<br/>See the [[#Preview|Preview section]] below for pre-release versions.}}--> | ||
'''AddOn Studio {{#var:EDITION}} for World of Warcraft''' is a fully-featured development environment for creating and | |||
developing [[wo:AddOn|AddOn]]s for World of Warcraft. [[AddOn Studio]] features a professional [[wo:Lua|Lua]] editor | |||
with full code-completion and other modern facilities, an integrated visual [[wo:User interface|WoW UI]] designer, | |||
SVN code repository support, project based [[wo:AddOn]] file management and deployment, and much more. | |||
[[File:AddOn Studio | [[File:AddOn Studio {{#var:EDITION}} for World of Warcraft.png|x280px|right|AddOn Studio {{#var:EDITION}} for World of Warcraft]] | ||
To get started follow the [[#AddOn Studio | To get started follow the [[#AddOn Studio {{#var:EDITION}}|steps below]]. Feel free to visit the following pages for more | ||
information and help. Twitter: [//addonstudio.org/wow/twitter @AddonStudioWoW]. Documentation: | |||
[[#Getting started|Getting Started]]. History: [[AddOn Studio for World of Warcraft history|Release History]]. | |||
WoW API: [[wo:development|UI Customization]]. Support and Discord: [//addonstudio.org/wow/support AddOn Studio Discord]. | |||
Issues: [//addonstudio.org/wow/issues GitHub]. Donations: [//addonstudio.org/wow/donate PayPal]. | |||
== AddOn Studio | == AddOn Studio {{#var:EDITION}} == | ||
<span id="Install"></span>What you need: | <span id="Install"></span><span id="install"></span> | ||
=== What you need === | |||
<div class="dt-ol"> | |||
# '''Visual Studio {{#var:EDITION}} Shell (free), using this link:''' | |||
#* {{elink|site=Microsoft.com - Visual Studio 2010 Shell (Isolated)|link=https://my.visualstudio.com/Downloads?q=shell%202010|style=display:inline}} | |||
#*:''Link requires login. Choose 'Visual Studio 2010 Shell (Isolated)' and 'DVD'.'' | |||
# '''Service Pack 1 for Visual Studio 2010:''' | |||
#* {{elink|site=Microsoft.com - Visual Studio 2010 SP1|link=//my.visualstudio.com/Downloads?q=visual%20studio%202010%20with%20service%20pack%201<!--//www.microsoft.com/downloads/en/details.aspx?FamilyID=75568aa6-8107-475d-948a-ef22627e57a5&displaylang=en-->|style=display:inline}} | |||
#*:''Choose 'Visual Studio 2010 with Service Pack 1'. This is actually just the Service Pack 1.'' | |||
# '''AddOn Studio {{#var:EDITION}} for WoW:''' | |||
#* {{release|AddOn Studio {{#var:EDITION}}|AddOnStudio|WoW||3.0.251028.0|10/28/2025}}<!--{{NYR-item}}<br/> see [[#Preview|Preview]] below.--><br /> | |||
#*:''Release notes are currently being published on [//addonstudio.org/wow/discord Discord] in the #News section.'' | |||
# '''Follow these instructions:''' | |||
#* '''[[#Getting started|Install and Getting Started]]''' | |||
</div> | |||
=== Other installs and downloads === | |||
Current version: | |||
* {{release-5|AddOnStudio|WoW||3.0.251028.0|10/28/2025}} | |||
<span id="Beta"></span><span id="Preview"></span> | |||
<!-- Preview: | |||
* {{release-5|AddOnStudio|WoW|(Preview 3)|3.0.230904.0|9/04/2023}} | |||
--> | |||
Previous versions: | |||
* {{release-5|AddOnStudio|WoW||3.0.251019.0|10/19/2025}} | |||
* {{release-5|AddOnStudio|WoW||3.0.231009.0|10/09/2023}} | |||
* {{release-5|AddOnStudio|WoW|(Preview 3)|3.0.230904.0|9/04/2023}} | |||
* {{release-5|AddOnStudio|WoW|(Preview 2)|3.0.230831.0|8/31/2023}} | |||
* {{release-5|AddOnStudio|WoW|(Preview 1)|3.0.230823.0|8/23/2023}} | |||
* {{release-4|AddOnStudio|WoW||3.0.220514.0|5/14/2022}} | |||
* {{release-4|AddOnStudio|WoW||3.0.220407.6|4/28/2022}} | |||
* {{release-4|AddOnStudio|WoW||3.0.220325.0|3/25/2022}} | |||
<div width="50%"> | |||
:''Alternate file download services graciously donated by '[//www.thecorehosting.net The Core Hosting]' internet hosting [[File:LogoTheCoreHostingx31h.png|The Core Hosting|link=//www.thecorehosting.net]]<br/></div> | |||
Optional: | Optional: | ||
* Blizzard Interface ToolKit:<br /> [[File:Blizz.gif]] [[wo:Interface AddOn Kit|World of Warcraft Interface AddOn Kit]]<!--{{elink|prefix=Blizzard Interface ToolKit:<br />|icon=blizzus|site=Blizzard Support (US) - World of Warcraft Interface AddOn Kit|link=//us.blizzard.com/support/article.xml?locale=en_US&articleId=21466&pageNumber=1|style=display:inline}}--> | |||
* Blizzard Interface ToolKit:<br /> [[File:Blizz.gif]] [[Interface AddOn Kit|World of Warcraft Interface AddOn Kit]]<!--{{elink|prefix=Blizzard Interface ToolKit:<br />|icon=blizzus|site=Blizzard Support (US) - World of Warcraft Interface AddOn Kit|link=//us.blizzard.com/support/article.xml?locale=en_US&articleId=21466&pageNumber=1|style=display:inline}}--> | |||
Other editions: | Other editions: | ||
* {{NYR-item|NYR}} [[AddOn Studio 2022 for WoW]] - 64-bit, windows 7 and 10 only. same wow features | * <!--{{NYR-item|NYR}}--> [[AddOn Studio 2022 for WoW]] - 64-bit, windows 7 and 10 only. same wow features | ||
* [[AddOn Studio 2015 for WoW]] - newer look, enhanced editing, larger install. same wow features | * [[AddOn Studio 2015 for WoW]] - newer look, enhanced editing, larger install. same wow features | ||
Release information: | |||
* [[AddOn Studio for World of Warcraft history|AddOn Studio for WoW release history]] | |||
* | * [//addonstudio.org/wow/readme AddOn Studio for WoW requirements] | ||
== Recent features == | |||
:''See [[AddOn Studio 2022 for World of Warcraft | :''See [[AddOn Studio 2022 for World of Warcraft|AddOn Studio 2022 for WoW]] for more information on newer {{#var:EDITION}} features.''<span id="gettingstarted"></span><span id="Getting_Started"></span><span id="Getting Started"></span><span id="Getting started"></span> | ||
== Getting | == Getting started == | ||
; Initial installation: | |||
# Download and install the Visual Studio Shell above | |||
#* ''Choose the {{#var:EDITION}} version, en-US is English.'' | |||
* Copy the folder 'AddOn Studio for WoW | # Download and install the Visual Studio SP1 above | ||
* Run | # Download AddOn Studio {{#var:EDITION}} for World of Warcraft | ||
#* ''Open the downloaded ''''.zip'''' or ''''.7z'''' file'' | |||
#* ''Copy the folder ''''AddOn Studio for WoW {{#var:EDITION}}'''' to any location you like,<br/>such as: <!--'c:\Program Files', or -->'d:\apps', or your Desktop'' | |||
#* ''Run ''''WowAddonStudio.exe''''. Or, create a short-cut and run that instead.'' | |||
;Updating: | |||
# Rename or delete the installed 'AddOn Studio for WoW {{#var:EDITION}}' folder. | |||
# Follow the Installation steps above, skipping the Visual Studio Shell and SP1 install portion. | |||
;Basic usage: | |||
# Create a new Project | |||
# Add existing files or create new ones | |||
# Deploy to WoW by clicking 'Build' | |||
# Run WoW or use '/reload' to use your AddOn... | |||
;Support: | |||
* | * [[AddOn Studio for World of Warcraft documentation|AddOn Studio documentation]] and Quick Start Guide | ||
* [//discord.gg/eAGb7Rc AddOn Studio] on Discord, [//addonstudio.org/wow/issues Issue Tracker on GitHub], and [[AddOn Studio for WoW history|Release History]] | |||
* [[AddOn Studio {{#var:EDITION}} for WoW Demo]] media | |||
* '''If you are having trouble, try running the 'clean.cmd' in the install folder.''' | |||
== Product history == | |||
:''See [[AddOn Studio for WoW]] for a list of all editions, and [[AddOn Studio for WoW history|release history]] for detailed changes for each release.'' | |||
'''AddOn Studio {{#var:EDITION}} for World of Warcraft''' is an edition of the [[AddOn Studio for World of Warcraft]] | |||
'''AddOn Studio | series, built with Visual Studio {{#var:EDITION}}. | ||
Other editions exist, like [[AddOn Studio 2015 for World of Warcraft]], based on Visual Studio 2015. Both this version and the 2015 version will be updated and supported together, to give users a choice of which style, platform support, and functionality they are more comfortable with. | Other editions exist, like [[AddOn Studio 2015 for World of Warcraft]], based on Visual Studio 2015. Both this version | ||
and the 2015 version will be updated and supported together, to give users a choice of which style, platform support, | |||
and functionality they are more comfortable with. | |||
;Today's Reality | |||
The concepts for game and AddOn development, especially for WoW, are far more understood today and by a much larger audience, than they were at the time of the original [[ | The concepts for game and AddOn development, especially for WoW, are far more understood today and by a much larger audience, | ||
than they were at the time of the original [[wowwiki:World of Warcraft|World of Warcraft]]. | |||
Likewise, some of [[AddOn Studio|AddOn Studio's]] original features, like pure drag-and-drop UI building and wizard oriented development, were historically more useful for those just getting stared, or veterans who were committed to Blizzard's [[wo:Frame XML|Frame XML]] for UI layout. | |||
What this product really always was, and is, is a general, modern and well-featured [[wikipedia:Integrated_development_environment|IDE]] for WoW AddOn development, using a free Visual Studio back-end (much like the free Express and Community versions of Visual Studio for C#, C++ and the Web), with additional support for graphical frame development. There are quite a few bells and whistles too, including supporting nearly every VS integration feature available, which would be rare for a game production tool of any kind. This all together threatens to make AddOn development tools first class citizens, in a world where that almost never happens. | What this product really always was, and is, is a general, modern and well-featured [[wikipedia:Integrated_development_environment|IDE]] for WoW AddOn development, using a free Visual Studio back-end (much like the free Express and Community versions of Visual Studio for C#, C++ and the Web), with additional support for graphical frame development. There are quite a few bells and whistles too, including supporting nearly every VS integration feature available, which would be rare for a game production tool of any kind. This all together threatens to make AddOn development tools first class citizens, in a world where that almost never happens. | ||
; What Changed | |||
New features and changes for the AddOn Studio | New features and changes for the AddOn Studio {{#var:EDITION}} edition on initial release: | ||
* Support for the installer was dropped - Installers, especially for a VS shell product are fragile and non-trivial, and because of this would require more traditional packaging and release QA than is practical. This was one of the biggest headaches faced with 1.0 and 2.0 versions, which had a history of leaving most first time users stranded at some point. Instead, a great deal of work in this version, was put into making a more sustainable 'portable install' style product, where you just drop the files and run it. Any remaining setup actions are detected automatically and run at startup. The 'reset.cmd' can be run any time, after closing AddOn Studio, to 'reinstall' and restart automatic setup. | * Support for the installer was dropped - Installers, especially for a VS shell product are fragile and non-trivial, and because of this would require more traditional packaging and release QA than is practical. This was one of the biggest headaches faced with 1.0 and 2.0 versions, which had a history of leaving most first time users stranded at some point. Instead, a great deal of work in this version, was put into making a more sustainable 'portable install' style product, where you just drop the files and run it. Any remaining setup actions are detected automatically and run at startup. The 'reset.cmd' can be run any time, after closing AddOn Studio, to 'reinstall' and restart automatic setup. | ||
* Support for Visual Studio 'Web Projects' was added - Support was added in this rendition of AddOn Studio for basic web project support for 'existing web sites'. This translates into getting full-support editing support for html and other web related file formats, and for opening a 'flat view' as a separate project of any folder with full Lua and Web type file support, including your own project or cluster of projects, the WoW Interface or other folders, or other locations. This also translates to allowing a multi-project environment where you can potentially edit your AddOn website or other related site to your development or support in the same IDE that you are editing your AddOns, which for some should enhance productivity greatly. Support is also included for the automatic Web Project mini-webhost, so you can run the changes locally before deploying. You can use any arbitrary existing folder, ftp, http address as an existing site. This feature also allows folders, like from the WoW Tool Kits, to be added as a project on demand, and browsed inside the project explorer. And starting with AS WoW 2010, allows both modern Lua editing and viewing as well as FrameXML .xml files to be viewed in a designer window letting you see what they look like right there. | |||
; What Works | |||
Short list covering major historical issues addressed in AddOn Studio {{#var:EDITION}} for WoW. | |||
Short list covering major historical issues addressed in | |||
Updated Support: | Updated Support: | ||
* Includes support for current versions of WoW, originally released with support for [[ | * Includes support for current versions of WoW, originally released with support for [[wowwiki:Cataclysm|Cataclysm]], [[wowwiki:Mists of Pandaria|Mists of Pandaria]] - This includes 50400 version and later features, as well as continuing support for WoW Mists, Cataclysm, and earlier game content files, and Blizzard interface 'toolkits'. Support for new WoW releases is ongoing. Fixes for allowing the proper handling of file lock contention and coherency between WoW itself and AddOn Studio, and allowing both to peacefully run side-by-side no matter which you start first. Also works with partial updates, via the new WoW patch and content update processes. | ||
* SCC Integration for SVN - the new product includes an optional, integrated, and functional version of [//ankhsvn.open.collab.net/ AnkhSVN], with full support for all context menus. There is tested support for addon upload, download, and author services sites like {{link-curseforge}} and {{link-wowace}}. Plays nicely with [http://tortoisesvn.tigris.org/ TortoiseSVN] where you can use both of these at the same time and at will. If there is interest in using TFS or others like [//www.visualsvn.com/ VisualSVN], [//git-scm.com/ GIT], [//mercurial.selenic.com/ Mecurial], etc... please let me know. | * SCC Integration for SVN - the new product includes an optional, integrated, and functional version of [//ankhsvn.open.collab.net/ AnkhSVN], with full support for all context menus. There is tested support for addon upload, download, and author services sites like {{link-curseforge}} and {{link-wowace}}. Plays nicely with [http://tortoisesvn.tigris.org/ TortoiseSVN] where you can use both of these at the same time and at will. If there is interest in using TFS or others like [//www.visualsvn.com/ VisualSVN], [//git-scm.com/ GIT], [//mercurial.selenic.com/ Mecurial], etc... please let me know. | ||
| Line 101: | Line 135: | ||
* [[AddOn Studio 2022 for WoW]] - alternate edition, based on Visual Studio 2022 | * [[AddOn Studio 2022 for WoW]] - alternate edition, based on Visual Studio 2022 | ||
* [[AddOn Studio for WoW | * [[AddOn Studio for WoW documentation]] - getting started, details for installation and setup | ||
* [[AddOn Studio for WoW | * [[AddOn Studio for WoW history]] - effective release history with changes and notes | ||
* [[AddOn Studio | * [[AddOn Studio {{#var:EDITION}} for WoW Demo]] | ||
* [[WoWBench]] - WoWBench WoW Lua run-time simulation, including events, frames | * [[WoWBench]] - WoWBench WoW Lua run-time simulation, including events, frames | ||
* [[Viewing Blizzard's WoW user interface code]] | * [[wo:Viewing Blizzard's WoW user interface code|Viewing Blizzard's WoW user interface code]] | ||
* [[Extracting WoW user interface files]] | * [[wo:Extracting WoW user interface files|Extracting WoW user interface files]] | ||
== External links == | == External links == | ||
;Support | ;Support | ||
{{elink|site= | {{elink|site=AddOnStudio.org|link=//addonstudio.org/wow/support|desc=AddOn Studio for WoW Issue Tracker and Forums}} | ||
;News | ;News | ||
{{elink|icon=twitter|site=Twitter|link=// | {{elink|icon=twitter|site=Twitter|link=//addonstudio.org/wow/twitter|desc=@AddOnStudioWoW feed}} | ||