Repository Reference/Repository structure in-depth

From Blood Wiki
(Difference between revisions)
Jump to: navigation, search
m
m
Line 1: Line 1:
 
{{navigation title|Naming conventions}}
 
{{navigation title|Naming conventions}}
  
==kain/==
+
==User files==
 +
User files are files created by user, depending of engine settigns, they could be located in game folder or in '''My Documents/My Games/omnicide'''.
 +
Here is draft listing of this files:
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
{|
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''cubemaps'''
 
| cubemap light filters used on lights (animated cubemaps is stored in subfolders)
 
|-
 
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| '''data'''
 
| '''data'''
| this directory is created and managed by engine, it stores savegames, edited files, temp files
+
| this directory is created and managed by engine, it stores savegames, edited files, temp files etc.
 
|-
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| '''dds'''
 
| '''dds'''
| stores all DDS files to be loaded instead of base textures
+
| dynamically created DDS files (fonts, locale images)
 +
|-
 +
| [[File:Icon folder.png|16px|alt=|link=]]
 +
| '''screenshots'''
 +
| screenshots taken from game
 +
|-
 +
| [[File:Icon folder.png|16px|alt=|link=]]
 +
| '''videos'''
 +
| FMV's and recorded with '''cl_capturevideo''' videos
 +
|-
 +
| [[File:Icon file.png|16px|alt=|link=]]
 +
| '''config.cfg'''
 +
| game config file
 +
|-
 +
| [[File:Icon file.png|16px|alt=|link=]]
 +
| '''omnicide.log'''
 +
| engine log file
 +
|-
 +
| [[File:Icon file.png|16px|alt=|link=]]
 +
| '''darkplaces_history.txt'''
 +
| console typing history
 +
|}
 +
</div>
 +
 
 +
==Game files==
 +
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 +
{|
 +
| [[File:Icon folder.png|16px|alt=|link=]]
 +
| '''cubemaps'''
 +
| cubemap light filters used on lights (animated cubemaps is stored in subfolders)
 
|-
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
Line 51: Line 78:
 
| '''radiant'''
 
| '''radiant'''
 
| textures and scripts used by leve leditor
 
| textures and scripts used by leve leditor
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''screenshots'''
 
| screenshots taken from game (if running omnicide with no-home-dir option)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''videos'''
 
| FMV's and recorded with '''cl_capturevideo''' videos
 
 
|-
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
Line 75: Line 94:
 
| '''csprogs.dat'''
 
| '''csprogs.dat'''
 
| client-side compiled game logic
 
| client-side compiled game logic
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''darkplaces_history.txt'''
 
| console typing history (if running omnicide with no-home-dir option)
 
 
|-
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]  
 
| [[File:Icon file.png|16px|alt=|link=]]  
Line 111: Line 126:
 
| '''menu.dat'''
 
| '''menu.dat'''
 
| compiled game logic for a menu
 
| compiled game logic for a menu
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''omnicide.log'''
 
| engine log file (only if running game with developer option)
 
 
|-
 
|-
 
| [[File:Icon raw.png|16px|alt=|link=]]  
 
| [[File:Icon raw.png|16px|alt=|link=]]  

Revision as of 17:43, 9 August 2012

Repository Reference | previous chapter: Naming conventions

Contents

User files

User files are files created by user, depending of engine settigns, they could be located in game folder or in My Documents/My Games/omnicide. Here is draft listing of this files:

data this directory is created and managed by engine, it stores savegames, edited files, temp files etc.
dds dynamically created DDS files (fonts, locale images)
screenshots screenshots taken from game
videos FMV's and recorded with cl_capturevideo videos
config.cfg game config file
omnicide.log engine log file
darkplaces_history.txt console typing history

Game files

cubemaps cubemap light filters used on lights (animated cubemaps is stored in subfolders)
game game-related scripts (map scripts, gamemodel scripts etc.)
gfx all 2d textures used for graphical user interface
glsl OpenGL GLSL shaders
locale this folder stores all locales
maps game levels and it's additional files (lights, sources, lightmaps etc.)
models all game 3d models and textures for them/
music game music
particles textures used on particles
radiant textures and scripts used by leve leditor
scripts material scripts and client-side scripts such as menus, environments etc.
sound all game sounds
textures textures used on map surfaces (brushes, curves, terrains etc.)
csprogs.dat client-side compiled game logic
effectinfo.txt effects script
LEGACY0.PK3 Blood Omen original files (created during installation)
LEGACY1.PK3 Blood Omen sounds from demo version, this file only exist if installing PlayStation version of the game
LEGACY2.PK3 Blood Omen FMV's (created during installation)
LEGACY3.PK3 Blood Omen sprites DDS cache
PILL500.PK3 generated textures DDS cache (see Building a Game/Textures DDS cache)
lightstyles.txt Lightstyles table
menu.dat compiled game logic for a menu
pill.big Blood Omen original file (copied during installation)
progs.dat compiled server-side game logic
quake.rc engine startup file

game/

maps map configuration scripts, each file holds a script for particular map
models gamemodel scripts
default.cfg Defaut config file
engine.cfg Engine config file
omnicide.cfg Blood Omnicide-specific config file (loaded after engine config file)
world0.nsx worldmap script for prologue game part
world0.nsx worldmap script for the present game part

textures/

Tip: Once development progressing, new themes get added.
common textures for common materials
cellar textures for 'cellar' theme
crypt textures for 'crypt' theme
decals all decal textures
dungeon textures for 'dungeon' theme
envmaps environment maps and cubemaps used on materials for cubemap reflections and tcGen environment
liquids textures used for liquids - lava, water, swamp
mausoleum textures for 'mausoleum' theme
murals murals for spells, artifacts, events etc.
signboard textures for signboards
special special textures (overlays, force-material textures etc.)
surfaces generic surface textures
terrain textures used for terrain blending
towns textures for 'town' theme
blackmap.tga simple black texture
checker.tga common checker texture for testing UV distortions

models/

captives 3d captive models
enemies test 3d models of enemies
enviro models used in environment scripts
fx various models used in special effects
items item models
mapobjects models to be used on levels
maps specific prop models created for levels (such as terrains)
new all new models to be approved (and get texture and material created) goes here
plants Foliage models, such as grass
teststuff all test-only stuff (not exported to game's installer)
traps models to be used on various traps
weapons weapon models
cube.mdl 4x4 units cube model
null.mdl model with no geometry
point.mdl a sphere with an arrow (used for testun purposes)

models/mapobjects/

One or largest model folders. It contains models to be used on levels as func_model or func_gamemodel.

Tip: Once development progressing, new mapobject themes get added.
cave models for 'cave' theme
crypt models for 'crypt' theme
dungeon models for 'dungeon' theme
graveyard models for 'graveyard' theme
inn models for 'inn' theme
misc unthemed widely used models
outdoor models for 'Nosgoth Outdoors' theme
spikes models used in spike zones
town models for 'town' theme
trees tree models



Next chapter: Automations
Back to index | Top of the page

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox