FAQ

How do I update SnGGWave?

Download the newer version from https://sndevelopment.dev/plugins/snggwave and replace the jar. Configs auto-merge on restart.

Does it support Folia?

No, SnGGWave is not declared Folia-compatible.

Should I install it on the proxy or on a backend server?

Choose by the reach you want. On a Velocity proxy, waves are shown to every server of the network. On a Paper server, waves are shown on that server only.

Can I install it on the proxy and on the backend servers together?

No. Install it on ONE level only. Each copy would process the same GG.

Where does the license file go?

In plugins/.Sn-License/license.yml on the server or proxy that runs SnGGWave. Start it once to create the file, then paste your key.

Where does SnLib go?

SnLib.jar must be in the plugins/ folder of the same server or proxy as SnGGWave.

Why does the announcement have no sponsor head?

The head needs SkinsRestorer on the same level as SnGGWave. Without it, or if it fails, the announcement is sent without the head. You can also switch it off with visual.avatar.enabled.

Why does my GG not look like normal chat?

While a wave is open, SnGGWave takes over GG messages. It hides the original message and shows an animated rainbow line to everyone. Change the look under visual.chat and visual.rainbow.

What counts as a GG?

A message that matches allowed-gg-pattern in full, after trimming. The default accepts GG, GG! and GGG in any case. An invalid regex falls back to the default.

Can a player claim a wave twice?

No. Rewards run once per player for each wave. A later GG still shows the chat line. It claims another open wave if the player has not claimed it yet.

Why did my reward command not run on the proxy?

Reward commands run in the console of the platform that hosts the plugin. On a proxy that is the proxy console, so use commands the proxy knows.

What can I use in a reward command?

The placeholders {player}, {player_uuid}, {wave_id}, {sponsor}, {amount} and {seconds}. A leading / is ignored and blank entries are skipped.

How long does a wave last?

wave-seconds in config.yml sets it, from 1 to 86400 seconds. Run /ggwave reload to apply a change. A reload never ends a running wave.

Does /ggwave debug work on the proxy?

No, it is a Paper command. On a proxy, set debug.enabled in config.yml and run /ggwave reload.

How do I change the command alias?

Edit command.aliases in config.yml and run /ggwave reload. The default alias is /okigg.

Can other plugins hook into waves?

Yes. SnGGWave has a public developer API with events and a query service. See the Developer API page.