LootBoxes Plus (ARK)

LootBoxes Plus (ARK) 1.21

LootBoxes Plus allows you to create random lootboxes that you can award to your players via a webshop or some other method in order to monetize your ARK servers.

Features:
Timed LootBoxes:
- Set multiple intervals, each with a box, amount and group restrictions​
- Functions the same as ArkShop Timed Reward​
Loot Groups:
- Items: Armor, Weapons, Saddles, Structures, etc.​
- Shop Points: Random number of points for ArkShop​
- Resources​
- Dinos​
- Commands: EXP, Kits, another LootBox, etc!​
Group Restrictions:
Specify group restrictions for both receiving a TimedRewards LootBox and for opening a LootBox. Give your players a VIP box to incentivize membership!​
Config Generator:
From the Discord, you can access a config generator sheet for the plugin. It allows you to easily plan your LootBoxes and create your entire config.json file. You may set the weight of your entries and view your % Drop rates for both a single roll and for the box as a whole.​

Commands:
Chat Commands (Can set your own in config):
/lootboxes - View lootbox balance​
/lootbox <BoxName> - Use a lootbox​

RCON & Console Commands:
AddLootBox <SteamID> <BoxName> <Amount> - Add a LootBox by SteamID​
LBP.Reload - Reload config.json​
AddLootBoxFromCmd <BoxName> <Amount>
- Adds lootbox to the player that runs/buys this command (No SteamID needed)​
UseLootBoxFromCmd <BoxName>
- Opens lootbox for the player that runs/buys this command (They need to have one first)​

Example ArkShop Item:
Code:
    "SilverBox": { // Gives the buyer the specified LootBox
      "Type": "command",
      "Description": "Silver LootBox",
      "Price": 1,
      "Items": [
        {
          "Command": "addlootboxfromcmd Silver 1"
        }
      ]
    },
    "SilverOpenBox": { // Gives the buyer the specified LootBox and opens it automatically
      "Type": "command",
      "Description": "Silver LootBox",
      "Price": 1,
      "Items": [
        {
          "Command": "addlootboxfromcmd Silver 1"
        },
        {
          "Command": "uselootboxfromcmd Silver"
        }
      ]
    }

Configuration:
Code:
{
  "DisableWarnings": false, // Disables console warning/info logs
  "Database": {
    "UseMySQL": true, // Uses sqlite otherwise
    "MySQLHost": "localhost",
    "MySQLUsername": "root",
    "MySQLPassword": "password",
    "DBName": "arklootboxes", // Create this schema on your Mysql server, dont use the same schema as another plugin
    "SQLitePath": "D:/Servers/Database"
  },
  "Commands": { // Change your messages to match
    "ViewLootBoxes": "/lootboxes", // Show player lootboxes cmd
    "UseLootBox": "/lootbox" // Open a lootbox cmd
  },
  "TimedRewards": {
    "Enabled": true, // TimedRewards on or off
    "Intervals": [
      {
        "Interval": 60, // Time in minutes
        "Box": "Silver", // Name of the lootbox
        "Amount": 1, // Amount to give
        "Groups": "" // Groups to give to, "" for any group
      },
      {
        "Interval": 90,
        "Box": "Gold",
        "Amount": 1,
        "Groups": "Premiums"
      }
    ]
  },
  "DefaultBox":"Silver", // Box to be given out for /lootbox cmd without specifying a box
  "LootBoxes": {
    "Silver": { // Name of the lootbox
      "Groups":"Default,Premiums", // Groups that can open the box, "" for any group
      "Items": {
        "Rolls": 1,
        "PossibleItems": [
          {
            "Amount": 1,
            "MinQuality": 2,
            "MaxQuality": 3.5,
            "BlueprintChance": 10,
            "Blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponMetalPick.PrimalItem_WeaponMetalPick'"
          },
          {
            "Blueprint": "" // Filler - Empty entry if you want to have a chance for nothing to drop
          }
        ]
      },
      "Dinos": {
        "Rolls": 3,
        "PossibleDinos": [
          {
            "Level": 1,
            "Blueprint": "Blueprint'/Game/Mods/ClassicFlyers/Dinos/Quetz/Quetz_Character_BP.Quetz_Character_BP'"
          },
          {
            "Level": 1,
            "Blueprint": "Blueprint'/Game/PrimalEarth/Dinos/Rex/Rex_Character_BP.Rex_Character_BP'"
          },
          {
            "Blueprint": "" // Filler
          }
        ]
      },
      "Resources": {
        "Rolls": 1,
        "PossibleResources": [
          {
            "Amount": 50,
            "Blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Element.PrimalItemResource_Element_C'"
          },
          {
            "Amount": 100,
            "Blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Element.PrimalItemResource_Element_C'"
          },
          {
            "Blueprint": "" // Filler
          }
        ]
      },
      "ShopPoints": {
        "Rolls": 1,
        "PossiblePoints": [
          {
            "MinPoints": 1,
            "MaxPoints": 50
          },
          {
            "MinPoints": 50,
            "MaxPoints": 500
          },
          {
            "MinPoints": 250,
            "MaxPoints": 250
          },
          {
            "MaxPoints":0 // Filler
          }
        ]
      },
      "Commands": {
        "Rolls": 1,
        "PossibleCommands": [
          {
            "Random1": 1,
            "Random2": 5,
            "Command": "AddLootBoxFromCmd Silver %Random12%"
          },
          {
            "Random1": 100,
            "Random2": 1000,
            "Random3": 0,
            "Random4": 1,
            "Command": "AddExperience %Random12% %Random34% 0 0"
          },
          {
            "Random1": 1,
            "Random2": 3,
            "Command": "ChangeKitAmount %SteamID% starter %Random12%"
          },
          {
            "Command": "" // Filler
          }
        ]
      }
    },
    // More lootboxes here
  },
   "Messages": {
    "Sender":        "LootBoxesPlus",
    "Usage":         "Please use /lootbox <box>",
    "OpenMessage":   "You opened '%box%' LootBox!",
    "NoBox":         "You don't have any '%box%' LootBoxes!",
    "NotFound":      "LootBox '%box%' doesn't exist!",
    "NotAllowed":    "You do not have permission to open %box% LootBox!"
  },
  "FallBack": // Necessary for validation
}

In the works (Not implemented):
- LootBox Trading​
- Custom Loot Groups​

Dependencies:

Installation:
1. Install ARK: Server API
2. Install the ArkShop plugin​
3. Install the Permissions plugin​
4. Copy the LootBoxesPlus folder from .zip to "ArkApi/Plugins"​
5. Edit config.json to fit your needs. Use Config Helper if needed​

HWID Info:
Once you download the plugin, run it once to be shown your HWID. Join my Discord and send your HWID & PayPal Invoice # to me and within 24 hours I will have you licensed.​
If it is during the day EST I will usually have you licensed within an hour or two. Once you are licensed, the plugin will load normally.​
Author
Haragon
Downloads
3
Type
Digital product
License duration
Unlimited
First release
Last update
Rating
0.00 star(s) 0 ratings

More resources from Haragon

Latest updates

  1. LootBoxes Plus (ARK) V1.21

    Minor optimizations, no config update needed
  2. LootBoxes Plus (ARK) V1.2

    Added ability to specify multiple intervals Added commands section to LootBoxes Added option to...
  3. LootBoxes Plus (ARK) V1.1

    Added Console Commands (For use with ArkShop "Commands" purchase): AddLootBoxFromCmd <BoxName>...
Top