Fabric Wiki

User Tools

Site Tools

Trace:
tutorial:1.15:jigsaw

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
tutorial:jigsaw [2019/10/20 22:45] – draylartutorial:1.15:jigsaw [2020/08/15 12:46] – [Jigsaws] emmanuelmess
Line 1: Line 1:
 +====== Jigsaws ======
 Jigsaws are good for advanced structures such as dungeons & villages, and allow you to spend more time on actually building content vs. messing with procedural generation code.  Jigsaws are good for advanced structures such as dungeons & villages, and allow you to spend more time on actually building content vs. messing with procedural generation code. 
  
-==== Creating a StructureFeature ==== +A repository with finished code can be found [[https://github.com/Draylar/jigsaw-example-mod|here for 1.14]], [[https://github.com/Draylar/jigsaw-example-mod/tree/1.15|here for 1.15]], [[tutorial:jigsaw|here for 1.16]]  
-A ''StructureFeature'' is an advanced ''Feature'': it keeps track of its location and bounds, and also has the ability to generate itself from a structure file((While you can generate your StructureFeature from a ''.nbt'' file, most vanilla StructureFeatures simply override the `generate` method inside their given Piece class.)). If it helps, you can think of it as a ''Structure'' + ''Feature''. We'll need to create one for our jigsaw generated structure. To start, create a class that extends `StructureFeature<DefaultFeatureConfig>`((AbstractTempleFeature is another option. It automatically spaces out the structures similar to the existing temples-- this logic is also used by villages.)). Feature naming convention is "structure name" + "Feature"; a few vanilla examples are ''EndCityFeature'', ''OceanRuinFeature'', and ''VillageFeature''.+ 
 +===== Creating a StructureFeature ===== 
 + 
 +A ''StructureFeature'' is an advanced ''Feature'': it keeps track of its location and bounds, and also has the ability to generate itself from a structure file((While you can generate your StructureFeature from a ''.nbt'' file, most vanilla StructureFeatures simply override the ''generate'' method inside their given Piece class.)). If it helps, you can think of it as a ''Structure'' + ''Feature''. We'll need to create one for our jigsaw generated structure. To start, create a class that extends ''StructureFeature<DefaultFeatureConfig>''((AbstractTempleFeature is another option. It automatically spaces out the structures similar to the existing temples-- this logic is also used by villages.)). Feature naming convention is "structure name" + "Feature"; a few vanilla examples are ''EndCityFeature'', ''OceanRuinFeature'', and ''VillageFeature''.
  
 //Note: while Feature is the proper name for something generated in the world, we'll refer to our addition as a Structure. This is to distinguish between a StructureFeature and a standard Feature.// //Note: while Feature is the proper name for something generated in the world, we'll refer to our addition as a Structure. This is to distinguish between a StructureFeature and a standard Feature.//
  
-We'll keep the constructor as-is. The `Function<Dynamic<?>>` parameter is the structure config-- if you don't have any plans to mess with it, you can simply pass `DefaultFeatureConfig::deserialize` into super:+We'll keep the constructor as-is. The ''Function<Dynamic<?>>'' parameter is the structure config-- if you don't have any plans to mess with it, you can simply pass ''DefaultFeatureConfig::deserialize'' into super:
  
 <code java [enable_line_numbers="false"]> <code java [enable_line_numbers="false"]>
Line 114: Line 118:
  * turns into  * turns into
  
-{{https://i.imgur.com/owaJ0k2.png|Blank Jigsaw}}+{{ https://i.imgur.com/owaJ0k2.png?nolink&600 |Blank Jigsaw}}
  
 When thinking about this as a puzzle, the target pool is the group of puzzle pieces you can search through. If you have a total of 10 pieces, one target pool may have 7 of the total pieces. This field is how a jigsaw specifies, "Hi, I'd like a piece from group B to connect to me!" In the case of a village, this may be a road saying, "Give me a house!" The target pools of 2 jigsaws do not have to match: the requestor gets to decide who they select from. It is **not** defining what type //the given// jigsaw block is, but rather what type should be on the //other side//. When thinking about this as a puzzle, the target pool is the group of puzzle pieces you can search through. If you have a total of 10 pieces, one target pool may have 7 of the total pieces. This field is how a jigsaw specifies, "Hi, I'd like a piece from group B to connect to me!" In the case of a village, this may be a road saying, "Give me a house!" The target pools of 2 jigsaws do not have to match: the requestor gets to decide who they select from. It is **not** defining what type //the given// jigsaw block is, but rather what type should be on the //other side//.
Line 124: Line 128:
 Here's an example implementation: the given jigsaw will draw from the //tutorial:my_pool// structure pool, looks for any jigsaws with the //tutorial:any// type, and turns into cobblestone when it's done. Here's an example implementation: the given jigsaw will draw from the //tutorial:my_pool// structure pool, looks for any jigsaws with the //tutorial:any// type, and turns into cobblestone when it's done.
  
-{{https://i.imgur.com/f9tP2sv.png|Example Finished Jigsaw}}+{{ https://i.imgur.com/f9tP2sv.png?nolink&600 |Example Finished Jigsaw}}
  
 Our finalized structure will consist of multiple colored squares connecting to each other. It will have a white or a black square in the center, and orange, magenta, light blue, and lime squares branching off on the sides randomly. Here is the setup of our 2 initial squares: Our finalized structure will consist of multiple colored squares connecting to each other. It will have a white or a black square in the center, and orange, magenta, light blue, and lime squares branching off on the sides randomly. Here is the setup of our 2 initial squares:
-{{https://i.imgur.com/dVFADy8.png|Initial Squares}}+ 
 +{{ https://i.imgur.com/dVFADy8.png?nolink&400 |Initial Squares}}
  
 This jigsaw will ask for any other jigsaw that: This jigsaw will ask for any other jigsaw that:
Line 135: Line 140:
  
 For demo purposes, we've made 2 starting platforms: one is white, and one is black. The only difference is what they turn into. We'll save these as structure files using structure blocks: For demo purposes, we've made 2 starting platforms: one is white, and one is black. The only difference is what they turn into. We'll save these as structure files using structure blocks:
-{{https://i.imgur.com/31LAORw.png|Finalized Initial Squares}}+ 
 +{{ https://i.imgur.com/31LAORw.png?nolink&400 |Finalized Initial Squares}}
  
 For our randomized edge platforms, we've made 4 extra squares of different colors. Again, despite being used for a different purpose, the jigsaw construction is //the same// aside from the "turns into" field. For our randomized edge platforms, we've made 4 extra squares of different colors. Again, despite being used for a different purpose, the jigsaw construction is //the same// aside from the "turns into" field.
-{{https://i.imgur.com/OngxweJ.png|Colored Squares}}+ 
 +{{ https://i.imgur.com/OngxweJ.png?nolink&400 |Colored Squares}}
  
 We now have 6 saved ''.nbt'' files. These can be found in our world save folder under ''generated'': We now have 6 saved ''.nbt'' files. These can be found in our world save folder under ''generated'':
-{{https://i.imgur.com/ZKIoZT9.png|Saved NBT files}}+ 
 +{{ https://i.imgur.com/ZKIoZT9.png?nolink&400 |Saved NBT files}}
  
 For usage, we'll move these to ''resources/data/tutorial/structures'', where "tutorial" is your modid: For usage, we'll move these to ''resources/data/tutorial/structures'', where "tutorial" is your modid:
-{{https://i.imgur.com/kaiy84U.png|Moved NBT files}}+ 
 +{{ https://i.imgur.com/kaiy84U.png?nolink&400 |Moved NBT files}}
  
 The setup is complete! We now have 6 total squares. Let's briefly recap the goal: The setup is complete! We now have 6 total squares. Let's briefly recap the goal:
Line 239: Line 248:
  Registry.STRUCTURE_FEATURE,  Registry.STRUCTURE_FEATURE,
  new Identifier("tutorial", "example_structure_feature"),  new Identifier("tutorial", "example_structure_feature"),
- new ExampleFeature(DefaultFeatureConfig::deserialize)+ EXAMPLE_FEATURE
 ); );
  
Line 253: Line 262:
 <code java [enable_line_numbers="false"]> <code java [enable_line_numbers="false"]>
 Registry.BIOME.forEach(biome -> { Registry.BIOME.forEach(biome -> {
- biome.addFeature(GenerationStep.Feature.RAW_GENERATION, Biome.configureFeature(EXAMPLE_FEATURE, new DefaultFeatureConfig(), Decorator.NOPE, DecoratorConfig.DEFAULT)); + biome.addFeature(GenerationStep.Feature.RAW_GENERATION, EXAMPLE_FEATURE.configure(new DefaultFeatureConfig()).createDecoratedFeature(Decorator.NOPE.configure(DecoratorConfig.DEFAULT))); 
- biome.addStructureFeature(EXAMPLE_FEATURE, new DefaultFeatureConfig());+ biome.addStructureFeature(EXAMPLE_FEATURE.configure(new DefaultFeatureConfig()));
 }); });
 </code> </code>
Line 260: Line 269:
 === Finished! === === Finished! ===
 As you can see, we have a single white square in the center, with boxes going off the edges. Note that the radius in this screenshot was increased to 14 instead of the 7 used in the tutorial. As you can see, we have a single white square in the center, with boxes going off the edges. Note that the radius in this screenshot was increased to 14 instead of the 7 used in the tutorial.
-{{https://i.imgur.com/qndZzZu.png|Finalized}}+ 
 +{{ https://i.imgur.com/qndZzZu.png?nolink&600 |Finalized}} 
 +=== Jigsaw Tips === 
 +Ideally, you do not want structure pieces to be bigger than 32x32x32, so breaking them into chunk-sized pieces is the best option.  
 +You cannot generate other structure pieces of the same pool through jigsaws. So, if you have a piece in pool A and you try to generate another piece, you will have to have another pool. 
tutorial/1.15/jigsaw.txt · Last modified: 2021/12/28 19:44 by banana