Updating the Wiki with a Bot - Project-Path-of-Exile-Wiki/PyPoE GitHub Wiki

PyPoE supports exporting to the wiki directly using a bot.

CAUTION: When running the PyPoE wiki bot to update pages on the wiki, it is vitally important to respect the dev branch of this repo as the single source of truth. Never run the wiki bot on a forked repo!

To use the wiki bot, you need a bot account to mark all automated edits as performed by a bot so readers can identify and filter out these bulk edits. You should create a new account with a name that have the word bot and the username of the main account, and ask wiki admin to mark it as bot user group.

Running the Wiki Bot

To run the wiki bot, use a command such as:

pypoe_exporter wiki items item name "Celestial Necrolord Gloves" -w -w-u <username> -w-p <password> -w-msg "Message appended to the edit summary"

In which -w (or --wiki ) is exporting to the wiki

-w-u is the username of your bot account on the wiki

-w-p the password. You can either use your bot account password, or you can use a generated password for bot edits. See Generating Bot Passwords below.

-w-msg is the place to specify optional msg in the wiki edit summary, after the automatically filled text. Specify the game version for this update for example.

There are more commands. You can view the hander.py in C:\(you pypoe installation)\cli\exporter\wiki\handler.py

Generating Bot Passwords

It is not required to do so, but for additional security you can generate a password for making bot edits.

Navigate to https://www.poewiki.net/wiki/Special:BotPasswords while logged in to your bot account. You can just select the rights you need, such as high volume edit and then create. Or specify an IP range for more security. Or you can just allow the bot to run in any IP, but after you have used the bot, delete the bot password.

What you then enter for your username and password will be in the form: -w-u <username> -w-p <username>@<bot password>.

⚠️ **GitHub.com Fallback** ⚠️