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 and subdirectories required to operate. This will default to your Documents folder. You will then be asked for your MUC name, whether you have Google Drive for Desktop, the path to the RP Information folder (if you selected yes for Google Drive). 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, location or species. You will be asked different parameters. There are a few properties that may require some additional info.
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. 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
Gender - The only additional behaviour is automatically changing female and male to ♀ and ♂ respectively alongside dual gender to ♂♀. 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.
Location
Place Category - Required property. Select from a range of options. An invalid option, blank or '?' will result in "other" being applied to the field. Special parameters supported.
Population - Numerical values preferred. Supports special parameters.
Condition - Select from a range of options. Selecting "0" or an invalid option will result in "N/A" appearing. This property is only required for indoor locations
All other location specific properties operate as normal
Species
Height - Height will ask you for the minimum, average and maximum height range for the species. Metres/feet and centimetres/inches are asked separately. You only need the numbers.
Weight - Asks you for minimum, average and maximum ranges for the species.
Temperature - Entering '?' into all values results in "Unknown" being applied. Text adjusts to unknown min or max values.
Lifespan - Maximum lifespan can have "N/A" applied to it by entering no value
Rarity - Select from a range of options. Entering '?', '9' or an invalid option will apply "Unknown" to this value.
Enemies/Creatures
All enemy specific properties operate similar to one another. Entering a '?' or leaving a field blank will cause '???' to appear in that field.
Posts
All fields behave as a string.
All description type properties behave like the global defaults.
Global Defaults
Name - This will also be the name of file that stores your character, location or species properties when saved. You cannot change the name after you create the object.
Display Name - This will be the name displayed on your character, location or species page. This property can be changed.
Measure - Prior to being asked height, weight and temperature (location), you'll be asked for imperial, metric or codian 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 unit.
Description - New or existing you will enter the description of your character, location, species. 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. Descriptions can now be input by paragraph, so until you leave a paragraph blank you can keep entering data.
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 leave display name blank, it will be replaced with ???
If you place a '?' in any field that property will be populated with Unknown
If you leave all threat level properties blank it will be replaced with Unknown
Any type specific properties not listed above are normal string inputs
After you are done filling in the required information, you will be asked if you want to save your properties. You can type '1', 'y', 'Y', 'yes' or 'Yes' to save. Any situation where you decide not to save the properties means that data will be overwritten when you create another new object or exit the table generator. The files will be saved in the subdirectory matching your item type (character/location/species being saved in their respective subfolders) with the file name being the name of that object.
The import menu has a similar appearance to the new menu, asking for what type of object you would like to import. You will then be asked for the name of the object. This will be the same name you put for the object when creating them. The properties of the object will be imported. You have to do this to generate a table if you have not already created a new object.
This option will bring you to a large submenu with all of your object's properties. The menu that appears depends on whether your loaded object is a character, location or species.
Character Edit Menu
Template tags, located within '[]', are used to indicate which template that property will display in. The following apply to character templates.
PL:P - Penny Luck: Primary (or detailed)
PL:S - Penny Luck: Secondary
PL:T - Penny Luck: Trimary
BB:P - Blue Blood: Primary
BB:S - Blue Blood: Secondary
ALL - All character templates
No tags - Does not appear in templates
Location edit menu
Template tags, located within '[]', are used to indicate which template that property will display in. The following apply to location templates, regardless of Penny Luck or Blue Blood.
In - Indoor
Out:B - Outdoor: Basic
Out:D - Outdoor: Detailed
ALL - All location templates
No tags - Does not appear in templates
Additionally, a Category property will be visible for locations. If you configured location categories in the MUC settings menu, you can set it here. The default is 1.
Species edit menu
Template tags, located within '[]', are used to indicate which template that property will display in. The following applies to the species template, regardless of Penny Luck or Blue Blood.
B - Basic
D - Detailed
ALL - All species templates
Notable differences for editing is that height, weight and temperature will not ask you for the unit as this cannot be changed. Location temperature, precipitation and wind will also not have their units asked again. You can change the values however. The question at the top will be an indicator of which object you presently have active.
Additionally, a Category property will be visible for species. If you configured species categories in the MUC settings menu, you can set it here. The default is 1.
Enemy edit menu (V3.1+)
Template tags, located within '[]', are used to indicate which template that property will display in. The following applies to the species template, regardless of Penny Luck or Blue Blood.
E - Enemy
B - Boss
ALL - All species templates
There is a category option for enemies which can be configured in the MUC menu. There are three different category slots.
Pages edit menu (V3.1+)
Template tags will be implemented in the future when more than one type of page becomes available.
This option is only available when you have a character active. This option brings up a list of available templates based on what type of object you have active. Characters, locations and species all have their own type of templates available.
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. If you do not have settings configured for TPG's upload function or have it off, the nav bar will not have contents in it.
The result would look like this: (The nav bar component will be changed to only show on the non-Google site upload in a future update.)
When you have generated a table and are leaving the table generation menu, you will either be given instructions for a manual upload or, if you have Google Drive options configured, be asked to upload your changes. If you have changed your preferences to automatic, you will not get this prompt and the upload will take place automatically. If you have configured preferences to no, an upload will not take place and you will get the manual upload instructions.
This menu option brings you to your user options. From here you can change your Master User Controller (MUC) name, your cloud preferences, upload path, upload preferences and categories.
MUC
Please advise an administrator if you wish to change your MUC name. This option allows you to input your MUC name if you missed the prompt for it when the script asked initially.
Cloud Setting
Allows you to specify whether you have Google Drive on your desktop or not. Upload functions in the script can utilize additional features if you do.
Cloud Path
Only applicable if you have set Cloud Setting to 1 (or Yes). This is where you specify your Google Drive path to the Roleplay Information folder.
Upload Preferences
Only applicable if you have set Cloud Setting to 1 (or Yes). You can set this to automatic, ask or no. This controls the upload process after you generate a table.
Location Categories
You can edit up to three custom categories for your locations page. By default there is one configured as 'Locations'. These changes take effect next time you upload changes to a location.
Species Categories
You can edit up to three custom categories for your species page. By default there is one configured as 'Species'. These changes take effect next time you upload changes to species.
Enemy Categories (V3.1+)
You can edit up to three custom categories for your enemy page. By default there are two configured as 'Enemies' and 'Bosses'. These changes take effect next time you upload changes to enemies.
You will be asked if you want to save the changes to your settings afterwards. The file for user preferences is saved in the root of the TPG folder.
TPG presently covers these versions:
Penny Luck: Primary
Penny Luck: Secondary
Penny Luck: Trimary
Blue Blood
Penny Luck: Indoor
Penny Luck: Outdoor (Basic)
Penny Luck: Outdoor (Detailed)
Blue Blood: Indoor
Blue Blood: Outdoor (Basic)
Blue Blood: Outdoor (Detailed)
Penny Luck: Basic
Penny Luck: Detailed
Blue Blood: Basic
Blue Blood: Detailed
Enemy
Boss
Special parameters can be applied to objects to change labels, utilize special categories and more.
Medal=1 Shows the extra property for medals. Only use this if your character has been given at least one medal. Only used for primary templates.
PopN=Prison - Changes "Population" label to "Prisoners" label. Only applies to outdoor templates.
PopN=Work - Changes "Population" label to "Workers" label. Only applies to outdoor templates.
PopN=Visit - Changes "Population" label to "Visitors" label. Only applies to outdoor templates.
Own=Shared - Places your character into the shared section of the list. For characters, locations and species with more than one MUC.
Own=Borrowed - Places the character into the borrowed section of the list. For characters, locations, species and enemies that were not originally created by you.
LocCat=Ruined - Adds "(ruined)" to your location category. Can be used with other LocCat parameters.
LocCat=Multi - Enables selection of multiple location categories. Can be used with other LocCat parameters.
0.9
+ New characters can be created
+ Created characters can be imported
+ Imported and created characters can have their properties edited
+ Tables can be generated using the Penny Luck character template
+ Info section for notes on the script
1.0
+ Penny Luck character templates added
+ New submenus
• Subfolder for characters
• Improvements to description editing
1.01
○ Fix for save issues
2.0
+ New locations can now be created and edited
+ New species can now be created and edited
+ New submenus
+ Conditional submenus for generation
+ Import support for locations and species
• Menu updated
• Improvements to character displays
• Tags on character, location or species creation
○ Siblings property now displays on character tables
○ Display issues for generation addressed
2.1
+ Blue Blood: Secondary character template added
• Tags added to edit menus
• Certain species will change companion field to master
○ Primary element variable restores properly after creating a Blue Blood: Primary template
2.2
+ Penny Luck: Outdoor (Detailed) added
+ Blue Blood: Outdoor (Detailed) added
+ Additional properties for locations
+ Special parameters can now be assigned to objects
• Penny Luck: Outdoor renamed Penny Luck: Outdoor (Basic)
• Blue Blood: Outdoor renamed Blue Blood: Outdoor (Basic)
• Units now append to temperature, wind and rainfall
• More place categories can now be selected
○ Fixed variable display in Blue Blood: Secondary template
○ Fixed incorrect property request when editing character weight
3.0
+ Web Upload functions added
+ New properties for characters, locations and species
+ User settings
+ Location and species categories added
• Generation compatibility for uploading implemented
• Additional special parameters added
○ Fixed issue when selecting imperial units
* If you created a character and didn't get a unit selection prompt, you will have to edit the measurement parameter in the .xml file. Contact Cody for assistance if required.
○ Fix for species temperature values returning blank
3.01
○ Fix for Blue Blood locations not being added to locations.
3.1
+ Enemy templates added
+ Character posts can now be made
+ Generation for pages and enemies
• MUC menu updated to add categories for enemies
• Import compatibilities for missing properties