JHHM

dedit

a tool for Teeworlds demo file shenanigens
git clone https://jhhm.no/repos/dedit.git

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

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:

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.