Difference between revisions of "Virtual File"

From ISBoxer
Jump to: navigation, search
m (Virtual Files Syntax)
(Virtual Files Syntax)
Line 20: Line 20:
 
* The new syntax uses * and ?  wildcards for the filename pattern
 
* The new syntax uses * and ?  wildcards for the filename pattern
 
* The matching values are placed in {1} {2} and so on, left to right, for each wildcard.  
 
* The matching values are placed in {1} {2} and so on, left to right, for each wildcard.  
* Absolute file paths are now used in all cases.
 
 
* Each matching rule applies, in the order added (i.e. top to bottom)
 
* Each matching rule applies, in the order added (i.e. top to bottom)
 
   Examples:   
 
   Examples:   

Revision as of 18:30, 29 November 2018

Editing a Virtual File

A Virtual File can direct the game to a given file in place of another. This is typically used to use a single folder for performance reasons, while keeping multiple configurations.

The Quick Setup Wizard sets up some Virtual Files automatically for your convenience.

Creating a Virtual File

  1. In the top pane, right click Virtual Files
  2. Select New Virtual File from the drop-down menu
  3. Rename the new Virtual File to the actual filename on the disk, without the path. For example, Config.WTF, or LauncherUserSettings.XML
  4. Now, for each Character that will need this file virtualized
    1. Drag the Character from the top pane into the bottom left pane with the Virtual File selected (visible in the bottom left pane)
    2. Select the Character in the bottom left pane, so that on the bottom right pane you see "Virtualize as" with a box next to it
    3. In the Virtualize as box, enter the new filename, without the path. For example, Config-MyCharacter.WTF, or LauncherUserSettings-MyAccount.XML

In this fashion, each Character can have its own version of a settings file, or share with certain others, etc.

Virtual Files Syntax

  • The new syntax uses * and ? wildcards for the filename pattern
  • The matching values are placed in {1} {2} and so on, left to right, for each wildcard.
  • Each matching rule applies, in the order added (i.e. top to bottom)
 Examples:   
 fileredirect "*/core_user_*.dat" "{1}/core_user_allsamefile.dat"
 fileredirect "*/core_user_*.dat" "{1}/core_user_{2}-isboxer.dat"
 fileredirect "*/WTF/*" "{1}/WTF/{2}"
 fileredirect "*/Addons.txt" "{1}/Addons-ISBoxer.txt"
  • Backwards compatibility is retained. fileredirect commands that do not contain a pattern will exhibit the original behaviour.
    • Those ending in / translate from "/folder/" "/folder-other/" to "*/folder/*" "{1}/folder-other/{2}".
    • Those not ending in / translate from "filename.txt" "filename-other.txt" to "*filename.txt" "{1}filename-other.txt"

See Also