Understanding the File System
Jump to navigation
Jump to search
What is in the DikuMUD III repository, and which parts you are likely to change. For how the running programs use these directories, see Understanding the Architecture of DikuMUD at runtime.
The top directory
| Name | What it is |
|---|---|
LICENSE |
The licence. It is what lets you run, copy and change the software, and it sets the conditions for doing so. Keep it with any copy you make. |
README.md, README_cmake.md |
How to build and start the game, and more build options. |
CLAUDE.md, DIL_UNIT_TESTING.md, WIZARD_LEVELS.md |
Notes for developers: building, running and debugging; DIL tests inside the game; the administrator levels. |
vme/ |
The game itself: sources, configuration, zones, saved data and the web client. See below. |
CMakeLists.txt |
The build description. cmake . reads it; see Manual:Installation.
|
unit_tests/ |
The unit tests (Boost.Test), run by make all and ctest.
|
docs/ |
Code documentation, generated by Doxygen during the build if it is installed. |
Dockerfile, docker-compose.yaml, entrypoint.sh |
Running the game in a Docker container. |
.github/workflows/ |
The build and tests that GitHub runs for each change. |
githooks/, clang-format.sh, clang-tidy.sh |
Code formatting and checking for contributors. |
resethash.sh |
Clears the zone checksums that one of the unit tests compares against. |
.claude/skills/ |
Notes on writing zones, compiling them and writing DIL, for AI coding assistants. The build compiles their example zones. |
excel/ |
A spreadsheet of the ability tables. |
agents/, deploy/ |
Tools the maintainers use for their own game. Not needed to run a MUD. |
The vme directory
| Directory | What it holds |
|---|---|
bin/ |
The programs, after the build: vme (the game server), mplex (the network front end), vmc (the zone compiler), pp (its preprocessor), defcomp and the unit test programs. The start scripts are here too, and the server and mplex are started from this directory, so their logs (vme.log, mplex.log) and the Discord pipes appear here. The scripts are listed below.
|
src/ |
The C++ source of the server. Subdirectories: mplex/ (the front end, with the websocket library it uses), vmc/ (the zone compiler; its grammar is vmcpar.y and the DIL grammar dilpar.y), pp/ (the preprocessor) and defcomp/. The DIL interpreter is in the dil*.cpp files. Much of the game can be changed in the zones without touching this.
|
zone/ |
The world: one .zon source file per zone, with the rooms, objects, NPCs, resets and DIL programs. vmc compiles each one to a .data and a .reset file here, which the server loads at boot. A compile also leaves .err, .dh and .dot files. See the Manual:Zone Manual.
|
include/ |
The header files that zones include: macros and constants such as macros.h, values.h and vme.h. Most constants here must match the server's source, so change them only together with it, and recompile the server and all the zones afterwards.
|
etc/ |
Configuration and game definitions, read by the server at boot. server.cfg (the main settings), zonelist (which zones to load), the definition files abilities.def, commands.def, professions.def, races.def, sector.def, spells.def, weapons.def and color.def (the build turns each into a .dat file, which is what the server reads), money, messages (combat messages), badnames, the login screen logo, texts such as the message of the day in strings/, and the help pages in help/strings/.
|
lib/ |
The saved state of the game: player files in ply/a/ to ply/z/, the player id counter players.id, boards, banned sites, and the data DIL programs save (dilfiles/ and other directories named in zonelist). Treat this as live data and back it up.
|
log/ |
Statistics and account logs, and the logs of the start scripts (vme.log, mplex-<port>.log, dispatcher.log, muddiscord.log) with their older, compressed copies.
|
www/ |
The web client in client/ (index.html, and client-a.html for screen readers), the pictures it shows in img/, and the page the Docker image serves in docker/.
|
nginx/ |
The web server configuration used in the Docker image. |
doc/ |
Old documentation from VME 2.0 (2001): text files, the old zone manual and DIL pages. Much of it no longer matches the code; this wiki replaces it. |
scripts/ |
Conversion scripts from VME 1.x to VME 2.0 (2001). Not needed today. |
Scripts in vme/bin
| Script | What it does |
|---|---|
startvme.sh, stopvme.sh |
Start and stop the whole game: vme, one mplex for each mplexer line in server.cfg, and the Discord programs.
|
runvme.sh, runmplex.sh |
Run vme or one mplex, rotate its log in vme/log/, and start it again when it exits.
|
rundispatcher.sh, runmuddiscord.sh, dispatcher.py, muddiscord.py |
The Discord link. |
defconvert.perl |
Turns the .def files in vme/etc/ into .dat files; the build runs it.
|
intergration_test.sh |
Runs the DIL integration tests: it boots a test world with time-warped vme and checks the results. It copies etc/zonelist.test over etc/zonelist, so save your own zonelist before running it.
|
zoneflags.py |
Finds flag fields in zone sources that were given the wrong kind of flag, which vmc cannot catch. |
The other files in vme/bin/ (startvme.perl, ftpcompiler, emailcompiler, htmlcompiler, executer.perl and similar) are older scripts from earlier versions or for one particular site. The start scripts above don't use them.
What you will change first
vme/etc/server.cfg: the name of the game, the name of the first god, the ports. See Manual:Installation.vme/etc/zonelist: which zones are loaded.vme/zone/*.zon: the world. Recompile with vmc and restart the server.vme/etc/strings/: the welcome and login texts, the message of the day, the news.