EnlivenMinetest/procedures/testing/mapgen.md

"Map Generation" Test Documentation

This documentation covers all testing in the category of "mapgen," and is is based on general.md.

NOTICE: I originally created the original version of this document (and the original document that led to creating the article Minetest's Scope Issue, and the initial version of general.md) for my Software Development II class. I didn't do it here nor elsewhere before that nor plagiarize.

Test Design Guide

Setting up an efficient map generation test environment requires finding a seed that provides a biome providing edible plants near where grass and water are touching. The tsm_pyramids location must be far away enough from the starting location and farming locations that loading the pyramid cannot crash the game during other tests. The tsm_pyramids test must always come last.

Test Environment Creation

1. Add "enable_marble_generation = true" to minetest.conf to test technic_worldgen fully. Set the gamma to 2.0 to ensure that the testers can see in the dark so that ore generation tests proceed quickly and hopefully without the need to place torches.
2. Before entering the world, backup the minetest.conf file.
3. Enter as singleplayer and grant singleplayer the noclip, fly, and teleport privileges.
4. Add the following to singleplayer’s inventory: 1 stone hoe, 64 torches.
5. Determine the following locations and provide 3D coordinates for the tester: farming ("farming redo"), moreores, tsm_pyramids, technic_ores.

Instructions for Testers

This section is intended to be the only test document that the tester needs for this or other test categories.

General instructions:

Proceed to the tests section, use the inputs as the tests describe, then record the results.

Inputs:

[Instead of "...", the test documentation must provide coordinates of each test location.]

• farming: ...
• moreores: ...
• technic_ores: ...
• tsm_pyramids: ...

Tests:

1. Teleport to the farming location. Ensure that edible plants are there and that harvesting them yields produce or seeds.
   • Results:
2. Teleport to the moreores location. Ensure that "moreores:mineral_silver" appears within sight range and that harvesting it yields ore (not stone with silver) (Minetest-mods/moreores, 2020).
   • Results:
3. Teleport to the technic_ores location. Ensure that "technic:mineral_lead" appears within site range and that harvesting it yields ore (not stone with lead) (Minetest-mods/technic, 2019).
   • Results:
4. Teleport to the tsm_pyramids location. Wait 5 seconds. Ensure that the game does not crash. Enter the pyramid. Wait 5 more seconds. Ensure that the game does not crash.

• Results: