Download the PHP package tdmalone/slackemon without Composer
On this page you can find all versions of the php package tdmalone/slackemon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tdmalone/slackemon
More information about tdmalone/slackemon
Files in tdmalone/slackemon
Package slackemon
Short Description Inspired by Pokémon Go, now you can collect Pokémon and battle your teammates on Slack!
License GPL-3.0
Homepage https://github.com/tdmalone/slackemon
Informations about the package slackemon
Slackémon
Inspired by Pokémon Go, now you can catch and battle Pokémon with your teammates on Slack!
This program is very much a WORK IN PROGRESS, and should be considered very ALPHA. If you have any questions you're welcome to log an issue, but please be aware that code may be messy/incomplete, and some things may not work. In addition, not all mechanics are implemented yet. We're getting there!
Full Heroku deployment instructions
Scroll down for more setup options
Screenshots
Features
- Catch randomly spawned wild Pokémon and build your collection
- 'Travel' to different regions in the Pokémon world to find different wild Pokémon
- Battle wild Pokémon to make them easier to catch, and to level up your own Pokémon
- Battle your teammates to see who is the strongest!
- Compete with your teammates to see who can fill their Pokédex first
- Pick up randomly spawned items 'found on the ground': teach your Pokémon new moves, and evolve some Pokémon!
- Support for evolution based on level, happiness, time of day, item use, and known move/move type
- Tools to manage your Pokémon collection
- Live weather integration for a higher chance of, for example, water Pokémon during rain
- Add custom logic to control when legendary Pokémon can spawn
- Implements IVs, EVs, happiness, natures and growth rates
- Implements damage moves with PP, damage class, STAB, type effectiveness, recoil and drain
- Fainted, damaged and low-PP Pokémon auto-heal after an amount of time
- Respects users' Slack DND settings, so no-one wakes up to hundreds of missed spawns
- Includes a user-specific 'offline mode' so the game can be turned off when the interruptions are not wanted
Requirements
- A web environment running PHP7
- Access to a Slack organisation (if a free organisation, installing this will take up 1 of your 10 integrations)
- Optional: An API key for OpenWeatherMap, to enable weather features based on real-world weather
- Optional: An AWS S3 bucket for better performance when caching image assets
Setup
Setup of Slackémon is not quick. This may be worked on further in the future. For now, there are quite a few steps!
- Download/clone/etc. the contents of this repository, and put it on a web server somewhere that runs PHP7.
- Download ZIP or clone with Git:
git clone https://github.com/tdmalone/slackemon.git
- You may need to install depdendencies as well by running
composer install
. If you don't have Composer, get it here first. If you're not going to be developing Slackémon, you can speed up the install of depdendencies by instead runningcomposer install --no-dev
.
- You may need to install depdendencies as well by running
- Install with Composer:
composer require tdmalone/slackemon
- Deploy with Docker
- Deploy with Heroku
- Download ZIP or clone with Git:
- Log in to your Slack team, and visit https://api.slack.com/apps?new_app=1 to create a new App. You can call it whatever you like, but 'Slackémon' usually works best! You can then proceed to set up the app features through Slack's interface.
- Set up Slack's Interactive Messages
- From your App control page, under Features in the sidebar, click Interactive Messages
- For the Request URL and Options URL, enter the address where you are hosting Slackémon (eg. http://example.com/slackemon)
- Set up Slack's Slash Commands
- From your App control page, under Features in the sidebar, click Slash Commands
- Create a new command, naming it
/slackemon
. Set the Request URL to the same URL you used above. - Enter any description you like - this is what will show to your team when they start typing
/slacke....
. Something like 'Catch Pokémon and battle your teammates!' usually works well. - Leave the 'Escape channels...' checkbox unticked, and click Save.
- Set up permissions and install the app to your team
- From your App control page, under Features in the sidebar, click OAuth & Permissions
- Scroll down and add the following permission scopes:
- dnd:read
- chat:write:bot
- users.profile:read
- users:read
- Click Save Changes, then at the top of the page, click the button to install the app to your team, giving it the permissions it asks for. Make a note of your OAuth Access Token.
- At this point, if you are on a free Slack team, Slackémon will take up one of your 10 available integrations. If you have already used your 10 integrations, you'll need to completely remove one at
https://YOUR-DOMAIN.slack.com/apps/manage
before you can add Slackémon - or alternatively, upgrade to a paid Slack plan.
- At this point, if you are on a free Slack team, Slackémon will take up one of your 10 available integrations. If you have already used your 10 integrations, you'll need to completely remove one at
- Head back to the 'Basic Information' page for your app, and scroll down to your app's credentials section. Make a note of the Verification Token.
- You may also like to set up an icon for your app to make messages from it look slightly nicer - this Pokéball makes a good icon!
- Set up your environment variables, either by copying
.env.example
to.env
(development mode only - see instructions in the file), or setting the variables within your environment (recommended). Either way, see.env.example
for instructions on the variables to set. - In your system's crontab (eg.
crontab -e
on a Linux machine, or find the Cron option in your hosting control panel), set upcron.php
to run every minute, sending through the cron token you created earlier.- If you're invoking via the command line, you can use eg.
php /path/to/cron.php --token=XXXXXXXXXXXXXXXXXXXX
- If you're invoking via a GET request, you can use eg.
http://example.com/slackemon/cron.php?token=XXXXXXXXXXXXXXXXXXXX
- If you don't have access to cron, you can use a service such as cron-job.org
- If you're invoking via the command line, you can use eg.
- Time to install custom emoji! There's a lot to install, so we make use of the wonderful emojipacks:
- Enter
npm install -g emojipacks
at a command line (if you don't have Node.js/NPM installed, do that first) - Run
emojipacks -y https://github.com/tdmalone/slackemon/blob/master/etc/emojipack.yml
- You will be prompted for your Slack subdomain (eg.
YOUR-SUBDOMAIN.slack.com
- leave out theslack.com
part when entering it) as well as your username and password for Slack (neither Slackémon nor emojipacks will have access to your login details; it is simply required because Slack doesn't yet have an API endpoint for uploading emoji) - Wait... for quite awhile! When the script is done, you'll have almost a thousand new custom emoji covering every single Pokémon plus a few more custom emoji used by Slackémon 😃
- If you can't install custom emoji in your Slack organisation, ask your team admins, or set
SLACKEMON_ENABLE_CUSTOM_EMOJI
tofalse
in your environment variables.
- Enter
Well done, it's time to start playing! You should now be able to run /slackemon
anywhere in your Slack team to start the quick user onboarding process 👍
Future enhancements
Future enhancement ideas are progressively being added to the Projects section.
You can generally track what we're working on at moment through the Milestones.
User guide
A user guide will progressively be written at this repo's wiki.
Acknowledgements
Slackémon was first and foremost inspired by Pokémon Go. It borrows a few mechanics from Pokémon Go (mainly for simplicity), but as time goes on the aim is to be more true to the original Pokémon games wherever possible.
The idea of doing this on Slack came from Robert Vinluan's bot for having Pokemon battles in Slack. Inspiration and some battle move data has also been gleaned from Pokémon Showdown.
Thank you to those who have done the hard yards in bringing together Pokémon sprites, particularly PokeCSS.
Thank you to my co-worker Julian, who has been my main playmate in testing (and competing with!) this on our company Slack organisation at Chromatix, and to Alessandro Pezzè for being the first 'stranger contributor' to jump on board the project :). You can see the full list of contributors in CONTRIBUTORS.md
.
Thanks to Slack for maintaining a well-documented, open API and inviting collaboration on their platform.
Last but not least, this project would never have happened without the extensive work undertaken by Paul Hallet at Pokéapi. Working on Slackémon has been fun rather than painful, thanks to the rich collection of readibly accessible data that Paul and his team have collected and structured. Thank you!
License
Slackémon - Catch and battle Pokémon with your teammates on Slack
Copyright (C) 2016-2017, Tim Malone and contributors.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.