Friday, April 26, 2019

Announcing the Meowth 3.0 Open Beta

Greetings users of Meowth! Today is an exciting and somewhat terrifying day. It is time at last for an open beta of Meowth 3.0! I've been working hard to put the finishing touches on Meowth 3.0 and the end is definitely in sight! For now, I'm allowing everyone who wants to try the new version to invite the beta bot to their server. Before then, I'm hoping everyone will read this post as I try to summarize the key changes to keep in mind as you transition from 2.0 to the 3.0 beta.

Key Points

  • !research is the only major cog that is not yet ready, and the timetable for its completion is hopefully less than a week.
  • Most of the old commands work exactly as they did in 2.0.
  • Major commands that no longer exist: !invite
  • Commands that have been renamed and/or reworked: the !set commands, !starttime, !configure
  • Quick migration can be done with the !importconfig command
  • New configuration options are available
  • There will be bugs

Details

Gonna just go point by point and elaborate a bit here.

!invite has been removed, and EX Raid channels will be open to users just like regular raid channels. My observations lately have made me think that the invite command caused more confusion than value. I might put it back as an option later on.

A lot of the user-facing !set commands are still around under different names. !set pokebattler is now just !pokebattler, same with !set silph becoming simply !silph.

!starttime's functionality has been rolled into !group, which now allows the creation of multiple groups for a raid.

!configure is now a pair of commands !enable/!disable, and these work quite a bit differently and (I believe) are easier to understand. I'm attempting to hit a sweet spot of simplicity and customization here. The main change here is that !enable/!disable typically only changes settings in the current channel. This allows different reporting channels to have different settings as far as what commands are enabled, what area the channel covers, how raids reported in them are categorized.

The features that can be enabled/disabled are grouped into these areas: raid, wild, trade, research (still in development), meetup, and users. Most of these are self-explanatory. The "users" area is a catch-all for miscellaneous user self-management commands like !want, !team, !pokebattler, !silph, etc. The "spammy" commands if you like.

If you're happy with how Meowth 2.0 works or at least you want to just get it working on your server quickly, you can use the !importconfig command which will attempt to copy most of the applicable settings from 2.0. Note that this only transfers the settings and things like active raids will not transfer. With that, let's talk about the transition as a whole.

Migrating to 3.0b

Here's the quickest way to switch to the 3.0 open beta and get it configured in mostly the same way you had 2.0 configured. IT IS HIGHLY RECOMMENDED THAT YOU WAIT UNTIL RAIDS ARE DONE FOR THE DAY.

  1. Invite Meowth 3.0 with this link
  2. Keep the beta bot out of your current reporting channels for a bit.
  3. Use the !importconfig command in a channel the beta bot can see. If successful, it will give you a list of "location channels" that need further configuration. These are mainly your raid, wild, exraid reporting channels.
  4. One at a time, let the beta bot into each reporting channel, and use !setlocation in those channels. The arguments are <city> <lat> <lon> <radius>. Make sure to wrap the "city" argument in quotes if it is multiple words.
  5. Restrict Meowth 2.0's permissions in each channel after running !setlocation.
  6. Test each reporting command in each channel just to check that the permissions are all correct and to familiarize yourself with the new or altered features.
  7. At the end of this process, you should have kicked Meowth 2.0 out of all channels except the ones you need for research reporting. Because this cog is not enabled in 3.0, you should be able to use !research in channels where both Meowths are, but make sure you disable other commands for Meowth 2.0 so as not to get duplicate raid channels.
  8. At this point you can play around with the new options for configuration. You can change how raids are categorized, you can !enable train or clean if you like. !train was discussed in a previous post here, and if you do !enable clean in a reporting channel, the beta bot will erase all messages sent by other users, leaving only Meowth's responses to commands for a "clean" channel.
  9. PLEASE KEEP IN MIND THIS IS STILL A BETA. I have done some pretty extensive testing of most of this stuff, but I'm positive I missed things. If you are uncomfortable using the beta as your main bot while the kinks are ironed out, I would suggest putting it off for another week or so. But if you're brave and adventurous or just impatient, go ahead and jump in. You can switch back to 2.0 at any time and any configuring you do for 3.0 will carry over to the full release.
  10. BIG IMPORTANT THING WHY IS IT AT THE BOTTOM I DON'T KNOW. The !want command works differently now. When you !want a Pokemon, it will a) subscribe you to notifications for any Pokemon in that family and b) it will put you on a list Meowth keeps internally. Meowth will create a role for that want ONLY WHEN TEN USERS IN THE SAME SERVER WANT THAT WANT. Related to this, MEOWTH 3.0 DOES NOT KNOW ABOUT THE ROLES CREATED BY MEOWTH 2.0. So your users will have to redo all their wants. This change is an attempt to keep the number of roles Meowth creates to a more manageable level.
OK, I'm tired and nervous so let's just flip the switch and see what happens. I HIGHLY RECOMMEND NOT SWITCHING YOUR SERVER'S OPERATIONS TO THE BETA UNTIL TONIGHT OR TOMORROW FOR A FEW REASONS. FOR ONE THING IT WILL CAUSE A LOT OF CONFUSION IN THE MIDDLE OF THE DAY AND FOR ANOTHER I AM SEEING AVENGERS IN ABOUT FIVE HOURS AND I'LL BE DAMNED IF I'M GOING TO CHECK DISCORD DURING THE MOVIE. Ok, but seriously I'm tired, guys. I'll sleep so much better when this thing is done I tell you what. REMEMBER THAT 3.0 CAN'T DO RESEARCH YET. DON'T AT ME ABOUT IT PLEASE. THANK YOU ALL FOR YOUR PATIENCE I CAN'T BELIEVE WE'RE THIS CLOSE.

OH one more thing, Meowth can use your existing team roles but you need to do !teamrole <team name> <role name> for each of the three teams to make it work.

Changes to Research

More details on today's changes to the research command are below. A new optional argument has been added to the research command. Thi...