此站点大量使用JavaScript。
请在您的浏览器中启用JavaScript。
正式服
PTR
10.2.7
PTR
10.2.6
Beta
AddonGet - lightweight command line updater for non-technical people [Mac and Windows]
来自 Camellia256
[Last Updated]：
2020/06/22
变更日志
补丁：8.3.0
目录
评分：
WARNING:
AddonGet and this guide has not been tested on a Mac yet because this author does not have one. If you want to help me test it, please contact me. You help is very welcome!
AddonGet is still new. Backup your addons folder before you use it, and use it at your own risk.
If you don't know about addons, please read
AddOns: How to Install and Maintain
by
Keldesh
first
See
ElvUI Addon Guide
by
Jaydaa
for information about ElvUI and Tukui Client
Introduction
For many, addon is an integral part of their WoW gameplay. But manually installing and updating addons is a daunting task, especially if you use 20, 30 or even 100+. For people who get addons from CurseForge, there is the Twitch App, which offers the ability to automate installation and update of addons from CurseForge.com. This is a vastly better experience than manual installations. But if you, like me, have the following problems:
Update:
Twitch Sells CurseForge to Overwolf
Twitch App is packed with many features not related to WoW. Although it can be configured to focus on WoW addons, I still hear people complaining it as "bloatware". And personally, I agree with them. One should not need such a behemoth when all he/she wants is to install and update WoW addons
The popular ElvUI, which I am one of the many users, is only available from tukui.org or Tukui Client (that does not support Mac yet). If you, like me, use it, then you'll have to either use two clients or resort to manual installations. For me, this is not good user experience
There are several existing projects on GitHub, such as
wow-addon-updater
(currently maintained by grrttedwards), that aim to solve the problems above. Some of those great projects support both Retail and Classic. However, they are often written in Python, Nodejs, and Go, which is not easy for many non-technical people to set up. (If these things sound like garbage to you, then you know what I mean when I say "not easy")
Introducing AddonGet
AddonGet is my attempt to solve the above problems. It features
Lightweight and not buggy. The script itself takes up less than 40KB
Easy install and guide configuration
Support both Windows 10 and macOS
Support both CurseForge and Tukui
Support automatic installation and update
Support WTF folder backup
Below are some screenshots showing AddonGet in action
List installed addons
Update addons
Sounds interesting? Wanna give it a try? Then please follow me. In the next section I'll try my best to help you setting up and using AddonGet in ways that even non-technical people can easily follow. (I hope so, but if you think otherwise, please comment and tell me what should be improved. Your suggestions are very welcome!)
Now, let's begin.
Install AddonGet
1. Check your OS version
AddonGet should support most systems, but let's check it for sure
Click the Start Menu button and then on the Settings icon to open Settings App. Click on "System", and from the left sidebar choose "About", scroll down to "Windows Specifications". If you see an OS version greater than or equal to 1803, then congratulations, AddonGet supports your system.
From the Apple menu in the corner of your screen, choose About This Mac. You'll see the macOS name followed by its version number. If the verison number is greater than or equal to 10.13, then congratulations, AddonGet supports your system.
2. Install dependencies
Don't worry. It's not complicated. We only need 7-Zip which is small and easy to install. Just go to
7-zip website
and download the latest installer. And double click to run it. I recommend NOT to change the destination folder. But if you do, please write it down because we'll need it later.
We will use
Homebrew
to simplify this task. Open the Terminal App, then copy and run each command one by one. If you already have Homebrew, skip the first one. After it is done, close the Terminal App.
/bin/bash -c "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install.sh
)"
brew update
brew install p7zip
brew cask install powershell
If you want to know what these commands will do, see the spoiler below for detailed explanations
The first command downloads and runs Homebrew's official installer. The installer will explain what it will do and ask for confirmation. Read it if you want.
The second command updates Homebrew's database so that it knows what can be installed.
The third command installs p7zip, a macOS and Linux port of the popular WIndows program 7-Zip. This program is used by AddonGet to compress and decompress ZIP files.
The last command installs PowerShell 7, Microsoft's newest shell programming language interpreter. AddonGet is written in PowerShell, so it will need this interpreter. Windows PowerShell 5.1 is pre-installed on Windows 10, but not macOS.
3. Download AddonGet
Before you start, please read the security warnings below. AddonGet is a script, and scripts are powerful. Bad people use scripts all the time to do bad things. Be careful. Be very careful.
Security WARNING
:
NEVER run any script as Admin/root unless you know what you are doing
ONLY download and run PowerShell scripts from trusted sources
ONLY download PowerShell scripts via HTTPS links
If you can, inspect the script before running it
Click on Start Menu button, then enter "powershell", and click "Windows PowerShell"
A blue window will pop up. Copy and run the following commands one by one
mkdir ~/AddonGet
curl.exe -o $HOME/AddonGet/AddonGet.ps1
https://raw.githubusercontent.com/camellia256/AddonGet/master/AddonGet.ps1
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
New-Item -Path $PROFILE -ItemType "file" -Force
Write-Output "`$env:Path += "";`$HOME/AddonGet""`nNew-Alias adt AddonGet.ps1`n" >> $PROFILE
If you want to know what these commands will do, see the spoiler below for detailed explanations
The first command creates a new folder named "AddonGet" inside your user's home folder, typically "C:/Users/<Your Username>".
The second command downloads AddonGet from its GitHub repository and saves it as a file named "AddonGet.ps1" inside the just created "AddonGet" folder.
The third command changes PowerShell's script execution policy for the current user to "RemoteSigned". This allows you to run PowerShell scripts locally, but any downloaded script have to contain a valid digital signature.
The fourth command creates your PowerShell profile file with any missing parent folder.
The last command adds two lines to your PowerShell profile so that your can use the shorthand "adt" to run "~/AddonGet/AddGet.ps1"
Open your Terminal App, then copy and run the following commands one by one
mkdir ~/AddonGet
curl -o ~/AddonGet/AddonGet.ps1
https://raw.githubusercontent.com/camellia256/AddonGet/master/AddonGet.ps1
pwsh
New-Item -Path $PROFILE -ItemType "file" -Force
Write-Output "`$env:Path += "";`$HOME/AddonGet""`nNew-Alias adt AddonGet.ps1`n" >> $PROFILE
The commands above is explained in the spoiler below
The first command creates a new folder named "AddonGet" inside your user's home folder, typically "/Users/<Your Username>".
The second command downloads AddonGet from its GitHub repository and saves it as a file named "AddonGet.ps1" inside the just created "AddonGet" folder.
The third command will launch PowerShell 7 (installed from step 2) in your Terminal. You should see that the prompt is changed from "$" to ">"
The fourth command creates your PowerShell profile file with any missing parent folder.
The last command adds two lines to your PowerShell profile so that your can use the shorthand "adt" to run "~/AddonGet/AddGet.ps1"
4. Configure AddonGet
Close and reopen your PowerShell or Terminal App (remember to type "pwsh" to enter PowerShell on macOS). The run
adt new
AddonGet will guide you through the configure process. (GUI on Windows, no GUI for macOS for now)
It will perform the following steps:
AddonGet will try to detect 7-Zip automatically. If not, a window will pop up asking you to locate it.
AddonGet will try to detect retail WoW automatically. If not, a window will pop up asking you to locate it. If you have no idea where it is, see
Keldesh's
guide
Backing up Important WoW Data and You!
AddonGet will ask you for a backup location. If you plan to backup your WTF folder via AddonGet, in the pop up window select a folder to save backup. Personally, I use a folder in my OneDrive. (If you don't know what is WTF folder, see
Keldesh's
guide
Backing up Important WoW Data and You!
) If not, simply press Cancel.
It will perform the following steps:
AddonGet will ask you for your retail WoW location. If yours is in the default location, simply press Enter. Else, enter the path. If you have no idea where it is, see
Keldesh's
guide
Backing up Important WoW Data and You!
AddonGet will ask you for a backup location. If you plan to backup your WTF folder via AddonGet, in the pop up window select a folder to save backup. Personally, I use a folder in my OneDrive. (If you don't know what is WTF folder, again see
Keldesh's
guide
Backing up Important WoW Data and You!
) If not, simply press Enter.
Now confirm your success by running
adt version
You should see
AddonGet: v0.4.0
Good! Installation is complete.
Use AddonGet
WARNING: before you start using AddonGet, please make sure your addons folder does not contain anything that will be installed via AddonGet. I recommend move everything to another location, and after you have installed everything via AddonGet, move them back while NOT allowing overwriting. This way, anything that isn't managed by AddonGet will remain in place.
Launch PowerShell
You can't use AddonGet without a PowerShell session.
For macOS, open Terminal App, type "pwsh" and press Enter. You should see that the prompt is changed from "$" to ">"
For Windows, search "Windows PowerShell" in you start menu and click to run
Supported URLs
AddonGet supports three types of URLs from CurseForge.com and tukui.org
CurseForge
This is the same as the addon's project home page "
https://www.curseforge.com/wow/addons/<project
name>"
https://www.curseforge.com/wow/addons/details
https://www.curseforge.com/wow/addons/deadly-boss-mods
Tukui UIs (for ElvUI and Tukui only)
https://www.tukui.org/download.php?ui=elvui
https://www.tukui.org/download.php?ui=tukui
Tukui Addons
Please note, `
https://www.tukui.org/api.php?addon=<project
ID>` is tukui.org's public network API, not the addons' project page, which is `
https://www.tukui.org/addons.php?id=<porject
ID>`
https://www.tukui.org/api.php?addon=3
Install Addons Using URL Files
Create two empty text files named "fa.txt" and "a.txt" on your desktop.
In "fa.txt", put addons which are updated frequently.
https://www.curseforge.com/wow/addons/details
https://www.curseforge.com/wow/addons/deadly-boss-mods
https://www.tukui.org/download.php?ui=elvui
In "a.txt", put addons which usually are only updated when a new patch hits.
https://www.curseforge.com/wow/addons/method-dungeon-tools
https://www.curseforge.com/wow/addons/exorsus-raid-tools
https://www.curseforge.com/wow/addons/copypasta
https://www.tukui.org/api.php?addon=3
The run
adt f ~/Desktop/fa.txt -Frequent
adt f ~/Desktop/a.txt
Install Addons Using URLs
You can put any number of URLs in a single command as long as they are separated by whitespaces. "-Freuqent" should be put in the end if you use it.
If it is frequent, then
adt i
https://www.curseforge.com/wow/addons/deadly-boss-mods
https://www.tukui.org/download.php?ui=elvui
-Frequent
If it not, then
adt i
https://www.curseforge.com/wow/addons/family-familiar-helper
https://www.curseforge.com/wow/addons/rematch
Show Installed Addons
adt s
Remove Addons
Addons are removed using their "Project Name" and "Addon Source"
CurseForge
adt r deadly-boss-mods details
Tukui addons
adt r 3 -Source Tukui
ElvUI or Tukui
adt r elvui tukui -Source TukuiUI
Update Addons
Update addons that are marked as frequent
adt u
Update all installed addons
adt u -All
Backup WTF folders
adt b
The backups are named in the format "AddonGet-WoW-WTF-Backup-<Unix Time>-<Year>-<Month>-<Day>.zip", so old ones will never be overwritten by new one. You'll have to delete old backups manually if they take up too much space.
Export installed URLs
adt e ~/Desktop
Frequently updated addons' URL will be saved on your desktop as "AddonGet-FURLs.txt". Other addons' URL will be saved on your desktop "AddonGet-URLs.txt". These file can be used to install these addons directly using "adt f /path/to/file.txt"
Final words
We have reached the end of this guide. Thank you for taking your time to read and try AddonGet. If you encounter any problem or have some suggestions, feel free to comment or open an issue on
GitHub project page
.
About author
Camellia256, WoW player and long-time wowhead lurker (registered only recently). I main a Night Elf priest and enjoy pet battles and collection.
Acknowledgements
Thanks
Keldesh
for his amazing guides on Addons and Tools
wow-addon-updater
is currently maintained by grrttedwards and licensed under GNU GPLv3
Windows PowerShell and PowerShell are developed and copyrighted by Microsoft Corporation
Homebrew is a great package manager for macOS, developed by the Homebrew Project
curl is a command line tool developed by the curl project at
https://curl.haxx.se/
, distributed with Windows 10 and macOS
7-Zip is a file archiver developed by Igor Pavlov, licensed under GNU LGPL
p7zip is a POSIX port of 7-Zip
Addons installed via AddonGet are hosted by CurseForge.com and tukui.org, created and copyrighted by their authors
AddonGet is developed by this author and licensed under GNU GPLv3
[Get Wowhead]
高级会员
[$2]
[A Month]
[Enjoy an ad-free experience, unlock premium features, & support the site!]
评论
评论来自
SprosboldJenkins
Style: Very well written and comprehensive guide - was easily able to follow the steps in theory.
Unfortunately the AddonGet.ps1contents show as:
404: Not Found
,
meaning I'm unable to proceed. Your linked Github project is also not found. Is this addon/project still going, or is it not in the repository anymore? I'd be really keen to give it a go.
贡献
在发表评论前，请留心以下提示：
您的评论必须为简体中文，否则将会被删除。
不知道如何发评论？参考我们的
格式指南
！
发表前最好先自行校对一次。
有问题可以访问我们的
论坛
来寻求帮助。
发表评论
你没有登录。
请登录
或者
注册账号
来添加你的评论。
使用下面的表格浏览您的截屏。
[Screenshots containing UI elements are generally declined on sight, the same goes for screenshots from the modelviewer or character selection screen.]
质量越高越好！
[Please review our
Screenshot Guidelines
before submitting!]
您没有登录。请
登录
后提交截屏。
将视频URL输入下列表格即可。
URL：
支持：仅限 YouTube
说明：您的视频需通过审核才能在站点上显示。
我们用
Wowhead 客户端
保证数据库的及时更新，向您提供额外的有趣的功能！
两大目的：
它还维护WoW的一个插件
Wowhead Looter
, 在您游戏时采集数据！
它将
采集所得数据
上传至Wowhead，保证数据库时刻掌握最新信息！
您可以用它追踪完成的任务、配方、坐骑、伙伴宠物以及头衔！
您还在等什么？立即
下载客户端
整装待发吧。
我们用 Wowhead 客户端保证数据库的及时更新，向您提供额外的有趣的功能！
两大目的：
您可以用它追踪完成的任务、配方、坐骑、伙伴宠物以及头衔！
您还在等什么？立即 下载客户端 整装待发吧。