Thisha
Audiovisual support for divers

Supported Games
GameServerKingsGameServerKings

When wearing a diving tank, an oxygen level bar is being displayed in different colours, depending on the level and the actual amount is shown next to it.

When diving, by default, a short alert is given at 100 and a more continuous beeping occurs from 15 on. A second alert is available. Set alerts to 0 if no beep is wanted. A maximum number of alerts a player can have can be omitted by setting the configuraiton value to 0.

One can choose to display the bar, the value or both. A bitmap of which the URL can be changed in the config can be displayed to the left of those. Colors can be adjusted. The last two characters of the color codes are used for the transparancy. If omitted, the default will be used. Information can be repositioned. By default, when having permission, the bar and the value is being displayed.

Players can change the information shown, color levels and alerts when they have the modify permission.

Specific player data can be removed automatically by setting the config option "Remove after offline days". Data of players who haven't been online within the period will be removed. The data is checked once a day.

Permissions

  • chilldiving.use - Gives players the ability to use commands and allows the info to be shown.
  • chilldiving.modify - Lets players change what information is shown, modify color levels and alerts.

Configuration

{
  "Lower Range Color Value": {
    "Bar Color": "#996633",
    "Font Color": "#FFFFFFFF"
  },
  "Middle Range": {
    "Starting Value": 100,
    "Bar Color": "#FFFF00E4",
    "Font Color": "#FFFFFFFF"
  },
  "Higher Range": {
    "Starting Value": 300,
    "Bar Color": "#669933E4",
    "Font Color": "#FFFFFFFF"
  },
  "Alert 1": 100,
  "Alert 2": 0,
  "Continous alert": 15,
  "Show picture": false,
  "Picture URL": "https://i.imgur.com/z8JqhRB.png",
  "Show info (All, Bar, Value)": "All",
  "Postition": {
    "X-axis": 0.035,
    "Y-axis": 0.007
  },
  "Maximum Player Alerts": 6,
  "Remove after offline days": 0
}

Chat Commands

The player can enable or disable the functionality:

  • /diving on
  • /diving off

A player can change the information shown:

  • diving view bar
  • diving view value
  • diving view all

Add or update a single alert:

  • diving add alert <number>
    Example: diving add alert 80

To add a repeating alarm till 0 or the next level:

  • diving add alert <number>*
    Example: diving add alert 20*

To remove an alert

  • diving remove alert <number>
    Example: diving remove alert 20
    No * is needed to remove a continuous alert.

To add or update a color range:

  • diving add range <number> <barcolor> <fontcolor>
  • diving remove range <number>

Examples:

  • diving add range 500 #34EB3A #FFFFFF
  • diving add range 500 #34EB3AFF #FFFFFF
  • diving add range 100 Tomato White

The player can check his alerts and ranges by using the following commands:

  • diving show alerts
  • diving show ranges

A player can reset the custom data back to the defaults defined by the configuration:

  • diving reset

Diplays the list of color names:

  • diving colors list

Short info about the color usage:

  • diving colors help

Previews

Colors

Colors can be defined by using the hexadecimal value or a color name.

When using hexadecimal values, a custom transparancy can be defined by the last 2 characters.

  #669933     : the default transparancy will be used 
  #669933FF : a custom non-transparant color 

When using color names, following are available. The names are case-sensitive.

AliceBlue
AntiqueWhite
Aqua
Aquamarine
Azure
Beige
Bisque
Black
BlanchedAlmond
Blue
BlueViolet
Brown
BurlyWood
CadetBlue
Chartreuse
Chocolate
Coral
CornflowerBlue
Cornsilk
Crimson
Cyan
DarkBlue
DarkCyan
DarkGoldenrod
DarkGray
DarkGreen
DarkKhaki
DarkMagenta
DarkOliveGreen
DarkOrange
DarkOrchid
DarkRed
DarkSalmon
DarkSeaGreen
DarkSlateBlue
DarkSlateGray
DarkTurquoise
DarkViolet
DeepPink
DeepSkyBlue
DimGray
DodgerBlue
Firebrick
FloralWhite
ForestGreen
Fuchsia
Gainsboro
GhostWhite
Gold
Goldenrod
Gray
Green
GreenYellow
Honeydew
HotPink
IndianRed
Indigo
Ivory
Khaki
Lavender
LavenderBlush
LawnGreen
LemonChiffon
LightBlue
LightCoral
LightCyan
LightGoldenrodYellow
LightGray
LightGreen
LightPink
LightSalmon
LightSeaGreen
LightSkyBlue
LightSlateGray
LightSteelBlue
LightYellow
Lime
LimeGreen
Linen
Magenta
Maroon
MediumAquamarine
MediumBlue
MediumOrchid
MediumPurple
MediumSeaGreen
MediumSlateBlue
MediumSpringGreen
MediumTurquoise
MediumVioletRed
MidnightBlue
MintCream
MistyRose
Moccasin
NavajoWhite
Navy
OldLace
Olive
OliveDrab
Orange
OrangeRed
Orchid
PaleGoldenrod
PaleGreen
PaleTurquoise
PaleVioletRed
PapayaWhip
PeachPuff
Peru
Pink
Plum
PowderBlue
Purple
Red
RosyBrown
RoyalBlue
SaddleBrown
Salmon
SandyBrown
SeaGreen
SeaShell
Sienna
Silver
SkyBlue
SlateBlue
SlateGray
Snow
SpringGreen
SteelBlue
Tan
Teal
Thistle
Tomato
Turquoise
Violet
Wheat
White
WhiteSmoke
Yellow
YellowGreen
MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.