Social Media Buttons/In-Game Website Plugin (RMMV)

The Social Media Buttons Plugin enables you to display social media buttons (Twitter, Facebook, Google+, YouTube, and your project Website) on the Title Screen, each of which opens the corresponding website in a new window.

You can also use the plugin to send players to a website in-game via events with a simple Plugin Command.

 
Social Media Buttons/In-Game Website PluginUsage InstructionsVideo TutorialUpdate LogPersonal NotesPlugin RequirementsCompatibility IssuesDownloadFuture UpdatesTerms of Use
Version: 1.6
Author: Companion Wulf
Platform: RMMV
Script Type: Plugin
Required: None
Filesize: 10 Kb
File Format: JS
Release Dates: 1.6: 18 August 2017
1.5: 28 August 2016
1.4: 5 August 2016
1.3: 20 July 2016
1.2: 10 April 2016
1.1: 7 April 2016
1.0 (Beta): 3 April 2016
Last Update: 18 August 2017
The Social Media Buttons plugin only has five buttons to display: Twitter, Facebook, Google+, YouTube, and Website. Each one can be toggled on or off and will display dynamically in the bottom-right corner of the Title Screen.

You can also call a website from within the game (see Plugin Commands below).

NOTE: If playing in a browser, the URL might not open if you have a popup blocker, so make sure you allow it. In Windows versions, a new window will open to display the website.

TWITTER

These are the settings for sharing Twitter accounts via your games.

Twitter Toggle
This setting turns the Twitter button ON or OFF.

Twitter Action
Action is the behaviour type of the Twitter button. You can use one of three options: Screen Name, User ID or Follow.

  • Screen Name – The user name of the Twitter account you’d like your players to visit.
  • User ID – The unique identifier of the Twitter account.

    To find your User ID, log into your Twitter account and go into "Settings", then under "Your Twitter Data", your User ID is right under your Username. (You will have to reenter your password to access this area.)

    Alternatively, go to Tweeter ID and enter the Twitter "handle" to find the User ID number (or vice versa).

  • Follow – Enables players to follow your Twitter account directly from within RPG Maker MV, whether in a window or browser. As long as the "Twitter Action Settings" is set correctly, this will automatically use the Screen Name or User ID.

Twitter Account
This sets the Username or User ID for the Twitter account you wish to use. It’s used in conjunction with the "Twitter Action" setting.

For example, if you set that as "Screen Name", mine is "CompanionWulf", which will then lead to the my "RPG Maker Times" account there.

Bear in mind, however, that Usernames change often so it’s probably better to use the User ID, as it’s unique to each account whatever the Username may be.

FACEBOOK

These are the settings for sharing a Facebook page from within RMMV.

Facebook Toggle
Show (ON) or hide (OFF) the Facebook button on-screen.

Facebook Page Name
This is the page name reference to display your Facebook page.

For example, mine is "RPGMakerTimes" there, so clicking on the button will go to my "RPG Maker Times & Projects" page.

GOOGLE+

These options are to share a Google+ profile from within RMMV.

Google+ Toggle
Show (ON) or hide (OFF) the Google+ button on the Title Screen.

Google+ Account
Google+ has two options (depending on how you’ve set it up).

In most cases you can use your page or profile name, preceded by the + sign. For instance, mine is RpgmakertimesInfo there, so I’d put

+RpgmakertimesInfo

in this option. NOTE: You *must* include the + sign, otherwise you’ll receive a Page Not Found Error.

You can also set your 21-digit User ID number here. If you click on your Profile and you’ll see your ID number.

In most cases, however, your page or profile name is already set up with the + sign identifier (because of Google+’s updates).

YOUTUBE

These options are to display sharing something from YouTbue.

Show YouTube
Show (ON) or hide (OFF) the YouTube button on the Title Screen.

YouTube Action
This is the behaviour type for the YouTube button. The options you can have are: User, Channel, Video or Playlist.

YouTube Account
This provides the information for the "YouTube Action". You don’t need the full URL, just the identifying information.

  • Username – The username you use for your main profile.

    Mine is "Ferewulf". When you type

       https://www.youtube.com/ferewulf

    into the address bar, my YouTube profile loads, displaying all of the videos I’ve created.

  • Channel ID – The ID reference of your video channel.

    When you click on "My Channel" at YouTube, the channel page with its videos will load. This is the part of the URL that contains upper and lower case letters and numbers.

  • Video ID – The ID for the video you want to play in RPG Maker MV.

    This is part of the URL with upper/lower case letters and numbers. You can either obtain it with "Share" or from the main URL (after "watch?v=").

  • Playlist ID – The ID of the playlist you’d like to feature.

    When you put videos into playlists, each one has a rather long and unique identifier comprising upper/lower case letters and numbers. It’s after the "playlist?list=" part but minus any other parameters.

WEBSITE

These options set the website address you’d like visitors to go to when they click the button.

Website Toggle
Turns the Website icon ON or OFF.

Website URL
This is for setting your full website address. When the button is clicked, it’ll open in a window or browser.

DISPLAY METHOD

This selects how to display the "Website URL". You can choose to display your link in a game Window or in your default Browser.

PLUGIN COMMANDS

You can also call a website from within the game using the following Plugin Command:

   showurl url

where url is the FULL web address to open. This will open in a new window or browser tab.

ICONS

These are the icons you want to use for your social media buttons, separated by commas (Twitter, Facebook and Website).

Recommended size is 32×32.

Save these in the Pictures folder. If you use your own icons, be sure to change the settings to the filenames you used.

I created a video tutorial on how to use the Social Media Buttons plugin for those who need it.
For an up-to-date version history log, you can view it in the JS file from within the downloaded ZIP file.
This was inspired by Yanfly’s excellent External Links plugin and something RPG Maker Web said once on Twitter. I integrated it into Adventures of Tryggr, then into Otherworld, but wrote my own to trim out some of the superfluous code and make it more compatible with Otherworld‘s menu.

So based on that same principle, I decided to add a separate block on the Title Screen to contain Otherworld‘s Twitter account and official blogsite, as well as RPG Maker Times Facebook page, rather than putting them in the main menu – to declutter it. I then adapted it for more general use.

The plugin must be installed in RMMV’s Plugin Manager to run.
There shouldn’t be compatibility issues.

There has, however, been a report of conflicts (notably with some of Yanfly’s plugins), but I haven’t been able to replicate any errors.

Conflicts may also occur with Yanfly’s External Links Plugin. While the Social Media Buttons part of the plugin will still work, decide on which method you prefer to use and stick with it.

Download the ZIP file and extract CW_SocialMediaButtons.js directly into the JS folder in your RMMV project. Be sure to read the Terms of Use file as well.
  • Dynamic popup blocker alerter
  • Allow manual positioning of button block (to top left, top right, etc.)
  • Add mouse-over effects for icons??

Note: After v2.0, I’ll no longer actively update the plugin due to the way that most social media sites use their APIs and SDKs. While it IS possible to share an in-game screenshot and content from within MV, it’s not as easy as it may sound.

This isn’t necessarily from a developer’s perspective, but from the end-user perspective. I don’t want to over-complicate things, so will be keeping it simple and "as is": Promote and share your site on some of the most popular social media sites. And that’s it!

This plugin is free to use under CC BY-NC 4.0, but please refer to the RPG Maker Times Terms of Use for other details, including for commercial use.

Credit "Companion Wulf" or "RPG Maker Times" if using this plugin in your projects.