FREECIV21-RULEUP(6)

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