From 8ac335f92db9d7710dc69742ed961990776761e8 Mon Sep 17 00:00:00 2001 From: Ixrec Date: Wed, 29 Apr 2026 20:22:35 +0100 Subject: [PATCH] Docs: Rewrite get_filler_item_name's docstring to avoid implying it's for filling all unfilled locations #5956 --- worlds/AutoWorld.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/worlds/AutoWorld.py b/worlds/AutoWorld.py index 04f0b61ff8..ddc8ff2d2a 100644 --- a/worlds/AutoWorld.py +++ b/worlds/AutoWorld.py @@ -512,7 +512,9 @@ class World(metaclass=AutoWorldRegister): def get_filler_item_name(self) -> str: """ - Called when the item pool needs to be filled with additional items to match location count. + If core AP removes an item from your item pool, this method is called to choose a replacement item + so item count and location count remain equal. + For example: plando, item_links and start_inventory_from_pool are features that may cause this. Any returned item name must be for a "repeatable" item, i.e. one that it's okay to generate arbitrarily many of. For most worlds this will be one or more of your filler items, but the classification of these items