-
Notifications
You must be signed in to change notification settings - Fork 3
Server owner guide
Here are some tips for Server owners not covered in the help:
SeedWasp, our beta bot, has this default prefix: w,
Dronefly, our main bot, has this default prefix: ,
To change SeedWasp's server prefix to , like Dronefly, just use this command:
w,set serverprefix ,
Grant Dronefly Manage Messages permissions to allow it to remove reactions when using the menu buttons and remove user responses to prompts by the bot, e.g. when using the 🏘️ or 👥 buttons to add a place or user by name.
There are some server-wide settings that are turned off by default which you may wish to review & enable for your server.
Check ,inat show [setting] to check each setting.
Turn on automatic preview of observation links for the whole server with ,inat set autoobs server on.
Turn on lookup of taxa surrounded by dots with ,inat set dot_taxon server on.
See ,describe dot_taxon for more information about the feature.
Before adding your own copies of custom commands to your server (next section below), check with the bot owner if a global custom command could be added instead. Existing global custom commands that are automatically defined for all servers that invite Dronefly can be shown with ,cc global list. We would like to make the custom commands that are defined on iNaturalist Discord server available to everyone, and will happily add any that people use elsewhere upon request.
Please note that if you previously added custom commands on your own server, and we have subsequently made them available as custom commands, your old definition will still be in place and will be used instead of the global one. If we make improvements to the global version, you will not automatically benefit from those improvements.
To remove your own server-defined custom command, use ,cc remove. For example, if you ever defined your own birdcast command, that broke when we switched from customcom to tags, so we fixed it in the new global version. Remove the old definition with ,cc remove birdcast and the global version will be used instead.
Many users have submitted their requests for custom commands to be added for the iNaturalist Discord server. A custom command is something a server owner can add themselves, i.e. it doesn't require any programming to add. Most of these are shortcuts to various web searches, usually to find more about a taxon (e.g. xeno-canto for birdsongs, shown in the example that follows). These definitions only exist on the server where they are added, so if you want them on your server, you'll need to define them yourself. Update: it is now preferable to ask the bot owner to make the iNaturalist Discord custom command global (see previous section), so the following instructions are mostly useful for server owners who want to add completely new commands of their own, based on ones we've already made, or else run their own private Dronefly bot instance.
You need the tags cog from phen-cogs repository at https://github.com/phenom4n4n/phen-cogs to define and use these. Those who have invited SyntheticBee's Dronefly already have this cog loaded. See the author's documentation for Tags at https://phen-cogs.readthedocs.io/en/latest/
For a complete list of custom commands defined on the iNaturalist Discord, join the server and go to channel #bot-commands, then use ,cc list. Use ,cc raw to show the definition for each custom command, e.g. ,cc raw xc should show a display like:
https://www.xeno-canto.org/explore?query={args(1)}
Then define the same custom command on your server, e.g.
,cc add xc https://www.xeno-canto.org/explore?query={args(1)}
Repeat that for each listed custom command that you want to define on your own server.