Pedestal Crafting

插件

· 作者 0ranges_

可配置的展示台,允许你制作自定义物品。

0 本站下载 0 关注 更新于 9 个月前

最新 1.2 · 1.21.11 · Paper

一键开服(送7天)

? Pedestal Crafting - 终极自定义合成系统

通过带有动态全息投影、全局公告和完全可定制显示效果的精美视觉合成台,为您的服务器带来全新面貌。


? 概述

Pedestal Crafting 是一款高级 Minecraft 插件,通过美观且交互性强的基座彻底革新了自定义物品的创建方式。每个基座都具备悬浮的 3D 物品展示、完全可定制的全息文本以及壮观的视觉效果,为您打造沉浸式的合成体验。

非常适合 RPG 服务器、生存经济、任务系统、玩家商店 以及 自定义进度系统!


✨ 核心功能

? 惊艳的视觉系统

  • 3D 旋转物品:每个基座上方都有平滑的旋转动画
  • 全息显示:清晰可见的悬浮文本,展示合成配方
  • 可配置颜色:独立自定义每种文本的颜色
    • 结果物品名称
    • 材料名称
    • 数量指示器(例如 "1x"、"2x")
    • 剩余使用次数文本
    • 不可破坏指示器
  • 信标光束:可选的彩色光柱射向天空
  • 闪电效果:合成物品时触发戏剧性的闪电打击
  • 自定义名称保留:带有自定义颜色的物品会保持其格式不变

? 全局公告系统 (新增!)

  • 全服警报:当稀有物品被合成时进行广播
  • 末地传送门音效:所有玩家都能听到的史诗级音效
  • 聊天公告:支持占位符的可定制消息
  • 隐私控制:在公告中显示或隐藏玩家名称
  • 按基座开关:仅对特殊基座启用
  • 完全可配置:自定义声音、音量、音调和消息格式

⚙️ 高级自定义

  • 高度控制:独立调整物品和文本的高度
  • 文本定位:微调全息图位置(±0.1 或 ±0.5 格)
  • 物品缩放:使物品变大或变小(0.5倍至2.0倍)
  • 旋转速度:控制旋转动画的速度
  • 按基座设置:每个基座都可以覆盖全局默认值
  • 方块类型选择:从 100+ 种 Minecraft 方块中选择

? 直观的配置 GUI

  • 拖放操作:轻松放置物品
  • 实时预览:即时查看更改
  • 材料槽位:最多支持 7 种不同的所需材料
  • 可视化控件:基于点击的调整界面
  • 材料浏览器:分页的方块选择界面
  • 实时更新:全息图立即刷新

?️ 保护与权限

  • 仅限管理员放置:确保基座创建的安全性
  • 防破坏保护:防止未经授权的移除
  • 防爆保护:防范恶意破坏
  • 活塞保护:阻止机械干扰
  • 权限系统:为管理员和用户设置独立的控制权限

? 数据管理

  • 即时保存:配置立即持久化
  • 异步操作:保存/加载零延迟
  • 重启安全:所有数据均得到保留
  • 区块感知:全息图正确重新加载
  • YAML 存储:人类可读的数据文件

? 工作原理

对于玩家 ?

步骤 1:寻找基座 寻找带有彩色全息文本的悬浮物品,它们位于特殊方块上方。

步骤 2:阅读配方

Diamond Sword              ← 结果(白色文字)
3x Diamond                 ← 材料(1x 为灰色,Diamond 为金色)
2x Stick                   ← 材料(2x 为灰色,Stick 为金色)
5 uses remaining           ← 状态(绿色文字)

    ?                     ← 旋转的 3D 物品

    ?                     ← 基座方块

步骤 3:合成!

  • 收集所示的确切材料
  • 右键点击基座
  • 材料消耗,物品即刻获得!

对于管理员 ?

快速设置:

  1. /pedestal - 获取一个基座方块
  2. 放置在任意位置
  3. 按住 Shift + 右键点击以进行配置
  4. 设置结果物品和材料
  5. 自定义外观和效果
  6. 保存并搞定!

配置 GUI 功能:

  • 结果槽位:玩家获得的物品
  • 材料槽位 (7):合成所需的物品
  • 方块类型:更改基座外观
  • 最大使用次数:设置耐久度(或设为不可破坏)
  • 物品高度:调整悬浮物品的位置
  • 文本高度:控制全息图的位置
  • 物品缩放:使物品变大/变小
  • 信标光束:切换光柱效果
  • 全局公告:启用全服警报

? 命令与权限

命令

命令 别名 描述 权限
/pedestal /ped 获取一个基座方块 pedestalcrafting.admin

权限

权限 默认值 描述
pedestalcrafting.admin OP 创建、配置和管理基座
pedestalcrafting.use Everyone 使用基座合成物品

⚙️ 配置

全息图颜色 (新增!)

hologram:
  colors:
    result-item: WHITE       # 顶部物品名称
    material-name: GOLD      # 材料名称
    material-amount: GRAY    # 数量文本 (1x, 2x 等)
    uses-remaining: GREEN    # 使用次数文本
    unbreakable: GREEN       # 不可破坏文本

可用颜色: WHITE, GRAY, DARK_GRAY, BLACK, RED, DARK_RED, GOLD, YELLOW, GREEN, DARK_GREEN, AQUA, DARK_AQUA, BLUE, DARK_BLUE, LIGHT_PURPLE, DARK_PURPLE

全局公告 (新增!)

global-announcements:
  sound-enabled: true
  sound: BLOCK_END_PORTAL_SPAWN
  sound-volume: 1.0
  sound-pitch: 1.0
  message-enabled: true
  message: "&6[Pedestal] &e{player} &ahas crafted &e{item}&a!"
  show-player: true          # 显示玩家名称或 "Someone"

视觉设置

hologram:
  height: 1.8                # 基座上方的文本高度
  line-spacing: 0.25         # 行间距
  always-visible: true       # 始终显示或基于距离显示
  visibility-range: 10       # 可见范围(格)

item-display:
    height: -0.8             # 物品位置(负值 = 更低)
    rotation-enabled: true   # 启用旋转
    rotation-speed: 3.0      # 每刻度数
    scale: 1.0               # 尺寸倍数

消息

messages:
  prefix: "&8[&6Pedestal&8]&r "
  crafting-success: "&a你制作出了 {item}!"
  insufficient-materials: "&c你没有所需的材料!"
  no-permission: "&c你没有权限执行此操作。"
  config-saved: "&a祭坛配置已保存!"
  pedestal-destroyed: "&e该祭坛已被消耗并销毁。"
  not-configured: "&c该祭坛尚未配置!"

默认值

defaults:
  max-uses: 10               # 默认耐久度
  block-type: STONE          # 默认方块

? 使用场景

? RPG 服务器

  • 任务奖励:完成任务的一次性祭坛
  • Boss 战利品兑换:用 Boss 掉落物交换独特物品
  • 职业装备:针对特定职业的装备供应商
  • 技能解锁:等级进度系统

? 经济服务器

  • 玩家商店:美观的店面展示
  • 货币兑换:代币/金币交易站
  • 批量交易:资源转换亭
  • 限时销售:限时独家商品

⚔️ 生存服务器

  • 自定义配方:替代合成方法
  • 资源回收:经济平衡工具
  • 进度门控:基于等级的进阶
  • 稀有物品来源:难以获得的物品

? 活动服务器

  • 锦标赛奖励:PvP 奖品领取
  • 季节性物品:假日专属制作
  • 成就奖励:里程碑庆祝
  • 特别活动:限时优惠

? 示例配置

1. 传说武器商店

祭坛: 钻石块 + 信标光束
结果: "§6§lExcalibur" (附魔钻石剑)
材料:
  - 10x 钻石
  - 5x 下界合金锭
  - 1x 下界之星
最大使用次数: 10
全局公告: 开启

2. 货币兑换

祭坛: 绿宝石块
结果: 1x 钻石
材料:
  - 100x "§eServer Coins" (自定义代币)
最大使用次数: 不可破坏
全局公告: 关闭

3. 任务完成奖励

祭坛: 末地石 + 信标光束
结果: "§5§lDragon's Gift" (潜影盒)
材料:
  - 1x 龙首
  - 64x 末地石
  - 32x 鞘翅
最大使用次数: 1 (一次性)
全局公告: 开启

4. 批量资源交易

祭坛: 铁块
结果: 64x 箭
材料:
  - 16x 燧石
  - 16x 木棍
  - 16x 羽毛
最大使用次数: 不可破坏
全局公告: 关闭

? 高级功能

独立祭坛覆盖

每个祭坛都可以独立自定义:

  • ✅ 物品高度(覆盖配置默认值)
  • ✅ 物品缩放(覆盖配置默认值)
  • ✅ 文本高度(覆盖配置默认值)
  • ✅ 信标光束(独立开关)
  • ✅ 全局公告(独立开关)

切换控制

在 GUI 中使用 鼠标中键点击 可:

  • 在自定义值和默认值之间切换
  • 快速切换,无需手动重置

高度调整

点击控制:

  • 左键点击:+0.1 格
  • 右键点击:-0.1 格
  • Shift+左键:+0.5 格
  • Shift+右键:-0.5 格

缩放调整

点击控制:

  • 左键点击:+0.1x 尺寸
  • 右键点击:-0.1x 尺寸
  • Shift+左键:+0.5x 尺寸
  • Shift+右键:-0.5x 尺寸

? 技术规格

要求

  • Minecraft: 1.20.6+ 或 1.21.x
  • 服务端: Paper, Purpur 或基于 Paper 的分叉版本
  • Java: 17 或更高
  • API: 带有 Adventure 文本组件的 Paper API

性能

  • 内存: 每 100 个祭坛 <5MB
  • CPU: <0.1% TPS 影响
  • 存储: 每个祭坛约 1KB
  • 异步操作: 零阻塞 I/O

兼容性

  • ✅ WorldGuard (尊重区域)
  • ✅ GriefPrevention (尊重领地)
  • ✅ LuckPerms (权限系统)
  • ✅ EssentialsX (无冲突)
  • ✅ Vault (兼容经济)

数据格式

  • 类型: YAML (人类可读)
  • 位置: plugins/Pedestal-Crafting/pedestals.yml
  • 自动保存: 每次更改时
  • 备份: 建议定期备份

? 为什么选择 Pedestal Crafting?

与村民相比

  • ✅ 无 AI 寻路问题
  • ✅ 精确的配方控制
  • ✅ 美观的视觉展示
  • ✅ 无交易机制

与告示牌商店相比

  • ✅ 3D 全息显示
  • ✅ 动态物品模型
  • ✅ 无需命令语法
  • ✅ 更具沉浸感

与 GUI 菜单相比

  • ✅ 存在于世界中
  • ✅ 无库存杂乱
  • ✅ 更适合探索
  • ✅ 更有氛围

与 NPC 相比

  • ✅ 无需复杂插件
  • ✅ 资源占用更低
  • ✅ 即时交互
  • ✅ 更容易设置

? 功能对比

功能 Pedestal Crafting 村民 告示牌商店 NPC
视觉展示 ✅ 3D + 全息 ❌ ❌ ⚠️ 基础
自定义配方 ✅ 无限 ❌ 有限 ✅ ✅
易于设置 ✅ GUI ❌ 复杂 ⚠️ 命令 ❌ 脚本
动画 ✅ 旋转 ❌ ❌ ⚠️ 部分
全局警报 ✅ 内置 ❌ ❌ ❌
颜色自定义 ✅ 按元素 ❌ ⚠️ 有限 ⚠️ 有限
性能 ✅ 优秀 ⚠️ AI 负载重 ✅ ⚠️ 可变

? 玩家反馈

“全息显示绝对令人惊艳!玩家们喜欢从远处看到他们可以制作什么。” — 生存服务器拥有者

“当有人制作出传说物品时,全局公告能营造兴奋感。对经济类服务器很棒!” — RPG 服务器管理员

“设置非常简单。GUI 让配置变得轻而易举。” — 首次服务器拥有者

“颜色自定义让我能将祭坛完美匹配到我服务器的主题。” — 网络管理员


? 文档

包含的文件

  • PLUGIN_DESCRIPTION.md - 完整功能指南(本文件)
  • README.md - 快速入门指南
  • config.yml - 完全注释的配置
  • BUG_FIXES.md - 故障排除指南
  • HOLOGRAM_IMPROVEMENTS.md - 视觉系统详情
  • REBUILD_INSTRUCTIONS.md - 从源代码构建

其他资源

  • 游戏内工具提示
  • 详细错误信息
  • 配置文件注释
  • 权限说明

? v1.0 更新内容

最新功能

  • ✨ 全局公告:全服制作提醒
  • ? 颜色自定义:配置所有文本颜色
  • ? 文本高度控制:调整全息投影位置
  • ? 信标光束:可选视觉效果
  • ⚙️ 独立基座覆盖:单独自定义设置

近期改进

  • 优化了全息投影渲染
  • 增强了 GUI 响应速度
  • 改进了数据持久化
  • 更好的错误处理
  • 更流畅的动画效果

?️ 故障排除

常见问题

全息投影不可见?

  • 检查配置文件中的 hologram.height
  • 确保区块已加载
  • 尝试破坏并重新放置基座

无法制作?

  • 核实背包中是否有精确的材料
  • 检查 pedestalcrafting.use 权限
  • 确认基座已正确配置

GUI 无法打开?

  • 需要 pedestalcrafting.admin 权限
  • 必须按住 Shift + 右键点击
  • 确保你是基座的所有者/管理员

全局公告不生效?

  • 在基座 GUI 中启用(铃铛图标)
  • 检查配置文件中的 global-announcements.sound-enabled
  • 验证 global-announcements.message-enabled

? 技术支持

获取帮助

  1. 查阅随附文档
  2. 查看配置文件注释
  3. 验证权限设置是否正确
  4. 使用默认配置进行测试
  5. 检查控制台以获取错误信息

最佳实践

  • 定期备份数据
  • 部署前测试配置
  • 合理使用权限
  • 监控服务器性能
  • 保持插件更新

? 结语

Pedestal Crafting 提供专业、精美的自定义制作体验,适用于任何 Minecraft 服务器。凭借出色的视觉效果、强大的功能和直观的控制,它是自定义物品系统的终极解决方案。

核心亮点

  • ? 美观:惊艳的全息投影和动画
  • ⚙️ 强大:丰富的自定义选项
  • ? 性能:为大服务器优化
  • ? 用户友好:管理员和玩家易于上手
  • ? 灵活:适配各类服务器类型
  • ? 创新:独特的全局公告系统

立即提升服务器的制作体验!✨


Pedestal Crafting v1.0 By Orange

Compatible with Minecraft 1.20.6+ / 1.21.x Requires Paper or Paper-based server software

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源