OpenCCSensors

From ComputerCraft Wiki
Jump to: navigation, search

OpenCCSensors is a new, open-source, up to date replacement for CcSensors (outdated), allowing monitoring and gathering information from the Minecraft environment - including players, entities, proximity, world info, IndustrialCraft 2, BuildCraft 2, liquids, inventories - and more!


OpenCCSensors comes with its own API, and automatically installs a new program for you at /ocs/programs/sensorview. sensorview is a handy program for very quickly looking at the information gathered from your sensors.


Forum thread and download: OpenCCSensors

http://www.youtube.com/watch?v=i8Bv7uKkIOM&feature=youtu.be

Grid disk.png   OpenCCSensors Peripherals

NameDescription
Sensor Peripheral

The Sensor Peripheral needs to be placed next to a computer and it has a single slot to insert a Sensor Card


Obsidian

Redstone

Stone

Obsidian

Obsidian

Stone

Obsidian

Redstone

Stone

Sensor Peripheral




os.loadAPI("ocs/apis/sensor") Load the sensor API
mySensor = sensor.wrap(side) Returns the wrapped sensor on the side specified.
mySensor.getTargets() Returns a a table of all the targets for mySensor, where the keys are usually strings (either an entity name or a relative coordinate for blocks), and the values are each a table of basic details.
mySensor.getTargetDetails(key) Returns a table of full details for that particular target from the sensor mySensor - where the the "key" is the key returned from getTargets()
Gauge Peripheral

The Gauge Peripheral can be placed onto the side of certain machines to get instant readings from them. Right now this only supports Batboxes, MFE's, MFSU, Mass fabricators and Nuclear reactors. We hope to expand this in the future as well as offer an API to re-program the gauge from a computer.


glass_pane


Redstone


Monitor


Gauge Peripheral





Grid disk.png   OpenCCSensors Blocks

NameDescription
Proximity Sensor Block

This block outputs a redstone signal if players/mobs are within 16 blocks. The strength of the signal depends on how close the entity is to the block.

This block has 3 different modes: "Any Living Entity", "Any Player" or "Owner Only". To switch between modes, the owner of the block must right click on the block.



Comparator

Redstone


Proximity Sensor Card MKIV

Block of Iron


Comparator

Redstone

Proximity Sensor Block




Grid disk.png   OpenCCSensors Sensor Cards

NameDescription
Inventory Sensor Card The Inventory Sensor Card is capable of reading inventories of any chests or machines around the sensor. It gives full information about what item is in each slot.


Redstone

Redstone

paper

chest

Redstone

paper

Redstone

Redstone

paper

Inventory Sensor Card



Proximity Sensor Card The Proximity Sensor Card is capable of detecting players and entities within it's range.


Redstone

Redstone

paper

pressure_plate

Redstone

paper

Redstone

Redstone

paper

Proximity Sensor Card



Machine Sensor Card The Machine Sensor Card can read information from IC2 devices.


Redstone

Redstone

paper

Redstone

Redstone

paper

Redstone

Redstone

paper

Buildcraft Sensor Card



Power Sensor Card The Power Sensor Card can read power information from IC2 and Applied Energistics devices.


Redstone

Redstone

paper

Coal

Redstone

paper

Redstone

Redstone

paper

Power Sensor Card



Tank Sensor Card The Tank sensor card is far more powerful than it first seems. This card not only reads actual tanks, but reads internal tanks within a variety of different machines, such as:

Railcraft: Iron Tanks, Buildcraft: Tanks, Thermal Expansion: Aqueous Accumulator, Thermal Expansion: Igneous Extruder, Thermal Expansion: Glacial Precipitator, Thermal Expansion: Liquid Transposer, Thermal Expansion: Magma Crucible, Thermal Expansion: Magmatic Engine, Thermal Expansion: Steam Engine, Industrial Craft: Geothermal Generator, Thaumcraft: Crucible, Buildcraft: Tank, Buildcraft: Combustion Engine, Buildcraft: Pump, Buildcraft: Refinery, Forestry: Biogas Engine, Forestry: Fermenter, Forestry: Still, Forestry: Bottler, Forestry: Raintank, Forestry: Bio Generator, Forestry: Carpenter, Forestry: Moistener, Forestry: Squeezer, Forestry: Thermonic Fabricator, Extra Bees: Analyser, Extra Bees: Purifier, Extra Bees: Synthesizer, Extra Bees: Genepool, Extra Bees: Splicer, Railcraft: Hobbyist's Steam Engine, Railcraft: Commercial Steam Engine, Railcraft: Industrial Steam Engine, GregTech: Quantum Tank, GregTech: Thermal Generator


Redstone

Redstone

paper

Bucket

Redstone

paper

Redstone

Redstone

paper

Liquid Sensor Card



World Sensor Card The World Sensor Card is able to tell the time, weather, and more about the world.


Redstone

Redstone

paper

ender_pearl

Redstone

paper

Redstone

Redstone

paper

World Sensor Card



Dropped Item Sensor Card The Dropped Item Sensor Card is able to locate and identify dropped items.


Redstone

Redstone

paper

slime_ball

Redstone

paper

Redstone

Redstone

paper

Dropped Item Sensor Card



Sign Sensor Card The Sign Sensor Card is capable of reading signs within it's range.


Redstone

Redstone

paper

sign

Redstone

paper

Redstone

Redstone

paper

Sign Sensor Card



Minecart Sensor Card The Minecart Sensor Card can detect minecarts in the area and give basic information about them


Redstone

Redstone

paper

Minecart

Redstone

paper

Redstone

Redstone

paper

Minecart Sensor Card



Sonic Sensor Card The Sonic Sensor Card can detect blocks in the area and report if they're solid or liquid.


Redstone

Redstone

paper

Jukebox

Redstone

paper

Redstone

Redstone

paper

Sonic Sensor Card



Crop Sensor Card The crop sensor card can detect the growth status of crops within range. IndustrialCraft2 crops are also supported (+extra!)


Redstone

Redstone

paper

Wheat

Redstone

paper

Redstone

Redstone

paper

Crop Sensor Card




Grid disk.png   OpenCCSensors Sensor Card Upgrades

NameDescription
Range Extension Antenna The Range Extension Antenna is used to upgrade sensor cards to Mk1, Mk2, and Mk3.



stone

stone

redstone_torch

Redstone

iron_ingot


stone

stone

Range Extension Antenna



Signal Amplifier The Signal Amplifier is used to upgrade sensor cards to Mk3 and Mk4.


stone

Redstone

stone

Gold_Ingot

Redstone

Gold_Ingot

stone

Redstone

stone

Signal Amplifier



Advanced Amplifier The Advanced Amplifier is used to upgrade sensor cards to Mk4.


iron_ingot

Redstone

iron_ingot

Gold_Ingot

Diamond

Gold_Ingot

iron_ingot

Redstone

iron_ingot

Advanced Amplifier




Grid disk.png   Sensor Tiers

NameDescription
Mk 1 The recipes for Mk 1 sensors are all different. (See above sensor card lists)

Special-type sensor cards (Currently only the World Sensor Card) only exist as Mk 1, as they do not have a range.

Ranges:

TypeRangeSensor types
Block1 block away (3x3x3)

Inventory Sensor Industrial Craft 2 Sensor Buildcraft Sensor Liquid Sensor Sign Sensor Thaumcraft Sensor Sonic Sensor Crop Sensor

Entity4 block-radius sphere

Proximity Sensor Dropped Item Sensor Minecart Sensor

SpecialN/A

World Sensor

Mk 2 Mk 2 is the first upgrade to sensor cards. Simply combine a Range Extension Antenna with a Mk 1 sensor card (The recipe is shapeless)


Inventory Sensor Card


Range Extension Antenna




Inventory Sensor Card Mk2




Ranges:

TypeRangeSensor types
Block3 blocks away (7x7x7)

Inventory Sensor Industrial Craft 2 Sensor Buildcraft Sensor Liquid Sensor Sign Sensor Thaumcraft Sensor Sonic Sensor Crop Sensor

Entity12 block-radius sphere

Proximity Sensor Dropped Item Sensor Minecart Sensor

Mk 3 Mk 3 is the second upgrade to sensor cards. Note that the recipe is no longer shapeless.


Range Extension Antenna


Inventory Sensor Card Mk2

Signal Amplifier


Range Extension Antenna


Inventory Sensor Card Mk3




Ranges:

TypeRangeSensor types
Block5 blocks away (11x11x11)

Inventory Sensor Industrial Craft 2 Sensor Buildcraft Sensor Liquid Sensor Sign Sensor Thaumcraft Sensor Sonic Sensor Crop Sensor

Entity20 block-radius sphere

Proximity Sensor Dropped Item Sensor Minecart Sensor

Mk 4 Mk 4 is the highest tier of sensor card upgrades



Range Extension Antenna

Signal Amplifier

Range Extension Antenna

Inventory Sensor Card Mk3

Advanced Amplifier


Range Extension Antenna

Signal Amplifier

Inventory Sensor Card Mk4




Ranges:

TypeRangeSensor types
Block7 blocks away (15x15x15)

Inventory Sensor Industrial Craft 2 Sensor Buildcraft Sensor Liquid Sensor Sign Sensor Thaumcraft Sensor Sonic Sensor Crop Sensor

Entity28 block-radius sphere

Proximity Sensor Dropped Item Sensor Minecart Sensor


Usage Examples

Grid paper.png  Example
List all available targets on a Proximity Sensor on the left of the Computer.
Code
os.loadAPI("ocs/apis/sensor")
local prox = sensor.wrap("left")
print(textutils.serialize(prox.getTargets()))
Output A huge blob of text with all nearby available targets to the sensor, and some basic details.



Grid paper.png  Example
Turn on a Redstone lamp when a player is within a certain distance from it. The sensor is placed to the left of the computer and the lamp is placed on top of the computer.
Code
os.loadAPI("ocs/apis/sensor")
 
-- the location of the redstone lamp relative to the sensor
local offset = {
  X = 1,
  Y = 1,
  Z = 0
}
 
-- how close a player has to be to activate the lamp
local radius = 5

 -- find the distance from the player position to the offset
function distance(pos)
  local xd = pos.X - offset.X
  local yd = pos.Y - offset.Y
  local zd = pos.Z - offset.Z
  return math.sqrt(xd*xd + yd*yd + zd*zd)
end

 
local proximity = sensor.wrap("left")
while true do
  local signal = false
  local targets = proximity.getTargets()
  for k, v in pairs(targets) do
        if distance(v.Position) < radius then
          signal = true   
        end
  end
  rs.setOutput("top", signal)
end