FTB Team Dimensions

Important Disclaimer!

Like most FTB mods, this project was specifically developed for particular modified Minecraft packs. We strongly advise against using it outside of the packs it was created for, as this may cause conflicts with other mods it hasn't been tested with.

Feature Overview

FTB Team Dimensions provides tools for creating dynamic dimensions designed for player teams. Requires FTB Teams mod to be installed.

Players begin their adventure in a specially prepared lobby in the overworld containing a portal. Upon entering this portal, a selection interface appears offering one or more pre-built "island" structures. Each selected structure becomes the foundation for a new dimension created specifically for the player's team.

If a player doesn't have a team yet, one will be automatically created upon first portal entry. New members can join the team using standard methods and will be immediately teleported to their group's existing dimension.

World Generation Types

Currently, two chunk generation options are available, both working in void dimensions:

• Multi-biome generation - biome distribution similar to the regular world (used by default)
• Single biome generation - activated by setting the singleBiomeDimension parameter to true in mod configuration
  • Specific biome can be set via the singleBiomeName setting (default: minecraft:the_void)

Future versions plan to expand world generation customization options.

Configuration via Datapacks

Working with configuration requires basic understanding of data-driven world generation principles in version 1.19.2.

Main configuration is done through datapacks, using standard structure and structure_set types to define pre-built "islands". These structures are generated in new dimensions always in chunk coordinates (0,0).

Also used is a special datapack type ftbdim_prebuilt_structures, which determines which structures will be available to players upon first entering the lobby portal.

Structure Configuration Example

The standard pre-built structure (data/ftbteamdimensions/ftbdim_prebuilt_structures/island1.json) looks as follows (optional fields may be absent in the actual file):

{
  "id": "ftbteamdimensions:island1",
  "structure": "ftbteamdimensions:spawn/island1",
  "name": "Simple Island",
  // optional fields
  "author": "FTB Team",
  "structure_set": "ftbteamdimensions:default",
  "height": 64,
  "dimension_type": "ftbteamdimensions:default",
  "preview_image": "ftbteamdimensions:textures/spawn/island1.png",
  "spawn_override": [ 0, 64, 0 ]
}

Configuration Fields Description:

• id - mandatory unique field corresponding to the JSON filename
• structure - mandatory field determining the NBT structure file
  • Example: data/ftbteamdimensions/structures/spawn/island1.nbt contains a small island of grass and dirt
• name - mandatory field displayed in the structure selection interface
  • Can be a string or translation key
• author - optional author field (default: "FTB Team")
  • Displayed as "by " in selection interface
• structure_set - optional structure set field
  • Default: ftbteamdimensions:default, including only ftbteamdimensions:start
  • Determines which structure sets are used during dimension generation
• height - optional field for island generation height
  • Default: 64
• dimension_type - optional dimension type field
  • Default: ftbteamdimensions:default (similar to regular world)
• preview_image - optional preview image field
  • 128x64 texture for display in selection interface
  • Standard path: <modname>:textures/spawn/<id>.png
• spawn_override - optional spawn point override field
  • Default player spawn position is (0, HEIGHT, 0)

NBT Structures

Structure files (both for overworld lobby and dimension islands) use standard Minecraft NBT structure format created using Structure Blocks.

Important requirement: all structures must contain one Structure Block in data mode with the custom tag spawn_point. This block determines player spawn points in both the lobby and created team dimensions.

Structures are always positioned so that the spawn_point block is at position (0,H,0), where H is the value from the "height" field in JSON configuration. When placing the structure in the world, this block is replaced with air, and the player spawns at its location by default.

The standard lobby structure is located at data/ftbteamdimensions/structures/lobby.nbt, but it can be changed in two ways:

• through mod configuration (lobbyStructure parameter in ftbteamdimensions-common.toml)
• or simply override it via datapack!