Description

About VIP Token

This plugin will allow players to puchase a token via a shopfront such as Tebex.io and trade them in game.

These tokens can have different functions when consumed, which can include one or more of the following triggers:

• Groups: a token can assign a player to a group when consumed. This group could be anything from VIP, to specialized groups on a role play server etc. Players will automatically be removed from the group when the time expires.
• Commands: a token can run a server command when consumed. The command can be a general command like env.time or a targeted command from another plugin (like kits) to provide the player with a kit (kit give {id} kitName).
• Custom hooks: the plugin can also fire a hook when a token is consumed (OnTokenConsumed(BasePlayer player, string tokenKey). This is useful for developers who want to add specialized functionality to their plugins, or for some of my other plugins that work with VIPToken.

The primary benefit of this plugin, is that it allows your more generous donators to purchase and sell in-game perks to other players on your server for in-game items.

Features

• Customizable tokens to suit most servers monetary requirements.
• Scalable quantities of VIP perks.
• A GUI to manage and show the players token balance, token perks and the date of their subscription (configurable).
• Automatically adds and removes players from the desginated oxide groups. Time parameters are completely configurable via the config file.
• Fail safes to prevent abuse, restrictrict the amount of VIP time for each token (configurable), and prevent overlapping of existing group access (configurable).
• Run commands for plugins such as kits.

Click here for demo and setup video

Config example

{
  "Maximum VIP days that a player can accumulate per tier": 90,
  "Sound effect when purchasing or consuming a token": "assets/prefabs/deployable/vendingmachine/effects/vending-machine-purchase-human.prefab",
  "Sound effect when consuming a token. Set it to nothing if you do not want an effect": "assets/prefabs/misc/easter/painted eggs/effects/gold_open.prefab",
  "Password for command verification (make one up)": "ChangeThisPassword124u5109123",
  "Chat commands for opening the menu.": [
    "tokenmenu",
    "tokenbalance",
    "storetoken",
    "redeemtoken"
  ],
  "Date time format (case sensitive): dd == day. MM == month. yyyy == year": "dd-MM-yyyy",
  "Prevent players from consuming a token if they are already in the group?": true,
  "How often should the plugin check to see if a player has run out of VIP [seconds]?": 3600.0,
  "Add your vip tiers and commands here. Use {id} in place of a players userid and {name} in place of their name.": {
    "vip": {
      "name": "vip tier 1",
      "time_type": "day",
      "time_to_add": 30,
      "vip_group": "vip",
      "vip_description": "This is an example of a group only VIP token",
      "remove_tokens_on_wipe": false,
      "token_item": {
        "name": "VIP Token - 30 days",
        "skin": 2529344523,
        "item_shortname": "radiationresisttea.pure"
      },
      "_command": null
    },
    "command_1": {
      "name": "Command Token 1",
      "time_type": "day",
      "time_to_add": 0,
      "vip_group": null,
      "vip_description": "This is an example of a command only vip token",
      "remove_tokens_on_wipe": false,
      "token_item": {
        "name": "Day token",
        "skin": 2576299173,
        "item_shortname": "radiationresisttea.pure"
      },
      "_command": {
        "command": "env.time 11",
        "message": "You made it day.",
        "public_message": "{name} has redeemed a token, turning night to day.",
        "hook": false
      }
    },
    "kitstoken": {
      "name": "Kit token",
      "time_type": "day",
      "time_to_add": 0,
      "vip_group": null,
      "vip_description": "This is an example of a command that gives a kit when consumed",
      "remove_tokens_on_wipe": false,
      "token_item": {
        "name": "kit token",
        "skin": 2538724232,
        "item_shortname": "radiationresisttea.pure"
      },
      "_command": {
        "command": "kit give {id} vipkit",
        "message": "You redeemed a vip kit",
        "public_message": "{name} has redeemed a vip kit.",
        "hook": false
      }
    },
    "vip2withcommand": {
      "name": "VIP with Command",
      "time_type": "day",
      "time_to_add": 30,
      "vip_group": "vip2",
      "vip_description": "This is an example of a group and command token.nYou can also add new lines like this.",
      "remove_tokens_on_wipe": false,
      "token_item": {
        "name": "Item Giver",
        "skin": 2546992685,
        "item_shortname": "radiationresisttea.pure"
      },
      "_command": {
        "command": "inventory.giveto {id} scrap 1000",
        "message": "You received some scrap.",
        "public_message": "{name} has redeemed a token and give themselves some scrap. ID: {id}",
        "hook": false
      }
    }
  }
}