GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SPRING-HEADLESS (6)

.ds Aq ’

NAME

spring-headless - An open source RTS game engine - Headless Engine

CONTENTS

SYNOPSIS

spring-headless [--safemode] [-s|--server IP_OR_HOSTNAME] [-p|--projectiledump] [--benchmark TIME [--benchmarkstart TIME]] [-i|--isolation] [--isolation-dir PATH] [-n|--name STRING] [-C|--config FILE] SCRIPT

spring-headless --list-ai-interfaces

spring-headless --list-skirmish-ais

spring-headless --list-def-tags

spring-headless --list-config-vars

spring-headless [-h|--help]

spring-headless --sync-version

spring-headless [-V|--version]

DESCRIPTION

Spring is a versatile 3D RTS game engine. Using extensively Lua for scripting game-specific code to make nearly every aspect of the engine customizable, from GUI, to unit AI, to pathfinding.

It is mainly designed around online multiplayer games but can also be played in single-player mode against AIs.

This is the engine version without graphics or sound output. It still runs the full simulation, while spring-dedicated basically only redirects network traffic. It is useful for testing and simulating AI only games at high speeds on systems without graphics and sound output support.

OPTIONS

-h, --help

Print the options help message and exit

-V, --version

Display program version and exit

--sync-version

Display program sync version (for online gaming) and exit

--nocolor

Disables colorized stdout

--quiet

Ignore unreccognized arguments

--safemode

Turns off many things that are known to cause problems (i.e. on PC/Mac\(cqs with lower-end graphic cards)

-s, --server::IP_OR_HOSTNAME

Run as a server on the given address

-i, --isolation

Limit the data-dir (games & maps) scanner to one directory (see --isolation-dir and the SPRING_ISOLATED env var)

--isolation-dir::PATH

Specify the isolation-mode data-dir (see --isolation and the SPRING_ISOLATED env var)

--write-dir::PATH

Specify the directory used for all saving.

-n, --name::NAME

Set your player name

-C, --config::FILE

Exclusive configuration file

--list-ai-interfaces

Dump a list of available AI Interfaces to STDOUT

--list-skirmish-ais

Dump a list of available Skirmish AIs to STDOUT

--list-def-tags

Dump a list of available Definition Tags in JSON-format to STDOUT

--list-ceg-classes

Dump a list of available Projectile classes in JSON-format to STDOUT

--list-config-vars

Dump all default config vars in JSON-format to STDOUT

-g, --game::GAME

instantly start the GAME with a minimal setup. Requires --map to be present, too. Sets the modoption minimalsetup = 1

-m, --map::MAP

Requires --game to be set, too. see --game

FILES

~/.config/spring/

The default data-directory (see section DATA DIR).

~/.config/spring/springsettings.cfg

Contains the users settings for the engine, for things like graphic and sound.

/etc/spring/datadir

Contains the : separated paths to additional data-dirs (see section DATA DIR).

ENVIROMENT VARIABLES

SPRING_LOG_SECTIONS Selective functionality to change the verbosity (separated by ,).

SPRING_WRITEDIR Define custom primary write DATA DIR. Place where spring saves logs, settings, ...

SPRING_DATADIR Adds additional DATA DIRs Spring will search for files (separated by :).

SPRING_ISOLATED If defined, Spring will stop searching files outside of the binaries directory. If it is set to a valid directory path, it will be used as the isolation directory. See the --isolation and the --isolation-dir options.

SPRING_NOCOLOR Same as spring --nocolor.

PORTABLE MODE

An all-in-one-folder setup, which allows to run Spring without installation. To do so all relevant files (binaries & basecontent) must be in a single folder, esp. spring(.exe), libunitsync.so/unitsync.dll and springsettings.cfg. Spring will then use the all-in-one-folder for writing and won\(cqt do so anywhere else on the system, but it may open other files & directories for reading.

ISOLATION MODE

Not to confuse with Portable Mode, this mode disables all automatic Data Dir scanning and limit reading & writing to a single folder. This is very usefull when games want to run separate from other Spring games.

DATA DIRS

Data directories are searched for content, and among other things, may contain:

o

o config files

o

o logs

o

o games

o

o maps

o

o AIs

o

o cache

Sorted by priority the engine may use multiple data directories, but it will use only the one with the highest priority as writable, to write cache & log files to. The hierarchy the engine loads DATA DIRs in can be grouped in 3 sections:

priority section normal portable isolation      

CONFIG_HOME

Config directories in user\(cqs home.

*nix/MacOSX:

${XDG_CONFIG_HOME-"~/.config"}/spring

~/.spring

Windows:

C:/.../My Documents/My Games/Spring/

C:/.../My Documents/Spring/

C:/.../All Users/Applications/Spring/

INSTALL_DIR Location of spring-headless binary.

ETC_DIRS Additional : separated DATA DIRs defined in /etc/spring/datadir.

USR_SHARE

*nix/MacOSX: /usr/.../share/spring & binary dir if is Data Dir

MacOSX: .../Spring.app/Contents/Resources/share/games/spring/base/

Windows: Install directory

ISOLATION_DIR

Mode A (--isolation): INSTALL_DIR

Mode B (--isolation-dir): supplied dir

CONFIG FILES

Spring can load configurations from multiple files and merge them. So similar to DATA DIRs there is one file where the engine writes to and multiple read-only files.

It scans following directories for config files :

priority scanned directories   

(The one with highest priority will be used for writing.)

The filename of such config files can be as following:

priority filenames   

(An example for a versioned config file is "springsettings-94.1.cfg".)

SEE ALSO

spring(6) spring-legacy(6) spring-dedicated(6)

HOMEPAGE

More information about Spring can be found at link: \m[blue]http://springrts.com\m[]

AUTHOR

Spring was written by the Spring developers.

This manual page was written by Marco Amadori <\m[blue]marco.amadori@gmail.com\m[][1]>, for the Debian project (and may be used by others).

NOTES

1. marco.amadori@gmail.com  mailto:marco.amadori@gmail.com
Search for    or go to Top of page |  Section 6 |  Main Index


Spring package SPRING-HEADLESS (6) 04/05/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.