NAME

freeciv21-ruleup - Command line ruleset upgrade tool for Freeciv21.

SYNOPSIS

freeciv21-ruleup [ -r|--ruleset <RULESET> ] [ -o|--output <DIRECTORY> ] [ -h|--help ] [ -v|--version ]

DESCRIPTION

Freeciv21 is a free open source turn-based empire-building 4x strategy game, in which each player becomes the leader of a civilization. You compete against several opponents to build cities and use them to support a military and an economy. Players strive to complete an empire that survives all encounters with its neighbors to emerge victorious. Play begins at the dawn of history in 4,000 BCE.

Freeciv21 takes its roots in the well-known FOSS game Freeciv and extends it for more fun, with a revived focus on competitive multiplayer environments. Players can choose from over 500 nations and can play against the computer or other people in an active online community.

The code is maintained by the team over at Longturn.net and is based on the QT framework. The game supports both hex and square tiles and is easily modified to create custom rules.

This command line utility allows a user to upgrade a ruleset designed for an older version of Freeciv21 to work on a newer version. freeciv21-ruleup does not create well-formatted human-readable ruleset files, so some hand editing will be needed to aid readability.

OPTIONS

The following options are accepted on the command line of the ruleup tool. They may not be combined as with other tools. For example: freeciv21-ruleup -ro ~/myrulset ~/myupgradedruleset will not work. Instead you will need to enter each option separately, such as, freeciv21-ruleup -r ~/myruleset -o ~/myupgradedruleset.

-F, --Fatal: Raise a signal on failed assertion. An assertion is a code calculation error. With this set, the client process will SEGFAULT instead of issuing a warning message to the terminal console.
-r, --ruleset: The path to the old ruleset that needs to be upgraded.
-o, --output: The path to write the upgraded ruleset.
-h, --help: Display help on command line options.
--help-all: Display help including Qt specific options.
-v, --version: Display version information.

USER: Specifies the username of the current user.

BUGS

Please report bugs to the Freeciv21 bug tracker at https://github.com/longturn/freeciv21/issues/new/choose

MORE INFORMATION

See the Longturn home page at https://longturn.net/. You can also find the code repository at https://github.com/longturn/freeciv21/.

AUTHOR

Freeciv21 and Freeciv Contributors

COPYRIGHT

GPL-3.0-or-later, Freeciv21 and Freeciv Contributors