TentSystem

🏠 TentSystem — Portable Dwellings Plugin (Tents & Caravans) TentSystem is an advanced gameplay plugin for Minecraft servers that completely redefines survival, raiding, and player positioning. It allows players to craft, deploy, siege, and carry their own mobile bases (tents, caravans, outposts) right in their pockets.

A player can set up camp anywhere in the world with a single click, instantly teleport to it, and fold the entire structure back into an item when it's time to move. However, these homes are no longer invulnerable: they feature a built-in durability system, meaning they can be besieged, destroyed, or repaired using iron.

🛠 Administrator Guide: Creating Templates via WorldEdit The process of creating new dwelling types is fully integrated with the popular WorldEdit plugin, eliminating the need to manually configure block coordinates in configuration files:

1. Build the Structure: Build a tent, caravan, or tactical outpost directly in-game.

2. Select the Region: Select your build using the WorldEdit wooden wand (//wand).

3. Set the Center Point: Stand exactly where you want the player to land when teleporting (or at the center of the future foundation) and type the save command:

/tent save <template_name>

The plugin will automatically copy the blocks within the selection, bind them to the relative coordinates of your current position, and save it as an internal schematic file.

1. Configure Durability: You can set individual "health" (HP) values for each template in the config.yml file:

tents:
  kibitka_medium:
    max-durability: 500  # The maximum durability of the dwelling
    repair-material: IRON_INGOT # The material required for repairs
    repair-amount: 25   # How much durability one iron ingot restores

1. Bind CustomModelData: Assign a unique model ID to the template in the config. This allows a standard Minecraft item to turn into a beautiful 3D weapon/item model of a tent in the player's hands via your server's resource pack.

🎒 Player Mechanics: Management, Sieges, and Repairs 🚀 1. Deploying the Dwelling How to place: Hold the item with the 3D tent model in your hand and Right-Click (RMB) on the ground.

What happens: The item is consumed from your inventory, and a complete structure instantly generates on the spot. Simultaneously, the entire building is automatically protected by a private region assigned to the owner's UUID.

⚔️ 2. Durability and Raiding (Siege System) Every deployed dwelling has its own durability pool specified in the configuration.

How to destroy: Enemy players can attack the structure (damage mechanics are fully customizable, such as hitting the central control block with weapons or using TNT/artillery explosions).

What happens: Taking damage lowers the home's durability. If the durability drops to 0, the dwelling is completely demolished, the protection claim vanishes, and all chests and resources inside become fair game for the attackers.

🛠️ 3. Repairing the Dwelling The owner (or players with trusted access) can restore their shelter's durability after a rough siege or general wear and tear.

How to repair: Approach the central control block inside the house with iron ingots in your inventory and type /tent repair (or click the control block with an iron ingot). Each ingot restores a fixed amount of durability specified in the config.

📦 4. Packing Up (Folding the House) How to retrieve: Approach the central control block inside the house, hold Shift (Crouch) + Left-Click (LMB).

Condition: You can only pack up the dwelling if you are the rightful owner and its durability is at maximum health (or above a specific threshold). Once packed, the structure vanishes from the world, and the deployment item is returned to your inventory.

🛡 Security and Anti-Griefing Protection The plugin features an intelligent validation system to prevent any attempts to grief the world map or exploit claims:

Overlap Check: The dwelling will only deploy if there is enough space in the chosen location. If the structure's blueprint overlaps with another player's claim (WorldGuard / Towny / custom regions) or solid terrain (mountains, existing buildings, trees), the plugin will block the installation and display an error.

Foliage Bypass: To save players from manually clearing fields, the plugin ignores grass, ferns, and tall grass. When generating the house, these blocks are simply overwritten by the structure's blocks.

Smart Teleportation (/tent tp): When teleporting to a dwelling, the plugin calculates coordinates precisely to the center of a safe block, eliminating suffocation damage or getting stuck inside walls.