Skip to content

fablabjoinville/POAPBot

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@POAP-Bot: Code distribution for POAPs events

Using @POAP-bot during events

During active events, users only need to sent a DM to @POAP-bot

  1. Obtain the 'Secret Code' during the LIVE event
  2. Directly Message @POAP-bot with the 'Secret Code'
  3. Your POAP claim link code will be sent as a reply from the @POAP-bot.

Example: POAP-bot example

Add @POAP-bot to your server.

You can add to you discord server the @Makers-POAP-bot with this link: https://discord.com/oauth2/authorize?client_id=817041487161196594&permissions=2112&scope=bot

It will open the discord.com site in a browser page. Once the user signs in (which may happen automatically if credentials have been cached), they can select the guild in which the bot is to operate, and approve the bot's permissions in that guild.

The bot will appear as a new member of the server (check for POAP-bot#0094).

Setting up new POAP Event

Administrators may issue a command to the bot by mentioning it in a text channel, then adding the command in the message. Example:

@POAP-bot !setup

Note that the mention must be to the bot as a member and the bot will respond in a direct message dialog with the requesting user. Depending on the Discord client, the bot's member name may be offered alongside its icon in a selection list when beginning to type the bot's name.

  • !setup Will initiate a dialog to set up a POAP event. Use this to add or modify an event.

Some aspects of a POAP distribution event are customisable, specifically:

  • set the #channel to announce the beginning of an event
  • the messages privately by the bot during the event.
  • the start and end times (in UTC +0 time zone, with the following format: 2020-08-18 13:00)
  • a file containing POAP codes (Questions? Ask here -> https://t.me/poapxyz)

The bot will offer a default value for each parameter.

Example POAP Event

POAP-bot example

Run locally

  1. npm install
  2. npm install -g nodemon
  3. sudo -i -u postgres
  4. psql
  5. Run all queries on db/schema.js to create the tables
  6. Create a bot here and get the token. You can follow this tutorial
  7. Copy the bot Token and paste in the end of the bot.js, on process.env.BOT_TOKEN
  8. npm run start
  9. Paste the bot Client ID in this url: https://discordapp.com/oauth2/authorize?client_id=CLIENTID&scope=bot
  10. Access the URL and let the bot join your server
  11. Finished! Now have fun using it!

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%