Telecraft

Telecraft

This plugin implement a craftable teleportation system without the use of commands to feel like vanilla gameplay, Telecraft is intented to be used in survival by player without the need of an admin behind.

• Strange Rune : an emerald with strange engraved rune on it that can remember player location in its memory

  • you can SNEAK + RIGHT CLICK a bloc to ignite its memory and store player position in it...
  • you can rename it with an anvil (and be displayed if crafted in a Strangeblock)
  • you can use it on an existing strangeBlock to teleport to the coordinates saved in the rune.
  • you can teleport with if you enable the permission "telecraft.player.rune.teleport" but it's not recommanded if you want balanced gameplay

• Strange Block : this bloc can teleport players and mobs to the location stored in the StrangeRune used to craft it.

  • Can only be crafted with memory ignited Strange Runes
  • LEFT CLICK the Strange Block to Teleport near entitys...
  • RIGHT CLICK the Strange Block to desactivate it (or change display name color)
  • Sneak to destroy it and drop the rune.

• Piece of Rune : break your StrangeRune into several pieces to use in potions

  • can be obtained by using a memory ignited Strange Runes, a Death Rune or a Bed Rune...

• Spawn Rune : this craft ignite the rune memory with the current world spawn location.

  • Can only be crafted with a clean Strange Rune (no memory)

• Rune potion : using an Awkward Potion as base and "piece of rune" as ingredient, this potion Teleport the player to the "piece of rune" location used to craft the potion.

• Splash Rune potion : Teleport Dudes near impact ...[optional] create cloud portal to go back

• Persistent splash potion : Teleport Dudes in the cloud area...[optional] create cloud portal to go back

• Strange Arrow : Teleport Dudes near impact ...

• Death Rune : return to your last death location.

  • click a strangebloc with a death rune in hand to teleport to your last death location
  • cannot be used to craft a StrangeBlock or else

• Bed Rune : return to your respawn location.

  • click a strangebloc with a Bed Rune in hand to teleport to your respawn location
  • cannot be used to craft a StrangeBlock or else

• Chest Rune : Can store items stacks in its memory.

  • store chest(and more) content to the RuneChest memory : SNEAK + RIGHT CLIC
  • drop the RuneChest content into a chest : LEFT CLIC on chest
  • Browse RuneChest memory (virtual chest) : SNEAK + CLIC (a bloc other than a chest)
  • interract with Runechest content (need permission)
  • can be used like a personal Teleport Hub, you can use instant teleportation with StrangeRunes stored in (SHIFT + RIGHT CLIC), need the permission telecraft.player.chestrune.tp: true (false by default)
  • cannot be stored in a shulker box
  • cannot be stored in a CHEST RUNE
  • cannot be stored in custom plugin virtual chest like backpacks. (can be disabled at your own risk in config)
  • respect protections (LWC,etc...)

• Voodoo Doll : teleport to the linked entity

  • right click an entity to link the doll
  • left click a strangebloc with a Voodoo Doll in hand to teleport to the linked entity location.
  • Right click a Strangebolock to link it to the entity, so you can use the strange block to teleport to entity after without using the voodoo Doll, right click again (the voodoo doll need to have the same entity linked) to remove the link and use the strange block like before
  • cannot be used to craft a StrangeBlock or else

nb : when enabling Chestrune you have to be carefull with other plugins that add backpack like items, storing content that store content can result in a too big inventory an crash the player data file...

features :

• Craftable items, no commands to teleport
• Teleport players or mobs.
• multi-world.
• respect protected areas.
• support custom name using anvil and display it as Hologram on placed strangeblock
• StrangeBlock can be desactivated by owner.
• redstone support for StrangeBlocks (experimental / optional)
• configurable options and permissions to adjust to your server.
• temporary portal to teleport back (potions and strange blocks)
• no database (just a backup file used for strangeRunes verification on startup).
• Non-destructive, if you disable the plugin the strangeblocks items will despaw normally, if you subsequently reactivate the plugin the Strangeblocks will be reactivated.

Configuration :

you can configure the name of the items / blocks , plugins messages and some options in configuration file :

ATR_RuneMaterial: EMERALD
-> permit change base rune material
ATR_TeleportDelay_PLAYER: 200 
-> time for a player to wait before teleport again
ATR_TeleportDelay_ENTITY: 200 
-> time for a entity (not player) to wait before teleport again
ATR_TeleportDelay_REDSTONE: 80 
-> Threshold beetween redstone activation
ATR_TeleportMobs: true 
-> allow mobs to teleport
ATR_Teleport_Radius: 2  
-> area around the teleporter
ATR_Teleport_ProtectedArea: true 
-> check if rune can store location in memory in area not owned by the current player
ATR_SafeTeleport_MaxBlockCheck: 100
-> max bloc to check before stop an hope to find a safe place
ATR_EnableRuneOnBlock: true
-> allow to use coordinates saved in a Strange Rune on a Strange Block
ATR_AllowRuneCoordChange: true
-> allow to change saved coordinate by another without the need to clear it using soulsand craft
ATR_EnableDeathRune: false
-> true to enable DeathRune
ATR_EnableBedRune: false
-> true to enable BedRune
ATR_EnableChestRune: true
-> false to disable ChestRune
ATR_ChestRune_AllowCustomInventory: false
-> true to allow chestrune in custom inventory like backpack, be carefull you can break your player data doing that (too large packet with lot of items)
ATR_ChestRuneSize: 54
-> size of the chestRune memory must be multiple of 9 and max is 54
ATR_SplashPotion_Radius: 1 
-> area affected by the splash potion
ATR_Arrow_Radius: 0 
-> area affected around the arrow
ATR_Arrow_Dammages: false 
-> Does arrow dammage or not
ATR_SplashPotion_ProtectedArea: true 
-> stop the use of splash potion in protected area
ATR_CostToUse: true 
-> enable a price to pay for use this strange thing
ATR_CostToUseType: HUNGER 
-> cost type can be HUNGER / EXP / LIFE (but no money please)
ATR_CostToUseAmount: 3 
-> the price to pay for use this strange thing
ATR_StrangeBlocDropAmount: 8 
-> number of Obsidian dropped when breaking a StrangeBlock
ATR_StrangeBlocRedstone: true 
-> enable redstone on StrangeBlock (BE CAREFULL CAN BE LOUD FOR CPU !)
ATR_StrangeBlocRedstoneCost: false 
-> enable cost to use for player when teleport on redstone activated StrangeBlocks
ATR_StrangeBlocRedstoneReverseThreshold: true 
-> reverse the base teleport process ( 1.  Threshold  2. teleport -> 1.teleport 2. Threshold )
ATR_DisableStBlocksound: false
-> disable sound during strangeBlock teleport routine
ATR_DisableStStrikeFX: false
-> disable thunder strike on teleport
ATR_TpOnlyActivator: false
-> disable tp of nearest entity
ATR_PreventProtectedMobTP: false
-> disable tp of nearest entity not mounted by player on protected area
ATR_EnablePotionReturnCloud_LINGERING : true
-> create a temporary return portal on destination
ATR_EnablePotionReturnCloud_SPLASH : false
-> create a temporary return portal on destination
ATR_EnablePotionReturnCloud_STRANGEBLOCK : true
-> create a temporary return portal on destination
ATR_EnablePotionReturnCloud_STRANGERUNE : false
-> create a temporary return portal on destination
ATR_PotionCloud_DURATION : 6000
-> duration of the cloud(return portal) generated by LINGERING potion event
ATR_allowedWorld: []
-> you can access only world listed in this section
ATR_forbiddenWorld: []
-> you can't access world listed in this section
ATR_StrangeRuneCustomRecipe: false
-> enable custom recipe for StrangeRune
ATR_EnableCustomModel: false
-> enable custom model for StrangeRune (need custom datapack)
ATR_CustomModelID: 0
-> enable custom recipe for StrangeRune
ATR_StrangeRuneRecipeShape:
- E
- Y
-> the shape to use (max 3 caracters / line, max lines 3)
ATR_StrangeRuneRecipeIngredients:
  E: EMERALD
  Y: ENDER_EYE
-> ingredients used (1 line for each characters used in previous recipe) 

A StrangeRune custom recipe :

ATR_StrangeRuneCustomRecipe: true
ATR_StrangeRuneRecipeShape:
- GRG
- IEI
- AGA
ATR_StrangeRuneRecipeIngredients:
  E: EMERALD
  G: GOLD_BLOCK
  R: REDSTONE_BLOCK
  I: IRON_BLOCK
  A: AIR

Permissions :

Default permissions are defined for balanced gameplay, but you can change them has you like :

   telecraft.player.*:
      description: basic authorization for the use of the plugin by players
      default: true
      children:
         telecraft.player.rune.*:
            description: authorizes the use of rune
            children:
               telecraft.player.rune.crafts: true
               telecraft.player.rune.use: true
               telecraft.player.rune.teleport: false
               telecraft.player.rune.useonblock: true
               telecraft.player.rune.changecoord: true
         telecraft.player.block.*:
            description: authorizes the use of Strangesblocks
            default: true
            children:
               telecraft.player.block.crafts: true
               telecraft.player.block.place: true
               telecraft.player.block.break: true
               telecraft.player.block.teleport: true
         telecraft.player.potion.*:
            description: authorizes the use of potions
            default: true
            children:
               telecraft.player.potion.use: true
               telecraft.player.potion.teleport: true
         telecraft.player.splashpotion.*:
            description: authorizes the use of splash potions
            default: true
            children:
               telecraft.player.splashpotion.use: true
               telecraft.player.splashpotion.player: true
               telecraft.player.splashpotion.mobs: true
         telecraft.player.arrow.use: true
         telecraft.player.deathrune.use: true
         telecraft.player.bedrune.use: true
         telecraft.player.chestrune.use: true
         telecraft.player.chestrune.inv: false
         telecraft.player.chestrune.tp: false
         telecraft.player.voodoorune.use: false
         telecraft.player.bypass.*:
            description: authorizes bypass world restriction
            default: false
            children:
               telecraft.player.bypass.use: false
               telecraft.player.bypass.tp: false
   telecraft.nocost.*:
      description: cost to pay for teleport
      defaults: op
      children:
         telecraft.nocost.all: true
         telecraft.nocost.creative: true
         telecraft.nocost.redstone: true
   telecraft.admin.*:
      description: remove bad runes
      defaults: op
      children:
         telecraft.admin.clean: true
         telecraft.admin.reload: true
         telecraft.admin.bypass: true