Repository Reference/Repository structure in-depth

From Blood Wiki
(Difference between revisions)
Jump to: navigation, search
m
 
(5 intermediate revisions by 4 users not shown)
Line 66: Line 66:
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| '''models'''
 
| '''models'''
| all game 3d models and textures for them/
+
| all game 3d models and textures for them
 
|-
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
Line 78: Line 78:
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| '''radiant'''
 
| '''radiant'''
| textures and scripts used by leve leditor
+
| textures and scripts used by level editor
 
|-
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]  
 
| [[File:Icon folder.png|16px|alt=|link=]]  
Line 118: Line 118:
 
| [[File:Icon archive.png|16px|alt=|link=]]  
 
| [[File:Icon archive.png|16px|alt=|link=]]  
 
| '''PILL500.PK3'''
 
| '''PILL500.PK3'''
| generated textures DDS cache (see [[#Building a Game|Building a Game/Textures DDS cache]])
+
| generated textures DDS cache (see [[Repository_Reference/Building_a_Game#Textures_DDS_cache|Building a Game/Textures DDS cache]])
 
|-
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]  
 
| [[File:Icon file.png|16px|alt=|link=]]  
Line 310: Line 310:
 
|}
 
|}
 
</div>
 
</div>
 
====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.}}
 
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''cave'''
 
| models for 'cave' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''crypt'''
 
| models for 'crypt' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''dungeon'''
 
| models for 'dungeon' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''graveyard'''
 
| models for 'graveyard' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''inn'''
 
| models for 'inn' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''misc'''
 
| unthemed widely used models
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''outdoor'''
 
| models for 'Nosgoth Outdoors' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''spikes'''
 
| models used in spike zones
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''town'''
 
| models for 'town' theme
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''trees'''
 
| tree models
 
|}
 
</div>
 
 
==Development kit==
 
devkit/
 
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''bloodpill'''
 
| [[BloodPill|Blood Pill]] utility
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''cubemaps'''
 
| tools for making cubemaps
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''launcher'''
 
| source code for launcher
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''modelling'''
 
| tools for modelling (coverters, exporters)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''notepad++'''
 
| syntax highlight scripts for notepad++
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''other'''
 
| other tools
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''quakec'''
 
| game logic QuakeC sourcecode (client, server and menu)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''spr32edit'''
 
| Tool to edit sprites
 
|}
 
</div>
 
 
===devkit/modelling===
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''dpmwizard'''
 
| DPMWizard tool (make [[DPM]] models from Half-Life [[SMD]] models)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''gensurf'''
 
| An old tool to generate brush-based terrain from heightmaps or random noises.
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''plugins'''
 
| Import/Export plugins for various game formats used with Darkplaces engine.
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''plugins_src'''
 
| Source code for plugins.
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''qme'''
 
| Old program to edit [[MDL]] models.
 
|-
 
| [[File:Icon md3compiler.png|16px|alt=|link=]]
 
| '''MD3Compiler.exe'''
 
| [[MD3 Compiler|NPherno's MD3 Compiler]]
 
|}
 
</div>
 
 
===devkit/quakec===
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''csprogs.dat'''
 
| QuakeC sources for client-side progs
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''menu.dat'''
 
| QuakeC sources for menu progs
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''progs.dat'''
 
| QuakeC sources for game progs (server game logic)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''shared'''
 
| Shared QuakeC code (libraries, systems)
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''shared'''
 
| Shared QuakeC code (libraries, systems)
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''compile_csprogs.bat'''
 
| Script to compile client-side progs into '''kain/csprogs.dat'''
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''compile_menu.bat'''
 
| Script to compile menu progs into '''kain/menu.dat'''
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''compile_progs.bat'''
 
| Script to compile game progs into '''kain/progs.dat'''
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''fteqcc.exe'''
 
| FTEQCC QuakeC source compiler
 
|-
 
| [[File:Icon file.png|16px|alt=|link=]]
 
| '''sourcescanner.exe'''
 
| SourceScanner - a tool to make level editor entity defs (mapeditor/kain.game/kain/entities.ent) from QuakeC source.
 
|}
 
</div>
 
 
==Misc==
 
All misc files are stored in the '''misc/''' folder, there can be many subfolders there, but here we only list most useful.
 
 
<div style="border: 1px #999 dotted; padding: 8px; margin: 4px;vertical-align:bottom">
 
{|
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''Balance and Docs'''
 
| various documents regarding original game, dialogue scripts, weapon damage listings etc.
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''Concept Art'''
 
| All concept art submitted to Blood Omnicide.
 
|-
 
| [[File:Icon folder.png|16px|alt=|link=]]
 
| '''Graphics'''
 
| Various non-game graphical files (logos, icons, site designs)
 
|}
 
</div>
 
 
{{navigation footer|}}
 
{{finished}}
 

Latest revision as of 22:58, 4 April 2013

Repository Reference

Contents

[edit] User files

User files are files created by user, depending of engine settings, 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

[edit] Game files

kain/

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 level editor
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

[edit] 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

[edit] 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

[edit] 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)
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox