OdvenTure-Core

Odventure Core

为 Minecraft 添加两类展示型方块：奖杯基座与奖章。把方块、物品、刷怪蛋（奖杯）或物品（奖章）放进去展示并自定义名称。成品可作为物品取回，数据随物品保存，重新放置即可还原。

• 平台：Minecraft 1.20.1 / Forge 47.x
• Mod ID：odventure_core
• 作者：liluo23

---

功能

奖杯基座

• 平滑石材质的矮台座，放置时朝向玩家。
• 手持方块、物品或刷怪蛋右键放入展示：
  • 方块 -> 在台座上方渲染该方块
  • 物品 -> 渲染物品 3D 模型
  • 刷怪蛋 -> 渲染对应实体的成体，按体型自动缩放到统一大小
• 放入内容后台座变为整格碰撞。
• 创造模式下可调整展示物的缩放、旋转角度与高度偏移。

奖章

• 贴墙的金牌，放置时贴向被点击的墙面。
• 可挂载在完整方块、各类玻璃、萤石上；台阶、楼梯、栅栏、墙、花盆等不完整方块无法挂载。
• 支撑方块被移除时自动掉落。
• 手持物品右键嵌入展示，物品显示在金牌中央。

通用交互

• 内容与名称各自独立上锁。放入内容后锁定内容，命名后锁定名称。
• 潜行右键或破坏方块取回成品。成品为带数据的物品，重新放置还原展示并保持锁定状态。
• 准心指向时，方块上方显示悬浮名牌，支持 § 颜色代码。
• 物品悬停显示自定义名与展示内容名。
• 铁砧无法对成品改名，名称统一通过游戏内命名界面设置。

---

使用方法

1. 从创造栏「Odventure」取出空奖杯基座或空奖章。
2. 放置到世界中。
3. 手持要展示的内容右键放入，内容随即锁定。
4. 空手右键打开命名界面，输入名称后确认，名称随即锁定。
5. 潜行右键或破坏方块取回成品；重新放置可还原。

---

掉落处理

破坏掉落由代码处理（方块直接返回带数据的物品），因此本模组不附带战利品表。破坏展示方块一定会得到带完整数据的成品。

如果你更想用数据包的战利品表来控制掉落，可以自行覆盖。方块实体的字段存在顶层，用 copy_nbt 函数即可复制进 BlockEntityTag。奖杯示例：

{
  "type": "minecraft:block",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "odventure_core:trophy_base",
          "functions": [
            {
              "function": "minecraft:copy_nbt",
              "source": "block_entity",
              "ops": [
                { "source": "ContentType",   "target": "BlockEntityTag.ContentType",   "op": "replace" },
                { "source": "ContentId",     "target": "BlockEntityTag.ContentId",     "op": "replace" },
                { "source": "CustomName",    "target": "BlockEntityTag.CustomName",    "op": "replace" },
                { "source": "ContentLocked", "target": "BlockEntityTag.ContentLocked", "op": "replace" },
                { "source": "NameLocked",    "target": "BlockEntityTag.NameLocked",    "op": "replace" },
                { "source": "DisplayScale",  "target": "BlockEntityTag.DisplayScale",  "op": "replace" },
                { "source": "DisplayYaw",    "target": "BlockEntityTag.DisplayYaw",    "op": "replace" },
                { "source": "DisplayY",      "target": "BlockEntityTag.DisplayY",      "op": "replace" }
              ]
            }
          ]
        }
      ]
    }
  ]
}

注意：要启用战利品表，必须移除方块里的 getDrops 重写，否则代码路径优先。

---

发放成品（指令）

成品就是一个数据存在 BlockEntityTag 下的物品，可用 /give 发放。

展示钻石、名字带金色代码的奖杯：

/give @p odventure_core:trophy_base{BlockEntityTag:{ContentType:"ITEM",ContentId:"minecraft:diamond",ContentLocked:1b,CustomName:"§6冠军奖杯",NameLocked:1b,DisplayScale:1.0f,DisplayYaw:0.0f,DisplayY:0.0f}}

展示苦力怕（实体）、略微缩小的奖杯：

/give @p odventure_core:trophy_base{BlockEntityTag:{ContentType:"ENTITY",ContentId:"minecraft:creeper",ContentLocked:1b,CustomName:"§aBoss终结者",NameLocked:1b,DisplayScale:0.8f,DisplayYaw:0.0f,DisplayY:0.0f}}

嵌入下界之星的奖章：

/give @p odventure_core:medal{BlockEntityTag:{EmbeddedItem:{id:"minecraft:nether_star",Count:1b},ContentLocked:1b,CustomName:"§b最佳勇士",NameLocked:1b}}

---

FTB 任务奖励

本模组开箱兼容 FTB Quests 的物品奖励，因为所有数据都存在标准物品 NBT（BlockEntityTag）里，任务奖励的序列化会原样保留它。

两种配置方式：

1. 游戏内捕获：先拿到成品（制作、取回，或用上面的 /give），在 FTB Quests 编辑器里添加物品奖励并从背包选取，NBT 会一并被记录。
2. 用脚本调 API（如 KubeJS）。调用 OdventureCoreAPI 构造出精确的物品，作为奖励物品使用。

KubeJS 示例（服务端脚本），构造一个奖杯奖励物品：

// kubejs/server_scripts/odventure_reward.js
const API = Java.loadClass('com.odventure.core.api.OdventureCoreAPI')
const ContentType = Java.loadClass('com.odventure.core.data.TrophyData$ContentType')
const ResourceLocation = Java.loadClass('net.minecraft.resources.ResourceLocation')

global.makeChampionTrophy = () => {
    return API.createTrophy(
        ContentType.ITEM,
        new ResourceLocation('minecraft', 'diamond'),
        '§6冠军奖杯',
        1.0, 0.0, 0.0
    )
}

得到的 ItemStack 可用在任何接受奖励物品的地方。

---

API

门面类：com.odventure.core.api.OdventureCoreAPI

// 构造成品
ItemStack createTrophy(TrophyData.ContentType type, ResourceLocation contentId, String name)
ItemStack createTrophy(TrophyData.ContentType type, ResourceLocation contentId, String name,
                       float displayScale, float displayYaw, float displayY)
ItemStack createMedal(ItemStack embedded, String name)

// 写入世界中已存在的展示方块
boolean writeTrophy(Level level, BlockPos pos, TrophyData data)
boolean writeMedal(Level level, BlockPos pos, MedalData data)

// 读取
TrophyData readTrophy(ItemStack stack)
TrophyData readTrophy(Level level, BlockPos pos)
MedalData readMedal(ItemStack stack)
MedalData readMedal(Level level, BlockPos pos)

TrophyData 通过 getDisplayScale()/setDisplayScale(float)、getDisplayYaw()/setDisplayYaw(float)、getDisplayY()/setDisplayY(float) 暴露展示参数。MedalData 没有展示参数。

TrophyData 与 MedalData 均为 public，字段语义见类内注释。

---

兼容性说明

• 部分实体（末影龙、凋灵等）模型复杂或需要特殊上下文，渲染时受体型缩放与异常保护处理；个别实体可能显示效果有限，但不会导致游戏崩溃。
• 渲染异常的实体会被自动跳过。

---

许可

保留所有权利（All Rights Reserved）。