49
edits
AddOn Studio 2022 for World of Warcraft (source)
Revision as of 21:14, 16 November 2025
, 16 November 2025no edit summary
No edit summary |
|||
| (30 intermediate revisions by the same user not shown) | |||
| Line 10: | Line 10: | ||
information and help. Twitter: [//addonstudio.org/wow/twitter @AddonStudioWoW]. Documentation: | information and help. Twitter: [//addonstudio.org/wow/twitter @AddonStudioWoW]. Documentation: | ||
[[#Getting started|Getting Started]]. History: [[AddOn Studio for World of Warcraft history|Release History]]. | [[#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]. | 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]. | Issues: [//addonstudio.org/wow/issues GitHub]. Donations: [//addonstudio.org/wow/donate PayPal]. | ||
== AddOn Studio {{#var:EDITION}} == | == AddOn Studio {{#var:EDITION}} == | ||
<span | :''Important: AddOn Studio {{#var:EDITION}} unfortunately currently requires Visual Studio 17.12 or earlier. Below option automatically installs correct version. Works for new and along-side existing VS installs.'' | ||
<nomobile><span class="mw-collapsible mw-collapsed" data-expandtext="more info..." data-collapsetext="collapse more info..."><div class="mw-collapsible-content"> | |||
: Unfortunately due to certain bugs in all current versions of Visual Studio {{#var:EDITION}} 17.13 and 17.14, AddOn Studio currently requires any VS version before 17.13. The links below can be used for both for new or existing Visual Studio installs. For existing installs will work along-side any existing Visual Studio version, and will be found automatically by AddOn Studio. If you have Pro or Enterprise, you may alternatively revert in the Visual Studio Installer to the latest 17.12 version.<!--: Important (2/18/25, updated 4/05/25):''' Unfortunately there are issues currently with all versions of Visual Studio 2022 17.13 and 17.14. If you are on 17.12, or can revert to 17.12, please use 17.12 or earlier. Do NOT upgrade to 17.13 or 17.14 Preview. You may also install in-place of, or along-side, your current version one of the LTSC builds 17.10 being preferred most stable. If you are an existing VS user, then your existing Community, Pro, or Enterprise will work, so long as it is not 17.13 or 17.14. If you aren't sure, just run the script at the top of the list below, which will give you VS Community 17.10 LTSC, and which will also work along-side any other VS version if you have one already. Please visit the [https://discord.com/channels/637318438984876042/709647832956665896 AddOn Studio Discord] for more info.--> | |||
<div class="dt-ol"> | <div class="dt-ol"> | ||
# | # Original currently unsupprted VS install links: | ||
#* <s>{{elink|prefix=Visual Studio Community installer (1.6 MB):<br />|site=Microsoft.com - Visual Studio Community 2022|link={{asfiles-1|VisualStudioSetup_2022_Community_250525.exe}}|style=display:inline}}<!--{{elink|prefix=Visual Studio Community installer (1.6 MB):<br />|site=Microsoft.com - Visual Studio Community 2022|link={{asfiles-1|VisualStudioSetup_2022_Community_Preview_231124.exe}}|style=display:inline}}--> | |||
#*:''The exact installer stub from the download site. Just click run.'' | #*:''The exact installer stub from the download site. Just click run.''</s> | ||
#*:'''''-- or --''''' | |||
#* <s><!--{{elink|prefix=Visual Studio Community direct download link:<br />|site=Microsoft.com - Visual Studio Community 2022 Preview|link=https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&channel=Preview&version=VS2022&source=VSLandingPage&cid=2060&passive=false|style=display:inline}}-->{{elink|prefix=Visual Studio Community direct installer link:<br />|site=Microsoft.com - Visual Studio Community 2022|link=https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&channel=Release&version=VS2022|style=display:inline}} | |||
#*:''Just click run.''</s> | |||
#*:'''''-- or --''''' | #*:'''''-- or --''''' | ||
#* {{elink|prefix=Visual Studio | #* <s>{{elink|prefix=Main Visual Studio site:<br />|site=Microsoft.com - Visual Studio Community 2022|link=https://visualstudio.microsoft.com/vs/|style=display:inline}} | ||
#*:'' | #*:''Click 'Download Visual Studio' then click 'Community 2022', then run.''<!--''Click 'Download Visual Studio' then click 'Community 2022', then run.''--></s> | ||
#*:'''''-- or --''''' | #*:'''''-- or --''''' | ||
#* {{elink|prefix= | #* <s>{{elink|prefix=Visual Studio Downloads site:<br />|site=Microsoft.com - Visual Studio Community 2022|link=//my.visualstudio.com/Downloads?q=Community%202022|style=display:inline}} | ||
#*:''Click ' | #*:''Requires login. Click download on 'Visual Studio Community Preview', then run.''<!--''Requires login. Click download on 'Visual Studio Community', then run.''--></s> | ||
#*:'''''-- or --''''' | #*:'''''-- or --''''' | ||
#* {{elink|prefix=Visual Studio | #* <s>{{elink|prefix=Visual Studio older versions download site:<br />|site=Microsoft.com - Visual Studio Community 2022|link=//visualstudio.microsoft.com/vs/older-downloads/|style=display:inline}} | ||
#*:'' | #*:''Browse to 'Visual Studio Community 2022 Preview', then download. May require login.''<!--''Browse to 'Visual Studio Community 2022', then download. May require login.''--><br /></s> | ||
</div></div></span></nomobile><span id="Install"></span><span id="install"></span> | |||
=== What you need === | |||
<div class="dt-ol"> | |||
# '''Visual Studio {{#var:EDITION}}, using one of these install links:'''<!--'''Visual Studio {{#var:EDITION}} Community (free), using one of these install links:'''--> | |||
#* {{elink|prefix=Visual Studio Community (free) LTSC version 17.10 installer script (1.5 KB):<br />|site=Microsoft.com - Visual Studio Community 2022|link={{asfiles-1|get_shell_2022_250526.cmd}}|style=display:inline}} | |||
#*:''Installer script that runs the VS 2022 Community LTSC install. Just click run.'' | |||
#*:'''''-- or --''''' | #*:'''''-- or --''''' | ||
#* {{elink|prefix=Visual Studio | #* {{elink|prefix=Visual Studio Pro and Enterprise LTSC install links:<br />|site=Microsoft.com - Visual Studio 2022|link=https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history|style=display:inline}} | ||
#*:'' | #*:''Choose the appropriate 17.10 or 17.12 LTSC edition in the list, then click run.''<span id="Release"></span><span id="Instructions"></span> | ||
# '''AddOn Studio {{#var:EDITION}} for WoW:''' | # '''AddOn Studio {{#var:EDITION}} for WoW:''' | ||
#* {{release|AddOn Studio {{#var:EDITION}}|AddOnStudio|WoW||7.0. | #* {{release|AddOn Studio {{#var:EDITION}}|AddOnStudio|WoW||7.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.'' | #*:''Release notes are currently being published on [//addonstudio.org/wow/discord Discord] in the #News section.'' | ||
# '''Follow these instructions:''' | # '''Follow these instructions:''' | ||
| Line 40: | Line 51: | ||
=== Other installs and downloads === | === Other installs and downloads === | ||
Current version: | Current version: | ||
* {{release-5|AddOnStudio|WoW||7.0. | * {{release-5|AddOnStudio|WoW||7.0.251028.0|10/28/2025}} | ||
<span id="Beta"></span><span id="Preview"></span> | <span id="Beta"></span><span id="Preview"></span> | ||
<!-- Preview: | <!-- Preview: | ||
* {{release-5|AddOnStudio|WoW|(preview)|7.0.230831.0|8/31/2023}} | * {{release-5|AddOnStudio|WoW|(preview)|7.0.230831.0|8/31/2023}} | ||
--> | --> | ||
Recent previous versions: | |||
* {{release-5|AddOnStudio|WoW|( | * {{release-5|AddOnStudio|WoW||7.0.251019.0|10/19/2025}} | ||
* {{release-5|AddOnStudio|WoW||7.0. | * {{release-5|AddOnStudio|WoW||7.0.250905.0|9/05/2025}} | ||
* {{release- | * {{release-5|AddOnStudio|WoW||7.0.250728.0|7/28/2025}} | ||
* {{release-5|AddOnStudio|WoW||7.0. | <nomobile><span class="mw-collapsible mw-collapsed" data-expandtext="more info..." data-collapsetext="collapse more info..."><div class="mw-collapsible-content"> | ||
* {{release-5|AddOnStudio|WoW||7.0. | * {{release-5|AddOnStudio|WoW||7.0.250721.0|7/21/2025}} | ||
* {{release-5|AddOnStudio|WoW||7.0. | * {{release-5|AddOnStudio|WoW||7.0.250716.0|7/16/2025}} | ||
* {{release- | * {{release-5|AddOnStudio|WoW||7.0.250627.0|6/27/2025}} | ||
* {{release- | * {{release-5|AddOnStudio|WoW||7.0.250620.0|6/20/2025}} | ||
* {{release- | * {{release-5|AddOnStudio|WoW||7.0.250405.0|4/05/2025}} | ||
* {{release-5|AddOnStudio|WoW||7.0.250329.0|3/29/2025}} | |||
* {{release-5|AddOnStudio|WoW||7.0.250324.0|3/24/2025}} | |||
* {{release-5|AddOnStudio|WoW||7.0.250313.0|3/13/2025}} | |||
* {{release-5|AddOnStudio|WoW||7.0.250306.0|3/06/2025}} | |||
* {{release-5|AddOnStudio|WoW||7.0.241208.0|12/08/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240821.0|8/21/2024}} | |||
* <s>{{release-5|AddOnStudio|WoW||7.0.240819.0|8/19/2024}}</s> (removed) | |||
* <s>{{release-5|AddOnStudio|WoW||7.0.240817.1|8/17/2024}}</s> (removed) | |||
* {{release-5|AddOnStudio|WoW||7.0.240815.0|8/15/2024}} | |||
* <s>{{release-5|AddOnStudio|WoW||7.0.240814.0|8/14/2024}}</s> (removed) | |||
* {{release-5|AddOnStudio|WoW||7.0.240726.0|7/26/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240620.0|6/20/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240609.0|6/09/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240531.1|5/31/2024}} | |||
* <s>{{release-5|AddOnStudio|WoW||7.0.240530.0|5/30/2024}}</s> (removed) | |||
* {{release-5|AddOnStudio|WoW||7.0.240526.0|5/26/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240510.0|5/10/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240504.0|5/04/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.240302.0|3/02/2024}} | |||
* {{release-5|AddOnStudio|WoW||7.0.231124.0|11/24/2023}} | |||
</div></span></nomobile> | |||
<div width="50%"> | <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> | :''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: | |||
* 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}}--> | |||
Other editions: | Other editions: | ||
| Line 67: | Line 101: | ||
* [[AddOn Studio for World of Warcraft history|AddOn Studio for WoW release history]] | * [[AddOn Studio for World of Warcraft history|AddOn Studio for WoW release history]] | ||
* [//addonstudio.org/wow/readme AddOn Studio for WoW requirements] | * [//addonstudio.org/wow/readme AddOn Studio for WoW requirements] | ||
== Recent features == | == Recent features == | ||
| Line 111: | Line 142: | ||
: In memoriam of yesterday's full solar eclipse, is the new "Eclipse" Dark AS theme above, which mutes all of the overly bright IDE colors present in the normal VS 'Dark' theme. For some may make it much easier to focus on the code. The normal Visual Studio 'Dark' theme has many florescent style bright elements which are significantly brighter than the actual text edit window. This theme brings the brightness of all non-editor elements to 'at or below' the brightness of the editor window itself. A pre-built 'Eclipse (Solar)' with the "Solar" editor color scheme released the day before, is added for convenience. The can also now be imported on top of any theme, rather than just on 'Dark AS' as it was yesterday. | : In memoriam of yesterday's full solar eclipse, is the new "Eclipse" Dark AS theme above, which mutes all of the overly bright IDE colors present in the normal VS 'Dark' theme. For some may make it much easier to focus on the code. The normal Visual Studio 'Dark' theme has many florescent style bright elements which are significantly brighter than the actual text edit window. This theme brings the brightness of all non-editor elements to 'at or below' the brightness of the editor window itself. A pre-built 'Eclipse (Solar)' with the "Solar" editor color scheme released the day before, is added for convenience. The can also now be imported on top of any theme, rather than just on 'Dark AS' as it was yesterday. | ||
:''Themes Usage:<br/> Can be selected in 'Tools > Options > General'.''<span id="gettingstarted"></span><span id="Getting_Started"></span><span id="Getting Started"></span> | :''Themes Usage:<br/> Can be selected in 'Tools > Options > General'.''<span id="gettingstarted"></span><span id="Getting_Started"></span><span id="Getting Started"></span><span id="Getting started"></span> | ||
== Getting started == | == Getting started == | ||
; Initial installation: | ; Initial installation: | ||
# Download and install the Visual Studio Community {{#var:EDITION}} above | # Download and install the Visual Studio Community {{#var:EDITION}} above | ||
#* ''Must add the ''''.Net desktop development'''' workload'' | #* ''Must add the ''''.Net desktop development'''' workload'' | ||
#* ''Other defaults are fine'' | #* ''Other defaults are fine'' | ||
| Line 139: | Line 170: | ||
* [[AddOn Studio {{#var:EDITION}} for WoW Demo]] media | * [[AddOn Studio {{#var:EDITION}} for WoW Demo]] media | ||
* '''If you are having trouble, try running the 'clean.cmd' in the install folder.''' | * '''If you are having trouble, try running the 'clean.cmd' in the install folder.''' | ||
;Notes: | |||
* This 2022 edition does not work installed on 'exFAT' or 'FAT32' or any removable drives. The normal default Windows 'NTFS' is fine. AddOns and projects still work on any Windows disk format type or removable device as normally would. This is a limitation of VS 2022, and the AS 2010 or 2015 editions will work running off oher drive formats, a thumb drive or with the installed files being remote. | |||
* Does not work installed in 'Program Files' to allow support for use with "non-Administrator" windows accounts, which was a feature added by request. | |||
* Visual Studio 2022 17.8.x does not work due to issues/bugs in the Visual Studio core editor. You will need to roll-back to a previous VS 17.7.x version in the Visual Studio Installer or update to Visual Studio 17.9 or newer. | |||
== Product history == | == Product history == | ||
| Line 144: | Line 180: | ||
This 'AddOn Studio {{#var:EDITION}} for World of Warcraft' is a continuation of the previous [[AddOn Studio 2015 for World of Warcraft]] | This 'AddOn Studio {{#var:EDITION}} for World of Warcraft' is a continuation of the previous [[AddOn Studio 2015 for World of Warcraft]] | ||
edition, but built on Visual Studio {{#var:EDITION}}. Both the 'AddOn Studio 2010 for WoW' and 'AddOn Studio 2015 for WoW' editions will continue to | edition, but built on Visual Studio {{#var:EDITION}}. | ||
be updated in parallel in perpetuity. This gives users | |||
a choice of which IDE's style, platform support, and functionality they are more comfortable with. | Both the 'AddOn Studio 2010 for WoW' and 'AddOn Studio 2015 for WoW' editions will continue to be updated in parallel | ||
in perpetuity. This gives users a choice of which IDE's style, platform support, | |||
and functionality they are more comfortable with. | |||
;Today's Reality | ;Today's Reality | ||
The general concepts of game and AddOn development, especially for WoW itself, are far more well understood and by a larger audience today, than they were during the time of the original [[wowwiki:World of Warcraft|World of Warcraft]]. And since the introduction of AddOn Studio for WoW many games have come, and some gone, using Lua and similar game customization methods as WoW. With this the general expectations of quality in consumer level development tools has risen as well. | The general concepts of game and AddOn development, especially for WoW itself, are far more well understood and by a larger audience | ||
today, than they were during the time of the original [[wowwiki:World of Warcraft|World of Warcraft]]. | |||
And since the introduction of AddOn Studio for WoW many games have come, and some gone, using Lua and similar game customization methods as WoW. With this the general expectations of quality in consumer level development tools has risen as well. | |||
AddOn Studio {{#var:EDITION}} improves on the 2015 edition, with an even more advanced and complete set of IDE features, and is a powerful general IDE for WoW AddOn development. AoS uses a free Visual Studio back-end, with support for graphical [[wo:Frame XML|Frame XML]] AddOn development. One of AddOn Studio's goals is combine these together to help make WoW AddOn development tools real first class citizens, in a game tools world where that almost never happens. | AddOn Studio {{#var:EDITION}} improves on the 2015 edition, with an even more advanced and complete set of IDE features, and is a powerful general IDE for WoW AddOn development. AoS uses a free Visual Studio back-end, with support for graphical [[wo:Frame XML|Frame XML]] AddOn development. One of AddOn Studio's goals is combine these together to help make WoW AddOn development tools real first class citizens, in a game tools world where that almost never happens. | ||