Promocodes allows you to create promotion codes which run commands when redeemed by players.

You can either use automatically generated codes using the "Automatically Fill To (Amount)" option, or insert your own.

This website can be used to generate codes aswell.

Commands

This plugin provides universal chat and console commands. When using a command in the chat, prefix it with a forward slash: /.

• redeem <code> -- Redeem a promocode

Configuration

[
  {
    "Automatically Fill To (Amount)": 5,
    "Codes": [],
    "Commands": [
      {
        "Parameters": [
          "{username} just redeemed a code!"
        ],
        "Command": "say"
      }
    ]
  }
]

Every setting looks like this: "Key": Value

The key is the name/description of the setting while the value is the actual value you want to set it to.

The whole part inside the outer [ ] can be duplicated to create another "promocode group".

Automatically Fill To (Amount) -- Promocodes will ensure there are always this many codes, if there are less, it automatically generates new onesCodes -- Contains all redeemable codes of this code group (If the same code exists in multiple code groups, all of those are activated)Commands -- The commands to be run when a code from this code group is redeemed; The commands can also be duplicated to run multiple commandsParameters -- Contains the parameters to be passed when running the commandCommand -- The command to be run

Example Configuration

[
  {
    "Automatically Fill To (Amount)": 0,
    "Codes": [
        "ABC-DEF-GHI",
        "JKL-MNO-PQR-STU"
    ],
    "Commands": [
      {
        "Parameters": [
          "{username} just redeemed a VIP package!"
        ],
        "Command": "say"
      },
      {
        "Parameters": [
          "add",
          "{id}",
          "vip"
        ],
        "Command": "o.usergroup"
      }
    ]
  },
  {
    "Automatically Fill To (Amount)": 2,
    "Codes": [
        "123-456-111",
        "123-456-112"
    ],
    "Commands": [
      {
        "Parameters": [
          "{username} just redeemed a VIP  package!"
        ],
        "Command": "say"
      },
      {
        "Parameters": [
          "add",
          "{id}",
          "vip-plus"
        ],
        "Command": "o.usergroup"
      }
    ]
  }
]

Localization

{
  "Invalid Code": "The code you entered seems to be either invalid or already redeemed.",
  "Code Redeemed": "You redeemed a code with and received {amount} reward packages."
}