Troubleshooting

Troubleshooting

This page covers common PWAL problems and what to check before reporting a bug.

PWAL is a routing framework.

That means most problems come from one of four places:

• Looting is not enabled.
• The category is not enabled.
• The destination is not what you think it is.
• The game state does not support what you are trying to do.

Check the basics first.

Nothing Is Looting

Check this first:

• Is PWAL installed correctly?
• Is the plugin enabled?
• Are the scripts installed?
• Is looting enabled in the terminal?
• Is at least one loot category enabled?
• Are you close enough to valid loot?
• Are you in a restricted location?
• Are you expecting PWAL to loot something unsupported?

If looting is off, PWAL will not loot anything.

If the category is off, PWAL will not loot that category.

That is not a bug.

That is the framework obeying settings.

The Terminal Is Missing

The main PandaWorks AutoLoot Terminal should appear in the Weapons section of your inventory.

Check:

• Did the mod install correctly?
• Is the plugin enabled?
• Did the scripts install?
• Did the startup quest initialize?
• Are you using the current release?
• Did you load the game after enabling the mod?
• Are you looking in the Weapons section?

If the terminal never appears, this is probably an installation or quest initialization issue.

Do not report category or routing bugs until the terminal exists.

The Utility Device Is Missing

The Utility Device is separate from the main terminal.

Check:

• Is the plugin enabled?
• Are the scripts installed?
• Did the startup quest initialize?
• Did you receive the main PandaWorks AutoLoot Terminal?
• Are you using the current release?

If the main terminal exists but the Utility Device is missing, report it as a Utility Device issue.

If neither item exists, the problem is probably install or quest startup.

The Utility Device Does Not Open

Check:

• Does the main PandaWorks AutoLoot Terminal work?
• Does the Utility Device exist in your inventory?
• Are the scripts installed?
• Are you using the current release?
• Did you try closing and reopening the game after installation?

The Utility Device opens a utility terminal.

It is not the main configuration terminal.

Use the main PandaWorks AutoLoot Terminal for full setup.

Loot Goes To The Wrong Place

Check the destination settings.

PWAL routes loot based on category and destination rules.

If an item did not go to your player inventory, it may have gone to:

• PandaWorks Inventory
• Player Ship Cargo
• Lodge Safe
• The Void, where available

Also check whether the item is forced to a specific destination.

Some items ignore normal destination settings.

That is intentional.

Loot Is Missing

Check all possible destinations:

• Player inventory
• PandaWorks Inventory
• Player Ship Cargo
• Lodge Safe

If The Void is enabled and you routed the item there, it may be gone.

That is what disposal means.

Do not route items to The Void unless you are comfortable losing them.

Collectibles Are Going To Player

This is intended.

Collectibles always go to the player.

Do not report this as a routing bug.

PWAL does this so collectible pickups do not disappear into storage and confuse people.

The panda does not hoard your action figures.

Contraband Goes To PandaWorks Inventory

This is intended.

Contraband defaults to PandaWorks Inventory because Starfield’s contraband scan system can create stupid arrest-loop problems.

PWAL is trying to prevent automated contraband handling from getting the player repeatedly busted.

If you want to smuggle contraband, move it manually when you are ready.

Ship Cargo Does Not Work

Ship cargo requires a valid player home ship.

Check:

• Do you have a home ship?
• Are you past the point where the game gives you ship access?
• Is the ship cargo available?
• Are you checking the correct ship?
• Did the action fail safely because no valid ship exists?

If you do not have a valid home ship, PWAL cannot use ship cargo properly.

The panda cannot store loot in a ship the game has not given you yet.

Lodge Safe Does Not Work

Check:

• Is the Lodge Safe destination available?
• Are Lodge-related settings enabled?
• Are you checking the correct storage?
• Is the item forced somewhere else?
• Did the item route to Player, PandaWorks Inventory, or Ship Cargo instead?

The Lodge Safe is a supported storage destination, but forced routing rules still apply.

PandaWorks Inventory Does Not Show Items

If loot is routed to PandaWorks Inventory, open PandaWorks Inventory through the terminal or Utility Device.

Do not expect PandaWorks Inventory items to appear in your player inventory.

That is the entire point of separate storage.

If you routed something to PandaWorks Inventory, check PandaWorks Inventory.

A Category Is Not Looting

Check:

• Is looting enabled?
• Is the category enabled?
• Is the item actually part of that category?
• Is the item in range?
• Is the location allowed?
• Is the item blocked by forced routing or validation rules?

Categories control what PWAL is allowed to loot.

Destinations do not matter if the category itself is disabled.

A Category Is Missing

Some older or separate categories may have been merged.

For example, several collectible-style misc categories may now be handled under Collectibles.

That does not mean the category was forgotten.

It means the system was cleaned up.

Not every tiny item type needs its own menu goblin.

Resources Are Not Going Where Expected

Check whether you are dealing with:

• Inorganic resources
• Organic resources
• Manufactured resources
• Harvest resources
• Spell-harvest resources
• Nonlethal harvest resources

Some resource systems may use internal routing rules.

Extra harvest and spell-harvest variations should generally follow the main resource handling instead of acting like separate player-facing destination systems.

If a resource does not route as expected, report the exact item name and where it went.

Containers Are Not Looting

Check:

• Is container looting enabled?
• Are the item categories inside the container enabled?
• Is the container valid?
• Is the container in range?
• Is the container in a restricted location?
• Is the container owned or protected by game rules?

Container looting and item category looting are separate checks.

A container can be detected while some items inside it are still ignored.

Corpses Are Not Looting

Check:

• Is corpse looting enabled?
• Are the item categories on the corpse enabled?
• Is the corpse valid?
• Is the corpse in range?
• Is the location allowed?
• Is the corpse using unusual actor or inventory behavior?

Corpses are not always the same as normal containers.

Bethesda corpse inventories can involve actor data, equipment behavior, race handling, and other engine swamp nonsense.

Harvestables Are Not Looting

Check:

• Is the harvest category enabled?
• Is the resource category enabled?
• Is the object actually a supported harvestable?
• Is it in range?
• Is the location allowed?
• Is the harvest object exposed in a way PWAL can process?

Some harvestables are activator-based.

Some activator-style pickups may need to go directly to the player.

That is not always configurable.

Looting Is Slow

Check:

• Scan radius settings
• Number of enabled categories
• Number of nearby lootable objects
• Whether you are in a dense area
• Whether multiple destinations are being used
• Whether transfer/routing rules are doing extra work

Higher radius means more work.

More enabled categories means more work.

Routing to multiple destinations can be slower than routing everything to one destination.

Do not max every setting and then act surprised when the engine starts wheezing like a dying accordion.

The Game Stutters When Looting

Try:

• Lowering scan radius
• Enabling fewer categories
• Testing in a smaller area
• Avoiding massive loot piles
• Routing fewer categories to different destinations
• Checking for other script-heavy mods

PWAL is built for performance, but Starfield still has limits.

The engine is not magic.

It is a haunted spreadsheet with lighting effects.

A Transfer Did Nothing

Check:

• Is the source container empty?
• Is the destination available?
• Is ship cargo available?
• Does the transfer only move certain item types?
• Are the items actually eligible for that transfer?
• Did the transfer complete but send items somewhere you did not check?

Transfer utilities move existing stored items.

They do not create items.

They do not loot nearby objects.

They do not move what is not there.

The Ship Transfer Did Nothing

Check:

• Do you have a valid home ship?
• Is ship cargo accessible?
• Is the source container empty?
• Are the items eligible for the transfer?
• Did the transfer fail safely?

Ship cargo depends on game state.

If the game does not expose a valid ship cargo reference, PWAL cannot use it.

Logging Is Too Noisy

If logging is enabled, PWAL may produce debug output.

Use logging when testing or reporting bugs.

Turn it off for normal play if you do not need it.

If you are reporting a bug, logs are useful.

If you are not reporting a bug, log spam is just the engine whispering threats.

Restricted Locations

Some locations may be restricted by settings.

Check location-related settings if PWAL does not loot in:

• Lodge
• Outposts
• Player homes
• Ships
• Cities
• Special interiors
• Other protected areas

If location rules block looting, PWAL is doing what the settings tell it to do.

The Mod Worked Before Updating

After updating:

• Exit the game completely.
• Replace old files with the new version.
• Make sure the plugin is enabled.
• Make sure scripts updated correctly.
• Load the game.
• Test the terminal.
• Test one small category.

Do not hot-swap scripts mid-session and expect Papyrus to behave.

Papyrus remembers.

Papyrus always remembers.

Before Reporting A Bug

Include this information:

• PWAL version
• Starfield version
• Mod manager used
• Load order if relevant
• What you expected to happen
• What actually happened
• Which category was enabled
• Which destination was selected
• Where you were in-game
• Whether logging was enabled
• Any relevant log output
• Whether the issue happens on a small test case

Do not report “it does not work” with no details.

That is not a bug report.

That is a distress signal from a fog machine.

Good Bug Report Example

Good:

“PWAL v1.0.0-alpha. Looting enabled. Junk category enabled. Junk destination set to PandaWorks Inventory. Tested in New Atlantis interior. Loose junk nearby did not move. PandaWorks Inventory checked. Logging enabled. No transfer message appeared.”

Bad:

“Mod broken.”

One of these can be fixed.

The other gets thrown into the void.

Support

Support, bug reports, testing feedback, and general discussion are handled through the PandaWorks Discord.

https://discord.gg/aGJhkYb4

Summary

Most PWAL issues come down to settings, routing, location rules, or installation.

Check:

• Looting enabled
• Category enabled
• Destination configured
• Destination available
• Location allowed
• Item supported
• Scripts installed
• Plugin enabled

The panda usually does exactly what it was told.

Unfortunately, players do too.