Project talk:Data Dictionary: Difference between revisions

From Step Mods | Change The Game
No edit summary
No edit summary
Line 90: Line 90:
The following won't be stored semantically but are text boxes for the various text associated with the pack's description, installation, etc.
The following won't be stored semantically but are text boxes for the various text associated with the pack's description, installation, etc.
* {{Fc|#9eb6e6|'''''Description'''''}} (none/plaintext) - Introduction and description of the pack and its purpose.
* {{Fc|#9eb6e6|'''''Description'''''}} (none/plaintext) - Introduction and description of the pack and its purpose.
* {{Fc|#9eb6e6|'''''Pre-Pack Setup'''''}} (string) - Explanation of any pre-requisite steps that need to be taken before installing the pack's mods.
* {{Fc|#9eb6e6|'''''Pre-Installation Setup'''''}} (none/plaintext) - Explanation of any pre-requisite steps that need to be taken before installing the pack's mods.
*: {{fc|white| Need a better name :P }} ~[[User:Farlo|Farlo]][[File:User Farlo Sig.png|19px|link=User:Farlo]]<small>[[User talk:Farlo|Talk]]</small> 20:32, July 16, 2013 (MDT)
* {{fc|#9eb6e6|'''''Post-Installation Config'''''}} (none/plaintext) - Configuration instructions and anything else that should be done after installing the mods.  Also outro and special credits.


===== ModList =====
===== ModList =====

Revision as of 17:01, July 17, 2013

Vista-file-manager.png
Archive


New Properties for STEP Guides - WIP (Discussion Page)[edit source]

Following is a work-in-progress list of current and proposed attributes that can be associated with mod pages. Feel free to add anything you might think is useful. Let's try to keep it organized, so group similar or related properties as best you can. Note that Baseline has been removed from this list on purpose, that should be a Pack attribute based on the Pack's guidelines. ~FarloUser Farlo Sig.pngTalk 19:56, July 15, 2013 (MDT)

[edit]
Mod Info[edit source]
  • Author (string) - The author(s) of the mod.
  • FullName (string) - Full name of the mod according to source.
    Proposed: add Short Mod Description here (1 sentence, possibly from the Nexus API); currently this isn't in either the mod page or the STEP guide. It would be hard to include this in a STEP guide (core or pack) since it doesn't fit well in a multi-column format like those used in the guide
    • Description (string) - Brief mod description.
    Agreed, at the very least it'll help fill out the mod pages. ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)
  • SourceName (string) - Supported mod source. Specifies a URL created from "Steam" or "Nexus" mod ID. "Other" prompts for user input of a full URL string.
    • SourceID (string) - "Steam" or "Nexus" mod SourceID if either is specified in SourceName.
    • SourceURL (URL) - Full URL if SourceName is specified as "Other".
  • Section (string) - STEP installation "blocks" specified using "allows value" declarations.
    Proposed: Change to broad categorization of the mod (NOT the STEP section, similar idea to the Nexus categories but hopefully with categories more relevant to STEP) ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)
  • SectionLabel (string) - A human-meaningful label associated with Section. This is not passed into the template, only referenced.
  • Baseline (string) - Specifies the recommended mod option when more than one are available.
  • ForumTID (string) - Specifies a URL created using the thread ID of the mod on the STEP forums.
  • External URL (object) - Multiple-instance template containing:
    • ExternalURL (URL) - URL string specifying a page associated with the mod; other hosts, Facebook, etc. (URL)
    • ExternalLabel (string) - A human-meaningful label associated with ExternalURL (string)
  • HasResource (string) - Indicates how a mod's resources files are packaged. (BSA, Loose, None).
  • DLCRequired (string) - Indicates which DLC's are required by the mod.
  • DLCSupported (string) - Indicates which DLC's are supported by the mod via an addon.
Mod Flags[edit source]
  • DocDescription (Boolean) - Indicates that the mod includes a description of what the mod does.
  • DocInstall (Boolean) - Indicates that the mod includes installation instructions.
  • DocUninstall (Boolean) - Indicates that the mod includes un-installation instructions.
  • HasScript (Boolean) - Indicates that the mod uses scripts.
  • CompatibleBAIN (Boolean) - Indicates that the mod package has BAIN support.
  • CompatibleFOMOD (Boolean) - Indicates that the mod package has FOMOD support.
  • IsOptimized (Boolean) - Applies to texture mods only. Indicates that the mod textures are correctly formatted (but not that they are necessarily size/constraint optimized).
    Comment: The flag is somewhat problematic since it applies only to textures and can be hard to verify especially for non-core mods. Moreover, we may still want to separately optimize/reoptimize the normal maps even if the color map textures are adequately optimized. ~Kelmych Talk 12:26, July 16, 2013
    I think that this is a good flag for things that really should not be run through DDSopt for whatever reason. We can change the property and tag names easily enough if necessary. ~z929669 Ixian Insignia.png Talk 15:21, July 16, 2013 (MDT)
    What should we do if the color map textures are optimized but the normal maps are too large. Should there be tgwo flags, or just ignore the normal map issues? Kelmych (talk) 21:11, July 16, 2013 (MDT)
    IMO we should just track the file's optimization, they can be whatever resolution the author wants, unless I'm missing something about them being "too large" (is that a thing?). Unless everything is optimized it shouldn't be tagged as such. ~FarloUser Farlo Sig.pngTalk 23:44, July 16, 2013 (MDT)
  • HasSKSE (Boolean) - Indicates that the mod depends on SKSE.
  • HasMCM (Boolean) - Indicates that the mod has MCM functionality and depends on SkyUI.
  • HasSkyProc (Boolean) - Indicates that the mod contains a SkyProc patcher.
  • LoreFriendly (Boolean) - Indicates that the mod is considered lore friendly.
    Proposed: Remove, not a whole lot of meaning for most mods and isn't well defined. Also mostly useless for our purposes. ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)
    it is often difficult to assign/verify this flag ~Kelmych Talk 12:26, July 16, 2013
  • IsClean (Boolean) - Indicates that the mod's EPS/M files are free of ITM/UDR errors.
  • CleanUninstall (Boolean) - Indicates that mod can be deactivated without corrupting save games.
    Proposed: Fully specify if mod has plugins and that they are clean. Also, disambiguate clean plugins from clean uninstall (or eliminate clean uninstall altogether)
    • HasPlugin (Boolean) - Indicates that the mod has a plugin file (ESP, ESM, None).
      • CleanPlugin (Boolean) - Indicates that the mod's plugin is clean. Dependent on HasPlugin.
  • IsCore (Boolean) - Indicates if a mod is CORE to the STEP experience.
    Proposed: Remove, core mods -- will be in STEP:Core, this attribute isn't tied to the mod itself.
    Agreed ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)
  • AffectsFPS (Boolean) - Indicates if a mod has a noticeable FPS impact.
    Proposed: should have way to indicate whether effect is positive or negative ~Kelmych Talk 12:26, July 16, 2013
    Only Vano89's mod positively impacts performance, so this really denotes a negative impact. ~z929669 Ixian Insignia.png Talk 15:25, July 16, 2013 (MDT)
    But that might not be true for much longer, what if someone made a "craptastic computer pack", it might be nice to know that a mod has a positive effect. I think a choice of positive/none/negative would be well suited. ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)
    I was thinking about relative improvements compared to some STEP baseline, in which case a mod that reduces quality a small amount but improves FPS a lot might get a positive check here. Skyrim Performance Plus would certainly get a plus here also. Kelmych (talk) 21:11, July 16, 2013 (MDT)
    When Z, Stopping, and I were talking we kind of came to the conclusion that baseline wouldn't be a universal aspect since packs can target differing computer ranges. The AffectsFPS and AffectsVRAM tags would then be compared to Vanilla; for example an HD mod would obviously negatively impact FPS and VRAM whereas some gameplay mod wouldn't affect either. ~FarloUser Farlo Sig.pngTalk 23:44, July 16, 2013 (MDT)
  • AffectsVRAM (Boolean) - Indicates if a mod has a noticeable VRAM impact.
    [See above]
  • PerformanceAvailable (Boolean) - Indicates if a mod has a performance version available.
  • QualityAvailable (Boolean) - Indicates if a mod has a quality version available.

Proposed: Replace AffectsFPS, AffectsVRAM, PerformanceAvailable, and QualityAvailable with the following: ~FarloUser Farlo Sig.pngTalk 18:20, July 16, 2013 (MDT)

  • QualityItems (object) - Multiple-instance template containing:
    • QualityValue (string) - Available graphical tiers or options available (2048, 1024, High, Low, etc.).
    • AffectsFPS (Boolean) - Indicates if a mod has a noticeable FPS impact.
    • AffectsVRAM (Boolean) - Indicates if a mod has a noticeable VRAM impact.
Recommendations[edit source]
  • Recommendations (Text) - Contains either the short note, or a link to the Mod page if detailed instructions are available. This property is specified by Template:Recommendations.
    Proposed: Attach mod-specific notes to mod pages. Packs will also need recommendations relating to specific mods. Template:Recommendations could be used at the Pack level as it currently stands.
    • Notes (string) - Mod-specific information or special notes (string).
    Proposed: s4n suggested adding capability to set flags (plus mod IDs) to note conflicts.
    • Conflicts (?) - Figure out some method to denote salient conflicts of particular interest.
      how about a list of important conflicts using the STEP mod index in the list Kelmych (talk) 21:11, July 16, 2013 (MDT)
      We thought about this, but it'd be a huge pain in the ass to keep every mod updated with the mods it conflicts with. Not really sure how to go about this one. ~FarloUser Farlo Sig.pngTalk 23:44, July 16, 2013 (MDT)
[edit]
Basic Info[edit source]
  • Author (string) - The author(s) of the pack.
  • Description (string) - Brief pack description.
  • ForumTID (string) - Specifies a URL created using the thread ID of the mod on the STEP forums.
    We're just giving each pack it's own thread right? Some of the bigger ones could be given a subforum (STEP, SR, etc.) but we can deal with that on a case-by-case basis) ~FarloUser Farlo Sig.pngTalk 20:32, July 16, 2013 (MDT)
  • RequiredPack (string) - (Optional, multiple allowed) Pack(s) which are required for the pack to work.


The following won't be stored semantically but are text boxes for the various text associated with the pack's description, installation, etc.

  • Description (none/plaintext) - Introduction and description of the pack and its purpose.
  • Pre-Installation Setup (none/plaintext) - Explanation of any pre-requisite steps that need to be taken before installing the pack's mods.
  • Post-Installation Config (none/plaintext) - Configuration instructions and anything else that should be done after installing the mods. Also outro and special credits.
ModList[edit source]

The mod list for the pack will define X number of the following:

  • ModListObject (object) - Multiple-instance template containing:
    • Order (number) - Order of the mod in the pack's list.
    • ModName (string) - Name of the mod.
    • Notes (string) - Pack-specific notes regarding the mod's installation.