example from #415

Author: its-miroma

develop/blocks/block-containers.md

@@ -13,17 +13,17 @@ In this tutorial we'll create a block that uses its container to duplicate any i
 
 This should be familiar to the reader if they've followed the [Creating Your First Block](../blocks/first-block) and [Block Entities](../blocks/block-entities) guides. We'll create a `DuplicatorBlock` that extends `BaseEntityBlock` and implements `EntityBlock`.
 
-@[code transcludeWith=:::block](@/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java#block
 
 Then, we need to create a `DuplicatorBlockEntity`, which needs to implement the `Container` interface. As most containers are generally expected to work the same way, you can copy and paste a helper called `ImplementedContainer` that does most of the work, leaving us with just a few methods to implement.
 
 ::: details Show `ImplementedContainer`
 
-@[code](@/reference/latest/src/main/java/com/example/docs/container/ImplementedContainer.java)
+<<< @/reference/latest/src/main/java/com/example/docs/container/ImplementedContainer.java
 
 :::
 
-@[code transcludeWith=:::be](@/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java#be
 
 The `items` list is where the container's contents are stored. For this block we have it set to a size of 1 slot for the input.
 
@@ -33,15 +33,15 @@ Don't forget to register the block and block entity in their respective classes!
 
 If we want the contents to persist between game reloads like a vanilla `BlockEntity`, we need to save it as NBT. Thankfully, Mojang provides a helper class called `ContainerHelper` with all the necessary logic.
 
-@[code transcludeWith=:::save](@/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java#save
 
 ## Interacting with the Container {#interacting-with-the-container}
 
 Technically, the container is already functional. However, to insert items, we currently need to use hoppers. Let's make it so that we can insert items by right-clicking the block.
 
 To do that, we need to override the `useItemOn` method in the `DuplicatorBlock`:
 
-@[code transcludeWith=:::useon](@/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java#useon
 
 Here, if the player is holding an item and there is an empty slot, we move the item from the player's hand to the block's container and return `InteractionResult.SUCCESS`.
 
@@ -55,7 +55,7 @@ Let's now make it so that the block duplicates the stack you threw in it, but on
 
 To do this, we'll add a `tick` function to the `DuplicatorBlockEntity`, and a field to store how much we've been waiting:
 
-@[code transcludeWith=:::tick](@/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java#tick
 
 The `DuplicatorBlock` should now have a `getTicker` method that returns a reference to `DuplicatorBlockEntity::tick`.
 
@@ -73,13 +73,13 @@ To create this behavior, we need to implement the `WorldlyContainer` interface i
 
 Let's modify the `DuplicatorBlockEntity` to only accept items from the top:
 
-@[code transcludeWith=:::accept](@/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java#accept
 
 The `getSlotsForFace` returns an array of the slot _indices_ that can be interacted with from the given side. In this case, we only have a single slot (`0`), so we return an array with just that index.
 
 Also, we should modify the `useItemOn` method of the `DuplicatorBlock` to actually respect the new behavior:
 
-@[code transcludeWith=:::place](@/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java)
+<<< @/reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java#place
 
 Now, if we try to insert items from the side instead of the top, it won't work!
 

reference/latest/src/main/java/com/example/docs/block/custom/DuplicatorBlock.java

@@ -20,9 +20,9 @@
 import com.example.docs.block.entity.ModBlockEntities;
 import com.example.docs.block.entity.custom.DuplicatorBlockEntity;
 
-// :::block
+// #region block
 public class DuplicatorBlock extends BaseEntityBlock {
-	// :::block
+	// #endregion block
 
 	public DuplicatorBlock(Properties settings) {
 		super(settings);
@@ -33,37 +33,37 @@ protected MapCodec<? extends BaseEntityBlock> codec() {
 		return simpleCodec(DuplicatorBlock::new);
 	}
 
-	// :::block
+	// #region block
 	@Nullable
 	@Override
 	public BlockEntity newBlockEntity(BlockPos pos, BlockState state) {
 		return new DuplicatorBlockEntity(pos, state);
 	}
 
-	// :::block
+	// #endregion block
 
 	@Override
 	protected RenderShape getRenderShape(BlockState state) {
 		return RenderShape.MODEL;
 	}
 
-	// :::useon
+	// #region useon
 	@Override
 	protected InteractionResult useItemOn(ItemStack stack, BlockState state, Level world, BlockPos pos, Player player, InteractionHand hand, BlockHitResult hit) {
 		if (!(world.getBlockEntity(pos) instanceof DuplicatorBlockEntity duplicatorBlockEntity)) {
 			return InteractionResult.PASS;
 		}
 
-		// :::useon
+		// #endregion useon
 
-		// :::place
+		// #region place
 		if (!duplicatorBlockEntity.canPlaceItemThroughFace(0, stack, hit.getDirection())) {
 			return InteractionResult.PASS;
 		}
 
-		// :::place
+		// #endregion place
 
-		// :::useon
+		// #region useon
 		if (!player.getItemInHand(hand).isEmpty() && duplicatorBlockEntity.isEmpty()) {
 			duplicatorBlockEntity.setItem(0, player.getItemInHand(hand).copy());
 			player.getItemInHand(hand).setCount(0);
@@ -72,15 +72,15 @@ protected InteractionResult useItemOn(ItemStack stack, BlockState state, Level w
 		return InteractionResult.SUCCESS;
 	}
 
-	// :::useon
+	// #endregion useon
 
 	@Nullable
 	@Override
 	public <T extends BlockEntity> BlockEntityTicker<T> getTicker(Level world, BlockState state, BlockEntityType<T> type) {
 		return createTickerHelper(type, ModBlockEntities.DUPLICATOR_BLOCK_ENTITY, DuplicatorBlockEntity::tick);
 	}
 
-	// :::block
+	// #region block
 	// ...
 }
-// :::block
+// #endregion block

reference/latest/src/main/java/com/example/docs/block/entity/custom/DuplicatorBlockEntity.java

@@ -21,20 +21,20 @@
 /*
 The following is a dummy piece of code to not have `implements WorldlyContainer` in the first code block where we implement `ImplementedContainer`.
 lmk if you have a better idea on how to handle this.
-// :::be
+// #region be
 public class DuplicatorBlockEntity extends BlockEntity implements ImplementedContainer {
-// :::be
+// #endregion be
 */
 
 public class DuplicatorBlockEntity extends BlockEntity implements ImplementedContainer, WorldlyContainer {
-	// :::be
+	// #region be
 
 	private final NonNullList<ItemStack> items = NonNullList.withSize(1, ItemStack.EMPTY);
 
-	// :::tick
+	// #region tick
 	private int timeSinceDropped = 0;
 
-	// :::tick
+	// #endregion tick
 
 	public DuplicatorBlockEntity(BlockPos pos, BlockState state) {
 		super(ModBlockEntities.DUPLICATOR_BLOCK_ENTITY, pos, state);
@@ -45,9 +45,9 @@ public NonNullList<ItemStack> getItems() {
 		return items;
 	}
 
-	// :::be
+	// #endregion be
 
-	// :::save
+	// #region save
 	@Override
 	protected void loadAdditional(ValueInput input) {
 		super.loadAdditional(input);
@@ -60,9 +60,9 @@ protected void saveAdditional(ValueOutput output) {
 		super.saveAdditional(output);
 	}
 
-	// :::save
+	// #endregion save
 
-	// :::tick
+	// #region tick
 	public static void tick(Level world, BlockPos blockPos, BlockState blockState, DuplicatorBlockEntity duplicatorBlockEntity) {
 		if (duplicatorBlockEntity.isEmpty()) return;
 		duplicatorBlockEntity.timeSinceDropped++;
@@ -76,9 +76,9 @@ public static void tick(Level world, BlockPos blockPos, BlockState blockState, D
 		Block.popResourceFromFace(world, blockPos, Direction.UP, duplicate);
 	}
 
-	// :::tick
+	// #endregion tick
 
-	// :::accept
+	// #region accept
 	@Override
 	public int[] getSlotsForFace(Direction side) {
 		return new int[]{ 0 };
@@ -94,8 +94,8 @@ public boolean canTakeItemThroughFace(int slot, ItemStack stack, Direction dir)
 		return true;
 	}
 
-	// :::accept
+	// #endregion accept
 
-	// :::be
+	// #region be
 }
-// :::be
+// #endregion be