OpenSimulator - User contributions [en]

Hypergrid Parameters

2021-04-08T10:41:04Z

Thoys: /* DisallowExcept */

Apologies, this is another page that is currently far from complete. However, see [[Hypergrid Security]] for more discussion on some of these configuration settings.

= StandaloneCommon.ini or Robust.HG.ini/Robust.ini =

== [Hypergrid] ==

=== Home URI ===

=== Gatekeeper URI ===

Address of the gatekeeper service by which external installations can contact this simulator. Also needs to be set to resolve Hypergrid addresses.

== [GatekeeperService] ==

=== ForeignAgentsAllowed ===
If set to false, then foreign agents are not allowed to enter the installation, though local users should still be able to go to foreign destinations and return.

Default is true.

=== AllowExcept ===
If ForeignAgentsAllowed is set to true, prevent foreign agents from specific sources from Hypergridding to the installation.

=== DisallowExcept ===
If ForeignAgentsAllowed is set to false, whitelist specific sources to enter the installation.

== [GridService] ==

=== HypergridLinker ===

Controls whether hypergrid links can be made to external installations. Default is false.

If this is true then GatekeeperURI must also be set either here or in the [Hypergrid] section.

=== AllowHypergridMapSearch ===

Governs whether the simulator will resolve Hypergrid addresses entered in the map.

== [UserAgentService] ==

=== ForeignTripsAllowed_Level_<UserLevel> ===

Controls whether a user with the given <[[Userlevel]]> can hypergrid to foreign installations. This must be set separately for each level (e.g. 0 for ordinary users, 200 for gods).

Default is true for unspecified levels.

=== DisallowExcept_Level_<UserLevel> ===

If ForeignTripsAllowed is false for a given level, they can still travel to the foreign installations whitelisted here.

=== AllowExcept_Level_<UserLevel> ===

If ForeignTripsAllowed is true for a given level, blacklist certain installations that they cannot travel to.

[[Category:Hypergrid]]

OsTeleportAgent

2014-10-20T16:04:24Z

Thoys:

{{osslfunc
|threat_level=Severe
|function_syntax=void osTeleportAgent(key agent, integer regionX, integer regionY, vector position, vector lookat)<br />
void osTeleportAgent(key agent, string regionName, vector position, vector lookat)<br />
void osTeleportAgent(key agent, vector position, vector lookat)
|ossl_example=<source lang="lsl">
// Example osTeleportAgent Script
//
// Set Destination as described below, There are a Few Options depending on Application:
// IN GRID Teleport
// Destination = "1000,1000"; = Using In-Grid Map XXXX,YYYY coordinates
// Destination = "RegionName"; = Using RegionName
// HyperGrid Teleport (region must be HG Enabled)
// Destination = "TcpIpAddr:Port:RegionName"; = Using the Target/Destination IP Address
// Destination = "DNSname:Port:RegionName"; = Using the Target/Detination DNSname
// Note: RegionName is Optionally Specified to deliver Avatar to specific region in an instance.
//
// ========================================================================================
// === SET DESTINATION INFO HERE ===
//
string Destination = "LBSA Plaza"; // your target destination here (SEE NEXT LINES) Can Be
vector LandingPoint = <128,128,50>; // X,Y,Z landing point for avatar to arrive at
vector LookAt = <1,1,1>; // which way they look at when arriving
//
default
{
on_rez(integer start_param)
{
llResetScript();
}
changed(integer change) // something changed, take action
{
if(change & CHANGED_OWNER)
llResetScript();
else if (change & 256) // that bit is set during a region restart
llResetScript();
}
state_entry()
{
llWhisper(0, "OS Teleportal Active");
}
touch_start(integer num_detected)
{
key avatar = llDetectedKey(0);
llInstantMessage(avatar, "Teleporting you to : "+Destination);
osTeleportAgent(avatar, Destination, LandingPoint, LookAt);
}
}</source>
|description=Teleports an agent to the specified location. The first variant is able to teleport to any addressable region, including [[hypergrid]] destinations. The second variant teleports to a region in the local grid; the region coordinates are specified as region cells (not as global coordinates based on meters). The third variant teleports within the current region.

For osTeleportAgent() to work, the owner of the prim containing the script must be the same as the parcel that the avatar is currently on. If this isn't the case then the function fails silently.

See also [[osTeleportOwner]], and if you receive an error see [[OSSL Enabling Functions|how to enable OS functions]].
|
}}

OsCauseHealing

2014-10-20T16:02:37Z

Thoys:

{{osslfunc
|threat_level=High
|function_syntax=void osCauseHealing(key avatar, float healing)
|ossl_example=<source lang="lsl">
default
{
state_entry()
{
osCauseHealing(llGetOwner(), 50);
}
}
</source>
|description=Implemented December 30,2009 by Revolution in GIT# 87959464c9db8948bed89909913400bc2eb7524d - Rev 11850

This does the opposite of osCauseDamage. It gives health to the avatar.

See also [[OsCauseDamage]].
|
}}

OsCauseDamage

2014-10-20T16:01:09Z

Thoys:

{{osslfunc
|threat_level=High
|function_syntax=void osCauseDamage(key avatar, float damage)
|ossl_example=<source lang="lsl">
default
{
state_entry()
{
osCauseDamage(llGetOwner(), 50);
}
}
</source>
|description=Implemented December 30,2009 by Revolution in GIT# 87959464c9db8948bed89909913400bc2eb7524d - Rev 11850

This is an updated version of Mantis 0003777. It allows for damage on collision, touch, etc.

See also [[OsCauseHealing]].
|
}}