IITC-Plugin: Copy PokeNav Command
IITC Plugin that copies Portal Info to Clipboard or sends it directly to Discord via WebHook in the format needed by the PokeNav Discord Bot as follows:
@PokeNav create poi <type> «<name>» <latitude> <longitude> "ex-eligible: 1" (if Ex Gym)
Prerequisites
To use this IITC Plugin, you need
- An Account for Niantic's game Ingress
- If you want to use your Computer (recommended), you need a Userscript Manager for your Browser (e.g. Tampermonkey) and a Version of IITC installed (IITC or IITC-CE). Alternatively you can use the Browser Addon "IITC Button" available for Chrome and Firefox.
- If you want to use your Smartphone instead, you have to install IITC Mobile (Play Store, GitLab) or IITC CE Mobile (Play Store, GitHub) for Android. For IPhone you can only use IITC Mobile (not tested with this Plugin!) (App Store, GitHub).
Installation
To install the Plugin, click :point_right:here:point_left:.
You should be asked if you want to install an external Plugin. Confirm the Installation and you are done!
Features
With This Plugin you can...
- Classify a portal manually as Stop, Gym or EX Gym or use the Info already collected with Pogo Tools (see Integrations section)
- Copy The Command to Clipboard, use a WebHook to send it directly to the appropriate Discord channel or use the Companion Bot
- Decide if the commands should be sent directly to the Discord channel or a thread
- Send all the Data already collected with PoGo Tools to PokeNav with a few Clicks
- Pause the Bulk export and start off where you ended it
- Check for modifications of Pogo Tools data automatically
- Send or copy modification or deletion Commands for PokeNav, or let the Companion Bot do the work.
- View your PokeNav community bounds as a circle on the map
- Represent the state of the export in Colors with a highlighter: PokeStops are blue, Gyms red and Ex raid gyms have a red border and yellow filling.
Integrations
If you use the Pogo tools plugin by AlfonsoML (development from original author stalled, but still working), the info entered there is used to determine Type and Ex Eligibility if applicable. Otherwise you can choose manually.
If you use the Plugin, you also have the option to upload all gathered Data at once.
Original Source / Dependencies
Credits for the original source and licenses of dependencies can be found here.
Note
The Plugin is not the very best code style and the code may not be very "error-friendly" because i am in no way an expert in JavaScript at the moment, but the important thing for me was to get it work, and it does exacly that, nothing more :wink:
WebHook How-to:
A Tutorial on how to set up a WebHook in Discord can be found here.
The WebHook has to be set up for the PokeNav Admin Channel (named #pokenav by default).
If you created the WebHook, copy the WebHook URL and paste it into the Text Box in the Settings Dialog of the Userscript. The URL will be stored in Local Browser Storage for you, so you normally won't have to re-enter it.
Note: Have in mind that anyone who has the WebHook URL and knows how to post to WebHooks can send any Message he likes to the Channel, so be cautious who you give the WebHook URL to.
About the Companion Bot
The Companion Bot is a helper Bot that recieves a JSON file from the WebHook or an arbitrary CSV file from the user containing all PoI to create / update and posts the PokeNav commands one at a time. This is because WebHooks can only post 30 Messages per minute, resulting in long waiting times if you want to create all PoI via WebHook. And you have to keep IITC on all the time.
After the Export, the Bot does its Work automatically without the need to keep IITC open so long.
You can invite it to your server by clicking :point_right:here:point_left:.
How to contribute?
You can contribute by...
- translating this Plugin into your native language. A guide on how to translate can be found here.
- contributing Code to the plugin or the bot. Please fork this repository and open a pull request. I will then take a look at it and if i consider it good, i'll merge it into the dev branch and later on into main if everything is working.
- reporting Bugs and other issues.