dedit

dedit
Dedit is a Teeworlds / DDNet demo inspector and editor, written in portable C99 with zero external dependencies beyond the standard C library. The code repository is hosted here and on GitHub.
features
- rename tees
- change the skin of tees
- change the map of the demo
- merge data from multiple demos
- extract the map from the demo
- print chat log (same as demo_extract_chat)
- print information about each demo chunk
status & future work
Dedit is currently only tested and confirmed working for demo versions 5 and 6 (DDNet), and the Teeworlds 0.6 network protocol. I might tinker with supporting older demo versions, but the use case for this would be slim to none. Support for the 0.7 network protocol is planned, but I don't know when I will get around to implementing it.
compile
Requires a C99 compiler and a POSIX compatible make.
make
examples
Below are a couple of examples that should run without issue after compiling.
Prints info of clip.demo. Info consists of demo header and chunk counts.
./dedit testdata/clip.demo --info
Rename player with clientid 3 to holymadtee, change map to ice.map and save the output to out.demo.
./dedit testdata/clip.demo --rename 3 holymadtee --map testdata/ice.map --output out.demo
Set the skin of player with name New Hero to bomb, rename New Hero to Bob-omb, change map to jungle.map and save the output to out.demo.
./dedit testdata/clip.demo --skin "New Hero" bomb --rename "New Hero" Bob-omb --map testdata/jungle.map -o out.demo
Merge demos catchup_hero.demo, catchup_hex.demo and catchup_faceless.demo and save the output to out.demo.
./dedit testdata/catchup_hero.demo -M testdata/catchup_hex.demo -M testdata/catchup_faceless.demo -o out.demo
Tip: out.demo can be quickly viewed by running
DDNet out.demo
help
Usage: dedit <demo> [OPTIONS]
Argument:
<demo> Sets input demo
Options:
-r, --rename <id/name> <name> Renames player with id/name to name
-s, --skin <id/name> <skin> Set skin of player with id/name to skin
-m, --map <map> Changes the map of demo to map
-M, --merge <demo> Merges the game data of demo into input demo
-e, --extract-map <file> Saves the map of demo to file
-o, --output <file> Saves the output demo to file
-i, --info Prints info of demo
-I, --extended-info Prints extended info of demo
-c, --chat Prints the demo chat log
-h, --help Prints this help info
credits
Some functions/implementations are heavily inspired by other sources. They are commented in the code with links to their references. Below are some credits:
- libtw2: variable length int implementation, demo/snapshot documentation
- Teeworlds: huffman implementation
- DDNet: some demo writing specifics
license
This project is licensed under the GNU General Public License Version 3 (or, at your option, any later version). See the LICENSE file for the full license text.
This project also includes code that is derived from other sources, with their own licenses. See the NOTICES file for additional copyright, license, and attribution information.