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

Social Media Buttons Plugin v1.7

The Social Media Buttons/In-Game Website Plugin enables you to display social media buttons (Twitter, Facebook, Google+ and your project Website) on the Title Screen, each clickable to open 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 InstructionsUpdate LogPersonal NotesPlugin RequirementsCompatibility IssuesDownloadFuture UpdatesTerms of Use
Version: 1.7
Author: Companion Wulf
Platform: RMMV
Script Type: Plugin
Required: None
Filesize: 6 Kb
File Format: JS
Release Dates: v1.7: 5 August 2016
v1.6: 20 July 2016
v1.5: 10 April 2016
v1.2: 7 April 2016
v1.0 (Beta): 3 April 2016
Last Update: 5 August 2016
The Social Media Buttons/In-Game Website plugin only has four right now: Twitter, Facebook, Google+ and Website. The plugin will be improved over time, including adding more buttons and being able to adjust its position on-screen (currently it shows in the bottom right corner).

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).

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.

  • v1.7.0 (05-Aug-2016)
       –RELEASE: Version 1.7 (Public)
  • v1.6.2 (01-Aug-2016)
       –ADD: Google+ button
  • v1.6.1 (24-Jul-2016)
       –TWEAK: Dynamic icons positioning
  • v1.6 (20-Jul-2016)
       –RELEASE: Version 1.6 (Public)
       –TWEAK: Set page name instead of full URL (Facebook)
       –ADD: Screen Name, User ID and Follow options (Twitter)
       –TWEAK: Twitter account settings
       –TWEAK: Removed individual icons and placed them in a single setting array
  • v1.5.0 (10-Apr-2016)
       –RELEASE: Version 1.5 (Public)
  • v1.4.1 (09-Apr-2016)
       –TWEAK: showUrl Plugin Command also has Window/Browser options
       –ADD: Plugin options to open links in either a Window or Browser
       –ADD: Gui method to open links in default browser
  • v1.2.0 (07-Apr-2016)
       –RELEASE: Version 1.2 (Public)
  • v1.1.1b (06-Apr-2016)
       –TWEAK: Change plugin title to "Social Media Buttons/In-Game Website" Plugin
       –ADD: Plugin Command to call website from within the game
  • v1.0.0b (03-Apr-2016)
       –RELEASE: Version 1.0 (Beta)
       –BUG FIX: Icons show up even if toggle is OFF
       –ADD: More settings for choice of icon and websites
       –ADD: Website button
       –ADD: Facebook button
       –ADD: Twitter button
       –Created [as] Social Media Buttons Plugin
This was inspired by Yanfly’s excellent External Links plugin. 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.
Download the ZIP file and extract CW_SocialMediaButtons_17.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
  • Dynamically change positioning of icons if one is OFF
  • Allow manual positioning of button block (to top left, top right, etc.)
  • Add mouse-over effects for icons??

Note: There will be no further development on this plugin for a while (v1.7), as my focus will be on other things.

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.