https://www.fightorder.net/wiki/index.php?action=history&feed=atom&title=VirtualFileSystemVirtualFileSystem - Revision history2026-04-21T05:43:41ZRevision history for this page on the wikiMediaWiki 1.44.2https://www.fightorder.net/wiki/index.php?title=VirtualFileSystem&diff=642&oldid=prevQrow: 1 revision imported2025-11-14T05:21:28Z<p>1 revision imported</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 22:21, 13 November 2025</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Qrowhttps://www.fightorder.net/wiki/index.php?title=VirtualFileSystem&diff=641&oldid=prevInterwiki>Flozi: Game development -> Game Dev2013-03-25T20:18:32Z<p>Game development -> Game Dev</p>
<p><b>New page</b></p><div>[[Engine_Development|Development]] < {{FULLPAGENAME}}<br />
<br />
=VFS=<br />
The Virtual File System is an unified layer to access (read-only) the different archives used at runtime. So you can access map, game & config files via the same interface.<br />
<br />
==Archive Hierarchy==<br />
When loading a new archive (sdz, sd7, sdd) it overrides existing file references in the VFS, so the order archives are loaded is very important. So here it is (in reverse):<br />
<br />
# raw file system (only for unsynced data)<br />
# map<br />
## map archive itself<br />
## map dependencies<br />
## maphelper.sdz (engine supplied)<br />
# game<br />
## game archive itself<br />
## game dependencies<br />
## springcontent.sdz (engine supplied)<br />
### bitmaps.sdz (engine supplied)<br />
<br />
(top most are checked first when accessing a file -> map overrides game files!)<br />
<br />
==Extra Informations==<br />
Spring's VFS is '''lowercase''' only.<br />
Also it is '''extremely''' recommended to use linux style path separators, e.g. "foo/bar.txt" and not "foo\bar.txt".<br />
<br />
=Engine Read Files=<br />
The engine access a few files directly, most of them are lua files which access other files themselves.<br />
Here the list of files that must exist in the VFS (some of them don't have to be in the game/map archive cause there are fallback solutions in springcontent.sdz & maphelper.sdz):<br />
<br />
* ./<br />
** anims/<br />
*** [[MouseCursors|cursornormal.bmp/png]]<br />
** gamedata/<br />
*** [[defs.lua|defs.lua]]<br />
*** [[Explosions.lua|explosions.lua]]<br />
*** [[Explosion_alias.lua|explosion_alias.lua]]<br />
*** [[Icontypes.lua|icontypes.lua]]<br />
*** [[Messages.lua|messages.lua]]<br />
*** [[Modrules.lua|modrules.lua]]<br />
*** [[Resources.lua|resources.lua]]<br />
*** [[Resources.lua|resources_map.lua]]<br />
*** [[Sidedata.lua|sidedata.lua]]<br />
*** [[Sounds.lua|sounds.lua]]<br />
** luagaia/<br />
*** main.lua<br />
*** draw.lua<br />
** luarules/<br />
*** main.lua<br />
*** draw.lua<br />
** luaui/<br />
*** main.lua<br />
** shaders/<br />
*** ?<br />
** [[LuaAI.lua|luaai.lua]]<br />
** [[Mapinfo.lua|mapinfo.lua]]<br />
** [[Mapdev:MapOptions|mapoptions.lua]]<br />
** [[Modinfo.lua|modinfo.lua]]<br />
** [[Modoptions.lua|modoptions.lua]]<br />
** [[Validmaps.lua|validmaps.lua]]<br />
<br />
[[Category:Game Dev]]</div>Interwiki>Flozi