README.md

Upspring the Spring RTS model editor

Upspring is a model editor for .3do and .s3o files, it's able to convert from .3do to .s3o, it can handle .3ds as well.

Features

• Model editing and texturing via it's GUI.
• Lot's of helpers which make you the life in the GUI easier.
• LUA API via the "--run" option as well as lua plugins.

Roadmap

See TODO.md

Install

• Linux

  Build it on your own, it's easy to so with cmake.

  git clone --recursive https://github.com/techannihilation/upspring.git
  cd upspring
  cmake --preset gcc-release && cmake --build --preset gcc-release
  ./out/build/gcc-release/src/Upspring

  I need to check which dependecies you need.

  On Arch Linux it crashes hard without install Courier.

• Windows

  Download from the releases page.

CMD usage

• Open with:

  Upspring ~/.spring/games/TA.sdd/objects3d/cdevastator.3do

• Run lua script with arguments, everything after "--" is passed as "args" to lua.

  Upspring --run runscripts/convert.lua -- ~/.spring/games/TA.sdd/objects3d/cdevastator.3do

The given lua script here needs lfs you can install it with luarocks.

Authors

• @jochumdev - current Maintainer
• @abma
• @SpliFF
• kloot
• Jelmer Cnossen

License

• GPL-2.0
• We use parts from spring which is GPL-2.0 licensed.
• And the following libraries:

  Name	License
  7zip	public domain
  CLI11	BSD 3-Clause
  fltk2	LGPL-2
  lib3ds	LGPL-2
  minizip-ng	zlib license
  simdutf	Apache 2.0
  spdlog	MIT
  TXPK	MIT
  OpenIL	GPL-2