Trusted Free SHDinoColour 1.5

Dino Colours​

Requirements​

• AsaApiUtils - the free mod that draws the on-screen banners (without it the replies fall back to chat)
• Permissions - optional, only if you want to gate the command behind a permission

Features​

• One command to recolour - /sdc <Region> <Colour> repaints the dino the player is looking at
• Names or numbers - regions accept Body/Face/Side/Legs/Top/Under or 0-5, and colours accept Red/Blue/Yellow/DarkRed or any valid ID
• Free, gated, or paid - permission acts as a free pass; anyone without it pays through whichever payment method you turned on
• TokenBank or ArkShop - charge tokens or shop points per recolour, your choice
• Styled Notifications - every reply is an on-screen banner with its own text colour, background colour, size, duration, screen position and an optional copy to chat
• Per-Message Styling - each message is configured on its own, so a success can flash green while an error shows red
• Commented Config - the config file supports // comments, so you can leave notes right next to your settings

How It Works​

1. Player looks at one of their own tames and runs /sdc <Region> <Colour>
2. Plugin confirms the target is a living dino on the player's team
3. Region and colour are validated (names or numbers both work)
4. If the player has the permission it's free; otherwise the enabled payment is charged
5. The body region updates instantly and the player gets a confirmation banner

Access Payment​

• Permission only - the group with the permission uses it free, everyone else is refused
• Permission + ArkShop - the group uses it free, everyone else pays shop points
• Permission + TokenBank - the group uses it free, everyone else pays tokens
• No permission, payment on - everyone pays

Commands​

Regions Colours​

• Regions - 0 Body, 1 Face, 2 Side, 3 Legs, 4 Top, 5 Under
• Colours - IDs 1-100 and 128-254, or the names Red, Blue, Yellow, DarkRed. Full list at the ARK wiki

Configuration​

// SHDinoColors config - // comments are allowed.
{
  "General": {
    "SetColourOptions": {
      "SDC-CMD": "/sdc", // chat command players type to recolour the dino they're looking at
      // Permission = free pass. Without it, players pay via the enabled method below.
      "Permission": {
        "Enable": false,
        "Name": "SetDinoColour" // a permission string granted to groups, NOT a group name
      },
      // Enable ArkShop OR TokenBank, never both. With permission the recolour is free.
      "TokenBank": {
        "Enable": true,
        "Cost": 1,
        "Type": "DinoColourToken" // the TokenBank token type to charge
      },
      "ArkShop": {
        "Enable": false,
        "Cost": 3 // ArkShop points per recolour
      }
    }
  },
  // Per-message on-screen notifications (AsaApiUtils banners).
  // Colours: #RRGGBB or #RRGGBBAA. Position/Justification: Left | Center | Right.
  "Messages": {
    "Confirmation": {
      "Message": "{} - Colour has been updated!", // {} = the dino's name
      "backgroundColor": "#000000CC", // #RRGGBBAA or #RRGGBB; AA omitted = opaque
      "textColor": "#33FF33FF",
      "textScale": 1.3,
      "displaySeconds": 10.0, // how long the banner stays on screen
      "textJustification": "Center", // Left | Center | Right
      "screenPosition": "Center", // Left | Center | Right
      "alsoSendToChat": true // mirror the banner into chat as well
    },
    "NoPermission":     { "Message": "You don't have permissions to use this command", "textColor": "#FF3333FF" },
    "NotEnoughTokens":  { "Message": "You don't have enough Tokens to use this command", "textColor": "#FF3333FF" },
    "NotEnoughPoints":  { "Message": "You don't have enough Points to use this command", "textColor": "#FF3333FF" },
    "IncorrectSyntax_SDC": { "Message": "Incorrect Syntax: /sdc <Region> <Colour>", "textColor": "#FF3333FF" },
    "IncorrectColours": { "Message": "Dino Colour must be 1-100 | 128-254 OR Red, Blue, Yellow, DarkRed.", "textColor": "#FF3333FF" },
    "IncorrectRegion":  { "Message": "Dino Region must be 0-5 or Body, Face, Side, Legs, Top or Under.", "textColor": "#FF3333FF" },
    "IncorrectTeam":    { "Message": "That is not your dinosaur!", "textColor": "#FF3333FF" },
    "IncorrectTargeting": { "Message": "Please look at the dino you want to colour!", "textColor": "#FF3333FF" }
  }
}

Configuration Settings​

Message Styling​

• Message - the text the player sees ({} in the confirmation is filled with the dino's name)
• textColor / backgroundColor - hex, #RRGGBB or #RRGGBBAA (the AA is opacity)
• textScale - size of the text
• displaySeconds - how long the banner stays on screen
• textJustification / screenPosition - Left, Center or Right
• alsoSendToChat - also drop the message into chat
• Leave any field out and it falls back to the built-in default, so you only need to set what you actually want to change

Credits​

Support/Questions​

I Do not Monitor the ArkApi Site on a Daily Bases
Support and Questions are done in discord only
​