contentdb/app/flatpages/help/game_support.md
2023-06-19 21:57:54 +01:00

1.4 KiB

title: Supported Games

This feature is experimental

Why?

The supported/compatible games feature allows mods to specify the games that they work with, which improves user experience.

Support sources

mod.conf / texture_pack.conf

You can use supported_games to specify games that your mod is compatible with.

You can use unsupported_games to specify games that your mod doesn't work with, which is useful for overriding ContentDB's automatic detection.

Both of these are comma-separated lists of game technical ids. Any _game suffixes are ignored, just like in Minetest.

supported_games = minetest_game, repixture
unsupported_games = lordofthetest, nodecore, whynot

If your package supports all games by default, you can put "*" in supported_games. You can still use unsupported_games to mark games as unsupported. You can also specify games that you've tested in supported_games.

# Should work with all games but I've only tested using Minetest Game:
supported_games = *, minetest_games

# But doesn't work in capturetheflag
unsupported_game = capturetheflag

Dependencies

ContentDB will analyse hard dependencies and work out which games a mod supports.

This uses a recursive algorithm that works out whether a dependency can be installed independently, or if it requires a certain game.

Combining all the sources

mod.conf will override anything ContentDB detects.