跳到正文
返回搜索

LiftOff

作者 MiracleForest

Pick up chests, blocks and mobs in Minecraft Bedrock Edition and carry them in your arms

0.1.0

README0.1.0

LiftOff

Build License: LGPL-3.0-only

Pick up chests, blocks and mobs and carry them in your arms. LiftOff is a LeviLamina mod for Minecraft Bedrock Edition that works on dedicated servers and in single-player worlds.

How to play

  • Pick up: with both hands empty, hold the Carry key (default Left Shift; on a vanilla client: sneak) and use (right-click) a block that has contents, such as a chest, or a mob. You carry it in both arms and walk slower, the heavier the load. Players can be carried too.
  • Put down: use a block while carrying. Blocks keep their contents; mobs keep their name, health and data.
  • Stack: use a mob while carrying a mob to put it on top.
  • While carrying you cannot switch the hotbar slot, use items, open containers, break blocks or attack.

Servers can choose what may be carried (black/whitelists, scripts, custom pickup conditions); see docs/SPEC.md for the complete behaviour.

Players without the client mod can still pick up and put down everything. They see the arm pose and a stand-in of the carried block or mob (a carried chest shows no block), but no first-person view of the load.

Known limitations

  • In first person a carried mob is a client-side stand-in of its type: its variant, colours, age, saddle, chest, shorn wool, armour and held items come from the carried data. Its size comes from the mob your client saw picked up, another mob of that kind it has seen, or a table of vanilla mob sizes (a modded mob of a kind the client has never seen is sized as one block). An armour stand (blacklisted by default) is not drawn in first person.
  • Players without the client mod may briefly see the hotbar slot change or the block-breaking crack while carrying.

Install

You need Minecraft Bedrock Edition for Windows (x64) with LeviLamina (on a client, installed through LeviLauncher). A LiftOff release is built against each LeviLamina line it supports, for the dedicated server and for the client, and you pick the one that matches your game:

MinecraftLeviLaminaVariantServer downloadClient download
1.26.6026.60.x26_60, and the defaultliftoff-server-win-x64-ll26.60.zipliftoff-client-win-x64-ll26.60.zip
1.26.5126.51.x26_51liftoff-server-win-x64-ll26.51.zipliftoff-client-win-x64-ll26.51.zip

On a client, install LiftOff from the LeviMC Mods page of LeviLauncher; it offers the variants above, and the default is the newest line.

With lip 0.40.0 or later, on a dedicated server or a client (lip picks the build for the side of the folder you install into):

lip install github.com/MiracleForest/LiftOff#26_60
lip install github.com/MiracleForest/LiftOff#26_51   # to stay on Minecraft 1.26.51

Each variant is a package of its own to lip: to switch, uninstall the one you have first (your configuration is kept).

lip install github.com/MiracleForest/LiftOff, the default variant, is the newest line too.

Or download the zip for your side and line from the latest release and extract it into a LiftOff folder, next to LeviLamina/, so that LiftOff/manifest.json exists:

WhereFolder
Dedicated server, LeviLamina 26.60mods/LiftOff/
Dedicated server, LeviLamina 26.51plugins/LiftOff/
Client (LeviLauncher)mods/LiftOff/

Commands

CommandWhoWhat it does
/liftoff debugEveryoneShows what you carry (block, state, NBT / entity, name, NBT).
/liftoff clearEveryoneDeletes what you carry without placing it.
/liftoff clear <targets>OperatorsDeletes what the targets carry.
/liftoff place [targets]OperatorsPuts down what you / the targets carry, at the nearest free spot.
/liftoff reloadOperators, consoleReloads the configuration and translations.
/liftoff selftest ["glob"]Operators, consoleRuns the in-game selftests.

Configuration

Settings live in config/*.json inside the mod folder (mods/LiftOff/, or plugins/LiftOff/ on a LeviLamina 26.51 server). Each file is created with defaults on first start; /liftoff reload applies changes. On a server, a client with the mod applies changes to its own liftoff_client.json by itself within about a second.

FileSettingDefaultMeaning
mod.jsonlanguageen_USLanguage of server messages when a player's own language has no translation.
usePlayerLocaletrueUse each player's game language when a translation exists.
requireResourcePacktrueDedicated server: players must accept the resource pack to join.
liftoff.jsonsettings.maxDistance2.5How far away (blocks) something can be picked up.
settings.scaleDistancetrueScale the distance with the reach (longer in creative).
settings.maxEntityWidth / maxEntityHeight1.5 / 2.5Largest mob that can be picked up in survival.
settings.relativePlayerScaletrueMob sizes relative to the carrier's size.
settings.heavyTiles / heavyEntitiestrueHeavier blocks (more contents) and bigger mobs slow you down more.
settings.blockSlownessMultiplier / entitySlownessMultiplier1.0Scale the slowness.
settings.slownessInCreativetrueSlow down creative players too.
settings.pickupAllBlocksfalseAllow blocks without contents (stone, ...).
settings.pickupUnbreakableBlocksfalseAllow unbreakable blocks in survival.
settings.pickupHostileMobsfalseAllow monsters in survival.
settings.allowBabiesfalseBaby mobs ignore the entity lists.
settings.pickupPlayerstrueAllow carrying players.
settings.stackableEntitiestrueAllow stacking mobs.
settings.maxEntityStackLimit10Highest mob stack.
settings.entitySizeMattersStackingtrueOnly smaller (or equal) mobs go on top.
settings.hitWhileCarryingfalseAllow breaking blocks and attacking while carrying.
settings.dropCarriedWhenHitfalseDrop what you carry when you take damage.
settings.useScriptsfalseEnable scripts (config/scripts/).
settings.useWhitelistBlocks / useWhitelistEntities / useWhitelistStackingfalseUse the whitelists instead of the blacklists.
settings.placementStateExceptions(list)Block states recomputed when a block is put down.
blacklist.forbiddenTiles / forbiddenEntities / forbiddenStacking(lists)What can never be picked up / stacked on.
whitelist.allowedBlocks / allowedEntities / allowedStacking[]What can be, in whitelist mode.
customPickupConditions.customPickupConditionsBlocks / ...Entities[]Pickups that need a stage (player tag liftoff:stage:<name>).
liftoff_client.jsonsettings.facePlayerfalseCarried blocks face you.
settings.rotateEntitiesSidewaysfalseCarried mobs are held sideways.
settings.renderArmstrueShow the arms holding the load.
modelOverrides.modelOverrides(list)Draw some blocks as another block or item.

List entries are ids (minecraft:chest), wildcards (minecraft:*_door), tags (#tag) or ids with states (minecraft:seagrass[sea_grass_type=double_top]).

Contributing

See CONTRIBUTING.md. AGENTS.md is the developer guide.

License

LGPL-3.0-only (with the GPL-3.0 text it builds on). See NOTICE for third-party notices.

安装 LiftOff

运行端
  • 服务端
  • 客户端
平台
  • win-x64

在服务端目录中用 lip 运行:

lip install github.com/MiracleForest/LiftOff@0.1.0

在客户端上,请通过以下方式安装: LeviLauncher

从 GitHub 下载