FAQ
Why does /kf not open a menu on first use?#
The first release does not extract UI files automatically. An administrator player must click a language template button or run:
/kf ui en_US
Why is the old connection still active after changing database settings?#
Database connections are not switched at runtime. Fully stop and restart the server; do not use /reload.
Why can I not use the second through sixth slot positions?#
The matching slot level controls how many positions are active. Purchase input_slot, fuel_slot, or output_slot levels through the upgrade menu; changing the UI Layout alone does not unlock storage. If an upgraded slot still appears locked, make sure the Layout contains enough i/f/o positions and run /kf reload.
Why does cooking stop when the player goes offline?#
Offline behavior is controlled per furnace. A furnace without offline_smelting pauses; an unlocked furnace continues using absolute time.
Why is the provider unavailable even though Vault is installed?#
Vault is only a bridge and still needs a registered Economy implementation. A PlayerPoints price requires PlayerPoints to be enabled and the configured amount to be an integer. Check the provider in upgrades.yml, plugin enable order, and console errors.
What happens to payment when the database fails?#
KaFurnace restores the state from before the purchase or upgrade and attempts one refund through the original provider. If that backend also fails, the console writes a SEVERE audit entry with the player UUID, amount, and reason; an administrator must reconcile and compensate it manually.
Why does a blast furnace or smoker reject a regular furnace recipe?#
The three appliances are isolated by Bukkit recipe type. Blast furnaces accept blasting recipes and smokers accept smoking recipes.
Why did a menu edit not apply?#
Run /kf reload and check the console for invalid row width, missing button definitions, or invalid materials. An invalid external menu temporarily falls back to the built-in template for the same language.
Can multiple servers use the same MySQL database?#
Not as concurrent shared state. Each instance maintains its own in-memory state, so multiple instances can overwrite player data.
Why was a furnace action cancelled during a database outage?#
An action involving player items must receive database confirmation first. KaFurnace restores the previous state when the connection fails or the bounded critical queue is full, then asks the player to retry. A MySQL outage can block the current action until its connection or socket timeout; repeated failures open a short circuit breaker so every click does not wait for the full timeout again.