[Turtle][CraftOS]Liraal's Stuff: Keycard Lock; magicTurtle API v. 1.252

functions:
setPos(x,y,z)
getPos()
goToPos(x,y,z)
turnLeft()
turnRight()
forward(n)
back(n)
up()
down()
tunnel(w,h,l)
staircase(w,h,l)
build(blueprint)
sketch()
mine(mode,l) --modes are diamond/regular
autoUpdate() --runs an autoupdate/remote control function in the background
setUpdateID() --sets the ID of remote control terminal
sendCommand(id, side, command) --sends remote command
road() --follow a road of redtorches
wander() --wanders aimlessly around
wanderer(func) --the above but while doing a function func
jack(sap) --plants, watches and cuts down a single tree (param is the slot with saplings)
treefarm(sap) --the same but on full auto (param as above)
landmine(slot, net) --turtle buries itself in the ground and places TNT that is triggered when someone walks on top of it. Can be armed/disarmed by rednet if net is set to true. (slot is the slot containing TNT)
patch(slot, l, w) --patches holes in the ground (slot is the slot for filling material, like dirt/gravel, l is length and w is width)
guardArea(exec, w, l) --patrols an area, if detects a hole/obstacle triggers function exec
remoteArm(id) --arms the mine of the ID given (the arming terminal must be tuned with the mine, see below setMineID())
remoteDisarm(id) -- disarms the mien
remoteSleep(id, t) -- disarms, waits 't' time and arms again
setMineID(arming, disarming) -- sets mine arming/disarming IDs (these are separate and can differ from each other)
savePos() --saves turtle pos to a file
getPosF() --gets turtle pos from file
mineGrid(slot) --makes a grid of TNT placed 1 block beneath surface
camoMine(slot) --same as above but a single TNT
digSlot(slot) --digs the given slot, if wrong material dug, drops to the ground
quarry(width,length) -- BETA quarry function
architect(width, height, length) --destroys a building to make a blueprint of it
path(facing) --experimental pathfinder to find a way when facing is clear. moves in 3d
stf(blueprint, filename) --saves a blueprint to a file filename EXPERIMENTAL
tff(filename) --returns a blueprint from file filename EXPERIMENTAL

• Liraal (me)
• EatenAlive3

magicTurtle.tunnel(width, height, lenght)
magicTurtle.staircase(width, height, lenght) --cuts out a staircase in a material
magicTurtle.build(blueprint) --builds stuff
blueprint must be like:
bleuprint={layer1, layer2, etc}
layers are vertical and like so:
layer1={row1, row2, etc}
row1={block1, block2, etc}
block1, block2 are slot numbers for placed blocks or 0 for no block

local a=magicTurtle.sketch()
magicTurtle.build(a)

diamondMine(length) --length is the length of the branches of the mine

magicTurtle.setPos(x,y,z)

Liraal, on 27 February 2012 - 07:04 PM said:

save this as magicTurtle (without the '.txt' part) into your turtle's root folder (.minecraft/saves/savename/computer/computerID/).
then enter LUA prompt in-game. type 'os.loadAPI("magicTurtle")' then follow the instructions in the first post. then you can simply call the functions by using magicTurtle.functionname(params) (e.g. 'magicTurtle.tunnel(3,3,10)' )
the rest is up to you.

pcmaster160, on 29 February 2012 - 11:00 PM said:

when I call (in lua prompt) magicTurtle.mine(diamond) it returns true and does nothing. is there something I have to define before it will mine?

magicTurtle.mine("diamond")

MysticT, on 01 March 2012 - 12:35 AM said:

pcmaster160, on 29 February 2012 - 11:00 PM said:

when I call (in lua prompt) magicTurtle.mine(diamond) it returns true and does nothing. is there something I have to define before it will mine?

I think you have to pass a string to the function,so you should do it like this:

magicTurtle.mine("diamond")

pcmaster160, on 01 March 2012 - 02:14 AM said:

MysticT, on 01 March 2012 - 12:35 AM said:

pcmaster160, on 29 February 2012 - 11:00 PM said:

when I call (in lua prompt) magicTurtle.mine(diamond) it returns true and does nothing. is there something I have to define before it will mine?

I think you have to pass a string to the function,so you should do it like this:

magicTurtle.mine("diamond")

error line 146, attempt to performace arithmetic __sub on nil and number

same error comes up on line 156 for the tunnel program with arguments 10,10,10

silverwolfx, on 01 March 2012 - 04:02 AM said:

pcmaster160, on 01 March 2012 - 02:14 AM said:

MysticT, on 01 March 2012 - 12:35 AM said:

pcmaster160, on 29 February 2012 - 11:00 PM said:

when I call (in lua prompt) magicTurtle.mine(diamond) it returns true and does nothing. is there something I have to define before it will mine?

I think you have to pass a string to the function,so you should do it like this:

magicTurtle.mine("diamond")

error line 146, attempt to performace arithmetic __sub on nil and number

same error comes up on line 156 for the tunnel program with arguments 10,10,10

You probably forgot to call setPos() first. so the it's trying to do math on non-existent coords

magicTurtle.setPos(516,13,525)
magicTurtle.mine("diamond")

francogp, on 01 March 2012 - 09:14 AM said:

I cant use sendCommand with a turtle, can you post an example of ussage?

-- on the turtle
magicTurtle.setPos(0,0,0)
magicTurtle.setUpdateID(11)
magicTurtle.autoUpdate()
-- on the controller
redet.open("back")
magicTurtle.sendCommand(27, "print("Hello")")

Liraal, on 01 March 2012 - 12:51 PM said:

francogp, on 01 March 2012 - 09:14 AM said:

I cant use sendCommand with a turtle, can you post an example of ussage?

-- on the turtle
magicTurtle.setPos(0,0,0)
magicTurtle.setUpdateID(11)
magicTurtle.autoUpdate()
-- on the controller
redet.open("back")
magicTurtle.sendCommand(27, "print("Hello")")

Im thinking about making a youtube video, but not for the time being.

A preview of what Im working on ATM:
-Cobble Generator
-Mining specific blocks
-Reed Farm
-Following player
-Pathfinding
-Blowing up obstacles :unsure:/>/>

pcmaster160, on 02 March 2012 - 02:52 AM said:

can you make it so that it does not exit your application after running the goToPos command? For example in a program anything after goToPos is completed is canceled because gotopos ends the application.

Liraal, on 02 March 2012 - 06:11 AM said:

pcmaster160, on 02 March 2012 - 02:52 AM said:

can you make it so that it does not exit your application after running the goToPos command? For example in a program anything after goToPos is completed is canceled because gotopos ends the application.

Okay, I'll check it.

As for up()/down() it's simple: type magicTurtle.up() instead of up() :unsure:/>/>

--Simplest blueprint builder
os.loadAPI("magicTurtle")
magicTurtle.setPos(0,0,0)
magicTurtle.setNorth()
local a = magicTurtle.sketch()
print("build? y/n")
a,b=os.pullEvent()
while a~="char" do a,b=os.pullEvent() end
if b=="y" then magicTurtle.build(a) else return "aborted" end
return true

Liraal, on 03 March 2012 - 07:03 AM said:

--Simplest blueprint builder
os.loadAPI("magicTurtle")
magicTurtle.setPos(0,0,0)
magicTurtle.setNorth()
local a = magicTurtle.sketch()
print("build? y/n")
a,b=os.pullEvent()
while a~="char" do a,b=os.pullEvent() end
if b=="y" then magicTurtle.build(a) else return "aborted" end
return true

here you go

--Simplest blueprint builder
os.loadAPI("magicTurtle")
magicTurtle.setPos(0,0,0)
magicTurtle.setNorth()
local a = magicTurtle.sketch()
print("build? y/n")
local evt, b = os.pullEvent()
while evt ~= "char" do evt, b = os.pullEvent() end
if b == "y" then magicTurtle.build(a) else return "aborted" end
return true

for n = 1, 10 do
  while turtle.detect() do
	turtle.dig()
  end
  turtle.forward()
end

for n = 1, 10 do
  while not turtle.forward() do
	turtle.dig()
  end
end

Espen, on 04 March 2012 - 01:00 AM said:

@pcmaster160:
With falling sand and/or gravel it's oftentimes better to make a hindsight-check for a successful turtle movement instead of a check beforehand.
So instead of something like this…

for n = 1, 10 do
  while turtle.detect() do
	turtle.dig()
  end
  turtle.forward()
end

… you'd rather use something like this:

for n = 1, 10 do
  while not turtle.forward() do
	turtle.dig()
  end
end

The former will sometimes not move forward the whole 10 blocks depending on how the sand/gravel falls etc. because it checks blocks instead of checking its movement.
The latter is much more reliable, because the turtle will dig until all forward movements have returned true.

I mean, just think about it. You make a check for a block infront of you.
If there is a block, you dig. If sand is falling down now, then you can't detect it (while it's falling), because it's not an entity during that time.
So now you try to move forward. But between the time the sand was falling down and the time you needed to decide to move forward, it could very well happen that the sand has manifested itself as an entity again and is blocking your forward movement.
Since you're not checking the success of your forward movement (true or false), you're oblivious to the fact that you haven't actually moved yet.
If you (the turtle) had instructions to move forward 10 blocks, then you're already 1 block shy of that. :unsure:/>/>

Therefore I'd suggest to always check the return value of your movement and repeat digging until the movement returned true.

Liraal, on 04 March 2012 - 06:24 AM said:

I'm working on it, it'll be corrected in magicTurtle 1.3, as will be functions like forward and back giving return values.

BTW, I'm a he xD

Liraal, on 04 March 2012 - 12:30 PM said:

Okay, v. 1.3 is live! I rewrote parts of the code, goToPos should mine every obstacle before moving, forward/back now return values. Also added beta pathfinding (path() function ) and slot digging (digSlot(slot)). diamondMine will now accept additional param for slot for diamond samples (will drop everything else to the ground)

function up()
if y~=127 then
local state=turtle.up()
y=y + 1
return state
else return false
end
end

function up()
if y~=127 then
local state=turtle.up()
if state then
y=y + 1
end
return state
else return false
end
end

Liraal, on 14 March 2012 - 09:35 PM said:

Okay, finally updated to v. 1.31 (of the API). New features:
- Movement functions no longer modify coords if no movement done
- Added architect(width,height,length) function. (Gets blueprint from a destroyed building.)
- Added experimental functions:

quarry(width, length)
path(facing) –experimental pathfinder to find a way when facing is clear. moves in 3d
stf(blueprint, filename) –saves a blueprint to a file filename
tff(filename) –returns a blueprint from file filename

Upcoming features:
- UI
- Locating system
- Better digging with turtle.compare()
- Working blueprint management system

What more would you like to see in this API? Post your suggestions and bug reports here!

Espen, on 15 March 2012 - 12:51 PM said:

@Regelneef:
With turtles you can at least make a "descender": Stand on it and make it travel downwards. :)/>/>

Liraal, on 15 March 2012 - 12:58 PM said:

well, i can make a thing like this, but one catch: you'll have to jump on the way up. no way around this :D/>/>

If player stands on turtle then check DeRise
If DeRise == 0 then
  LOOP
	 descend and DescentCounter++
  UNTIL solid block below Turtle
  DeRise = 1
END

if DeRise == 1 then
  LOOP
	 Rise and DescentCounter--
  UNTIL DescentCount == 0
  DeRise = 0
END

Regelneef, on 16 March 2012 - 08:38 AM said:

Espen, on 15 March 2012 - 12:51 PM said:

@Regelneef:
With turtles you can at least make a "descender": Stand on it and make it travel downwards. :D/>/>

Please tell me how :)/>/> I'm just to incompetent atm…

1. Stand on a turtle
2. Make it go downwards by repeatedly calling turtle.down()

Liraal, on 16 March 2012 - 10:07 AM said:

a turtle physically cannot lift you. It's a block and thus cannot interact with entities that way.

Espen, on 15 March 2012 - 12:51 PM said:

It works literally how I said:

1. Stand on a turtle
2. Make it go downwards by repeatedly calling turtle.down()

There's really not much more to it. At least regarding the basic functionality.

local state=false

os.loadAPI("mT/magicTurtle")
os.loadAPI("mTmagicTurtleCore")
os.loadAPI("mT/magicTurtleMine)

function turn360()
for i=1,4,1 do turnLeft() end
end

local env = getfenv()
for k,v in pairs( magicTurtleCore ) do
env[k] = v
end
setfenv(<Module name>,env)

if not magicTurtle then print("Requires magicTurtle to run") end
rawset(magicTurtle,"turn360",turn360)

EatenAlive3, on 08 April 2012 - 04:21 PM said:

@kinxkinxkin, 1.4 is currently in beta, so bugs are expected. If you want a stable release, continue to use 1.3 until 1.4 is fully released.

@M1cr0man: If you mean making hollow versions of blueprints, that is certainly possible. I can add that in. Otherwise, I don't understand what you mean.

setPos(60,64,60,2)
savePos()
getPosF()

EatenAlive3, on 08 April 2012 - 04:21 PM said:

@M1cr0man: If you mean making hollow versions of blueprints, that is certainly possible. I can add that in. Otherwise, I don't understand what you mean.

Liraal, on 27 February 2012 - 07:04 PM said:

save this as magicTurtle (without the '.txt' part) into your turtle's root folder (.minecraft/saves/savename/computer/computerID/).
then enter LUA prompt in-game. type 'os.loadAPI("magicTurtle")' then follow the instructions in the first post. then you can simply call the functions by using magicTurtle.functionname(params) (e.g. 'magicTurtle.tunnel(3,3,10)' )
the rest is up to you.

Aquilamo, on 15 July 2012 - 01:57 PM said:

I don't think the landmine api is working: it gives "magicTurtle1.31:147: attempt to perform arithmetic __sub on nil and number" when
I write "landmine(1, true)" in the lua command line. Am I doing something wrong?