DOE Organisations Extension

From Fantasy Grounds Wiki
Jump to: navigation, search

The Organisations Extension provides a database for the recording of formal groups of Individuals, such as Guilds (including Thieves and Assassins Guilds), Bard Colleges, Adventuring Companies, Pirate Crews, Military Units, Secret Societies, Spy Rings, Terrorist Groups, Government Departments, Resistance Cells, Humanoid Tribes; in fact any conceivable group and hierarchy of groups can be recorded. The Extension will also work with the DOE: Locations Extension and other DOE Extensions.

The Organisations Extension consists of Organisation Records. Each Organisation may have a "parent" Organisation, and each "parent" Organisdation may have any number of "children" Organisations (including none). Organisations may also have a "relationship" with (be linked to) other Organisations as well.

All of the Organisation Records in the Extension can be used as Shortcut Links in other FG Records (ie as Links in entires in Story Records, as Map/Image Pin Links, etc). Some FG Records can also be used as targets to Links in Organisation Records (eg Organisation Records can have one or more Maps/Images Linked to them).

While the Organisations Extension will stop you from adding an Organisation Record as a "parent", "child" or "sibling" of itself, it is possible to set up "circular chains" of Organisation Records using two or more Records to do so (eg having Organisation 1 the "parent" of Organisation 2 which is the "parent" of Organisation 3 which is the "parent" of Organisation 1, completing the circle). It is STRONGLY recommended that you DO NOT do this, especialy if you intend to Export Organisation Records to a Module and/or use the Organisation Extension in conjunction with the DOE: Locations Extension.

Version

1.0 - Initial Creation
1.5 - FGv3.2 Compatibility Update
1.6 - FGv3.2.2 Compatibility Update

Dependencies

This Extension is dependent upon the following Rulesets:

  • CoreRPG v3.2.2+

This Extension is dependent upon the following Extensions:

  • DOE: Base v2.3

Ruleset Compatibility

This Extension has been tested and works with the following Rulesets:

  • CoreRPG Ruleset v3.2.2+
  • 3.5E D&D Ruleset
  • 4E D&D Ruleset
  • Barbarians Of Lemuria Ruleset
  • 6E Call Of Cthulhu Ruleset
  • 7E Call Of Cthulhu Ruleset
  • Fate Core Ruleset
  • MoreCore Ruleset
  • Numenera Ruleset
  • Pathfinder Ruleset
  • SavageWorlds Ruleset

This Extension has been tested and works with the following Rulesets, but requires compatible Graphics. Please contact the Author if you would like to help by providing suitable Graphics:

  • 13th Age Ruleset v3+
  • 5E D&D Ruleset
  • Castles And Crusades Ruleset
  • d20 Modern Ruleset

This Extension is not required by the following Rulesets, as this functionality is already built-in:

  • DOR: Core Ruleset
  • DOR: Alternity Ruleset
  • DOR: Dragon Warriors Ruleset
  • DOR: √úbergame Ruleset

This Extension will not work with any other Ruleset. Other CoreRPG-Child Rulesets may be able to use this Extension, but the Extension will need to be tested first. Please contact the Author if you would like this Extension to be tested with an unlisted CoreRPG-Child Ruleset.

Extension Compatibilities

This Extension has been tested and works with the following Extensions:

  • DOE: Alignment Graph Extension
  • DOE: Campaign Style Graph Extension
  • DOE: Locations Extension
  • DOE: OLE Extension
  • DOE: Sound Extension
  • DOE: Weather Extension
  • 1890s Era (CoC)
  • 5E - Language Fonts (FR) - Wizards
  • 5E - Language Fonts - Wizards
  • Blank Skills (Fate)
  • D&D Player's Handbook Desktop Decal Extension
  • Dark Ages (CoC)
  • Present Era (CoC)
  • Theme - Dungeon
  • Theme - Wood

This Extension has been tested and works with the following Extensions, but requires compatible Graphics. Please contact the Author if you would like to help by providing suitable Graphics:

  • 5E D&D Theme - Wizards

This Extension has not been tested with any other Extension, but should work with any Extension compatible with the CoreRPG Ruleset v3.2+ and any child Rulesets.

Supersedes

This Extension supersedes the following Extensions:

  • None

Known Bugs

This Extension has the following known bugs:

  • None.

Usage

Internal Referential Integrity

The DOE: Organisations Extension maintains "Internal Referential Integrity". This means that if you add an Organisation Record as the "parent" to a second Organisation Record, an entry is made in the "parent" Organisation Record listing the "child" Organisation Record as belonging to it as well (ie a two-way Link is formed, with a Shortcut Link being recorded in both Organisation Records). If you subsequently break the Link in either Organisation Record (by deleting a Record, moving the second Organisation Record to be the "child" of a third Organisation Record, etc) the Link in both Organisation Records is removed (and a new two-way Link is formed with the new Organisation Record, if applicable).

Note that the Referential Integrity only applies to DOE: Organisations Extension Records; as Organisation Records can have "child" Links to, or be "child" Links of, other Fantasy Grounds Records those Links are NOT subject to the Referential Integrity of the DOE: Organisations Extension - hence the DOE: Organisations Extension having "Internal" Referential Integrity.

Also note that the Referential Integrity also applies to any and all other DOE Extensions, where relevant.

It is possible to break the Internal Referential Integrity by exporting some Organisation Records to a Module without also Exporting their "parent" and/or "child" Records. The DOE: Organisations Extension is not sophisticated enough to detect and stop this from happening. However, if you subsequently create new Links with these "orphaned" Organisation Records the DOE: Organisations Extension will re-establish Internal Referential Integrity with these Organisation Records if at all possible.

Extension Details

General Information

All Controls and Entryfields should be self-explanitory. Notes are provided for those that may not be.

All Fields will be Hidden when Empty (strings) or when 0 (number). Comboboxes are never automativally hidden. Exceptions are noted below.

All Text Entryfields are multi-line.

Any Entries Shared with the Players MUST have the corresponding Linked Entries Shared as well, otherwise the Players will receive a Messagebox informing them that the Record Cannot be Found.

Organisation Records are eligible to be used as Pin Locations on Maps as well as Links in all CoreRPG sub-systems. Organisation Records should also be able to be used as Links in CoreRPG-Child Ruleset sub-systems, but this is not guaranteed.

Accessing The DOE: Organisations System

The DOE: Organisations System is accessed from the Menubar/Sidebar by clicking on the Large Organisations Button located with the other Large Buttons. Note that this Button may be different from the one shown in some Rulesets. Also note that the Button may not show up by default; in which case activate it from the Library Button/System.

This opens the Organisations Record List Window, which consists of a List of Organisations. In addition, there is the standard Filter Box along the bottom.

An Organisation Record consists of six Pages, each accessible from one of the Tabs along the right-hand side.

Main Page

Drag another Organisation Shortcut to the Parent Org entry to set the other Organisation Record as the Organisation's "parent".

The Type Entryfield can be used to record what type of Organisation this is: Military Unit, Trade Guide, Secret Society, Thieves Guild, etc.

The Purpose Entryfield can be used to record what the goal of the Organisation is: World Conquest, Control all the crime in the city, Convert the Unbelivers, etc.

The Reach Entryfield can be used to record just how far the influence of the Organisation stretches: Across the City, Across the World, Across the Galaxy, the Local Neighbourhood, etc.

Drag a Location or a Building Shortcut from the DOE: Locations Extension to the Headquarters entry to set the Location or Building Record as the Organisation's Headquarters or main base of operations.

The Leader Link Entry is used to Link an NPC or Character Sheet Record to the Organisation. Drag and Drop an NPC or a Character Sheet Record to Set.

The Leadership Style Entryfield is used to list the Style of the Leader (eg Despotic, Democratic, Dictator, etc).

The Structure Entryfield can be used to record the organisational structure of the Organisation: Cell, Hierarchy, Federation, Committee, etc. It is best used when a group of Organisation Records are used together eg each Cell in a Resistance Organisation would have a separate Organisation Record.

The Membership Benefits Field is a FormatedText Field and is used to record what benefits belonging to the Organisation brings.

The Membership Obligations Field is a FormatedText Field and is used to record what responsibilities and obligations belonging to the Organisation has eg Membership Dues, special clothing that must be worn, unquestioning obedience to the leader, etc.

The History Field is a FormatedText Field.

The GM Notes Field is a FormatedText Field and will NEVER be visible to Players.

NPCs Page

The NPCs Page contains two dynamically sizing Lists of NPC and Character and Encounter Record Links along with two separate List Edit Buttons (GM Only).

Each Entry in the NPC List consists of a Name, a Position Entryfield, a Rank Entryfield, a Reputation Entryfield, a GM Only Checkbox, a Shortcut Icon and, when the List is in Edit Mode, a Delete Item Button.

Each Entry in Encounter List consists of a Name, a GM Only Checkbox, a Shortcut Icon and, when the List is in Edit Mode, a Delete Item Button.

When a GM Only Checkbox is Checked the NPC, Character and/or Encounter Record Link is not displayed to the Players.

The Position, Rank and Reputation Entryfields of the NPC List are used to record these details about this NPC or Character in relation to this Organisation.

The Position, Rank and Reputation Entryfields of the NPC List can be modified whenever the parent Place Record is Unlocked.

Drag and Drop NPC Records from the NPC System to set NPCs and Character Sheet Records from the Characters System to set Characters.

Drag and Drop Encounter Records from the Encounter System to set Encounters.

Organisations Page

The Organisations Page contains a List of Organisation Record Links, along with a List Edit Button (GM Only).

Each Entry in the List consists of a Name, a Relationship ComboBox, a GM Only Checkbox, a Shortcut Icon and, when the List is in Edit Mode, a Delete Item Button.

The Relationship Combobox is used to record how this Organisation and the one listed are Linked. It has five values, four of which are settable from the Combobox's Dropdown List:

  • Ally: The two Organisations are allies.
  • Enemy: The two Organisations are enemies.
  • Friend: The two Organisations are frindly toward one another.
  • Indifferent: The two Organisations are are aware of each other but are not particularly friendly nor particularly hostile towards each other.
  • Subordinate: The listed Organisation is subordinate to this Organisation. This setting is only set when an Organisation is made a "parent" Organisation of another Organisation.

When the GM Only Checkbox is Checked the Organisation Record Link is not displayed to the Players.

Drag and Drop other Organisation Records to set.

Locations Page

The Locations Page contains three dynamically sizing Lists of Location, Town and Building Record Links along with three separate List Edit Buttons (GM Only).

Each Entry in each List consists of a Name, a GM Only Checkbox, a Shortcut Icon and, when the List is in Edit Mode, a Delete Item Button.

When a GM Only Checkbox is Checked the Location, Town and/or Building Record Link is not displayed to the Players.

Drag and Drop Location, Town and Building Records from the DOE: Locations Extension to set Locations, Towns and Buildings which this Organisation has some connection too. A corresponding Organisation Link will be placed in the relevant List on the relevant DOE: Locations Extension Record.

Maps Page

The Maps Page contains a List of Image and Map Links, along with a List Edit Button (GM Only).

Each Entry in the List consists of a Name, a GM Only Checkbox, a Shortcut Icon and, when the List is in Edit Mode, a Delete Item Button.

When the GM Only Checkbox is Checked the Image/Map Link is not displayed to the Players.

Drag and Drop Image/Map Records from the Images & Maps System to set.

Sounds Page

The Sounds Page contains a List of Sound Links, along with a List Edit Button (GM Only).

Each Entry in the List consists of a Name, a GM Only Checkbox, a Soundlink Icon and, when the List is in Edit Mode, a Delete Item Button.

When the GM Only Checkbox is Checked the Sound Link is not displayed to the Players.

Drag and Drop Sound Links from the Sound Board of the DOE: Sound Extension to set.

Notes Page

The Notes Page contains a Formatted Text Field which will be visible to the Players (if shared).

Useful Links

This Extension

Other Extensions By Dulux-Oz

Copyright Information

This Software is Copyright Peregrine I.T. Pty Ltd © 2004-2017 except where explicitly stated otherwise.

'Purple Die Over Australia' is Copyright Peregrine I.T. Pty Ltd © 2004-2017.

'Fantasy Grounds' is a trademark of SmiteWorks USA, LLC.

'Fantasy Grounds' is Copyright © 2004-2017 SmiteWorks USA LLC.

Copyright to other material within this Manual/Extension may be held by other Individuals and/or Entities. Nothing in or from this Manual/Extension in printed, electronic and/or any other form may be used, copied, transmitted or otherwise manipulated in ANY way without the explicit written consent of Matthew James BLACK or, where applicable, any and all other Copyright holders.

License Agreement

Please see the Extension Module (available from this Extension's Forum Page) for full Licensing details.

Donations

If you like this Extension and find it useful, you may like to consider making a Donation to the Author so that this Extension and similar Software can continue to be maintained and developed.

Donations can be made via PayPal to:

Thankyou.

Developer Notes

The following Notes are provided to enable other Developers to write Rulesets and Extensions which will be compatible with this one.

The Author is happy to assist fellow Developers to get their Ruleset and/or Extension working with this Extension - please contact the Author via the Fantasy Grounds Forums.

Extension Properties

This Extension includes the following Properties Tags:

<exclusiongroup>DOEOrganisations</exclusiongroup>
<loadorder>50</loadorder>

Return to the Extensions Page.