User Guide &
Documentation

© 1990-2021 Stephen Gose LLC.

Adventurers of Renown™
White-labeled CMS Edition —


a Massive Multiplayer Fantasy RPG Content Management system
with The Ruins of Able-Wyvern™ (ARRA) In-Gamd Module (IGM)


Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) is a full-featured, stand-alone, online fantasy game for your website and community. However, unlike some other online RPGs,

  • ARRA does not rely on a gamer's native "knee-jerk" reflexes (aka "the patellar reflex") nor "eye-to-hand" coordination for its "Player vs. Player" (aka PvP) dueling outcomes.
  • ARRA does not discriminate against age groups. Great-grandparents can play on a "leveled playing field" with great-grandchildren.
  • ARRA has an "Everyone" ESRB rating initially configured; but could be tailored, in the administration dashboard, to meet your online community expectations.
  • ARRA has game mechanics based on "pure strategy" for the players and their avatar's skill-set — a player uses their raw intellect and combat tactics to outwit their opponents. The gamer acts as an "avatar team manager", sending their "heroes" into the dreaded ruins as a "solo" or "team" explorations.
  • ARRA is "Syndicated" which means registered members can send their avatars into other affiliated website games for regional or international contests and tournaments! You can neatly fit ARRA and other external content, as an "In-Game Modules" (IGM), into this over-arching Content Management System.
  • ARRA is a fully customizable "White Labeled Game" with your unique branding and offers a variety of combat systems from elementary "click-fest" combat, to the typical "dice-rolling", or the default "ultimate strategy" version mentioned above.

Learn how to create more socially networked website games from these "How to" instruction books:



 



Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) is a massive multiplayer, text-based, menu-driven, Fantasy Role-Playing Game (aka "RPG" or "MMORPG") for membership communities. It is licensed as a "White-labeled" PHP framework solution from Renown Games (with or without web hosting) as a "Content-as-a-Service" (CaaS) solution. It was developed using the most optimized "full-stack" web technologies.

Instead of initially investing thousands of dollars to develop a massive gaming system, and even more to maintain such a system. This application package lets you have a socially networked — and syndicated — gaming system for either a small annual subscription-lease or a one-time purchase fee with other expanded "Fantasy Gaming Themes" or a "Contemporary theme" setting such as CubeVille™.

Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) is easily tailored to your specific gaming community's expectations in the administration dashboard and lets you use this proven — and highly popular — MMoG Fantasy Gaming Series that's had over half-a-million game sessions on the Worldwide Web to date! ARRA was originally developed as a Bulletin Board System Game in 1990 from its table-top board game version (Copyright © 1972) and migrated to Flash for the World Wide Web in 1997. ARRA is now upgraded into its fourth edition. It is based on ludology research and social group dynamics. It has many configurable options and settings, from which, you could modify (or newly create!) your desired game interactions. (See: "Create Your Own Adventures (CYOA)" below ...)

Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) uses a "multifunctional full-stack" PHP gaming scripts — e.g., a 3-tier architecture including both the "front-side client" and "back-end servers" — that lets you create your "White Labeled" membership gaming community to your liking. The "front-end" Phaser JavaScript Game Frameworks — using either v2.x.x or v3.24.2 — are sent to your members' browsers from your website deployment, meanwhile your back-end server processes members' incoming actions. This Professional Edition lets you completely replace the "client-side Front-end" with your customized version that won't disrupt any of the back-end services.

A primary feature of Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) is its e-commerce capabilities — — activated with an "Extended License". You can create "virtual products and services" for registered members as either digital products, reoccurring purchases (such as "subscriptions"), or just simple "digital-licensed access" (for example, "in-game modules" creation or documents). This social gaming platform provides a virtual world in an affordable "Content-as-a-Service (CaaS) architecture.

Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) delivers what you and your members want:
Adults gamers want to:

You want to:

Within your community's activities, registered members receive a free "home-base" account (known as a "Hamlet") and manage their various "personae" to represent them within the gameplay. Registered Members — using their virtual "in-game currencies" can buy armor, weapons, properties, items, home-base upgrades, additional "Avatars", storage hoards for their treasures, waterfront piers, pet companions, livestock, characteristic-point enhancements, and so much more to improve their "renown, respect, and your gamers' score board popularity". Unlike many competitive RPG games, your members have the opportunity to work in a variety of careers, earn skills in "Magic" and "Miracles" using the various syndicated "Gateway Quest Portals" (... perhaps created by YOU???), practice martial arts in the Warrior's Guild, restore their health at the parsonages, and many other activities that are hidden within the software as "Quests", Regional/International Contests, and Tournaments.

Be Advised: You Can: You Cannot:

For any queries or problems feel free to contact us at the following Emails:

Developer's Handbook:

Available in your purchased downloads:

Non-Refundable After Purchase

Be Advised: Once you have purchased this product package, it is not possible to receive a refund since you have full access to its proprietary source codes, and in good faith, have consented to its non-disclosure agreements. Therefore, be dedicated to your purchase!

Licensing Clarifications & Information

Referring to "Envato's License Types", you should purchase an Extended License whenever you wish to:

Either, or both, the "Regular" or "Extended" license are allowed on one "Top Level Domain" (TLD). The difference between these licenses is that under a "Regular" License, your deployed package is available for general access free of charge; whereas, under an "Extended License", your published package restricts game access for a fee or subscription (i.e., PAID Access) or could be sold — its license transferred and surrendered to a purchaser — as a "Work for Hire".
For more information visit: https://codecanyon.net/licenses/standard?license=extended

and much more...
  1. Upload the files from the script's "Source" folder into your web host account. (watch this 1-minute video: "Drag & Drop File Manager").

  2. Create a dedicated MySQL database (watch this 1-minute video: "Advanced Database Manager").
    Practice setting up a database and review this interactive tutorial here.

  3. Inside the "Source/arra-caas/config/config.php" file, Open and complete lines 14, to 28 with your affiliate's information you received by email.
    Lines 29 to 64 help you manually tailor a unique game for Search Engine Optimization (SEO) settings.

  4. Enter your newly created database using "PHPMyAdmin".
    * Use your live web hosting access; this won't work in the demonstration mode.

  5. Then, Import your database source code file (SQL/"Database_SQL.sql") using the "PHPMyAdmin" import tab.

    Note: If you are updating the Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) gaming engine, you must perform a clean installation: 1) delete all Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) related database tables; 2) then replace those with the updated content and follow these "Installation Steps" again. This is required because the database tables' structure could be modified. To backup your data export all Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) related database tables.

  6. Generate your "ReCaptcha" v2 keys; see the instructions below. Log into your admin account using the defaults: admin and admin [Username & Password]. Then, inside the "Admin Panel", Add your unique "ReCaptcha v2" keys on the "Settings" page.

  7. Change the default "admin" account password from "admin" and record your changes.

The game demonstration uses: demo and demo [Username & Password]
This account is reset every five minutes or on log out.


Everyone has had wonderful ideas for building their own RPG game; yet unfortunately, many of those dreams sometimes have never materialized. Well, let's put a stop to that and have you extend this "Game Construction Kit™" with your ideas with a few simple steps.

Let's start by building a:

  1. new simple "shop" or "area" — also known as a CYOA extension module in "Standard Format"!

    (Designer's Note:
    you can sneak a peek at some simple examples from the game's "Province" or "Able-Wyvern Forest" OR either of their enhanced versions here. YES! both the simple and the "enhanced" versions are using the exact same code from the back-end! This is the power of the Game Design System™ and "Content-as-a-Service" (CaaS). It's just the "front-end that has all the "eye-candy" and "game juice". (... learn more about this design process in your Developer SDK documentation)

  2. game-turn orders (GTO) for your new "module";
  3. game-turn results (GTR) from those GTO submissions; and finally,
  4. Publishing your module locally (or into the Game Syndication Network)!
  5. CYOA "Game Book" (CGB) OR a Collector's Edition Comic Book from your previous work above!


Design Step #1: Building an "Area" or a "Shop"

You must decide on what would help your gamers. No matter if your tweaking this game for a "Fantasy" or "Space-Age" RPG adventure, avatars still have the same physical needs and demands; they will need either "goods" or "services". Download this draft document from my 1990s brainstorming sessions while initially building this game for my BBS.

If you're having a difficult time deciding on what to build, then I recommend a quick 3-minute read from this article. From your 3-minute investment, you'll know exactly what your gamer's avatars are looking for in this Medieval Fantasy RPG. With some "twisted thinking and translation", you'll also discover how to integrate what you've read into a "Space-Age" RPG adventure.

So much for local deployment under VID #1 using a "Standard License"! But perhaps, you might like your new module spread throughout our Network Syndication Market? To do this, you must become a registered "Vendor", receive another Vendor Identification (VID above #1) and register your new module(s) under your new Vendor identification. You also need an "Extended License" or upgrade your "Standard License". Once you have this new VID, you can globally offer your module(s) under various commercial terms — such as: Wholesale or Retail Commissions, Rent per-use, Subscription Lease, Life-Time Purchase, or as Public Domain (e.g: all non-commercial; Read “How to Copyright Software” written by a Lawyer; so that we avoid all the current "herd-following non-sense" offered as legal advice today! ). Once you select a term offering, it is permanent! So, do your "due diligence" before committing. You will be responsible for all maintenance, and software fixes to your module(s) — even if it was offered as PUBLIC DOMAIN. After 14 years of teaching college-level software and network engineering, I found this approach as the best solution toward homework completion and encouragement! If significant complaints are received, your module will be suspended from the Syndication Market — you've earned a "Failing Grade"; there are "NO DO OVERS".

Design Step #5: Building a "Game Book" Comic

Wikipedia states, "A gamebook is a work of printed fiction that allows the reader to participate in the story by making choices. The narrative branches along various paths, typically through the use of numbered paragraphs or pages. "

To build a "Game Book", all we need to do is store those "game turn results" (GTR) and print a consolidated report. We could save pictures for the gamer, OR better yet, let the gamer participate and take "screen-shots" of their gameplay. We could then let the gamer "drag'n'drop" their screen captures into "image place holders" within the narrative's text that we've prepared and preserved. I'll bet your imagination is running wild! Right?

How to accomplish this? Fortunately, I've already written another complete Workshop Guide for just this purpose.

  1. Go to the "Advanced" Tab and then select "CRON jobs".

    * NOTE: If your chosen web host does not support Cron Jobs you can use this website: Cron-Job.org


  2. To set up a cronjob you will need to press the "Create A New Cronjob" button and set a few parameters: the schedule, execution command, and the email to where the cronjob result notifications should be sent. Experience level - you can choose between Standard or Advanced levels of experience - this is how you might set up its scheduled times.

Here is an example of a cron job schedule:


Example commands:
php /home/<web hosting name>/<domain>/cubeville/cron/energyrefill.php
php /home/<web hosting name>/<domain>/cubeville/cron/pastDueCompetitions.php


Collect further ideas for your unique deployment from: https://www.studentstutorial.com/codeigniter/cron-job


Firstly, you should have an "Extended License" activated. Then ....
Determine who your merchant of record should be: Square vs. Paypal and Strips vs. Paypal vs. Square
If you've chosen PayPal, then Follow these official Paypal instructions:

https://developer.paypal.com/docs/api-basics/notifications/ipn/IPNSetup/#setting-up-ipn-notifications-on-paypal

Example Callback URL:

https://yoursite.com/paypal-ipn.php
  1. Login To Your PayPal Account

  2. Manually Change To Developer URL & Click On the “My Account” — Once you have logged into your Paypal account, you must manually change the URL to “https://developer.paypal.com/“. Or, simply click here – https://developer.paypal.com/. After this, you'll select the drop-down menu and click on "My Account" sub-menu.

  3. Click On “My Apps & Credentials” — In the developer dashboard, click on “My Apps & Credentials” available in the left sidebar.

  4. Navigate To “REST API Apps” — Once clicked, scroll down to the “REST API Apps” section and click on “Create App” button.

  5. Create New App — Once you clicked on the "Create App" button (in step 4 above), a pop-up window should appear, in which you'll enter this application's details such as "App Name" and "Sandbox Developer Account".
    App Name should be the name of the application that you are creating.
    Sandbox Developer Account takes your PayPal sandbox email address.
    For example, If your PayPal email address is “mypaypal@gmail.com” then your Sandbox email address will be “mypaypal-facilitator@gmail.com“. Clearly, all you have to do is add “-facilitator” just before the “@” symbol.
    After this, click on the “Create App” button.

  6. Generate Client ID & Secret Key For Your App — Once you have created your app by clicking the “Create App” button (from step 5), you are now required to generate Client ID & Secret Key for your app by first, click on the “Live” button.
    After this, your Client ID & Secret Key will be generated automatically.

  7. Select App Feature Options — Before moving to the next step make sure to select the following checkboxes (after scrolling down) to make your app fully functional —
    • Accept Payments
    • Invoicing
    • Payouts

    After this, click on the “Save”.

  8. Add PayPal Client ID & Secret Key In Admin Settings — The last step involves the addition of Client ID & Secret Key in your ecommerce solution — in my case, it is the Pabbly Form Builder.
    From your form builder, select the Payment element. Now click on Configure Payment.
    In that, select PayPal Payment Gateway, two new input fields will appear. One for Secret key and the other for Client ID.

After setting up your products/Payment details, click on the “Save Payment Settings” button to save the settings. Now, you are all set to collect payments via PayPal Payment Gateway.
NOTE: PayPal and Stripe payment gateway charge some amount as "Transaction Fees" on every customer transaction of yours.

The Site Key and Secret Key can be generated on this page:
https://www.google.com/recaptcha/admin/create

Choose reCAPTCHA v2 -> “I’m not a robot” Checkbox. Then fill in the other details and submit the form.


Finally, the reCAPTCHA v2 public and private keys are found on the following page:

Put the generated keys in the related fields on the Game Settings page of the Admin Panel.

Your "application type" determines which Facebook products and associated APIs become available. If this is your first time creating such an item or you just want to explore the creation flow, choose the "Something Else" option. Otherwise, we'll create a Facebook App for Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA) using "Build or Connect to a Game". Later, when you are more familiar with their products and APIs, refer to their app types document to determine which type of category is best suited for Adventurers of Renown™ — The Ruins of Able-Wyvern (ARRA), then create a new app and choose an appropriate type.
You will need the following:

Follow the steps below to create a Facebook App and generate an "App ID" and "App Secret" designations.

  1. Go to the Facebook for Developers page and log into with your Facebook account.

  2. After you logon, click the "My Apps" menu tab

  3. You will see any existing apps you may have created. If this is your first Facebook App, click on the "Create App" button". A popup window should appear; you must select a type for this application you're creating. The choice you make determines how Facebook will process our game. There are five possible application types. Review the supporting documents for more detailed information here.:
    • Business Integration;
    • Build or Connect to a Game — as either a "Gaming Service" (a game hosted on your website), an "Instant Game" (a game hosted on Facebook's servers);
    • Build Connected Experiences — apps that integrate consumer-related products like Facebook Login to provide app users with a more connected experience;
    • More Options.
    Once you choose an "app type", your app will only be presented with products, permissions, and features that are available to that app type. I'm choosing "Build Connected Experiences" to simplify my deployment because I'm simply creating a "Facebook Login" for our hosted game. Click "Continue".

  4. Type in your app Display Name, contact email. Click the "Create App" button.

  5. Since I chose the "Build Connected Experience", I can "Add Products" to my game. I'll choose only the Facebook Login (for now). (more detailed information here.)

  6. In this next window, I'll choose "Web" and then answer the 5 "Quick Start" questions.

  7. Let's go directly to our "Setting > Basic" in the left menu; we'll skip the remainder of the "Quick start" for now.

  8. In "Setting > Basic", you'll see your "App ID" and the "App Secret" — the App ID is visible and App Secret key is hidden. To see your "hidden App Secret", click on the "Show" button. Now that you know both of the "App ID" and "App Secret" Keys, let's add those into our configuration file ("Source/config.php" Lines 9, 10, and 11). The "App ID" and "App Secret" are only accessible, by default, from your Facebook account. We must make these available for public access.

  9. In the settings, type your "app domain" name, your contact email, the URL of your "Privacy Policy", "Terms of Service", and "Cookie Policy". Upload an App Icon, and assign a category and sub-Category. This will be used by the FB servers, after authentication, to return control to our application.

  10. Now go to "Status & Review", and toggle your app as — LIVE — available for the public.

https://developers.google.com/identity/sign-in/web/sign-in

Various Resources Used and Highly Recommended:

Various Tools for Game expansion and enhancements:

    © 1990-2021 Stephen Gose LLC. All rights reserved.