St3ix Docs

AFKPlus FAQ

Why the shop is empty, why kills pay nothing, and how to move balances to another storage.

Does an update reset my config?

No. A new JAR does not replace config.yml, lang.yml, gui.yml, or animations.yml when those files already exist. A missing key uses the built-in value. The file you edited stays. /afk admin reload reads the files again. It does not copy the template over them.

Saving a shop offer, a booster, or the pay-confirm switch rewrites config.yml from the values already loaded. That can drop inline comments. It does not restore the sample shop or the sample rewards.

Why is the shop empty?

The live plugins/AFKPlus/config.yml has no Shop block. AFKPlus does not paste the sample offers into a file you already have. Add an offer with /afk admin shop, or copy a Shop section in by hand and reload. Pages are mapped in gui.yml. A slot that names a missing offer is skipped.

Why do kills pay nothing?

Kills.Enabled starts as false. Mob kills also need Kills.Mobs.Enabled: true, and the mob must be listed under Kills.Mobs.List. A kill in a world that is not in Kills.Worlds pays nothing when that list is not empty. The victim never loses shards.

Why are the placeholders empty?

%afkplus_balance% and the other %afkplus_…% placeholders need PlaceholderAPI installed and a restart. AFKPlus still starts without it. %afkplus_currency% is the only one that works with no player. The list is on Placeholders.

How do I switch from SQLite to MySQL or YAML?

Do not rename afkplus.db and expect MySQL to read it.

  1. Run /afk admin storage export. That writes plugins/AFKPlus/transfer.yml and leaves the current database in place.
  2. Stop the server.
  3. Set Storage.Type to SQLITE, YAML, or MYSQL, and fill in that engine’s keys.
  4. Start the server.
  5. Run /afk admin storage import.

Import replaces the zones in the storage you just started and overwrites player balances and boosters from transfer.yml. If that file is missing, nothing is changed.

The pay screen never opens

Shards.Pay: false blocks /shards pay entirely. Shards.PayConfirm is the default. A player turns their own screen off with /shards confirm disable. Another player is set with /afk admin confirm <player> disable, or with a UUID or name under Shards.PayConfirmPlayers. Shop confirms are separate: each offer has its own Confirm key.

Suggestions

Export with /afk admin storage export before you edit Storage.Type, then follow Storage. If a command still fails after that, set Debug: true and use the ticket steps on FAQ.

On this page