Merge branch 'mc-1.16.x' into mc-1.17.x

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -10,6 +10,7 @@ body:
     options:
       - 1.15.x
       - 1.16.x
+      - 1.17.x
   validations:
     required: true
 - type: input

src/main/java/dan200/computercraft/core/apis/RedstoneAPI.java

@@ -72,6 +72,7 @@ public class RedstoneAPI implements ILuaAPI
      * "back".
      *
      * @return A table of valid sides.
+     * @cc.since 1.2
      */
     @LuaFunction
     public final String[] getSides()
@@ -122,6 +123,7 @@ public class RedstoneAPI implements ILuaAPI
      * @param side  The side to set.
      * @param value The signal strength between 0 and 15.
      * @throws LuaException If {@code value} is not betwene 0 and 15.
+     * @cc.since 1.51
      */
     @LuaFunction( { "setAnalogOutput", "setAnalogueOutput" } )
     public final void setAnalogOutput( ComputerSide side, int value ) throws LuaException
@@ -136,6 +138,7 @@ public class RedstoneAPI implements ILuaAPI
      * @param side The side to get.
      * @return The output signal strength, between 0 and 15.
      * @see #setAnalogOutput
+     * @cc.since 1.51
      */
     @LuaFunction( { "getAnalogOutput", "getAnalogueOutput" } )
     public final int getAnalogOutput( ComputerSide side )
@@ -148,6 +151,7 @@ public class RedstoneAPI implements ILuaAPI
      *
      * @param side The side to get.
      * @return The input signal strength, between 0 and 15.
+     * @cc.since 1.51
      */
     @LuaFunction( { "getAnalogInput", "getAnalogueInput" } )
     public final int getAnalogInput( ComputerSide side )

src/main/java/dan200/computercraft/shared/turtle/apis/TurtleAPI.java

@@ -515,8 +515,8 @@ public class TurtleAPI implements ILuaAPI
     /**
      * Refuel this turtle.
      *
-     * While most actions a turtle can perform (such as digging or placing blocks), moving consumes fuel from the
-     * turtle's internal buffer. If a turtle has no fuel, it will not move.
+     * While most actions a turtle can perform (such as digging or placing blocks) are free, moving consumes fuel from
+     * the turtle's internal buffer. If a turtle has no fuel, it will not move.
      *
      * {@link #refuel} refuels the turtle, consuming fuel items (such as coal or lava buckets) from the currently
      * selected slot and converting them into energy. This finishes once the turtle is fully refuelled or all items have

src/main/java/dan200/computercraft/shared/turtle/upgrades/TurtleTool.java

@@ -91,14 +91,7 @@ public class TurtleTool extends AbstractTurtleUpgrade
     @OnlyIn( Dist.CLIENT )
     public TransformedModel getModel( ITurtleAccess turtle, @Nonnull TurtleSide side )
     {
-        float xOffset = side == TurtleSide.LEFT ? -0.40625f : 0.40625f;
-        Matrix4f transform = new Matrix4f( new float[] {
-            0.0f, 0.0f, -1.0f, 1.0f + xOffset,
-            1.0f, 0.0f, 0.0f, 0.0f,
-            0.0f, -1.0f, 0.0f, 1.0f,
-            0.0f, 0.0f, 0.0f, 1.0f,
-        } );
-        return TransformedModel.of( getCraftingItem(), new Transformation( transform ) );
+        return TransformedModel.of( getCraftingItem(), side == TurtleSide.LEFT ? Transforms.leftTransform : Transforms.rightTransform );
     }
 
     @Nonnull
@@ -293,4 +286,20 @@ public class TurtleTool extends AbstractTurtleUpgrade
         Direction direction = tile.isRemoved() ? null : turtle.getDirection().getOpposite();
         DropConsumer.clearAndDrop( turtle.getLevel(), turtle.getPosition(), direction );
     }
+
+    private static class Transforms
+    {
+        static final Transformation leftTransform = getMatrixFor( -0.40625f );
+        static final Transformation rightTransform = getMatrixFor( 0.40625f );
+
+        private static Transformation getMatrixFor( float offset )
+        {
+            return new Transformation( new Matrix4f( new float[] {
+                0.0f, 0.0f, -1.0f, 1.0f + offset,
+                1.0f, 0.0f, 0.0f, 0.0f,
+                0.0f, -1.0f, 0.0f, 1.0f,
+                0.0f, 0.0f, 0.0f, 1.0f,
+            } ) );
+        }
+    }
 }

src/main/resources/data/computercraft/lua/rom/apis/peripheral.lua

@@ -11,6 +11,8 @@
 -- Peripheral functions are called *methods*, a term borrowed from Java.
 --
 -- @module peripheral
+-- @since 1.3
+-- @changed 1.51 Add support for wired modems.
 
 local expect = dofile("rom/modules/main/cc/expect.lua").expect
 
@@ -24,6 +26,7 @@ local sides = rs.getSides()
 -- Modem, then it'll be reported according to its name on the wired network.
 --
 -- @treturn { string... } A list of the names of all attached peripherals.
+-- @since 1.51
 function getNames()
     local results = {}
     for n = 1, #sides do
@@ -69,6 +72,7 @@ end
 -- @tparam string|table peripheral The name of the peripheral to find, or a
 -- wrapped peripheral instance.
 -- @treturn string|nil The peripheral's type, or `nil` if it is not present.
+-- @changed 1.88.0 Accepts a wrapped peripheral as an argument.
 function getType(peripheral)
     expect(1, peripheral, "string", "table")
     if type(peripheral) == "string" then -- Peripheral name passed
@@ -118,6 +122,7 @@ end
 --
 -- @tparam table peripheral The peripheral to get the name of.
 -- @treturn string The name of the given peripheral.
+-- @since 1.88.0
 function getName(peripheral)
     expect(1, peripheral, "table")
     local mt = getmetatable(peripheral)
@@ -209,6 +214,7 @@ and returns if it should be included in the result.
 @usage This abuses the `filter` argument to call @{rednet.open} on every modem.
 
     peripheral.find("modem", rednet.open)
+@since 1.6
 ]]
 function find(ty, filter)
     expect(1, ty, "string")