Post date: Feb 7, 2022 16:00:00
Hello everyone,
I have been hard at work on making an easier way to make character tables and would like to give you some information on the new script I am working on. The goal of this project is to generate embed code. This makes editing tables far less painful than the new Google Sites has made it. Thanks to the support of responsive HTML, these tables can react to different size displays. I would like to provide the proper instruction to use this.
First things first, this file is a PowerShell script. It is possible that your computer's default settings will not allow it to run. If you notice the window opening and closing right away this is likely the cause. Should this happen you will need to open a PowerShell window as an administrator and type Set-ExecutionPolicy RemoteSigned which allows running of local scripts on your computer, but requires remote scripting to be signed. This script does not utilize remote functions.
When you first run the script, it will create the directory required to operate. This will default to your Documents folder. Whether you've run the script before or not, you will then be presented with a menu.
This will walk you through the process of creating a new character. You will be asked different parameters. There are a few properties that may require some additional info.
Name - This will also be the name of file that stores your character properties when saved. You cannot change the name after you create the character.
Unit (hidden property) - Prior to being asked height and weight, you'll be asked for imperial or metric units. Units will be placed automatically, so you don't need to put them in. You cannot change the units of measurement once you create the character.
Height - Height will ask you about metres/feet and centimetres/inches separately. You only need to put the numbers into this.
Birthday - Birthday will ask for the day, then the month, then the year
Gender - The only additional behaviour is automatically changing female and male to ♀ and ♂ respectively. Other genders will display as is
Threat Level - You will be asked threat levels for four different situations. Friendly, Neutral, Hostile and Duty. You do not have to fill all of these out. This field will display differently depending on if you've assigned a number to more than one or just one value
Elements - Please note that Primary Element and Secondary Element are separate fields. Only put one element into each field. A future version may implement recognition of registered elements.
Description - New or existing you will enter the description of your character. You can copy from another document and right click in PowerShell to paste the contents. This field works with HTML tags, so you can use <i>italics</i>, <b>bold</b>, <u>underline</u> and so on.
Global Defaults
If you leave a field blank for properties where no value is permitted, it will be populated with N/A. This applies to mother, father, siblings, partner, children, friends, companion and secondary element.
If you leave a required field blank, that will be populated with Unknown
If you place a '?' in any field that property will be populated with Unknown
If you leave part of a birthday blank or use '?', those fields will appear as '??' in the birthday format. If you leave all birthday properties blank or with a '?', it will be replaced with Unknown
If you leave all threat level properties blank it will be replaced with Unknown
After you are done filling in the required information, you will be asked if you want to save your character properties. You can type '1', 'yes' or 'Yes' to save. Any situation where you decide not to save the character properties means that data will be overwritten when you create another new character or exit the table generator. The files will be saved in the script's directory with the file name being the name of your character.
This option will ask for your character name. This will be the same name you put for the character when creating them. The properties of the character will be imported. You have to do this if you have started a session and have not created a new character.
This option will bring you to a large submenu with all of your character's properties. Most options here will behave similar to creating a new character.
A notable difference is that height and weight will not ask you for the unit as this cannot be changed. You can change the values however. The question at the top will be an indicator of which character you presently have active.
This option is only available when you have a character active. This will generate the code that you can put into an embed to get the desired result. All you have to do with this is to copy it over and select the embed option when on your character page.
Copy the text that was output. Alternatively you can also copy the text from the .html file that is generated when the Generate Table command is executed.
The result would look like this:
That is all there is to this particular script. You can find this script in the Roleplay Information folder. If there are any issues, please let me know.
Cody