Filesystem: Difference between revisions

From Jedi Knight Wiki | JKHub
(adding detail)
(more)
Line 16: Line 16:
== Directory structure ==
== Directory structure ==
This is the directory structure of JK2 and JA, found inside the PK3 files.
This is the directory structure of JK2 and JA, found inside the PK3 files.
==== botfiles ====


==== botroutes ====
==== botroutes ====
Line 21: Line 23:
==== eagle ====
==== eagle ====
Contains files associated with the Creative Labs enhanced audio system.
Contains files associated with the Creative Labs enhanced audio system.
==== effects ====
Contains effects ([[.efx]]) files. This is JK2's particle system.
==== ext_data ====
Contains various kinds of important game definitions.
[[dms.dat]] music definitions
[[items.dat]] items definitions
[[weapons.dat]] weapons definitions
* npcs subdirectory: contains [[.npc]] files
* sabers subdirectory: contains [[.sab]] lightsaber definitions
* Siege subdirectory
* vehicles subdirectory: contains [[.veh]] vehicle definitions
==== fonts ====
==== gfx ====
Various graphics files, used in the menu system and in-game.
==== menu ====
==== models ====
Contains [[.md3]] models and character [[.glm]] models.
* chunks subdirectory
* flags subdirectory: CTF flags
* items subdirectory: ammo, med packs, and other items
* map_objects subdirectory
* players subdirectory: all playable and NPC character models
* weaphits subdirectory
* weapons2 subdirectory: all weapons


==== levelshots ====
==== levelshots ====
Line 26: Line 64:


==== maps ====
==== maps ====
Map files. [[.bsp]]
Map files. (See [[.bsp]])


==== music ====
==== music ====
Music files. [[.mp3]]
Music files. ([[.mp3]] format)


==== scripts ====
==== scripts ====
Line 49: Line 87:


[[objectives.str]] contains mission objectives.
[[objectives.str]] contains mission objectives.
==== video ====
Contains [[.roq]] cutscenes.






[[Category:Tutorials]]
[[Category:Tutorials]]

Revision as of 14:20, 3 November 2021

Games using the Quake 3 Engine, such as Jedi Outcast and Jedi Academy, use a virtual filesystem.

It works similarly to mounting in Linux: When a certain file is requested, for example "models/players/kyle/model.glm", its actual location can be in any of the mounted directories/pk3 archives; it does not matter which one. This makes the game extendible: New files can simply be put into an additional .pk3 archive that will get mounted at startup.

So what archives and directories are mounted?

  • Any PK3 file inside GameData/base; PK3 files are just renamed .zip files, and only zip compression is supported! One freeware tool for reading and creating zip archives is 7-Zip.
  • Any PK3 file inside GameData/currentmod, if you're inside a mod
  • In Single Player, and in MP if the CVar "sv_pure" is set to 0: any loose files and folders in GameData/base and GameData/currentmod

So, to get back to our example of "models/players/kyle/model.glm": In unmodified Jedi Academy Single Player this would search for:

  • "GameData/base/models/players/kyle/model.glm"
  • for "models/players/kyle/model.glm" inside "GameData/base/assets0.pk3", "GameData/base/assets1.pk3", "GameData/base/assets2.pk3" and "GameData/base/assets3.pk3"

Directory structure

This is the directory structure of JK2 and JA, found inside the PK3 files.

botfiles

botroutes

eagle

Contains files associated with the Creative Labs enhanced audio system.

effects

Contains effects (.efx) files. This is JK2's particle system.

ext_data

Contains various kinds of important game definitions.

dms.dat music definitions

items.dat items definitions

weapons.dat weapons definitions

  • npcs subdirectory: contains .npc files
  • sabers subdirectory: contains .sab lightsaber definitions
  • Siege subdirectory
  • vehicles subdirectory: contains .veh vehicle definitions

fonts

gfx

Various graphics files, used in the menu system and in-game.

menu

models

Contains .md3 models and character .glm models.

  • chunks subdirectory
  • flags subdirectory: CTF flags
  • items subdirectory: ammo, med packs, and other items
  • map_objects subdirectory
  • players subdirectory: all playable and NPC character models
  • weaphits subdirectory
  • weapons2 subdirectory: all weapons


levelshots

JPEG images shown during level loading.

maps

Map files. (See .bsp)

music

Music files. (.mp3 format)

scripts

Icarus script files. They are grouped in subdirectories for each map.

sound

Sound effects, in .wav and .mp3 format.

sound.txt contains all soundset definitions.

  • chars subdirectory: character sound effects (including English dialogue)
  • chr_d subdirectory: character dialogue in German
  • chr_e subdirectory: character dialogue in Spanish
  • chr_f subdirectory: character dialogue in French

strings

.str files containing subtitles.

objectives.str contains mission objectives.

video

Contains .roq cutscenes.