# \ud83c\udfa8 Pedestal Crafting – Ultimate Custom Crafting System<\/p>\n
> Transform your server with stunning visual crafting stations featuring animated holograms, global announcements, and fully customizable displays.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Overview<\/p>\n
**Pedestal Crafting** is a premium Minecraft plugin that revolutionizes custom item creation through beautiful, interactive pedestals. Each pedestal features floating 3D item displays, fully customizable holographic text, and spectacular visual effects that create an immersive crafting experience.<\/p>\n
Perfect for **RPG servers**, **survival economies**, **quest systems**, **player shops**, and **custom progression**!<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
### \ud83c\udfad **Stunning Visual System**
\n– **3D Rotating Items**: Smooth spinning animations above each pedestal
\n– **Holographic Displays**: Crystal-clear floating text showing recipes
\n– **Configurable Colors**: Customize every text color independently
\n – Result item names
\n – Material names
\n – Amount indicators (e.g., “1x”, “2x”)
\n – Uses remaining text
\n – Unbreakable indicators
\n– **Beacon Beams**: Optional colored light beams shooting skyward
\n– **Lightning Effects**: Dramatic strikes when items are crafted
\n– **Custom Name Preservation**: Items with custom colors maintain their formatting<\/p>\n
### \ud83d\udd14 **Global Announcement System** *(NEW!)*
\n– **Server-Wide Alerts**: Broadcast when rare items are crafted
\n– **End Portal Sound**: Epic sound effect heard by all players
\n– **Chat Announcements**: Customizable messages with placeholders
\n– **Privacy Controls**: Show or hide player names in announcements
\n– **Per-Pedestal Toggle**: Enable only for special pedestals
\n– **Fully Configurable**: Customize sound, volume, pitch, and message format<\/p>\n
### \u2699\ufe0f **Advanced Customization**
\n– **Height Controls**: Adjust both item and text heights independently
\n– **Text Positioning**: Fine-tune hologram placement (\u00b10.1 or \u00b10.5 blocks)
\n– **Item Scaling**: Make items larger or smaller (0.5x to 2.0x)
\n– **Rotation Speed**: Control spinning animation speed
\n– **Per-Pedestal Settings**: Each pedestal can override global defaults
\n– **Block Type Selection**: Choose from 100+ Minecraft blocks<\/p>\n
### \ud83c\udfaf **Intuitive Configuration GUI**
\n– **Drag & Drop**: Easy item placement
\n– **Live Preview**: See changes instantly
\n– **Material Slots**: Up to 7 different required materials
\n– **Visual Controls**: Click-based adjustment for all settings
\n– **Material Browser**: Paginated block selection interface
\n– **Real-Time Updates**: Holograms refresh immediately<\/p>\n
### \ud83d\udee1\ufe0f **Protection & Permissions**
\n– **Admin-Only Placement**: Secure pedestal creation
\n– **Break Protection**: Prevents unauthorized removal
\n– **Explosion Protection**: Safeguards against griefing
\n– **Piston Protection**: Blocks mechanical disruption
\n– **Permission System**: Separate controls for admins and users<\/p>\n
### \ud83d\udcbe **Data Management**
\n– **Instant Saving**: Configurations persist immediately
\n– **Async Operations**: Zero lag on save\/load
\n– **Server Restart Safe**: All data preserved
\n– **Chunk-Aware**: Holograms reload properly
\n– **YAML Storage**: Human-readable data files<\/p>\n
—<\/p>\n
## \ud83c\udfae How It Works<\/p>\n
### For Players \ud83d\udc65<\/p>\n
**Step 1: Find a Pedestal**
\nLook for floating items with colorful hologram text above special blocks.<\/p>\n
**Step 2: Read the Recipe**
\n“`
\nDiamond Sword \u2190 Result (WHITE text)
\n3x Diamond \u2190 Materials (1x in GRAY, Diamond in GOLD)
\n2x Stick \u2190 Materials (2x in GRAY, Stick in GOLD)
\n5 uses remaining \u2190 Status (GREEN text)<\/p>\n
\ud83d\udd37 \u2190 Spinning 3D item<\/p>\n
\ud83d\udfe8 \u2190 Pedestal block
\n“`<\/p>\n
**Step 3: Craft!**
\n– Gather the exact materials shown
\n– Right-click the pedestal
\n– Materials consumed, item received instantly!<\/p>\n
—<\/p>\n
### For Admins \ud83d\udc51<\/p>\n
**Quick Setup:**
\n1. `\/pedestal` – Get a pedestal block
\n2. Place it anywhere
\n3. Shift + Right-Click to configure
\n4. Set result item and materials
\n5. Customize appearance and effects
\n6. Save and done!<\/p>\n
**Configuration GUI Features:**
\n– **Result Slot**: Item players receive
\n– **Material Slots (7)**: Items required to craft
\n– **Block Type**: Change pedestal appearance
\n– **Max Uses**: Set durability (or make unbreakable)
\n– **Item Height**: Adjust floating item position
\n– **Text Height**: Control hologram placement
\n– **Item Scale**: Make items bigger\/smaller
\n– **Beacon Beam**: Toggle light beam effect
\n– **Global Announcements**: Enable server-wide alerts<\/p>\n
—<\/p>\n
## \ud83d\udcdd Commands & Permissions<\/p>\n
### Commands
\n| Command | Aliases | Description | Permission |
\n|———|———|————-|————|
\n| `\/pedestal` | `\/ped` | Get a pedestal block | `pedestalcrafting.admin` |<\/p>\n
### Permissions
\n| Permission | Default | Description |
\n|————|———|————-|
\n| `pedestalcrafting.admin` | OP | Create, configure, and manage pedestals |
\n| `pedestalcrafting.use` | Everyone | Use pedestals to craft items |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Hologram Colors *(NEW!)*
\n“`yaml
\nhologram:
\n colors:
\n result-item: WHITE # Top item name
\n material-name: GOLD # Material names
\n material-amount: GRAY # Amount text (1x, 2x, etc.)
\n uses-remaining: GREEN # Uses text
\n unbreakable: GREEN # Unbreakable text
\n“`<\/p>\n
**Available Colors:**
\n`WHITE`, `GRAY`, `DARK_GRAY`, `BLACK`, `RED`, `DARK_RED`, `GOLD`, `YELLOW`, `GREEN`, `DARK_GREEN`, `AQUA`, `DARK_AQUA`, `BLUE`, `DARK_BLUE`, `LIGHT_PURPLE`, `DARK_PURPLE`<\/p>\n
### Global Announcements *(NEW!)*
\n“`yaml
\nglobal-announcements:
\n sound-enabled: true
\n sound: BLOCK_END_PORTAL_SPAWN
\n sound-volume: 1.0
\n sound-pitch: 1.0
\n message-enabled: true
\n message: “&6[Pedestal] &e{player} &ahas crafted &e{item}&a!”
\n show-player: true # Show player name or “Someone”
\n“`<\/p>\n
### Visual Settings
\n“`yaml
\nhologram:
\n height: 1.8 # Text height above pedestal
\n line-spacing: 0.25 # Space between lines
\n always-visible: true # Always show or proximity-based
\n visibility-range: 10 # Range in blocks<\/p>\n
item-display:
\n height: -0.8 # Item position (negative = lower)
\n rotation-enabled: true # Enable spinning
\n rotation-speed: 3.0 # Degrees per tick
\n scale: 1.0 # Size multiplier
\n“`<\/p>\n
### Messages
\n“`yaml
\nmessages:
\n prefix: “&8[&6Pedestal&8]&r ”
\n crafting-success: “&aYou crafted {item}!”
\n insufficient-materials: “&cYou don’t have the required materials!”
\n no-permission: “&cYou don’t have permission to do that.”
\n config-saved: “&aPedestal configuration saved!”
\n pedestal-destroyed: “&eThis pedestal has been used up and destroyed.”
\n not-configured: “&cThis pedestal hasn’t been configured yet!”
\n“`<\/p>\n
### Defaults
\n“`yaml
\ndefaults:
\n max-uses: 10 # Default durability
\n block-type: STONE # Default block
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udca1 Use Cases<\/p>\n
### \ud83c\udff0 RPG Servers
\n– **Quest Rewards**: One-time pedestals for quest completion
\n– **Boss Loot Exchange**: Trade boss drops for unique items
\n– **Class Equipment**: Profession-specific gear vendors
\n– **Skill Unlocks**: Level progression systems<\/p>\n
### \ud83d\udcb0 Economy Servers
\n– **Player Shops**: Beautiful storefront displays
\n– **Currency Exchange**: Token\/coin trading stations
\n– **Bulk Trading**: Resource conversion booths
\n– **Limited Sales**: Timed exclusive items<\/p>\n
### \u2694\ufe0f Survival Servers
\n– **Custom Recipes**: Alternative crafting methods
\n– **Resource Sinks**: Economy balance tools
\n– **Progression Gates**: Tier-based advancement
\n– **Rare Item Sources**: Hard-to-obtain items<\/p>\n
### \ud83c\udfaa Event Servers
\n– **Tournament Rewards**: PvP prize claims
\n– **Seasonal Items**: Holiday-exclusive crafts
\n– **Achievement Rewards**: Milestone celebrations
\n– **Special Events**: Limited-time offerings<\/p>\n
—<\/p>\n
## \ud83c\udfaf Example Configurations<\/p>\n
### 1. Legendary Weapon Shop
\n“`
\nPedestal: Diamond Block + Beacon Beam
\nResult: “\u00a76\u00a7lExcalibur” (Enchanted Diamond Sword)
\nMaterials:
\n – 10x Diamond
\n – 5x Netherite Ingot
\n – 1x Nether Star
\nMax Uses: 10
\nGlobal Announcements: ON
\n“`<\/p>\n
### 2. Currency Exchange
\n“`
\nPedestal: Emerald Block
\nResult: 1x Diamond
\nMaterials:
\n – 100x “\u00a7eServer Coins” (Custom Token)
\nMax Uses: Unbreakable
\nGlobal Announcements: OFF
\n“`<\/p>\n
### 3. Quest Completion Reward
\n“`
\nPedestal: End Stone + Beacon Beam
\nResult: “\u00a75\u00a7lDragon’s Gift” (Shulker Box)
\nMaterials:
\n – 1x Dragon Head
\n – 64x End Stone
\n – 32x Elytra
\nMax Uses: 1 (One-time)
\nGlobal Announcements: ON
\n“`<\/p>\n
### 4. Bulk Resource Trade
\n“`
\nPedestal: Iron Block
\nResult: 64x Arrow
\nMaterials:
\n – 16x Flint
\n – 16x Stick
\n – 16x Feather
\nMax Uses: Unbreakable
\nGlobal Announcements: OFF
\n“`<\/p>\n
—<\/p>\n
## \ud83d\ude80 Advanced Features<\/p>\n
### Per-Pedestal Overrides
\nEach pedestal can independently customize:
\n– \u2705 Item height (overrides config default)
\n– \u2705 Item scale (overrides config default)
\n– \u2705 Text height (overrides config default)
\n– \u2705 Beacon beam (per-pedestal toggle)
\n– \u2705 Global announcements (per-pedestal toggle)<\/p>\n
### Toggle Controls
\nUse **Middle-Click** in the GUI to:
\n– Switch between custom and default values
\n– Quick toggle without manually resetting<\/p>\n
### Height Adjustment
\n**Click Controls:**
\n– Left-Click: +0.1 blocks
\n– Right-Click: -0.1 blocks
\n– Shift+Left: +0.5 blocks
\n– Shift+Right: -0.5 blocks<\/p>\n
### Scale Adjustment
\n**Click Controls:**
\n– Left-Click: +0.1x size
\n– Right-Click: -0.1x size
\n– Shift+Left: +0.5x size
\n– Shift+Right: -0.5x size<\/p>\n
—<\/p>\n
## \ud83d\udd27 Technical Specifications<\/p>\n
### Requirements
\n– **Minecraft**: 1.20.6+ or 1.21.x
\n– **Server**: Paper, Purpur, or Paper-based forks
\n– **Java**: 17 or higher
\n– **API**: Paper API with Adventure text components<\/p>\n
### Performance
\n– **Memory**: <5MB per 100 pedestals\n- **CPU**: <0.1% TPS impact\n- **Storage**: ~1KB per pedestal\n- **Async Operations**: Zero blocking I\/O\n\n### Compatibility\n- \u2705 WorldGuard (respects regions)\n- \u2705 GriefPrevention (respects claims)\n- \u2705 LuckPerms (permission system)\n- \u2705 EssentialsX (no conflicts)\n- \u2705 Vault (economy compatible)\n\n### Data Format\n- **Type**: YAML (human-readable)\n- **Location**: `plugins\/Pedestal-Crafting\/pedestals.yml`\n- **Auto-Save**: On every change\n- **Backup**: Recommended regular backups\n\n---\n\n## \ud83c\udfa8 Why Choose Pedestal Crafting?\n\n### vs. Villagers\n- \u2705 No AI pathfinding issues\n- \u2705 Exact recipe control\n- \u2705 Beautiful visual displays\n- \u2705 No trading mechanics\n\n### vs. Sign Shops\n- \u2705 3D holographic displays\n- \u2705 Animated item models\n- \u2705 No command syntax\n- \u2705 More immersive\n\n### vs. GUI Menus\n- \u2705 In-world presence\n- \u2705 No inventory clutter\n- \u2705 Better for exploration\n- \u2705 More atmospheric\n\n### vs. NPCs\n- \u2705 No complex plugins needed\n- \u2705 Lower resource usage\n- \u2705 Instant interaction\n- \u2705 Easier setup\n\n---\n\n## \ud83d\udcca Feature Comparison\n\n| Feature | Pedestal Crafting | Villagers | Sign Shops | NPCs |\n|---------|------------------|-----------|------------|------|\n| Visual Display | \u2705 3D + Hologram | \u274c | \u274c | \u26a0\ufe0f Basic |\n| Custom Recipes | \u2705 Unlimited | \u274c Limited | \u2705 | \u2705 |\n| Easy Setup | \u2705 GUI | \u274c Complex | \u26a0\ufe0f Commands | \u274c Scripting |\n| Animations | \u2705 Spinning | \u274c | \u274c | \u26a0\ufe0f Some |\n| Global Alerts | \u2705 Built-in | \u274c | \u274c | \u274c |\n| Color Customization | \u2705 Per-element | \u274c | \u26a0\ufe0f Limited | \u26a0\ufe0f Limited |\n| Performance | \u2705 Excellent | \u26a0\ufe0f AI Heavy | \u2705 | \u26a0\ufe0f Variable |\n\n---\n\n## \ud83d\udcac Player Feedback\n\n> “The hologram displays are absolutely stunning! Players love seeing what they can craft from afar.”
\n> \u2014 *SurvivalServer Owner*<\/p>\n
> “Global announcements create excitement when someone crafts legendary items. Great for economy!”
\n> \u2014 *RPG Server Admin*<\/p>\n
> “Setup was incredibly easy. The GUI makes configuration a breeze.”
\n> \u2014 *First-time Server Owner*<\/p>\n
> “The color customization lets me match pedestals to my server’s theme perfectly.”
\n> \u2014 *Network Administrator*<\/p>\n
—<\/p>\n
## \ud83d\udcda Documentation<\/p>\n
### Included Files
\n– `PLUGIN_DESCRIPTION.md` – Complete feature guide (this file)
\n– `README.md` – Quick start guide
\n– `config.yml` – Fully commented configuration
\n– `BUG_FIXES.md` – Troubleshooting guide
\n– `HOLOGRAM_IMPROVEMENTS.md` – Visual system details
\n– `REBUILD_INSTRUCTIONS.md` – Build from source<\/p>\n
### Additional Resources
\n– In-game tooltips
\n– Detailed error messages
\n– Config comments
\n– Permission descriptions<\/p>\n
—<\/p>\n
## \ud83c\udf81 What’s New in v1.0<\/p>\n
### Latest Features
\n– \u2728 **Global Announcements**: Server-wide crafting alerts
\n– \ud83c\udfa8 **Color Customization**: Configure every text color
\n– \ud83d\udccf **Text Height Control**: Adjust hologram positioning
\n– \ud83d\udd14 **Beacon Beams**: Optional visual effects
\n– \u2699\ufe0f **Per-Pedestal Overrides**: Individual customization<\/p>\n
### Recent Improvements
\n– Optimized hologram rendering
\n– Enhanced GUI responsiveness
\n– Improved data persistence
\n– Better error handling
\n– Smoother animations<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Troubleshooting<\/p>\n
### Common Issues<\/p>\n
**Hologram not visible?**
\n– Check `hologram.height` in config
\n– Ensure chunk is loaded
\n– Try breaking and replacing pedestal<\/p>\n
**Can’t craft?**
\n– Verify exact materials in inventory
\n– Check `pedestalcrafting.use` permission
\n– Confirm pedestal is configured<\/p>\n
**GUI won’t open?**
\n– Need `pedestalcrafting.admin` permission
\n– Must Shift + Right-Click
\n– Make sure you’re the pedestal owner\/admin<\/p>\n
**Global announcements not working?**
\n– Enable in pedestal GUI (Bell icon)
\n– Check config `global-announcements.sound-enabled`
\n– Verify `global-announcements.message-enabled`<\/p>\n
—<\/p>\n
## \ud83d\udcde Support<\/p>\n
### Getting Help
\n1. Check included documentation
\n2. Review configuration file comments
\n3. Verify permissions are set correctly
\n4. Test with default configuration
\n5. Check console for error messages<\/p>\n
### Best Practices
\n– Regular data backups
\n– Test configurations before deploying
\n– Use permissions wisely
\n– Monitor server performance
\n– Keep plugin updated<\/p>\n
—<\/p>\n
## \ud83c\udfc6 Conclusion<\/p>\n
**Pedestal Crafting** delivers a professional, polished custom crafting experience that enhances any Minecraft server. With stunning visuals, powerful features, and intuitive controls, it’s the ultimate solution for custom item systems.<\/p>\n
### Key Highlights
\n– \ud83c\udfa8 **Beautiful**: Stunning holograms and animations
\n– \u2699\ufe0f **Powerful**: Extensive customization options
\n– \ud83d\ude80 **Performance**: Optimized for large servers
\n– \ud83d\udc65 **User-Friendly**: Easy for admins and players
\n– \ud83d\udd27 **Flexible**: Adapts to any server type
\n– \ud83d\udca1 **Innovative**: Unique global announcement system<\/p>\n
Transform your server’s crafting experience today! \u2728<\/p>\n
—<\/p>\n
**Pedestal Crafting v1.0**
\n*By Orange*<\/p>\n
*Compatible with Minecraft 1.20.6+ \/ 1.21.x*
\n*Requires Paper or Paper-based server software*<\/p>\n","protected":false},"excerpt":{"rendered":"
Configurable pedestals that allow you to craft custom items.<\/p>\n","protected":false},"featured_media":120159,"template":"","meta":{"_minecraft_slug":"pedestal-crafting","_minecraft_project_id":"eQvQCDTs","_minecraft_author":"0ranges_","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":188,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pedestal-crafting.zip","_minecraft_size_bytes":136678,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:50:14.123612Z","_minecraft_date_created":"2026-02-04T23:57:28.216491Z","_minecraft_date_modified":"2026-02-05T12:10:24.735159Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pedestal-crafting","_minecraft_icon_attachment_id":120159,"_minecraft_imported_at":"2026-06-07T01:44:25+00:00","_minecraft_import_hash":"a7f2e01f7f3a94bdb1602252b868a82a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,156,88,122,866,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-120158","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-decoration","mod_category-equipment","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n