# LodeItems

> Custom items, blocks and furniture for Paper servers, defined in YAML with their textures and models right beside them.

- [Introduction](https://items.lodemc.net/index.md): Custom items, blocks and props for Paper, written in YAML with their textures right beside them.
- [Installation](https://items.lodemc.net/installation.md): Put Lode Items on your server and check that the pack reaches players.
- [How content works](https://items.lodemc.net/basics.md): Ids, folders, file paths, text formatting and reloading. The rules every page of these docs builds on.
- [Items](https://items.lodemc.net/items.md): Make a custom item, then give it stats, food, cooldowns and any vanilla data component.
- [Item mechanics](https://items.lodemc.net/item-mechanics.md): Backpacks, hammers, auto-smelting, harvesting, soulbound items and other special behaviour.
- [Armour](https://items.lodemc.net/armor.md): Custom worn textures for armour, elytra and mob armour, plus effects and full-set bonuses.
- [3D armour](https://items.lodemc.net/armor/3d.md): Armour worn in full 3D from a Blockbench model, with shader-pack support and a flat fallback.
- [Events and actions](https://items.lodemc.net/events.md): Run commands, messages, effects and sounds when an item, block or prop is used.
- [Recipes](https://items.lodemc.net/recipes.md): Crafting, smelting, stonecutting, smithing and brewing recipes for your items.
- [Blocks](https://items.lodemc.net/blocks.md): Full blocks, logs, see-through and walk-through blocks, stairs, slabs, trapdoors and doors.
- [Mining, drops and behaviour](https://items.lodemc.net/blocks/mining-and-drops.md): Hardness, tools, drops, light, sounds, tags and stripping.
- [Looks and rotation](https://items.lodemc.net/blocks/looks.md): One texture, a texture per face, or a model, and blocks that turn like logs or furnaces.
- [Connected textures](https://items.lodemc.net/blocks/connected-textures.md): Blocks that join into one surface with their neighbours, like big windows or tiled floors.
- [Stairs, slabs, trapdoors and doors](https://items.lodemc.net/blocks/shapes.md): Blocks that work exactly like vanilla stairs, slabs, trapdoors and doors.
- [World generation](https://items.lodemc.net/blocks/world-generation.md): Ores that generate in veins in new chunks, shaped like vanilla's.
- [Fluids](https://items.lodemc.net/fluids.md): Custom liquids that flow and swim like water, with their own colour, look, light, effects and bucket.
- [Elements](https://items.lodemc.net/elements.md): Models you place in the world: props today, flora next.
- [Props](https://items.lodemc.net/furniture.md): Chairs, tables, lamps, beds, storage, doors, sofas that join up, growing plants and more.
- [Placing and turning](https://items.lodemc.net/props/placement.md): Where a prop can go, how it turns, placement rules and the placement hologram.
- [How it looks](https://items.lodemc.net/props/looks.md): Scale, offset, brightness, glow, shadows and dyeing.
- [Prop hitboxes](https://items.lodemc.net/furniture-hitboxes.md): What players bump into and click on. Worked out from the model by default, or written by hand.
- [Seats and beds](https://items.lodemc.net/props/seats-and-beds.md): Chairs and benches players sit on, and beds that skip the night.
- [Storage](https://items.lodemc.net/props/storage.md): Chests, wardrobes, personal lockers, ender chests and bins.
- [Light](https://items.lodemc.net/props/light.md): Lamps and lights that can be switched on and off.
- [Doors and states](https://items.lodemc.net/props/doors-and-states.md): Doors that swing or slide, and props that switch between looks.
- [Sofas that join up](https://items.lodemc.net/props/connecting.md): Pieces that change shape to match their neighbours, like stairs.
- [Growing plants](https://items.lodemc.net/props/growing.md): Props that grow into other props over time.
- [Text and music](https://items.lodemc.net/props/text-and-music.md): Signs with text lines, and props that play music discs.
- [Breaking, drops and sounds](https://items.lodemc.net/props/breaking-and-drops.md): How many hits a prop takes, what it drops and the sounds it makes.
- [Flora](https://items.lodemc.net/flora.md): Grass, flowers and crops as elements.
- [Glyphs and emojis](https://items.lodemc.net/glyphs.md): Pictures that work as characters in chat, names, lore, signs, books and menus. Animated ones too.
- [HUDs](https://items.lodemc.net/huds.md): Text and glyphs that stay on screen, above the hotbar.
- [Sounds and music discs](https://items.lodemc.net/sounds.md): Add your own .ogg sounds and turn them into music disc songs.
- [Paintings](https://items.lodemc.net/paintings.md): Add your own paintings, placeable from the painting item or a custom one.
- [Translations and dialogs](https://items.lodemc.net/translations-and-dialogs.md): Show text in each player's own language, and open dialog screens.
- [Resource pack](https://items.lodemc.net/resource-pack.md): How Lode Items builds the pack and gets it to players: built-in hosting, your own URL, S3, merging and optional packs.
- [config.yml](https://items.lodemc.net/configuration.md): Every setting in plugins/LodeItems/config.yml.
- [Commands and permissions](https://items.lodemc.net/commands.md): Every Lode Items command, and who can use it.
- [Integrations](https://items.lodemc.net/integrations.md): LodeEntities, protection plugins, WorldEdit, MythicMobs, ModelEngine, PlaceholderAPI and Geyser.
- [Importing from Nexo and ItemsAdder](https://items.lodemc.net/importing.md): Convert your existing Nexo or ItemsAdder configs and packs with one command.
- [Bedrock (Geyser)](https://items.lodemc.net/bedrock.md): Let Bedrock players joining through Geyser see your items, blocks, props, armour, sounds and glyphs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.