SnDevelopmentFAQ
On this page(18)
How do I update SnPlayerWarps?
Download the newer snplayerwarps-v* release and replace the jar. Configs auto-merge on restart.
Does it support Folia?
No, SnPlayerWarps is not Folia-compatible.
The plugin will not enable and the console says License: FAIL
The key in plugins/.Sn-License/license.yml is missing, wrong or expired. Paste a valid Sn bundle key there and restart. One key covers every bundled Sn plugin on the server.
How many warps can a player own?
limits.default-warps, which ships at 1. Grant snplayerwarps.limit.<n> to let a rank own <n> warps. The highest node a player holds wins, checked up to limits.permission-scan-max. snplayerwarps.admin.bypass.limit ignores the limit.
Players cannot buy sponsor slots
Check the currency first. The shipped sponsor.currency is okicoins, a command-backed example built for SnCredits. On a server without SnCredits, point it at money (Vault) or at a currency of your own. Also check the console for a skipped currency or a skipped slot at start.
A command-backed currency always refuses
Its balance is read through balance-placeholder, so PlaceholderAPI and the expansion behind that placeholder must be installed. Check it resolves to a plain number with /papi parse <player> %your_placeholder%. A take-command without {player} and {amount} skips the whole currency.
A sponsor slot is configured but never shows in the browser
guis/browse.yml shows one sponsor slot per S cell of its layout, in position order. Slots past the last S cell are not sold, and the console names them at start and after every reload. Add S cells, remove the slots, or free held ones with /playerwarp admin clearsponsor <slot> refund.
A sponsor slot is skipped with a WARN about its price
price is required and must be a plain number, quoted or not. A missing price or one like 1k skips the slot instead of making it free. Write price: 0 for a free slot.
What happens to the money when a sponsored warp is deleted?
It depends on sponsor.refund-mode. NONE pays nothing and PRORATED refunds the unused share. FULL refunds the whole price only for a staff delete, a staff lock or the inactivity purge; otherwise it refunds the unused share. See Configuration.
Players cannot create warps on their island
With islands.privilege-check: true, their island role needs the PLAYER_WARPS privilege. Add it to the member role of the island plugin, and a player_warps entry to its menus/permissions.yml. See Installation. To rely on membership alone, set islands.privilege-check: false.
A player left an island and their warps disappeared
That is islands.on-member-removed. Leaving, a kick, a ban or a disband deletes or closes that player's warps on the island. Set it to CLOSE to keep the warps closed instead of deleting them.
A coop player's warps vanished after they logged out
SuperiorSkyblock uncoops a player when they log out. With islands.allow-coop: true, a coop's warps last one coop session and are removed (or closed) once it ends.
The [pwarp] chat link sometimes shows as plain text
The link is added before the chat plugin formats the message. SnChat rebuilds the message from plain text when a player allowed to use & color codes types one, and the link is lost for that message.
A command-filter plugin blocks the chat link clicks
With chat-tag.click-mode: CALLBACK, a click runs through Paper's /paper:callback command, which command filters see. Allow it, or set click-mode: COMMAND so the link runs /playerwarp visit <owner> <warp>.
Visit counts rose again after a restart
visits.unique-window is kept in memory. After a restart, the next visit of each player to each warp counts again.
A warp cannot be visited and staff see it in the validation report
Warps in unloaded worlds stay in the database but cannot be visited until their world loads again. /playerwarp admin validate lists them, along with warps the world rules or the safety check now refuse.
I switched from SQLite to MySQL and every warp is gone
Nothing is migrated between databases. Your warps, sponsor slots and queued refunds stay in the old database. Switch back to reach them.
Can two servers share one MySQL database?
No. The plugin loads the database once at start and does not see changes made by another server. Give each server its own database.