Skip to content

Blueprint blueprint

The blueprint feature allows players to place 'schematic spawners' which will, after a set time, paste a schematic. All schematics must be provided by admins and placed into the /FactionsKore/blueprint/ directory.

Config

reset-timer-when-blocked

A schematic spawner can be blocked from placing when an enemy is nearby or when the schematic's region overlaps with enemy territory. Setting this to true will make the timer reset back to its maximum when it's blocked.

block-when-enemy-players-within-range

This is the range in which the schematic spawner will be blocked by enemy players.

outline-to-players-within-range

The range in which players are able to see the particle outline of the schematic.

particle-tick-speed

How often, in ticks, the particles will be re-rendered to players.

blueprint-item

The item that the schematic spawners use when given to a player.

blueprints Section

This section defines all blueprints players can use on your server. Here's an example: 

    255-qp:
      decals:
        '1':
          type: CANNON_DIRECTION
          direction: SOUTH
          float: LEFT
      place-time: 60 # 1 minute
      placed-type: TNT
      only-in-base-region: false
      max-y-height-placeable: 128 # This schematic can't be placed at Y height 129 or higher.
      display-name: '&a255 Quick Print'
      # If this blueprint can be overlapped with other to-be-placed blueprints
      allow-overlap: false
      description:
      - '&7Range: &aX chunks'
      - '&7Float: &aY chunks'
      schematic-path: 255_quickprint.schematic # Taken from the /plugins/FactionsKore/blueprint/ directory
place-time - How much time in seconds it takes to place the schematic.

placed-type - Which type of block the schematic spawner is when its placed.

only-in-base-region - If this blueprint should only be placeable within a faction's base region.

max-y-height-placeable - The maximum height that this blueprint is placeable.

display-name - This is the display name players see when this schematic is referenced.

allow-overlap - If this spawner should be able to be overlapped with others.

description - Should contain descriptive things about the schematic.

schematic-path - This is the name of the schematic taken from the /plugins/FactionsKore/blueprint/ directory.

The decals section is optional, but allows you to define particle decals that help the player understand things about the schematic. In this example, the schematic is a 255 quickprint cannon. However, players may not know which direction it shoots or floats by default. (It'd be terrible to wait 60 seconds just to have the cannon place incorrectly).

The arrow shows how the schematic will shoot BY DEFAULT. When players rotate/flip the schematic, the decal will update with it.

blueprint-hologram Section

Defines the holograms for the two states of blueprints 'blocked' and 'unblocked'.

Command

  • /blueprint list - Lists all available blueprints.
  • /blueprint give (player) (blueprint) [amount=1] - Gives a player a schematic spawner.

Permissions

  • Base Level - Use blueprints.
  • Admin Level - List and give blueprints.