Builder Shopv1.1.5
Pythonby TheNINJALLOAn Endstone plugin that allows players to get building materials from NPCs.
pip install https://github.com/TheNINJALLO/endstone-builder-shop/releases/download/v1.1.5/endstone_builder_shop-1.1.5-py3-none-any.whl- Stars
- 1
PLUGINSBUILDER SHOP
# Install
Use the animation for reference. Follow the plugin's README for exact steps.
# README
Overview
An Endstone plugin that allows players to get building materials from NPCs. This release is aligned with Endstone 0.11.14 and Minecraft Bedrock Dedicated Server 1.26.52.3, and is distributed as a Python wheel for direct installation in an Endstone server.
What it does
- Opens a category-based building-material catalog when a player interacts with a tagged NPC.
- Supplies obtainable blocks in sensible stack sizes without requiring individual shop commands.
- Supports multiple shop NPCs and runtime configuration reloads.
How to use
- Spawn an NPC and tag it with
/tag @e[type=npc,c=1] add builder. - Interact with the NPC to verify that the category menu opens and items can be selected.
- After changing the generated shop configuration, run
/buildershop reloadas an operator.
Commands and permissions
| Command / usage | What it does | Access |
|---|---|---|
/buildershop reload | Builder Shop commands | buildershop.admin |
Compatibility
| Component | Supported version |
|---|---|
| Endstone | 0.11.14 |
| Endstone API | 0.11 |
| Bedrock Dedicated Server | 1.26.52.3 |
| Python | >=3.11 |
| Plugin release | v1.1.5 |
Install
Download the wheel from the matching GitHub release:
gh release download v1.1.5 --repo TheNINJALLO/endstone-builder-shop --pattern "*.whl"Copy the downloaded wheel into the server's plugins/ directory, remove any older wheel for the same plugin, and restart Endstone.
Important
Use Endstone 0.11.14 with BDS 1.26.52.3. Back up worlds and plugin data before upgrading a production server.
Configuration and secrets
Runtime databases, logs, local .env files, server directories, and root config.toml files are excluded from source releases. When an example configuration is provided, copy it locally and keep live tokens, passwords, webhook URLs, and server identifiers out of Git.
Release automation
Every v* tag runs the wheel release workflow, builds the package in a clean GitHub runner, stores the wheel as a workflow artifact, and attaches it to the matching GitHub release.
Project guide
An Endstone plugin that provides access to every obtainable item in Minecraft through NPCs tagged as "builder".
Features
- Complete Item Collection: Access to 900+ items across 40+ categories
- NPC Interaction: Players can interact with any NPC that has the
builderscoreboard tag - Organized Categories: Items are logically grouped for easy browsing:
- Building blocks (stone, wood, variants)
- Stairs, slabs, walls, fences
- Decorative blocks
- Ores & minerals
- All copper variants
- Glass, terracotta, concrete, wool (all colors)
- Redstone components
- Plants & crops
- Food items
- Raw materials & crafting items
- Music discs
- Dyes (all colors)
- Pottery shards & smithing templates
- Spawn eggs (all mobs)
- Coral & ocean blocks
- Sculk blocks
- And much more!
- Smart Quantities: Automatically gives appropriate amounts:
- 128 for most stackable items
- 16 for items with smaller stack sizes (buckets, signs, etc.)
- 1 for unique items (elytra, music discs, etc.)
- User-Friendly Interface: Clean form-based UI with easy navigation
What's Included
✅ Every block and item you can normally obtain, including:
- All building blocks and variants
- All decorative blocks
- All functional blocks
- All food items
- All crafting materials
- All mob drops
- All spawn eggs
- All music discs
- All pottery shards and armor trims
- All dyes and colored items
- Coral, sculk, and special blocks
❌ Excluded items (as requested):
- Tools (pickaxes, axes, shovels, hoes)
- Armor (helmets, chestplates, leggings, boots)
- Weapons (swords, bows, crossbows, tridents)
- Arrows and tipped arrows
- Potions, splash potions, lingering potions
- Enchanted books
- Shulker boxes (all colors)
- Bedrock
- Command blocks and structure blocks
- Other creative/give-only items
Installation
- Ensure you have Endstone 0.11.9 or higher installed
- Copy the plugin files to your plugins directory with this structure:
plugins/ └── endstone-builder-shop/ ├── pyproject.toml └── src/ └── endstone_builder_shop/ ├── __init__.py └── builder_shop.py - Install the plugin using pip in your Endstone environment:
pip install -e path/to/endstone-builder-shop - Restart your server
Usage
For Players
- Find an NPC with the
buildertag - Right-click (or interact with) the NPC
- Browse through 40+ categories
- Click on any item to receive it instantly
- Navigate back to choose more items
For Administrators
Creating a Builder NPC
- Spawn an NPC in your world
- Add the "builder" tag to the NPC using:
/tag @e[type=npc,c=1] add builder - Players can now interact with this NPC to access the complete item shop
Removing the Builder Tag
/tag @e[type=npc,tag=builder] remove builderMultiple Shop NPCs
You can create multiple builder NPCs throughout your world. All NPCs with the builder tag will open the same shop interface.
Item Categories
The plugin organizes items into these categories:
- Stone & Rock Blocks - All stone variants, deepslate, granite, etc.
- Wood Blocks & Logs - All wood types, logs, planks, stems
- Stone Stairs - All stone stair variants
- Wood Stairs - All wood stair variants
- Stone Slabs - All stone slab variants
- Wood Slabs - All wood slab variants
- Walls - All wall types
- Fences & Gates - All fence and gate variants
- Nether Blocks - Netherrack, soul sand, basalt, blackstone, etc.
- End Blocks - End stone, purpur, chorus
- Ores & Minerals - All ores and mineral blocks
- Copper Blocks - All copper variants including weathered and waxed
- Decoration Blocks - Bricks, prismarine, quartz, etc.
- Glass & Stained Glass - All glass colors and panes
- Terracotta - All terracotta colors and glazed variants
- Concrete & Powder - All concrete colors
- Wool - All wool colors
- Carpet - All carpet colors
- Sand & Sandstone - Sand, sandstone variants
- Soil & Nature - Dirt, grass, snow, ice
- Doors & Trapdoors - All door and trapdoor types
- Lighting - Torches, lanterns, glowstone, etc.
- Redstone Components - All redstone items
- Rails - All rail types
- Plants & Crops - Saplings, flowers, crops, fungi
- Functional Blocks - Crafting tables, furnaces, etc.
- Storage & Utility - Chests, barrels, hoppers
- Banners - All banner colors
- Beds - All bed colors
- Candles - All candle colors
- Mob Heads - Skeleton, zombie, creeper, etc.
- Misc Decorations - Paintings, item frames, signs
- Food Items - All food types
- Raw Materials - Ingots, gems, crafting materials
- Music Discs - All music discs
- Dyes - All 16 dye colors
- Pottery & Smithing - Pottery shards, armor trims
- Mob Drops - Common mob drops
- Spawn Eggs - All mob spawn eggs
- Misc Items - Elytra, totems, fireworks, etc.
- Coral & Ocean - All coral types and ocean items
- Sculk Blocks - Sculk variants
Smart Stack Sizes
The plugin intelligently determines stack sizes:
- 128: Most blocks and stackable items
- 16: Buckets, signs, banners, eggs, boats, minecarts, stews
- 1: Unique items (elytra, totem, music discs, dragon egg, nether star)
Requirements
- Endstone >= 0.11.9
- Python >= 3.9
- Bedrock Dedicated Server compatible with Endstone
Development
Project Structure
endstone-builder-shop/
├── pyproject.toml # Project configuration
├── README.md # This file
└── src/
└── endstone_builder_shop/
├── __init__.py # Package initialization
└── builder_shop.py # Main plugin code (900+ items!)API Version
This plugin uses Endstone API version 0.11
Customization
Adding or Removing Items
The plugin now uses a configuration file for easy customization! After the first run, a config.toml file will be created in the plugin's data folder.
Location: The config file will be created in the plugin's data folder (typically plugins/builder-shop/config.toml or similar, depending on your Endstone setup)
To add or remove items:
- Edit the
config.tomlfile in the plugin's data folder - Add new categories or modify existing ones
- Use
/buildershop reloadin-game to apply changes without restarting
Item Format:
- Simple items:
"item_id"(e.g.,"stone","dirt") - Items with data values:
"item_id:data_value"(e.g.,"wool:14"for red wool,"bed:0"for white bed)
Example:
[categories."My Custom Category"]
items = [
"diamond",
"emerald",
"wool:14", # Red Wool
"bed:0" # White Bed
]Color Data Values (for wool, carpet, terracotta, concrete, glass, beds, banners):
- 0 = White, 1 = Orange, 2 = Magenta, 3 = Light Blue
- 4 = Yellow, 5 = Lime, 6 = Pink, 7 = Gray
- 8 = Light Gray, 9 = Cyan, 10 = Purple, 11 = Blue
- 12 = Brown, 13 = Green, 14 = Red, 15 = Black
Note: Banners use inverted color order (0=Black, 15=White)
Reload Configuration
Use the /buildershop reload command to reload the configuration without restarting the server:
- Permission:
buildershop.admin(operator by default) - Usage:
/buildershop reload
Changing Stack Sizes
Stack sizes are automatically determined based on item names:
- 128: Most blocks and stackable items (default)
- 16: Items containing: bucket, sign, banner, egg, boat, minecart, stew, soup
- 1: Items containing: bed, cake, armor_stand, painting, item_frame, saddle, totem, elytra, music_disc, or specific items like dragon_egg, nether_star, end_crystal
Performance
Despite containing 900+ items, the plugin is highly performant:
- Items are organized into categories (only 40+ buttons on main menu)
- Each category typically has 10-50 items
- Forms load instantly
- No database or file I/O required
License
This plugin is open source. Feel free to modify and distribute.
Support
For issues, questions, or contributions, please refer to your server's plugin documentation.
Changelog
Version 1.1.2
- FIXED: Proper Bedrock Edition 1.21.123 item ID format with data values
- UPDATED: Colored items (wool, beds, banners, terracotta, concrete, glass) now use correct
item:dataformat - IMPROVED: Display names now show proper colors (e.g., "Red Wool", "White Bed")
- VERIFIED: All item IDs match official Bedrock Edition data values
- Banners correctly use inverted color order (0=Black, 15=White)
- Terracotta uses
stained_hardened_clay:dataformat - Concrete powder uses
concretePowder:dataformat
Version 1.1.0
- NEW: Configuration file system - items now stored in
config.toml - NEW:
/buildershop reloadcommand to reload config without server restart - NEW: Easy customization - add/remove items and categories via config file
- Improved plugin architecture with dynamic config loading
- Better error handling and logging
Version 1.0.0
- Initial release
- 900+ items across 40+ categories
- Smart stack size detection
- Interactive form-based UI
- Complete Minecraft item coverage (excluding tools, armor, arrows, potions, enchanted books, bedrock, and give-only items)
- NPC tag-based activation
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.