VoidExpanse/scope-game

From AtomicTorchWiki


Scope game

Used for various in-game functions.

Visibility: Global.

List of functions

ApplyForceToObject
Arguments Returns Example
  • int: object_id
  • double: force_x
  • double: force_y

void 

game.ApplyForceToObject(153, 10, 0); // add x-axis force
Description

Applies force to physics object. Will work on any interactive object.


ApplyTorqueToObject
Arguments Returns Example
  • int: object_id
  • double: torque

void 

game.ApplyTorqueToObject(153, 10); // add torque
Description

Applies torque to physics object. Will work on any interactive object.


DamageProjectile
Arguments Returns Example
  • int: system_id
  • int: projectile_id
  • double: damage

void 

game.DamageProjectile(1, 12, 10);
Description

Damages projectile. Projectile, that took enough damage, will explode.


TryToRemoveContentFromAsteroid
Arguments Returns Example
  • int: asteroid_id
  • string: name
  • int: amount

int: amount of content extracted from asteroid 

game.TryToRemoveContentFromAsteroid(12, "ResourceOre", 10);
Description

Tries to remove specified resource from asteroid's contents. Returns extracted amount.


GetItemEffects
Arguments Returns Example
  • string: xml_item_id

array of objects:

  • double: effect_base
  • double: effect_cap
  • double: effect_per_level
  • double: effect_type
 
var effects = game.GetItemEffects("SomeItem");
Description

Returns an array of all effects of specified item.


GetStationDockedNpcs
Arguments Returns Example
  • int: station_id

array of int 

var npcs = game.GetStationDockedNpcs(25353);
Description

Returns an array of IDs of all ships, that are docked to a station.


GetItemPrice
Arguments Returns Example
  • string: xml_item_id

int: item_price 

var price = game.GetItemPrice("SomeItem");
Description


GetItemSID
Arguments Returns Example
  • int: unique_item_id

string: xml_item_id 

var xml_item_id = game.GetItemSID(12352);
Description

Returns xml_id of item by it's instance ID.


GetProjectileDescriptionByXmlID
Arguments Returns Example
  • string: projectile_xml_id

object:

  • double: damage
  • string: damage_type
 
var xml_item_id = game.GetProjectileDescriptionByXmlID("wpn_0");
Description

Gets projectile description. Projectile xml ID is constructed by the following rule: wpn_id + "_" + projectile_order (starting with 0).


GetSecondsMultiplier
Arguments Returns Example

void

void 

var multiplier = game.GetSecondsMultiplier();
Description

Returns time passed since last frame. Useful when calculating time-depended stuff, like health-regeneration or damage.


GetGameObjectTags
Arguments Returns Example
  • int: object_id

void 

var tags = game.GetGameObjectTags(131);
Description

Gets game object tags. Any physical object, such as asteroid, space object, ship or else, has it's own tags. This function can retrieve it. Alias of game.GetTags.


GetTags
Arguments Returns Example
  • int: object_id

void 

var tags = game.GetTags(131);
Description

Gets game object tags. Any physical object, such as asteroid, space object, ship or else, has it's own tags. This function can retrieve it. The same as game.GetGameObjectTags.


GetShipOwner
Arguments Returns Example
  • int: ship_id

string: owner_name 

var name = game.GetShipOwner(123142);
Description

Returns name of ship's owner. If ship is npc-controller, that would be npc name, else - player's name.


GetAsteroidMiningListByID
Arguments Returns Example
  • int: asteroid_id

array of objects:

  • string: xml_id
  • int: quantity
  • int: extraction
 
var list = game.GetAsteroidMiningListByID(1252);
Description

Returns actual ateroid mining list.


GetAsteroidDescriptionByID
Arguments Returns Example
  • int: asteroid_id

object:

  • int: type
  • int: difficulty
 
var desc = game.GetAsteroidDescriptionByID(1252);
Description

Returns asteroid description.


GetSkillEffects
Arguments Returns Example
  • string: skill_xml_id

array of objects:

  • int: cost
  • int: page
  • string: title
 
var effects = game.GetSkillEffects("SomeSkill");
Description

Returns array of specified skills' effects.


IsResource
Arguments Returns Example
  • string: item_xml_id

bool: is specified item resource 

var is_res = game.IsResource("SomeItemOrResource");
Description


IsHull
Arguments Returns Example
  • string: item_xml_id

bool: is specified item is hull 

var is_hull = game.IsHull("SomeItemOrResource");
Description


IsDevice
Arguments Returns Example
  • string: item_xml_id

bool: is specified item is device 

var is_dev = game.IsDevice("SomeItemOrResource");
Description


IsWeapon
Arguments Returns Example
  • string: item_xml_id

bool: is specified item is weapon 

var is_wpn = game.IsWeapon("SomeItemOrResource");
Description


IsShipPlayerControlled
Arguments Returns Example
  • int: ship_id

bool: is ship controlled by player 

var is_player = game.IsShipPlayerControlled(123252);
Description


GetSystemJumpgates
Arguments Returns Example
  • int: system_id

array: IDs of system jumpgates 

var jumpgates = game.GetSystemJumpgates(1);
Description

Returns all jumpgates of specified system.


GetSystemBases
Arguments Returns Example
  • int: system_id

array: IDs of system bases 

var bases = game.GetSystemBases(1);
Description

Returns all bases of specified system.


GetSystemShips
Arguments Returns Example
  • int: system_id

array: IDs of system ships 

var ships = game.GetSystemShips(1);
Description

Returns all ships of specified system.


GetSystemShipsOfClass
Arguments Returns Example
  • int: system_id
  • string: tags_class

array: IDs of system ships 

var miner_ships = game.GetSystemShipsOfClass(1, "miner");
Description

Returns all ships of specified system, which tag "class" is equal to specified value.


GetSystemPlayersShips
Arguments Returns Example
  • int: system_id

array: IDs of system players' ships 

var ships = game.GetSystemPlayersShips(1);
Description

Returns all player-controlled ships of specified system.


GetObjectCoordinates
Arguments Returns Example
  • int: system_id
  • int: object_id

vector2: coordinates 

var coords = game.GetObjectCoordinates(1, 25442);
Description

Returns coordinates of specified object.


DeleteGameObject
Arguments Returns Example
  • int: object_id

void 

game.DeleteGameObject(25442);
Description

Deletes game object from game world.


GetBaseEntryPointsByID
Arguments Returns Example
  • int: base_id

array of vector2 

var points = game.GetBaseEntryPointsByID(353);
Description

Returns bases' actual entry points coordinates.


SetSecondsBetweenStarSystemUpdates
Arguments Returns Example
  • int: system_id
  • int: seconds

void 

game.SetSecondsBetweenStarSystemUpdates(1, 60);
Description

Sets interval between event "OnStarSystemUpdate" for this system calls.


SendNotification
Arguments Returns Example
  • string: player_name
  • string: title
  • string: message

void 

game.SendNotification("dlirry", "Server notification", "You are great player!");
Description

Sends notification to connected player.


GetAllItems
Arguments Returns Example

void

array: xml-ids (strings) of all items 

var res = game.GetAllItems();
Description

Gets all items.


GetItems
Arguments Returns Example
  • int: level
  • string[]: item_types

array: xml-ids (strings) of items 

var res = game.GetItems(15, ["Hull", "Consumable"]);
Description

Gets all items of specified type.


GetItemTypes
Arguments Returns Example

void

array: strings of types 

var res = game.GetItemTypes();
Description

not implemented


GetProjectileFromSystemByID
Arguments Returns Example
  • int: system_id
  • int: projectile_id

object:

  • string: id
  • double: coord_x
  • double: coord_y
  • int: caster_id
 
var proj = game.GetProjectileFromSystemByID(15,2524);
Description

Returns basic information about specified projectile. ID in returned object is full projectile ID, which is xml_weapon_id + "_" + number_of_projectile_in_weapon.


ProjectileFromSystemDestroy
Arguments Returns Example
  • int: system_id
  • int: projectile_id

void 

game.ProjectileFromSystemDestroy(15,2524);
Description

Destroys specified projectile.


ProjectileFromSystemSetSpeed
Arguments Returns Example
  • int: system_id
  • int: projectile_id
  • double: speed_x
  • double: speed_y

void 

game.ProjectileFromSystemSetSpeed(15,2524, 0, 0); //stop projectile
Description

Sets projectile linear speed. Useful for manipulating projectile speed, doesn't affect it's direction.


PlaySound
Arguments Returns Example
  • string: player_name
  • string: sound

void 

game.PlaySound("Neolog", "special/blast_sound.ogg");
Description

Plays a special sound on a client's side for specified player.


ShipPlaySound
Arguments Returns Example
  • int: ship_id
  • string: sound_id
  • string: sound_path
  • double: delay
  • bool: isLooping

void 

game.ShipPlaySound(123, "grappler_1", "special/grappler_process.ogg", 0.1, true);
Description

Emits specified sound from specified ship. If isLooping is on, then sound must be stopped with game.ShipStopSound command. Sound_id argument must be unique inside ship's sounds and used for stopping looping sounds.


ShipStopSound
Arguments Returns Example
  • int: ship_id
  • string: sound_id

void 

game.ShipStopSound(123, "grappler_1");
Description

Stops the looping sound, that was started with game.ShipPlaySound command.

Retrieved from "https://wiki.atomictorch.com/index.php?title=VoidExpanse/scope-game&oldid=234"