tw-make¶
usage: tw-make [-h] [--output PATH] [--seed SEED] [--format {ulx,z8}]
[--overview] [--save-overview] [--third-party PATH] [-f]
[--list] [--silent | -v]
{custom,tw-coin_collector,tw-treasure_hunter,tw-simple} ...
Positional Arguments¶
- subcommand
Possible choices: custom, tw-coin_collector, tw-treasure_hunter, tw-simple
Kind of game to make.
Named Arguments¶
- --silent
Default: False
- -v, --verbose
Default: False
General settings¶
- --output
Path where to save the generated game. If it points to a folder, the game’s UUID will be used as the filename.
Default: “./tw_games/”
- --seed
- --format
Possible choices: ulx, z8
Which format to use when compiling the game. Default: “ulx”
Default: “ulx”
- --overview
Display an overview of the generated game.
Default: False
- --save-overview
Save the overview image of the generated game alongside the game as a PNG file.
Default: False
- --third-party
Load third-party module. Useful to register new custom challenges on-the-fly.
- -f, --force
Default: False
- --list
List available challenges.
Default: False
Sub-commands:¶
custom¶
Make a custom game.
tw-make custom [-h] [--output PATH] [--seed SEED] [--format {ulx,z8}]
[--overview] [--save-overview] [--third-party PATH] [-f]
[--list] [--silent | -v] [--world-size SIZE] [--nb-objects NB]
[--theme THEME] [--include-adj] [--blend-descriptions]
[--ambiguous-instructions] [--only-last-action]
[--blend-instructions] [--entity-numbering]
[--nb-parallel-quests NB_PARALLEL_QUESTS]
[--quest-length LENGTH] [--quest-breadth BREADTH]
[--quest-min-length LENGTH] [--quest-max-length LENGTH]
[--quest-min-breadth BREADTH] [--quest-max-breadth BREADTH]
[--quest-min-depth DEPTH] [--quest-max-depth DEPTH]
Named Arguments¶
- --silent
Default: False
- -v, --verbose
Default: False
- --world-size
Nb. of rooms in the world.
Default: 5
- --nb-objects
Minimum nb. of objects in the world.
Default: 10
General settings¶
- --output
Path where to save the generated game. If it points to a folder, the game’s UUID will be used as the filename.
Default: “./tw_games/”
- --seed
- --format
Possible choices: ulx, z8
Which format to use when compiling the game. Default: “ulx”
Default: “ulx”
- --overview
Display an overview of the generated game.
Default: False
- --save-overview
Save the overview image of the generated game alongside the game as a PNG file.
Default: False
- --third-party
Load third-party module. Useful to register new custom challenges on-the-fly.
- -f, --force
Default: False
- --list
List available challenges.
Default: False
Grammar settings¶
- --theme
Theme to use for generating the text. Default: “house”
Default: “house”
- --include-adj
Turn on adjectives.
Default: False
- --blend-descriptions
Blend descriptions across consecutive sentences.
Default: False
- --ambiguous-instructions
Refer to an object using its type (e.g. red container vs. red chest).
Default: False
- --only-last-action
Intruction only describes the last action of quest.
Default: False
- --blend-instructions
Blend instructions across consecutive actions.
Default: False
- --entity-numbering
Append a number after an entity name if there is not enough variation for it (e.g. ‘red apple 2’).
Default: False
Quest settings¶
- --nb-parallel-quests
Nb. of parallel quests the game will have. Default: 1.
Default: 1
- --quest-length
Nb. of actions the quest requires to be completed. It is a shorthand for ‘–quest-min-length N –quest-max-length N –quest-max-depth N’.
- --quest-breadth
Nb. of subquests the quests will have. It is a shorthand for ‘–quest-min-breadth N –quest-max-breadth N’.
Quest settings (advanced)¶
- --quest-min-length
Minimum nb. of actions the quest requires to be completed. This setting is ignored if –quest-length is provided. Default: 1.
Default: 1
- --quest-max-length
Maximum nb. of actions the quest requires to be completed. This setting is ignored if –quest-length is provided. Default: 5.
Default: 5
- --quest-min-breadth
Minimum nb. of subquests the quests can have. This setting is ignored if –quest-breadth is provided. Default: 1.
Default: 1
- --quest-max-breadth
Maxmimum nb. of subquests the quests can have. This setting is ignored if –quest-breadth is provided. Default: 5.
Default: 5
- --quest-min-depth
Minimum nb. of actions the subquests can have. Default: 1.
Default: 1
- --quest-max-depth
Maximum nb. of actions the subquests can have. This setting is ignored if –quest-length is provided. Default: 5.
Default: 5
tw-coin_collector¶
Generate a Coin Collector game
tw-make tw-coin_collector [-h] [--output PATH] [--seed SEED]
[--format {ulx,z8}] [--overview] [--save-overview]
[--third-party PATH] [-f] [--list] [--silent | -v]
--level LEVEL
Named Arguments¶
- --silent
Default: False
- -v, --verbose
Default: False
General settings¶
- --output
Path where to save the generated game. If it points to a folder, the game’s UUID will be used as the filename.
Default: “./tw_games/”
- --seed
- --format
Possible choices: ulx, z8
Which format to use when compiling the game. Default: “ulx”
Default: “ulx”
- --overview
Display an overview of the generated game.
Default: False
- --save-overview
Save the overview image of the generated game alongside the game as a PNG file.
Default: False
- --third-party
Load third-party module. Useful to register new custom challenges on-the-fly.
- -f, --force
Default: False
- --list
List available challenges.
Default: False
Coin Collector game settings¶
- --level
The difficulty level. Must be between 1 and 300 (included).
tw-treasure_hunter¶
Generate a Treasure Hunter game
tw-make tw-treasure_hunter [-h] [--output PATH] [--seed SEED]
[--format {ulx,z8}] [--overview] [--save-overview]
[--third-party PATH] [-f] [--list] [--silent | -v]
--level LEVEL
Named Arguments¶
- --silent
Default: False
- -v, --verbose
Default: False
General settings¶
- --output
Path where to save the generated game. If it points to a folder, the game’s UUID will be used as the filename.
Default: “./tw_games/”
- --seed
- --format
Possible choices: ulx, z8
Which format to use when compiling the game. Default: “ulx”
Default: “ulx”
- --overview
Display an overview of the generated game.
Default: False
- --save-overview
Save the overview image of the generated game alongside the game as a PNG file.
Default: False
- --third-party
Load third-party module. Useful to register new custom challenges on-the-fly.
- -f, --force
Default: False
- --list
List available challenges.
Default: False
Treasure Hunter game settings¶
- --level
The difficulty level. Must be between 1 and 30 (included).
tw-simple¶
Generate simple challenge game
tw-make tw-simple [-h] [--output PATH] [--seed SEED] [--format {ulx,z8}]
[--overview] [--save-overview] [--third-party PATH] [-f]
[--list] [--silent | -v] --rewards {dense,balanced,sparse}
--goal {detailed,brief,none} [--test]
Named Arguments¶
- --silent
Default: False
- -v, --verbose
Default: False
General settings¶
- --output
Path where to save the generated game. If it points to a folder, the game’s UUID will be used as the filename.
Default: “./tw_games/”
- --seed
- --format
Possible choices: ulx, z8
Which format to use when compiling the game. Default: “ulx”
Default: “ulx”
- --overview
Display an overview of the generated game.
Default: False
- --save-overview
Save the overview image of the generated game alongside the game as a PNG file.
Default: False
- --third-party
Load third-party module. Useful to register new custom challenges on-the-fly.
- -f, --force
Default: False
- --list
List available challenges.
Default: False
Simple game settings¶
- --rewards
Possible choices: dense, balanced, sparse
The reward frequency: dense, balanced, or sparse.
- --goal
Possible choices: detailed, brief, none
The description of the game’s objective shown at the beginning of the game: detailed, bried, or none
- --test
Whether this game should be drawn from the test distributions of games.
Default: False