azuvotifier

A fork of NuVotifier with various enhancements, such as Redis forwarding and support for additional platforms. From the original README:

NuVotifier is a secure alternative to using the original Votifier project. NuVotifier will work in place of Votifier - any vote listener that supports Votifier will also support NuVotifier.

Useful resources

• Setup Guide
• Troubleshooting Guide
• Developer Information

Supported platforms

azuvotifier is currently supported on the following platforms:

• CraftBukkit, Spigot, Paper, Pufferfish or Purpur (1.8.8+)
  • Older versions might work but no support will be provided.
  • Any fork without significant breaking changes should also work.
  • Folia (1.21.5+)
  • Fabric (1.21.10)
  • Sponge 11 (1.20+)
  • BungeeCord/Waterfall
  • Velocity

It can also run as a standalone application using the redis and proxy forwarding methods.

Running

You can get the latest release directly from GitHub or Modrinth. Then, follow the instructions for your server software or the standalone version:

Bukkit, Folia, Sponge, BungeeCord and Velocity

Drag and drop the downloaded JAR into your plugins/ folder. You should've downloaded the JAR that has your server software in its name. If you've done everything right, it should work out of the box.

Fabric

Drag and drop the downloaded JAR into your mods/ folder. You'll also need to download and install Fabric API.

Standalone

Open up the terminal, go into the directory the previously downloaded JAR is at, and then run it like this:

$ java -Xms512M -Xmx512M -jar azuvotifier-standalone.jar

You can also use command line arguments to configure some settings, such as the hostname:

$ java -Xms512M -Xmx512M -jar azuvotifier-standalone.jar --host 127.0.0.1 --config /etc/nuvotifier/

To get a full list of options, run:

$ java -jar azuvotifier-standalone.jar --help

Standalone with Docker

A Docker image for the standalone version is available at Docker Hub. To pull it, run:

$ docker pull azurejelly/standalone-nuvotifier:latest   # for the latest stable release
$ docker pull azurejelly/standalone-nuvotifier:unstable # for the latest commit on master

You can then run the image using a command like:

$ docker run -p 8192:8192 \
    -v /etc/nuvotifier:/app/config \
    --restart unless-stopped \
    --name nuvotifier \
    azurejelly/standalone-nuvotifier:latest \
    --port 8192

This will:

• Expose port 8192 on the host machine;
• Map /etc/nuvotifier (host) to /app/config (container) using socket mounts;
• Restart the container automatically unless stopped;
• Name the container nuvotifier;
• Use the azurejelly/standalone-nuvotifier:latest image;
• And pass --port 8192 as a command line argument to NuVotifier.
  • Not required as 8192/tcp is already the default port, but helps to show that you can pass arguments such as --port or --config.

If you want to use Docker Compose, an example docker-compose.yml file is available on the repository.

License

azuvotifier is GNU GPLv3 licensed. This project's license can be viewed here.