Ares D6System Plugin

An open d6 system plugin for AresMUSH.

Credits

Lyanna @ AresCentral

Overview

This plugin can be used as an alternative to the fs3 system. It is based on the D6 system published by West End Games and can be configured to fit various settings and requirements. The system offered here is based on the D6 Adventure sheet. It covers most areas, such as chargen, rolls and a damage system, whereas post chargen raising/adding abilities will have to be handled through requests/admin.

You need to disable the fs3 plugin on the ares-webportal before you install this plugin.

What this plugin covers

• Setting attributes, skills, specializations, advantages, disadvantages and special abilities in chargen, both on the game client and on the webportal.
• Rolling abilities from the game client and the webportal scene system.
• Rolling abilities from the webportal job menu to add a roll to a job.
• Enhancing rolls with spending fate and/or character points.
• Optional: Rolling against a difficulty level.
• In game sheet command and sheet integration on the character page of the webportal.
• Optional cron job for regularly awarding character points (similar to how it's done with xp on FS3 Systems).
• Admin game client commands to manage fate and character points (awarding/removing).
• Admin game client commands for handling post chargen ability raises which will happen on request basis.
• The possibility to define starting abilities based on the group values of a char, which will be automatically applied when resetting during chargen. These will also be checked against in the app review.
• Optional dice limit for rolls (specializations/skills/attributes). Additional modifiers will still apply.
• A damage system based on wound levels, including an admin command for setting wound levels, player commands for healing other players and cron jobs for natural healing. The damage system also has full webportal support to be used in scenes and also in jobs.

There may be bugs

This plugin has been tested on a more than one live game, yet there may be bugs and glitches. If you find any or if you have other suggestions for improvement, please let me know. I'm Lyanna on the AresMUSH discord server. Also, I'll gladly help when you need assistance with installation, configuration etc.

Compatibility

This plugin is compatible with AresMUSH v1.0.9 (ember 4) upwards. If you want to use this plugin but you are running on AresMUSH < 1.0.9, you may have to have a look at d6-chargen-option.js and comment out / remove the new code ( marked as 'ember 4' in the comments ) and uncomment the code for older ember versions.

Screenshots

Game Sheet

Game Client Roll Examples

Webportal Roll Ability Window

Webportal Opposed Roll Window

Webportal Chargen - Attributes

Webportal Chargen - Skills

Webportal Chargen - Specializations

Webportal Chargen - Add Option

Webportal Chargen - Edit Option

Installation

In the game, run: plugin/install https://github.com/cailleach1310/ares-d6system-plugin

Updating Custom Files

If you do not have any existing edits to these custom files, you can use the files in the custom_files folder of this repository as-is. If you do, then you may use them as templates to add the lines of code needed for the d6system plugin.

aresmush/plugins/profile/custom_char_fields.rb

Update with: custom_files/custom_char_fields.rb

aresmush/plugins/chargen/custom_app_review.rb

Update with: custom_files/custom_app_review.rb

aresmush/plugins/scenes/custom_scene_data.rb

Update with: custom_files/custom_scene_data.rb

aresmush/plugins/jobs/custom_job_data.rb

Update with: custom_files/custom_job_data.rb

ares-webportal/app/templates/components/chargen-custom.hbs

Update with: custom_files/chargen-custom.hbs

ares-webportal/app/components/chargen-custom.js

Update with: custom_files/chargen-custom.js

ares-webportal/app/templates/components/chargen-custom-tabs.hbs

Update with: custom_files/chargen-custom-tabs.hbs

ares-webportal/app/custom-routes.js

Update with: custom_files/custom-routes.js

ares-webportal/app/templates/components/profile-custom.hbs

Update with: custom_files/profile-custom.hbs

ares-webportal/app/components/profile-custom.js

Update with: custom_files/profile-custom.js

ares-webportal/app/templates/components/profile-custom-tabs.hbs

Update with: custom_files/profile-custom-tabs.hbs

ares-webportal/app/templates/components/live-scene-custom-play.hbs

Update with: custom_files/live-scene-custom-play.hbs

ares-webportal/app/components/live-scene-custom-play.js

Update with: custom_files/live-scene-custom-play.js

ares-webportal/app/templates/components/job-menu-custom.hbs

Update with: custom_files/job-menu-custom.hbs

ares-webportal/app/components/job-menu-custom.js

Update with: custom_files/job-menu-custom.js

Adding Chargen Stages

Add the following lines to 'stages' in the chargen.yml, i.e. inbetween 'ranks' and 'background':

   reset:
     help: reset
   attributes:
     help: attributes
   skills:
     help: skills
   specializations:
     help: specializations
   advantages:
     help: advantages
   disadvantages:
     help: disadvantages
   specials:
     help: special abilities

Adding Menu Items to the Webportal

/aresmush/game/config/website.yml

Add routes to the top bar menu under 'System' for the configured abilities and wound levels.

  top_navbar:
(...)
- title: System
  menu:
(...)
    - title: Abilities List
      route: d6-abilities
    - title: Wound Levels
      route: d6-wound-levels
(...)

Optional: Adding rolls to jobs from the webportal

This option requires core code modifications. If you want to enable this feature, see this file for instructions.

Optional: Alternate template for the d6-abilities route

If you feel that the traditional d6-abilities route looks too cluttered, there is this alternate template available. Simply replace the old file in the folder /ares-webportal/apps/templates with this file. This template uses tabs.

Configuration

After installation, you should check the d6system config files below and make adjustments where necessary. The keys in the configuration files are explained below.

d6system_misc.yml

achievements

There are three achievements defined, d6_roll for making a roll for the first time, d6_fate_spent for spending a fate point on a roll, and d6_cp_spent for spending a char point to add another die to the roll.

cp_cron

Configuration for the cron job that handles the automatic character points raise of characters.

extranormal_blurb

Chargen info about extranormal attributes and skills.

max_char_hoard

Maximum character points that can be stored on a character.

max_fate_hoard

Maximum fate points that can be stored on a character.

periodic_cp

Amount of character points that are gained with each run of the cron job.

roll_max_dice

If you want to have a house rule on your game, limiting dice for ability roles, you need to enter the limit here. Examples: "10D" or "6D+2". If you don't want to have a limit, leave this entry at the default "{}". Additional modifiers will still apply.

sheet_columns

This is where you can customize the columns of the sheet, allowing you to arrange attribute-skill-blocks to optimize the look of the sheet. This affects both the in game sheet and the webportal sheet. Please note: Only those extranormal skills and attributes will be listed that have actually been learned. Also: "Extranormal" instead of attribute name will list the extranormal attributes and respective skills as one block.

show_sheet

Here you can toggle visibility of the sheet for other players.

d6system_attrs.yml

attributes

Each attribute has a name and a desc. The attribute list can be adjusted here.

attributes_blurb

This is the respective info for chargen.

extranormal_attributes

Extranormal attributes are listed here, as some of the limitations are not valid for them. If you don't have any extranormal attributes on your game, set this to '{}'.

d6system_skills.rb

skills

Each skill has a name, a linked_attr and a desc. The skill list can be adjusted here.

skills_blurb

This is the respective skills info for chargen.

specializations_blurb

This is the respective info on skill specializations for chargen.

d6system_advantages

advantages

Advantages have a name, a desc and ranks. Please note that ranks can be either a number or a slash-separated list of valid ranks. This is where you would adjust the list of advantages for your game.

advantages_blurb

This is the chargen information on advantages.

d6system_disadvantages

disadvantages

Disadvantages have a name, a desc and ranks. Please note that ranks can be either a number or a slash-separated list of valid ranks. This is where you would adjust the list of disadvantages for your game.

disadvantages_blurb

This is the chargen information on disadvantages.

d6system_specials

special_abilities

Special abilities have a name, a desc and a cost. Cost defines the cost for the 1st rank of the ability. This is where you would add or remove special abilities for your game.

specials_blurb

This is the chargen information on special abilities.

specials_difficulty

This key should be set to 'cost' if you want each subsequent rank of a special ability to cost the same amount of creation points as the 1st rank. Set this to '1' or any other number, if you want a unified (cheaper) cost for ranks greater than 1.

d6system_chargen.yml

Anything pertaining to character generation, such as chargen limits and starting abilities.

creation_points

Here you can set the max amount of creation points for character generation.

max_attr_dice_total

Maximum number of dice you can distribute on attributes in chargen. Default is 18.

max_attr_dice

Maximum value of dice for an attribute in chargen.

min_attr_dice

Minimum value of dice an attribute in chargen.

max_skill_dice_total

Maximum number of dice you can distribute on skills in chargen. Default is 7.

max_skill_dice

Maximum value of dice for a skill in chargen.

min_skill_dice

Minimum value of dice for a skill in chargen.

max_advantage_rating

Maximum rank for an advantage in chargen.

max_disadvantage_points

Maximum points you can gain from taking disadvantages in chargen.

max_rank_specials

Maximum rank for special abilities in chargen.

starting_abilities

Group based starting abilities (similar to starting skills in fs3skills). You can define attributes, skills and specializations with their minimum ratings. For specializations you have to add the respective skill in brackets after the name of the specialization, as shown in the example below.

   Faction:
     Noble:
       abilities:
         Knowledge: 3D
   Vocation:
     Warrior:
       abilities:
         Melee Combat: 2D
         Reflexes: 4D
         Physique: 4D+1
         Coordination: 3D
         Sword (Melee Combat): 0D+2

starting_char_points

By default 1.

starting_fate_points

By default 3.

d6system_damage.yml

Specifics regarding wound levels and healing can be configured in this particular file.

assist_heal_block

Number of hours, during which a char will be blocked from healing another char after attempting a heal on them.

assist_healed_cron

Times, at which assisted heal blocks will be checked.

heal_skills

Skills that can be used by a healer for healing another char. Each skill can have a modifier configured (usually '0').

natural_heal_cron

Times for the natural heal cron check.

natural_heal_message

Text for the natural heal job that will be triggered by the natural_heal_cron.

wound_levels

Definition of the wound levels, including their name, effect, natural heal difficulty, assisted heal difficulty and resting time (in days).

wound_level_blurb

General information about wound levels for the wound level route.

wounds_fields

Definition of fields for the wound/list admin command.

Uninstallation

Removing the plugin requires some code fiddling. See Uninstalling Plugins.

License

Same as AresMUSH.