About storage systems

 Kirikiri refers to files, files in archives, and other resources as "storage" rather than files.

Unified storage name

 A unified storage name is a name that represents storage that is used only within Kirikiri and represents storage in a manner similar to URI.
 Notation is

media://domain/path

 It is done in the form Use / (slash) as a path separator.

Local storage

 The unified storage name for local storage (local file) uses file for media and . (dot) for domain. In Windows, the path starts with a drive letter.

 For example, C:\Program Files\Game\game.exe becomes
file://./c/program files/game/game.exe
 

 The Storages.getFullPath method can convert the file name used by the OS to a unified storage name. During this process, all uppercase letters in the file name are converted to lowercase (local storage is not case sensitive). If \ is used as a path separator, it is converted to /.
 The Storages.getLocalName method can convert the unified storage name to the file name used by the OS. You need to use this method when passing the storage name to applications other than Kirikiri.

Archive storage

 When specifying the storage in the archive, separate with >, specify the storage name of the archive storage before > and the path in the archive after >.

 For example, storage image/base.jpg in file://./c/program files/game/game.xp3 would be
file://./c/program files/game/game.xp3>image/base.jpg
 
 Starting from 2.19 beta 14, the archive delimiter has changed from '#' to '>'.

 Kirikiri can handle the Kirikiri unique archive storage called XP3 by default (XP3 because it is the third generation format of XPK). See Releaser for how to create an XP3 archive.

Project folder

 When making games and tools in Kirikiri, it is common practice to develop all necessary files in a "project folder". Kirikiri sets the project folder to the current current folder at startup.
 If you specify everything by relative path in the project folder, you do not need to change the path specification even if it is a single executable file with Release.

Data storage location

 The data storage location is the folder specified by the -datapath option of Command line options. You can get it in the System.dataPath properties.
 Various logs output by Kirikiri and configuration files for each user are output here.
 Also, if the user makes games, tools, etc., it is recommended that data be saved here.