Relocators: Difference between revisions

From Official Gamemode 4 Wiki
Jump to navigation Jump to search
(Fix some of the new info and add some of the old info)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{ModuleInfobox|name=Relocators|creator=BluePsychoRanger|type=Reliant|versions=1.14|complementary=[[Custom Crafters]], [[Liquid Tanks]], [[Block Compressors]]|requires=[[Custom Crafters]]}}This module adds an item that can pick up Gamemode 4 machine blocks such as custom crafters, liquid tanks, and more!
{{ModuleInfobox|name=Relocators|creator=BluePsychoRanger|type=Reliant|versions=1.14+|complementary=[[Block Compressors]], [[Book Binders]], [[Disassemblers]], [[Enchantment Extractors]], [[Ender Hoppers]], [[Liquid Tanks]], [[Master Crafting]], [[Smelteries]], [[Tinkering Compressors]]|requires=[[Custom Crafters]]}}This module adds an item that can pick up and move containers and Gamemode 4 machines without having to take out the contents!
==Features==
==Features==
By placing down a relocator, the player is able to pick up and move a custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a machine block.
By placing down a relocator, the player is able to pick up and move a container or custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a container or machine block.
Containers containing shulker boxes or filled relocators can not be picked up.


====== Picking Up a Machine Block ======
The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block).  Relocators will not pick up blocks with items in them. Relocating a liquid tank will empty it of its contents.
Once a machine is picked up, the relocator will drop as the block type it was placed on (e.g. dropper for custom crafter or hopper for liquid tank). This item will have an enchanted glint and be named according to the custom name of the block, and will have the first line of lore set to “Relocator” (yellow and italic).
====== Placing Down a Machine Block ======
To get the machine block back, simply place down the item created when picking up a machine block. The original relocator item will drop once the block is created.
===Crafting===
===Crafting===
{| class="wikitable"
{| class="wikitable"
Line 18: Line 12:
|-
|-
|Relocator (x1)
|Relocator (x1)
|4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Book
|4x Crying Obsidian, 2x Shulker Shell, 2x Amethyst Shard, 1x Silk Touch Book
|{{Crafting
| Input = {{CraftingGrid
| Crying Obsidian | Shulker Shell | Crying Obsidian
| Amethyst Shard | {{Stack|Enchanted Book|lore=&7Silk Touch}} | Amethyst Shard
| Crying Obsidian | Shulker Shell | Crying Obsidian
}}
| Output = {{CraftingCell
| gm4:Relocator
}}
}}
|-
|Relocator (x1)
|4x Crying Obsidian, 2x Shulker Shell, 2x Amethyst Shard, 1x [[Book Binders|Silk Touch Page]]
|{{Crafting
|{{Crafting
| Input = {{CraftingGrid
| Input = {{CraftingGrid
| Diamond | Popped Chorus Fruit | Diamond
| Crying Obsidian | Shulker Shell | Crying Obsidian
| Popped Chorus Fruit | Enchanted Book | Popped Chorus Fruit
| Amethyst Shard | {{Stack|gm4:Enchanted Page|lore=&7Silk Touch}} | Amethyst Shard
| Diamond | Popped Chorus Fruit | Diamond
| Crying Obsidian | Shulker Shell | Crying Obsidian
}}
}}
| Output = {{CraftingCell
| Output = {{CraftingCell
| Relocator
| gm4:Relocator
}}
}}
}}
}}
|}
|}


=== Technical Summary ===
=== Picking Up a Container or Machine Block ===
Scores of the armor stands are not stored, so liquid tanks will not retain their liquid type or fill amount.
The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block), this could be a chest, a dropper, a [[Liquid Tanks|Liquid Tank]], a [[Custom Crafters|Custom Crafter]] or similar. Relocators can not pick up containers that have a Shulker Box inside.
 
Once a block is picked up, the relocator will drop as a filled item. It will have a lore indicating what is stored inside.
 
=== Placing Down a Container or Machine Block ===
To get the block back, simply place down the custom block created when initially picking up a machine block. An empty relocator item will drop once the block is created.
 
===Compatibility===
The relocator is capable of picking up compatible GM4 Machine Blocks. Any module can support relocation; custom pick up and place down functions are available so each module is able to be correctly compatible with relocators.


Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.
The following modules have relocation support:


The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
*[[Block Compressors]]
*[[Custom Crafters]]
*[[Disassemblers]]
*[[Enchantment Extractors]]
*[[Ender Hoppers]]
*[[Liquid Tanks]]
*[[Master Crafting]]
*[[Smelteries]]
*[[Tinkering Compressors]]


The following data is stored for a machine block: CustomName, Lock
All machine data (inventory items, liquid levels, ...) is preserved when moving a machine this way.


===Compatibility===
The relocator is capable of picking up almost any machine block by Gamemode 4. There is no hard-coded list, but if the machine block has an armor stand, it is likely that it can be picked up.
===Advancements===
===Advancements===
{| class="wikitable"
{| class="wikitable"
|+
|+
!Advancement
!Advancement
!Description
!Requirement
!Requirement
|-
|-
|It's moving day!
|{{Advancement|gm4:Relocator|It's Moving Day!|Pick up a machine with the relocator}}
|Pick up a machine with the relocator
|Place down a relocator that picks up a block
|Place down a relocator which picks up a machine block
|}
|}
==Learn More and Download==
==Learn More and Download==
{{Download|url=https://gm4.co/modules/relocators}}
{{Download|url=https://gm4.co/modules/relocators}}
==History==
==History==
{| class="wikitable"
{| class="wikitable"
Line 62: Line 83:
!Change
!Change
|-
|-
| rowspan="2" |1.14
|1.14
|01 Dec 2019
|01 Dec 2019
|Released Relocators
|Released Relocators
|-
| rowspan="3" |1.16
| rowspan="3" |29 Nov 2020
| Improved reliability of placing down a relocated machine
|-
| Relocated machines are now custom blocks instead of the block that makes up the machine block
|-
| Improved module compatibility; each machine block can run custom pick up and place down functions
|-
| rowspan="2" |1.18
| rowspan="2" |23 Apr 2022
| Redesigned relocators to preserve all machine properties and allowed relocators to pick up any container
|-
| Changed crafting recipe
|}
==Previous Versions==
=== MC 1.14-1.15 Versions ===
Prior to 1.16, Relocators were less reliable and less expandable.
When picking up a block, the block that the machine block was made of (e.g. dropper/hopper) dropped as the relocated block, instead of a custom block item. Additionally, there was no hardcoded implementation for deciding whether a block should or shouldn't be picked up, leading to errors with some machine blocks (e.g. relocated smelteries were bugged until breaking and placing it down again).
In these versions, the following technical details were present:
* Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.
* The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
* The following data is stored for a machine block: CustomName, Lock
=== MC 1.15-1.17 Versions ===
Prior to 1.18, Relocators were solely used to pick up and move Gamemode 4 machines.
Pickup would only work for empty machines (no items in internal inventory) and data such as a [[Liquid Tanks|Liquid Tanks']] liquid would be lost.
The relocator recipe in these versions are as follows:
{| class="wikitable"
|+
!Item
!Ingredients
!Recipe ([[Custom Crafters|Custom Crafter]])
|-
|Relocator (x1)
|4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Book
|{{Crafting
| Input = {{CraftingGrid
| Diamond | Popped Chorus Fruit | Diamond
| Popped Chorus Fruit | {{Stack|Enchanted Book|lore=&7Silk Touch}} | Popped Chorus Fruit
| Diamond | Popped Chorus Fruit | Diamond
}}
| Output = {{CraftingCell
| gm4:Relocator
}}
}}
|-
|Relocator (x1)
|4x Diamond, 4x Popped Chorus Fruit, 1x [[Book Binders|Silk Touch Page]]
|{{Crafting
| Input = {{CraftingGrid
| Diamond | Popped Chorus Fruit | Diamond
| Popped Chorus Fruit | {{Stack|gm4:Enchanted Page|lore=&7Silk Touch}} | Popped Chorus Fruit
| Diamond | Popped Chorus Fruit | Diamond
}}
| Output = {{CraftingCell
| gm4:Relocator
}}
}}
|}
|}
{{Modules List/Custom Crafters}}
{{Modules List/Relocatable Machines}}
[[Category:Reliant Modules]]
[[Category:Reliant Modules]]
[[Category:All Modules]]
[[Category:All Modules]]

Latest revision as of 01:40, 4 October 2022

Relocators

Module TypeReliant
Created byBluePsychoRanger
Required ModulesCustom Crafters
Complementary ModulesBlock Compressors, Book Binders, Disassemblers, Enchantment Extractors, Ender Hoppers, Liquid Tanks, Master Crafting, Smelteries, Tinkering Compressors
Compatible MC Versions1.14+

This module adds an item that can pick up and move containers and Gamemode 4 machines without having to take out the contents!

Features

By placing down a relocator, the player is able to pick up and move a container or custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a container or machine block. Containers containing shulker boxes or filled relocators can not be picked up.

Crafting

Item Ingredients Recipe (Custom Crafter)
Relocator (x1) 4x Crying Obsidian, 2x Shulker Shell, 2x Amethyst Shard, 1x Silk Touch Book
Relocator (x1) 4x Crying Obsidian, 2x Shulker Shell, 2x Amethyst Shard, 1x Silk Touch Page

Picking Up a Container or Machine Block

The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block), this could be a chest, a dropper, a Liquid Tank, a Custom Crafter or similar. Relocators can not pick up containers that have a Shulker Box inside.

Once a block is picked up, the relocator will drop as a filled item. It will have a lore indicating what is stored inside.

Placing Down a Container or Machine Block

To get the block back, simply place down the custom block created when initially picking up a machine block. An empty relocator item will drop once the block is created.

Compatibility

The relocator is capable of picking up compatible GM4 Machine Blocks. Any module can support relocation; custom pick up and place down functions are available so each module is able to be correctly compatible with relocators.

The following modules have relocation support:

All machine data (inventory items, liquid levels, ...) is preserved when moving a machine this way.

Advancements

Advancement Requirement
It's Moving Day!
Pick up a machine with the relocator
Place down a relocator that picks up a block

Learn More and Download

Download

History

Version Date Change
1.14 01 Dec 2019 Released Relocators
1.16 29 Nov 2020 Improved reliability of placing down a relocated machine
Relocated machines are now custom blocks instead of the block that makes up the machine block
Improved module compatibility; each machine block can run custom pick up and place down functions
1.18 23 Apr 2022 Redesigned relocators to preserve all machine properties and allowed relocators to pick up any container
Changed crafting recipe

Previous Versions

MC 1.14-1.15 Versions

Prior to 1.16, Relocators were less reliable and less expandable. When picking up a block, the block that the machine block was made of (e.g. dropper/hopper) dropped as the relocated block, instead of a custom block item. Additionally, there was no hardcoded implementation for deciding whether a block should or shouldn't be picked up, leading to errors with some machine blocks (e.g. relocated smelteries were bugged until breaking and placing it down again).

In these versions, the following technical details were present:

  • Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.
  • The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
  • The following data is stored for a machine block: CustomName, Lock

MC 1.15-1.17 Versions

Prior to 1.18, Relocators were solely used to pick up and move Gamemode 4 machines. Pickup would only work for empty machines (no items in internal inventory) and data such as a Liquid Tanks' liquid would be lost. The relocator recipe in these versions are as follows:

Item Ingredients Recipe (Custom Crafter)
Relocator (x1) 4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Book
Relocator (x1) 4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Page