{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"693712d0-782e-4c25-be1c-5ed2087e86fd"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"408e812d-ddf0-40b5-abc8-29cd0d3fe02b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Item structure","type":"text"}]},{"type":"paragraph","content":[{"text":"All elements that can be bought for Nuyen use the ","type":"text"},{"text":"item","type":"text","marks":[{"type":"code"}]},{"text":" element. This is by far the most powerful and most complex XML definition you will encounter.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n ...\n \n \n \n \n \n \n \n \n \n \n ...\n ...\n ...\n \n \n \n ...\n \n \n \n \n \n ...\n \n ...\n ...\n ...\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Let us have a look at the item attributes first","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"strong"}]},{"text":" - The identifier (","type":"text"},{"text":"required)","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The identifier must be unique for all gear definitions in the whole application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lang","type":"text","marks":[{"type":"strong"}]},{"text":" - The language (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"A ISO language code. If it is present, it marks this definition as only valid for a specific langauge.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"strong"}]},{"text":" - The major sort category (","type":"text"},{"text":"required","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"This is used to help the user find the item and usually follows the categories from the rulebooks.","type":"text"},{"type":"hardBreak"},{"text":"There can only be one sort type per item.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"subtype","type":"text","marks":[{"type":"strong"}]},{"text":" - A sort catgory within the major category (","type":"text"},{"text":"required","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"More attributes are supported to allow being more compatible with old Genesis datafiles.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"avail","type":"text","marks":[{"type":"strong"}]},{"text":" - A shortcut for a the items availability (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"This shortcut definition cannot deal with formulas.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"price","type":"text","marks":[{"type":"strong"}]},{"text":" - The cost in Nuyen (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"This shortcut definition does not support formulas","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"modOnly","type":"text","marks":[{"type":"strong"}]},{"text":" - ","type":"text"},{"text":"Modification Only","type":"text","marks":[{"type":"em"}]},{"text":" (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"A item with ","type":"text"},{"text":"modOnly=”y”","type":"text","marks":[{"type":"em"}]},{"text":" can not be selected directly by a user.","type":"text"},{"type":"hardBreak"},{"text":"Better use the RESTRICTED flag","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"count","type":"text","marks":[{"type":"strong"}]},{"text":" - Marks if the object should be countable (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"Better use the COUNTABLE flag","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Elements within an ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"attrdef","type":"text","marks":[{"type":"strong"}]},{"text":" - Attribute Definition","type":"text"},{"type":"hardBreak"},{"text":"Used to define a value for a single item attribute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"choice(s)","type":"text","marks":[{"type":"strong"}]},{"text":" - Choices a user needs to make to configure the item.","type":"text"},{"type":"hardBreak"},{"text":"Usually this is the items rating, but some items require more decisions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"flag","type":"text","marks":[{"type":"strong"}]},{"text":" - Adds a flag to the item","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"modifications","type":"text","marks":[{"type":"strong"}]},{"text":" - A list of modifications this item provides to either the character or a parent item (in case of accessories)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"requires","type":"text","marks":[{"type":"strong"}]},{"text":" - A list of requirements to use the item and even be able to put in in the inventory","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"usage","type":"text","marks":[{"type":"strong"}]},{"text":" - How should the item be used? Is it carried? Should it be embedded as an accessory? Or is it an Implant or a not easily reversed modification? In case of accessories, a slot (required) and a size value (optional) can be given.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"armor, matrix, weapon…","type":"text","marks":[{"type":"strong"}]},{"text":" - Shortcut elements for easy data input and backward compatibility.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"variant","type":"text","marks":[{"type":"strong"}]},{"text":" - List of possible variants of this item. ","type":"text"},{"type":"hardBreak"},{"text":"For some items, like e.g. ","type":"text"},{"text":"flare compensation","type":"text","marks":[{"type":"em"}]},{"text":", do exist multiple variants.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"A very simple item","type":"text"}]},{"type":"paragraph","content":[{"text":"The very basic item","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":607,"id":"d349ad5d-a265-4242-b57e-19496e08a582","collection":"contentId-2007138305","type":"file","height":35}}]},{"type":"paragraph","content":[{"text":"looks like this in XML","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"If you choose the backward compatibility notation, it would be:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Items with shortcuts","type":"text"}]},{"type":"paragraph","content":[{"text":"For ease of use and for backward compatibility with Genesis data, there are elements within an item, that replace attribute definitions.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":676,"id":"3d078758-1fca-4a1c-9cfc-9e85ee37301c","collection":"contentId-2007138305","type":"file","height":52}}]},{"type":"paragraph","content":[{"text":"would be written like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"With the use of the shortcuts elements and the -line, this can be shortened to","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"modifications"}},"macroMetadata":{"macroId":{"value":"a659832350b0bff7ad025efcbe902ff9"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"7c16c5bc-df8b-42bd-a429-a88d598e7182"}},{"text":"Items with modifications","type":"text"}]},{"type":"paragraph","content":[{"text":"Some items have modifications that should be applied - to either the item itself, the parent item containing the defined item or the character. The most common example is defining slots for accessories","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":681,"id":"9980e9f2-4c22-4aad-b4c7-604cf86c229d","collection":"contentId-2007138305","type":"file","height":21}}]},{"type":"paragraph","content":[{"text":"Like all light pistols, the Beretta supports Top or Barrel-mounted accessories","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" is they key element here - it says that it will modify/provide a Hook (meaning a slot for accessories) of a specific type. Note that both Hooks don’t require a capacity value.","type":"text"}]},{"type":"paragraph","content":[{"text":"ToDo: Modifications with capacity","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Items with requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"ToDo: assault rifles with strength","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Accessories - “usage”","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes items are not intended to be used on their own, but added into a slot of an existing item (see ","type":"text"},{"text":"Modifications","type":"text","marks":[{"type":"link","attrs":{"href":"#modifications"}}]},{"text":" ) - this is where the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" element comes into play. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This signals that the item is to be embedded into the optical slot of an item and requires 3 points of capacity.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can have more than one element inside an item.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"There are 3 valid usage modes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CARRIED ","type":"text","marks":[{"type":"strong"}]},{"text":"(this one is implicit, if no is definied )","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EMBEDDED ","type":"text","marks":[{"type":"strong"}]},{"text":"- for all kinds of accessories (requires slot= and supports size= attributes)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IMPLANTED ","type":"text","marks":[{"type":"strong"}]},{"text":"- for all bodyware (items costing essence)","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If no ","type":"text"},{"text":"usage","type":"text","marks":[{"type":"code"}]},{"text":" element is present, a CARRIED usage mode is assumed.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Items with variants","type":"text"}]},{"type":"paragraph","content":[{"text":"Variants are different versions of the same item. If an item has variants, it copies all attributes from the main item and allows you to override those attributes or even add new ones.","type":"text"}]},{"type":"paragraph","content":[{"text":"A good example is the “Flare Compensation” in Shadowrun 6. This is a visual enhancement that can be added as an accessory to OPTICAL slots (contacts, glasses …) or as an helmet accessory. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":702,"id":"e300ef52-584c-4d8f-9ee4-2a74ba546c53","collection":"contentId-2007138305","type":"file","height":55}},{"type":"caption","content":[{"text":"Normal accessory","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":698,"id":"e9f981a5-9eee-4b7a-ba26-a9f26b41b8a7","collection":"contentId-2007138305","type":"file","height":158}},{"type":"caption","content":[{"text":"Cyberware - or accessory for cybereye","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You will note that the the cyberware version is significantly expensive and has a different availability. Also both versions are considered augmentations and are subject to cost changes e.g. for Deltaware - which does not apply to the regular version.","type":"text"}]},{"type":"paragraph","content":[{"text":"We decide to consider the normal visual enhancement the “regular” version with two use cases (OPTICAL slot or HELMET_ACCESSORY slot). We than need two different versions for the cyberware - one that costs capacity and one that costs essence.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \t\n \t\n \t\n \tAUGMENTATION\n \n \n \t\n \t\n \t\n \t\n \tAUGMENTATION\n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Now we have an item with a variant “cybereye” and one called “bodyware”. The ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" line is specific to this case and flags the items to be subject to cost changes due to augmentation grades.","type":"text"}]},{"type":"paragraph","content":[{"text":"Variants can have ","type":"text"},{"text":"attrdef","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"usage","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"flags","type":"text","marks":[{"type":"code"}]},{"text":" on their own. They also support the shortcuts like ","type":"text"},{"text":"weapon","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"armor","type":"text","marks":[{"type":"code"}]},{"text":" …","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Dynamic Items: Choices and Formulas","type":"text"}]},{"type":"paragraph","content":[{"text":"Not all items are simple with static values. Often you have to make a decision (e.g. the rating) when adding the item and have values that depend on that decisions (like Cost = Rating * 100). This is where ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" will help you.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":938,"id":"57e85402-ac49-41f9-b444-8c543068272a","collection":"contentId-2007138305","type":"file","height":61}},{"type":"caption","content":[{"text":"Values depending on a decision","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n\t \n \n \n\t\n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"choices","type":"text","marks":[{"type":"code"}]},{"text":" block defines one choice (there can be more choices) that will let you decide an item attribute (those you define via ","type":"text"},{"text":"attrdef ","type":"text","marks":[{"type":"em"}]},{"text":"), specifically that or the RATING. You can choose the ratings from 1-14. The UUID given is to store your decision in the character.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can access item attributes in ","type":"text"},{"text":"attrdef","type":"text","marks":[{"type":"code"}]},{"text":" and modifications and requirements using the $ infront of it. So ","type":"text"},{"text":"$RATING","type":"text","marks":[{"type":"code"}]},{"text":" will be replaced with the rating - or in this case the rating decision.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to build VERY simple formulas with basic operations (Addition, Substraction, Division, Multiplication).","type":"text"}]},{"type":"paragraph","content":[{"text":"The application will ensure that decisions are made all present when an item is added to the character.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dynamic table lookups","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes values depending on a (rating) choice cannot be expressed in a formula.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":907,"id":"e47b7863-db8e-44b0-a6bf-9162f9c67758","collection":"contentId-2007138305","type":"file","height":149}}]},{"type":"paragraph","content":[{"text":"In the example above, the ","type":"text"},{"text":"essence","type":"text","marks":[{"type":"em"}]},{"text":" can be expressed in a formula, but the other attributes cannot. For this case the ","type":"text"},{"text":"attrdef","type":"text","marks":[{"type":"code"}]},{"text":" element has an optional ","type":"text"},{"text":"table","type":"text","marks":[{"type":"strong"}]},{"text":" attribute, which is used ","type":"text"},{"text":"after","type":"text","marks":[{"type":"em"}]},{"text":" the value attribute has been calculated. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n

\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"$RATING","type":"text","marks":[{"type":"strong"}]},{"text":" has a range from 1-5. It is used to look up in the table and use that result instead.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The result of the formula in the ","type":"text"},{"text":"value","type":"text","marks":[{"type":"code"}]},{"text":" attribut must be a positive (1 or higher) integer and may not have a value higher than the elements in the comma-separated table.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":" that the table can be used in the ","type":"text"},{"text":"attrdef","type":"text","marks":[{"type":"code"}]},{"text":" element as well as in the ","type":"text"},{"text":"valmod","type":"text","marks":[{"type":"code"}]},{"text":" modification element.","type":"text"}]}],"version":1}

Browser not supported