Lost Souls directory structure
From LSWiki
(Difference between revisions)
| Revision as of 18:47, 9 January 2007 (edit) Msb (Talk | contribs) ← Previous diff |
Revision as of 18:53, 9 January 2007 (edit) Msb (Talk | contribs) Next diff → |
||
| Line 5: | Line 5: | ||
| ==/d== | ==/d== | ||
| This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar. | This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar. | ||
| + | :Read access [[privilege]]: [[read_d]] | ||
| + | :Write access [[privilege]]: [[write_d]] | ||
| - | Read access [[privilege]]: [[read_d]] | + | *'''/d/Affiliations''' This is where affiliations (associations, guilds, offices, racial and other faculties). |
| - | + | ::Read access [[privilege]]: [[read_sensitive]] | |
| - | Write access [[privilege]]: [[write_d]] | + | ::Write access [[privilege]]: [[write_sensitive]] |
| - | + | *'''/d/Almeria''' This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear. | |
| - | *'''/d/Affiliations''' | + | *'''/d/System''' This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms. |
| - | :This is where affiliations (associations, guilds, offices, racial and other faculties). | + | *'''/d/Misc''' Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower). |
| - | :Read access [[privilege]]: [[read_sensitive]] | + | *'''/d/(various planes)''' Like Almeria, except not on Almeria. |
| - | :Write access [[privilege]]: [[write_sensitive]] | + | |
| - | *'''/d/Almeria''' | + | |
| - | :This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear. | + | |
| - | *'''/d/System''' | + | |
| - | :This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms. | + | |
| - | *'''/d/Misc''' | + | |
| - | :Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower). | + | |
| - | *'''/d/(various planes)''' | + | |
| - | :Like Almeria, except not on Almeria. | + | |
| ==/daemon== | ==/daemon== | ||
| This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right? | This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right? | ||
| - | + | :Read access [[privilege]]: [[read_lib]] | |
| - | Read access [[privilege]]: [[read_lib]] | + | :Write access [[privilege]]: [[write_lib]] |
| - | + | ||
| - | Write access [[privilege]]: [[write_lib]] | + | |
| ==/def== | ==/def== | ||
| This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions. | This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions. | ||
| - | + | :Read access [[privilege]]: [[read_lib]] | |
| - | Read access [[privilege]]: [[read_lib]] | + | :Write access [[privilege]]: [[write_lib]] |
| - | + | ||
| - | Write access [[privilege]]: [[write_lib]] | + | |
| ==/etc== | ==/etc== | ||
| Line 42: | Line 31: | ||
| ==/lib== | ==/lib== | ||
| More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort. | More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort. | ||
| + | :Read access [[privilege]]: [[read_lib]] | ||
| + | :Write access [[privilege]]: [[write_lib]] | ||
| - | Read access [[privilege]]: [[read_lib]] | + | *'''/lib/dev''' This is where developer work-in-progress lib files go; everyone has write access to this directory. |
| - | + | ::Read access [[privilege]]: [[standard]] | |
| - | Write access [[privilege]]: [[write_lib]] | + | ::Write access [[privilege]]: [[standard]] |
| - | + | *'''/lib/descriptors''' This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system. | |
| - | *'''/lib/dev''' | + | |
| - | :This is where developer work-in-progress lib files go; everyone has write access to this directory. | + | |
| - | :Read access [[privilege]]: [[standard]] | + | |
| - | :Write access [[privilege]]: [[standard]] | + | |
| - | *'''/lib/descriptors''' | + | |
| - | :This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system. | + | |
| ==/mod== | ==/mod== | ||
| This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std. | This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std. | ||
| - | + | :Read access [[privilege]]: [[read_lib]] | |
| - | Read access [[privilege]]: [[read_lib]] | + | :Write access [[privilege]]: [[write_lib]] |
| - | + | ||
| - | Write access [[privilege]]: [[write_lib]] | + | |
| ==/obj== | ==/obj== | ||
| This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases. | This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases. | ||
| + | :Read access [[privilege]]: [[read_lib]] | ||
| + | :Write access [[privilege]]: [[write_lib]] | ||
| - | Read access [[privilege]]: [[read_lib]] | + | *'''/obj/extensions''' This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be. |
| - | + | *'''/obj/interfaces''' System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface. | |
| - | Write access [[privilege]]: [[write_lib]] | + | *'''/obj/master''' This is where things like the master object and the simul_efun object are kept -- crucial system things. |
| - | + | ::Read access [[privilege]]: [[read_secure]] | |
| - | *'''/obj/extensions''' | + | ::Write access [[privilege]]: [[write_secure]] |
| - | :This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be. | + | |
| - | *'''/obj/interfaces''' | + | |
| - | :System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface. | + | |
| - | *'''/obj/master''' | + | |
| - | :This is where things like the master object and the simul_efun object are kept -- crucial system things. | + | |
| - | :Read access [[privilege]]: [[read_secure]] | + | |
| - | :Write access [[privilege]]: [[write_secure]] | + | |
| ==/pub== | ==/pub== | ||
| This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers. | This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers. | ||
| - | + | :Read access [[privilege]]: [[read]] | |
| - | Read access [[privilege]]: [[read]] | + | :Write access [[privilege]]: [[standard]] |
| - | + | ||
| - | Write access [[privilege]]: [[standard]] | + | |
| ==/std== | ==/std== | ||
| Line 88: | Line 64: | ||
| ==/tmp== | ==/tmp== | ||
| A public directory for temporary files. Files in this directory are cleared out periodically. | A public directory for temporary files. Files in this directory are cleared out periodically. | ||
| - | + | :Read access [[privilege]]: [[read]] | |
| - | Read access [[privilege]]: [[read]] | + | :Write access [[privilege]]: [[standard]] |
| - | + | ||
| - | Write access [[privilege]]: [[standard]] | + | |
| ==/txt== | ==/txt== | ||
| ==/usr== | ==/usr== | ||
| User files, mainly incarnos and kept-item save files, are in this hierarchy. | User files, mainly incarnos and kept-item save files, are in this hierarchy. | ||
| - | + | :Read access [[privilege]]: [[player_files]] | |
| - | Read access [[privilege]]: [[player_files]] | + | :Write access [[privilege]]: [[player_files]] |
| - | + | ||
| - | Write access [[privilege]]: [[player_files]] | + | |
| ==/w== | ==/w== | ||
| This is where developer workspaces go; your personal directory, ''/w/yourname'', is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name. | This is where developer workspaces go; your personal directory, ''/w/yourname'', is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name. | ||
| - | + | :Read access [[privilege]]: [[read_w]] | |
| - | Read access [[privilege]]: [[read_w]] | + | :Write access [[privilege]]: [[write_w]] |
| - | + | ||
| - | Write access [[privilege]]: [[write_w]] | + | |
Revision as of 18:53, 9 January 2007
This structure of this file mirror the LS directory structure. If you don't know how to navigate the directory structure, please read the Developer Primer.
This page is going to need a lot more work, but it's worthwhile work, especially since I don't actually the actual organizational principles behind half this stuff.
Contents |
/d
This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar.
- /d/Affiliations This is where affiliations (associations, guilds, offices, racial and other faculties).
- Read access privilege: read_sensitive
- Write access privilege: write_sensitive
- /d/Almeria This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear.
- /d/System This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms.
- /d/Misc Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower).
- /d/(various planes) Like Almeria, except not on Almeria.
/daemon
This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right?
/def
This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions.
/etc
A few general lib files are here, like item.h
/lib
More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort.
- /lib/dev This is where developer work-in-progress lib files go; everyone has write access to this directory.
- /lib/descriptors This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system.
/mod
This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std.
/obj
This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases.
- /obj/extensions This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be.
- /obj/interfaces System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface.
- /obj/master This is where things like the master object and the simul_efun object are kept -- crucial system things.
- Read access privilege: read_secure
- Write access privilege: write_secure
/pub
This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers.
/std
/sys
/tmp
A public directory for temporary files. Files in this directory are cleared out periodically.
/txt
/usr
User files, mainly incarnos and kept-item save files, are in this hierarchy.
- Read access privilege: player_files
- Write access privilege: player_files
/w
This is where developer workspaces go; your personal directory, /w/yourname, is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name.
