Difference between revisions of "Turtle.refuel"
From ComputerCraft Wiki
(Changing int to number) |
(better code examples) |
||
| Line 2: | Line 2: | ||
{{Function | {{Function | ||
|name=turtle.refuel | |name=turtle.refuel | ||
| − | |args={{type|number}} | + | |args={{type|number}} fuel item consume quantity |
|api=turtle | |api=turtle | ||
|returns={{type|boolean}} true if fuel, else false. | |returns={{type|boolean}} true if fuel, else false. | ||
|addon=ComputerCraft | |addon=ComputerCraft | ||
| − | |desc= | + | |desc=If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. If the current slot doesn't contain a fuel item, it returns false. If a quantity is specified, it will refuel only up to that many items (if 32 is specified and 16 is present only 16 will be consumed), otherwise, it will consume all the items in the slot. |
|examples= | |examples= | ||
{{Example | {{Example | ||
| − | |desc= | + | |desc=Checks if the item in the current slot can be used as fuel without consuming it |
| − | |code=turtle.refuel( | + | |code=local valid = turtle.refuel(0) |
| − | |output= | + | print(valid) |
| + | |output=If the current slot is valid fuel | ||
}} | }} | ||
{{Example | {{Example | ||
| − | |desc= | + | |desc=Consumes only 4 items in the current slot if the item is a valid fuel |
| − | + | |code=local success = turtle.refuel(4) | |
| − | + | print(success) | |
| + | |output=whether it successfully refuelled | ||
| + | }} | ||
| + | {{Example | ||
| + | |desc=Loops through the turtle's inventory checking if the item is valid fuel and then consuming half of the stack when it is | ||
| + | |code=for i = 1, 16 do -- loop through the slots | ||
| + | turtle.select(i) -- change to the slot | ||
| + | if turtle.refuel(0) then -- if it's valid fuel | ||
| + | local halfStack = math.ceil(turtle.getItemCount(i)/2) -- work out half of the amount of fuel in the slot | ||
| + | turtle.refuel(halfStack) -- consume half the stack as fuel | ||
| + | end | ||
| + | end | ||
}} | }} | ||
}} | }} | ||
Revision as of 19:04, 6 November 2013
 Function turtle.refuel | |
| If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. If the current slot doesn't contain a fuel item, it returns false. If a quantity is specified, it will refuel only up to that many items (if 32 is specified and 16 is present only 16 will be consumed), otherwise, it will consume all the items in the slot. | |
| Syntax | turtle.refuel(number fuel item consume quantity) |
| Returns | boolean true if fuel, else false. |
| Part of | ComputerCraft |
| API | turtle |
Examples
 Example | |
| Checks if the item in the current slot can be used as fuel without consuming it | |
| Code |
local valid = turtle.refuel(0) print(valid) |
| Output | If the current slot is valid fuel |
| Example | |
| Consumes only 4 items in the current slot if the item is a valid fuel | |
| Code |
local success = turtle.refuel(4) print(success) |
| Output | whether it successfully refuelled |
| Example | |
| Loops through the turtle's inventory checking if the item is valid fuel and then consuming half of the stack when it is | |
| Code |
for i = 1, 16 do -- loop through the slots
turtle.select(i) -- change to the slot
if turtle.refuel(0) then -- if it's valid fuel
local halfStack = math.ceil(turtle.getItemCount(i)/2) -- work out half of the amount of fuel in the slot
turtle.refuel(halfStack) -- consume half the stack as fuel
end
end
|
Fuel Values
Fuel values for different items.
| Item | Movement gained | Added by |
|---|---|---|
| Biofuel Can | 520 | IndustrialCraft |
| Scrap | 15 | IndustrialCraft |
| Coalfuel Can | 1520 | IndustrialCraft |
| Wooden Scaffolding | 15 | IndustrialCraft |
| Peat | 80 | Forestry |
| Sugar Cane | 0 | Vanilla |
| Wooden Tools | 10 | Vanilla |
| Lava | 1000 | Vanilla |
| Blaze Rod | 120 | Vanilla |
| Wood Blocks | 15 | Vanilla |
| Sticks | 5 | Vanilla |
| Coal/Charcoal | 80 | Vanilla |
| Mushroom Blocks | 15 | Vanilla |
| Coal Coke | 320 | Railcraft |
1.41:
The formula for calculating the movement gain from a fuel is "((fuel / 100) * 6)". Where fuel is the items burn time in ticks in a regular furnace and "/" is integer division.
1.42+:
Formula changed to ((fuel * 6) / 100). This will give more accurate movement values.
1.48:
Formula changed to ((fuel * 5) / 100)
