Troubleshooting

Nothing gets picked up

Work through this list:

  1. autopickup.enabled is true in config.yml.
  2. The player's toggle is on. Have them run /autopickup settings, or check default-enabled.
  3. The player isn't in creative mode while disable-in-creative is true.
  4. The player isn't explicitly denied autopickup.toggle.
  5. The whitelist isn't on with entries that don't match. Remember block breaks are matched on the block ID, not the item ID. See Item Filters.
  6. The console shows no Failed to initialize database warning at startup. If it does, see below.

"Failed to initialize database" at startup

The database couldn't be opened. With MySQL or MariaDB, check host, port, name, user and password, and that the database exists. With SQLite, check that the server can write to mods/BusyBee_AutoPickup/ and that the platform is supported (see Requirements). Fix it and restart; a reload doesn't reopen the database.

Players can't run /autopickup

Hytale only runs a command for players who have been granted its node. Grant autopickup.toggle to their group. For /autopickup settings and /autopickup reload, they need autopickup.toggle and the subcommand's own node. See Commands & Permissions.

Some drops are picked up, others are left behind

  • Scattered drops: the item landed outside pickup-radius. Raise it a little, or make sure Tree Detection covers the block.
  • Late drops: the item spawned after entry-expiry-ms. Raise it and restart.
  • Full inventory: whatever doesn't fit stays on the ground.

A player picked up items they didn't break

The item spawned within pickup-radius of one of their recent breaks, and closer to it than to anyone else's. Lower pickup-radius and entry-expiry-ms. See Performance Guide.

My config.yml lost its comments

The startup check saved the file after fixing a value or adding missing tree types, and that save writes plain YAML without comments. Your values are kept. See Main Configuration.

A change didn't apply after /autopickup reload

database settings and entry-expiry-ms are only read at startup. Restart the server.

"Both whitelist and blacklist are enabled!" in the console

Only one mode can be on. The whitelist wins and the blacklist is switched off. Set the one you don't want to false.