Advanced CarryOn

Advanced CarryOn is a Paper/Spigot plugin that lets players pick up and carry mobs and blocks (including tile entities like chests, furnaces, and more) on their head. Carried items persist across logout/login and are fully configurable.

Inspired by the mod Carry On.

---

Features

• Carry Mobs — Pick up whitelisted mobs and carry them on your head. Place them on the ground or stack them on top of other mobs.
• Carry Blocks — Pick up whitelisted blocks (including tile entities with their contents preserved) and place them elsewhere.
• Tile Entity Support — Chests, barrels, shulker boxes, furnaces, etc. keep their inventory and data when carried and placed.
• Mob Stacking — Optionally stack multiple mobs on top of each other.
• Persistent Carry — Carried blocks and mobs are saved on logout and restored on login.
• Smooth Block Visuals — Carried blocks render on the player's head with configurable position, scale, and rotation that always faces forward.
• Toggle Messages — Players can enable/disable pickup and place messages per player with /carryon messages.
• Fully Configurable — Whitelists, sounds, messages, visuals, and more.

---

Commands

Command	Description	Permission
/carryon reload	Reloads the configuration file	carryon.reload
/carryon messages [on/off]	Toggles pickup/place messages on or off (supports explicit on/off)	carryon.use

Tab completion is supported — type /carryon and press Tab to see available subcommands.

---

Permissions

Permission	Description	Default
carryon.use	Allows using the carry mechanics (picking up and placing blocks/mobs) and /carryon messages	true (everyone)
carryon.reload	Allows using /carryon reload	op
carryon.command	Allows using the /carryon base command	op

---

How to Use

Picking up Mobs

• Sneak + Right-Click (with an empty hand) on a whitelisted mob to pick it up.
• Right-click on the ground to place it down.
• Right-click on another mob to stack it on top (if mob stacking is enabled).

Picking up Blocks

• Sneak + Right-Click (with an empty hand) on a whitelisted block to pick it up.
• Right-click on a block face to place it down.
• The block's inventory (chest contents, etc.) is preserved.

Dropping

• Carried items are saved when you log out and restored when you log back in.

---

Default Configuration

# Advanced CarryOn Configuration
# Version: 1.0

# General Settings
pickup-distance: 2.0
sneak-to-pickup: true
show-messages: true
blacklisted-worlds:
  - "example_world_nether"

# Visuals
visuals:
  block-scale: 0.6
  block-offset-x: -0.30
  block-offset-y: -1.76
  block-offset-z: -0.29
  viewer-head-offset: 0.0

# Mob Stacking allows you to carry multiple mobs on top of each other.
mob-stacking:
  enabled: true

# Which entities can be picked up?
allowed-entities:
  - VILLAGER
  - COW
  - SHEEP
  - PIG
  - CHICKEN
  - WOLF
  - CAT
  - OCELOT
  - FOX
  - HORSE
  - DONKEY
  - MULE
  - LLAMA

# Which blocks can be picked up?
allowed-blocks:
  - CHEST
  - BARREL
  - ENDER_CHEST
  - SHULKER_BOX
  - FURNACE
  - SMOKER
  - BLAST_FURNACE
  - CRAFTING_TABLE
  - BOOKSHELF
  - ANVIL

# Sounds (use standard Minecraft sound names)
sounds:
  pickup: ENTITY_ITEM_PICKUP
  place: BLOCK_GRAVEL_PLACE
  volume: 1.0
  pitch: 1.0

# Messages (supports color codes like &a, &c, &6 etc.)
messages:
  prefix: "&8[&6Advanced CarryOn&8] &7"
  pickup-success: "&aPicked up &e%target%&a."
  place-success: "&aPlaced &e%target%&a."
  stack-success: "&aStacked &e%target%&a on top."
  stack-full: "&cCannot stack more mobs."
  cannot-carry-stack: "&cYou cannot pick up stacked mobs."
  reload-success: "&aConfiguration reloaded successfully."
  no-permission: "&cYou do not have permission to do this."
  world-blacklisted: "&cYou cannot use CarryOn in this world."
  messages-enabled: "&aMessages activated."
  messages-disabled: "&cMessages deactivated."
  carry-blocked: "&cYou are currently carrying something."