Setting up basic settings & integrations

Location of Settings

Go to the 'easyLink v2.0.0 [ easyPOS ]' script, then double click on 'Settings'.

Location of 'Settings' script

Editing the Settings

ShowDisplayName

Settings.ShowDisplayName = true

This setting determines whether player's display names are also included in messages. true = Chris (@TheMysticalBeat) false = TheMysticalBeat

AutoHeadset

Settings.AutoHeadset = {
	Enabled = false,
	OnSpawn = false,
}

This setting determines where players are automatically given the easyLink headset when they join. You can also set OnSpawn to true, to give the headset every time the player spawns, not just for the first time.

Please remember that players can unequip the headset via settings.

HeadsetBattery

Settings.HeadsetBattery = {
	Enabled = true,
	Lifespan = 60,
}

This setting determines whether the headsets have a battery life, and therefore can run out of charge, requiring the player to get a new headset. Lifespan is the number of minutes the headset will work for.

GetPlayerRole

This setting determines if a player's rank should be visible in the chat & summon page. This does require some coding, we have provided some examples below.

Examples

Group Rank

Settings.GetPlayerRole = function(Player)
	return Player:GetRoleInGroup(32675391)
end

No Rank Visible

Settings.GetPlayerRole = function(Player)
	return nil
end

Integrations

This setting determines which of the built-in integrations are enabled - and here you can edit images, sounds, channels and colours.

Settings.Integrations = {
	["JSM EAS"] = {
		Enabled = true,
		Zones = {
			[1] = "Example Location",
			[2] = "Another Example",
		},
		
		-- This edits the message sent:
		Channel = "All",
		Image = "rbxassetid://11317573426",
		Sound = nil,
		Color = ColorSequence.new({
			ColorSequenceKeypoint.new(0, Color3.new(0.333333, 0, 0)),
			ColorSequenceKeypoint.new(1, Color3.new(0.666667, 0, 0)),
		}),
	},
}

Enabled

This determines whether the integration is enabled.

Zones

Here you can convert Zone IDs into locations, since JSM only allows setting zone numbers, not strings.

Channel

This is the channel where the alert will be sent to. Enter a channel name or All for all channels.

Image (optional)

Specify an image ID which'll be displayed next to the image. If not specified, an image of the Hub will be displayed.

Sound (optional)

Specify a sound ID which'll be played in easyLink when this alert is triggered.

Color (optional)

Specify a ColorSequence which'll be the gradient background of the message.

Whitelists

This setting houses all the whitelists for the various functions of the product. Some coding is required to get this to your liking.

HeadsetGiver
Settings.Whitelists = {
	HeadsetGiver = function(Player) -- Determines who can actually pick up the headset
		local GroupRank = Player:GetRankInGroup(32675391)
		local MinRank = 10
		
		return GroupRank >= MinRank
	end,
}

Example group rank

Hub
Settings.Whitelists = {
	Hub = function(Player) -- Determines who can disable/enable the hub
		local GroupRank = Player:GetRankInGroup(32675391)
		local MinRank = 20

		return GroupRank >= MinRank
	end,
}

Example group rank

HelpPoint
Settings.Whitelists = {
	HelpPoint = function(Player, Location) -- Determines who can active help points
		--local GroupRank = Player:GetRankInGroup(32675391)
		--local MinRank = 1
		--return GroupRank >= MinRank
		

		return true -- Anyone can press it
	end,
}

Example for anyone

HelpPoint_Reset
Settings.Whitelists = {
	HelpPoint_Reset = function(Player, Location) -- Determines who can right click the help point to deactivate the request
		local GroupRank = Player:GetRankInGroup(32675391)
		local MinRank = 10

		return GroupRank >= MinRank
	end,
}

Example group rank

ServiceCaller
Settings.Whitelists = {
	ServiceCaller = function(Player, Button, Location) -- Determines who can use the service caller. You can set permissions for individual calls here, button is a string "Example Call"
		local GroupRank = Player:GetRankInGroup(32675391)
		local MinRank = 10

		return GroupRank >= MinRank
	end,
}

Example group rank

Summon
Settings.Whitelists = {
	Summon = function(Player, Target) -- Player would like Target to come over to them
		
		-- We will not be providing example code here. We only recommend editing this if you know what you're doing.
		
		-- return true to allow this request to be made, return false to not
		-- The players must share a channel to make a summon request
		return true
	end,
}

Example for anyone

Want to do something else with the whitelists? Ask ChatGPT - it can probably do it for you!

Last updated