BlueGit

timfa copperfarmer

Files

copperfarmer / TESTING.md

TESTING.md

chore: bump version to 0.1.22
timfa GitLab CI · pushed by timfa · 2 months ago
71c4df13 History
TESTING.md 4.0 KiB Download Raw

CopperFarmer 0.1.22 smoke test

Use this checklist on a Paper 26.2 server before treating 0.1.0 as production-ready.

Startup

0 of 3 tasks completed

  • Start the server with CopperFarmer installed and confirm there is no enable error.
  • Confirm the log contains Seed recipe cache: once shortly after startup.
  • Confirm the plugin does not repeatedly rebuild the recipe cache while the server is running.

Crafting and placement

0 of 7 tasks completed

  • Craft 1 Copper Golem Statue + 1 Copper Hoe and verify the result is named Copper Farmer Golem.
  • Repeat with a damaged / renamed / enchanted Copper Hoe and verify those exact properties survive on the stored construction tool.
  • Test the same recipe in a vanilla Crafter.
  • Place the special statue and verify it becomes exactly one Copper Golem on the next tick.
  • Place a normal Copper Golem Statue and verify CopperFarmer leaves it completely alone.
  • Verify the farmer does not perform vanilla Copper Golem sorting/wandering behaviour.
  • Verify the Copper Hoe is visibly rendered in the main hand. If not, the server-side equipment is still present; add an ItemDisplay visual in the next version.

Chest binding

0 of 6 tasks completed

  • Put two copper chests within the configured search area and verify the closest loaded one is selected.
  • Put a closer chest in an unloaded chunk and verify CopperFarmer does not force-load that chunk.
  • Break the bound chest while the farmer is carrying items and verify it searches for another copper chest.
  • Make the bound chest unreachable and verify the farmer eventually abandons it after the configured path retries/cooldown.
  • With the farmer loaded and its bound chest chunk unloaded, verify the chest binding is kept (not cleared from PDC).
  • Fill the chest completely and verify the farmer keeps its cargo instead of dropping/deleting it.

Crops

Test at least one full harvest/replant/deposit cycle for:

0 of 10 tasks completed

  • Wheat
  • Carrots
  • Potatoes
  • Beetroot
  • Nether Wart
  • Cocoa
  • Sweet Berry Bushes
  • Torchflowers (only the flower block is harvested; age-1 crop is left alone)
  • Melon (fruit breaks; attached stem survives)
  • Pumpkin (fruit breaks; attached stem survives)

Also verify:

0 of 7 tasks completed

  • Immature crops are ignored.
  • A mature but completely unreachable crop is not selected endlessly.
  • The farmer tries alternative standable sides of a target before declaring it unreachable.
  • The farmer only accepts complete native paths (no partial path into a wall) and prefers the shortest complete stand-position route.
  • Once a path is accepted, the farmer follows vanilla navigation rather than recalculating every brain tick.
  • A changed obstruction causes a retry instead of permanently freezing the farmer.
  • Harvest/plant/deposit require line-of-sight and the configured horizontal/vertical action distances (no acting through walls).

Seeds and expansion

0 of 6 tasks completed

  • Normal seed/crop-as-seed replanting consumes exactly one appropriate item.
  • If a supported crop has a shaped/shapeless crop-to-seed recipe, remove direct seed drops and verify the farmer crafts once and replants.
  • If that recipe outputs multiple seeds, verify one is replanted and the remainder stays available for expansion/deposit.
  • Verify repeated cells in a shaped recipe consume the correct ingredient count.
  • Add/change a recipe after CopperFarmer's cache was built and verify it is ignored until restart/reload.
  • Leave connected farmland empty and verify spare seeds are planted one reachable position at a time.

Persistence and death

0 of 4 tasks completed

  • Let the farmer carry cargo, unload/reload its chunk, and verify cargo + chest binding + construction tool survive.
  • Restart the server while a farmer has cargo and verify the same state survives.
  • Kill a farmer with cargo and verify its exact construction Copper Hoe and all cargo drop.
  • Verify no duplicate construction hoe is produced by vanilla equipment drops.

Weathering

0 of 1 tasks completed

  • With prevent-oxidation: true, verify the farmer remains active and does not eventually weather back into a statue.
Source
1# CopperFarmer 0.1.22 smoke test
2
3Use this checklist on a Paper 26.2 server before treating 0.1.0 as production-ready.
4
5## Startup
6
7- [ ] Start the server with CopperFarmer installed and confirm there is no enable error.
8- [ ] Confirm the log contains `Seed recipe cache:` once shortly after startup.
9- [ ] Confirm the plugin does not repeatedly rebuild the recipe cache while the server is running.
10
11## Crafting and placement
12
13- [ ] Craft 1 Copper Golem Statue + 1 Copper Hoe and verify the result is named `Copper Farmer Golem`.
14- [ ] Repeat with a damaged / renamed / enchanted Copper Hoe and verify those exact properties survive on the stored construction tool.
15- [ ] Test the same recipe in a vanilla Crafter.
16- [ ] Place the special statue and verify it becomes exactly one Copper Golem on the next tick.
17- [ ] Place a normal Copper Golem Statue and verify CopperFarmer leaves it completely alone.
18- [ ] Verify the farmer does not perform vanilla Copper Golem sorting/wandering behaviour.
19- [ ] Verify the Copper Hoe is visibly rendered in the main hand. If not, the server-side equipment is still present; add an ItemDisplay visual in the next version.
20
21## Chest binding
22
23- [ ] Put two copper chests within the configured search area and verify the closest loaded one is selected.
24- [ ] Put a closer chest in an unloaded chunk and verify CopperFarmer does not force-load that chunk.
25- [ ] Break the bound chest while the farmer is carrying items and verify it searches for another copper chest.
26- [ ] Make the bound chest unreachable and verify the farmer eventually abandons it after the configured path retries/cooldown.
27- [ ] With the farmer loaded and its bound chest chunk unloaded, verify the chest binding is kept (not cleared from PDC).
28- [ ] Fill the chest completely and verify the farmer keeps its cargo instead of dropping/deleting it.
29
30## Crops
31
32Test at least one full harvest/replant/deposit cycle for:
33
34- [ ] Wheat
35- [ ] Carrots
36- [ ] Potatoes
37- [ ] Beetroot
38- [ ] Nether Wart
39- [ ] Cocoa
40- [ ] Sweet Berry Bushes
41- [ ] Torchflowers (only the flower block is harvested; age-1 crop is left alone)
42- [ ] Melon (fruit breaks; attached stem survives)
43- [ ] Pumpkin (fruit breaks; attached stem survives)
44
45Also verify:
46
47- [ ] Immature crops are ignored.
48- [ ] A mature but completely unreachable crop is not selected endlessly.
49- [ ] The farmer tries alternative standable sides of a target before declaring it unreachable.
50- [ ] The farmer only accepts complete native paths (no partial path into a wall) and prefers the shortest complete stand-position route.
51- [ ] Once a path is accepted, the farmer follows vanilla navigation rather than recalculating every brain tick.
52- [ ] A changed obstruction causes a retry instead of permanently freezing the farmer.
53- [ ] Harvest/plant/deposit require line-of-sight and the configured horizontal/vertical action distances (no acting through walls).
54
55## Seeds and expansion
56
57- [ ] Normal seed/crop-as-seed replanting consumes exactly one appropriate item.
58- [ ] If a supported crop has a shaped/shapeless crop-to-seed recipe, remove direct seed drops and verify the farmer crafts once and replants.
59- [ ] If that recipe outputs multiple seeds, verify one is replanted and the remainder stays available for expansion/deposit.
60- [ ] Verify repeated cells in a shaped recipe consume the correct ingredient count.
61- [ ] Add/change a recipe after CopperFarmer's cache was built and verify it is ignored until restart/reload.
62- [ ] Leave connected farmland empty and verify spare seeds are planted one reachable position at a time.
63
64## Persistence and death
65
66- [ ] Let the farmer carry cargo, unload/reload its chunk, and verify cargo + chest binding + construction tool survive.
67- [ ] Restart the server while a farmer has cargo and verify the same state survives.
68- [ ] Kill a farmer with cargo and verify its exact construction Copper Hoe and all cargo drop.
69- [ ] Verify no duplicate construction hoe is produced by vanilla equipment drops.
70
71## Weathering
72
73- [ ] With `prevent-oxidation: true`, verify the farmer remains active and does not eventually weather back into a statue.