NameMC (Paper)

Paper plugin that checks whether a player has liked your server on NameMC and runs commands when detected.

Requirements

1. Paper 1.21+.
2. Java 21.

Installation

1. Put the jar in plugins/.
2. Start the server to generate config.yml.
3. Adjust the configuration for your server.
4. Restart or run /namemcreload to reload.

Commands

1. /namemc
2. /namemcreload (permission namemc.command.reload)

Behavior

1. If check-join-event is true, the like is checked when the player joins.
2. If check-join-event is false, it is only checked when running /namemc.
3. If the like is true, the commands in commands are executed as console.

Configuration (config.yml)

# The IP address from which you want to check the player's like status.
# It's important that the IP address is spelled correctly. NO SUFFIXES.
ip-server: "example.com"

# The cache time saved per like.
# It should be checked when the player logs in.
check-join-event: false

# the commands that will be executed when a player's "like" is detected.
# commands are executed in that order.
commands:
  - 'lp user {player} meta setsuffix " &aOK"'

error-message: "<red>There was an error verifying your like on NameMC, please try again later."

api-link: "https://api.namemc.com/server/{server}/likes?profile={uuid}"

Config Notes

1. ip-server: exact domain or IP of your server on NameMC (no suffixes).
2. check-join-event: enables or disables the PlayerJoinEvent check.
3. commands: list of commands to run if the like is true. Supports {player}.
4. error-message: MiniMessage text sent when the API call fails.
5. api-link: NameMC URL with placeholders.

Placeholders

1. {server} is replaced by ip-server.
2. {uuid} is replaced by the player UUID without dashes.

Permissions

1. namemc.command.reload for /namemcreload.