白羊羊
本帖最后由 mimimis 于 2018-2-21 19:11 编辑 ) w! ~! i: \/ I( @
7 d6 D* C+ a" M, k9 z
ItemStack序列化
了解bukkit在保存或加载配置时使用的格式！
本页介绍插件从配置文件保存/加载ItemStack时Bukkit使用的格式。6 v) q" v/ j9 l

" a7 g& F- Z/ a# I# {将新的元数据添加到物品，或者当bukkit / spigot的序列化有变更时，此页面会更新。
% S2 s' s3 o. d9 \$ z1 w7 c2 `$ {4 C当前版本基于：1.12.2-R0.1-SNAPSHOT（从2017.10.15开始）; h6 ^: |/ Y3 r

: i3 r$ j- T* a9 @# F3 A! U根据物品类型，该物品可以包含不同的数据，首先介绍所有项目共有的数据：
8 R$ }5 [; ?6 C. b
  1. path-to-item:
    - ]: k4 h" v7 R. k
  2.    ==: org.bukkit.inventory.ItemStack; j, m8 q7 Z; y: D; @# _. ~( i  Q
  3.    type: <item type name>$ c1 M' y# _4 a' l$ ~/ A! h
  4.    damage: <item data value / durability>
    " E( x9 ~2 [8 \8 k. L
  5.    amount: <stack size>
    8 X& Z% a$ _, h1 }, z' }: u" B
  6.    meta:8 N6 |, Y  _1 I4 {/ P# ^3 Q' G% L
  7.      ==: ItemMeta  a6 M7 i* _* k" J& t  ^8 d" U" H
  8.      meta-type: <meta data type id>
    % D! s' v  q3 g* j& _: R- d
  9.      display-name: <display name># i5 I8 Q: i6 a; G7 B! y
  10.      loc-name: <localized display name>; J7 [/ N8 V1 A$ @' y% ?
  11.      lore:
    " \% B# n+ x/ x8 _! v4 J0 d# x
  12.      - <lore line>
    8 a( Z2 O& `& j6 d/ O8 h6 }
  13.      - < .. more lore lines .. >
    1 x  A( |- W2 W- I+ l7 k
  14.      enchants:
    * d0 U: u6 S9 O( g3 y) }
  15.        <enchantment name>: <enchantment level>7 e  [! A; x. p  O6 p3 @3 B# k
  16.        < .. more enchantment entries .. >
    - e# I, a6 F) l2 \: T
  17.      repair-cost: <repair penalty>" V( G6 C! E/ k1 p5 @
  18.      ItemFlags:
    0 T$ b+ d; U; q( {- _
  19.      - <item flag name>" a( @2 P$ N5 K: i: Y: `. F
  20.      - < .. more item flag names .. >* X! z, ?* B$ h6 H+ j
  21.      Unbreakable: <true|false>
    ( T. l: j$ M- T4 `. H, N( H1 T
  22.      internal: <unhandled data compressed as base64 text>
复制代码
所有物品类型名称可以在这里找到：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html& f. f: C, x4 E" \) d1 H+ M
附魔的名字可以在这里找到：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html
% q# n, z  z$ @% `( |  Z8 N物品标志名称可以在这里找到：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html% V6 \& G4 J" G$ Y4 P

. Z" c5 t' w; D" Q, [4 B meta 部分中的某些物品可以另外包含更具体的数据。 他们的元数据类型标识符和它们存储的数据将逐个介绍。
9 C8 t7 Q! ~/ k& t# c/ v# C& {当某个物品包含未在此处明确列出的数据时，该数据就会存储在上述未处理的 internal 数据中。
+ i% M+ Y5 j% X* C5 t$ E* P8 `! ?: u! ?8 F; _6 I6 {  K( E2 [5 |2 ?
- C0 l! ^) n! }8 o
这里没有列出的物品：: s" @8 t, U1 q2 s/ t
元数据类型ID：UNSPECIFIC
- n( S) n' h* j! e; f  l它只存储上面已经描述的通用元数据。. v# r9 J4 @2 }+ a/ x4 G. ^
5 H4 E' N* {1 c- z7 G2 e' Z7 l
旗帜:
3 i6 |* e( C# _, z 元数据类型ID: BANNER
7 g: m7 I" F0 I6 ~6 J/ v
  1. base-color: <color name>
    - j- Z$ Z* Q4 ^# a. n
  2. patterns:
    . j% l) \) j# R/ x
  3. - ==: Pattern
    9 {9 G( W7 o4 S& R) d
  4. color: <color name># y  l! s: D5 C9 N+ S: Y
  5. pattern: <pattern code>
    . j; }; y& T5 p
  6. - < .. more patterns .. >
复制代码
所有颜色名称的列表可以在这里找到：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/DyeColor.html
' F% U. b/ B; t9 L6 k/ r" o# w所有图案代码的列表可以在这里找到：http://minecraft.gamepedia.com/Banner/Patterns
" q; Q( g) s/ U  v4 w" ]/ v+ v- U5 F, @6 c" a8 g9 Q! o  H
方块实体:
, V: z: v8 v6 m2 A元数据类型ID: TILE_ENTITY
$ z9 ~. f3 i  p: l3 a/ k( H" A
  1. blockMaterial: <item type>
复制代码
请参阅minecraft wiki以获取方块实体列表：http://minecraft.gamepedia.com/Block_entity1 a& N5 ~! O/ d& w8 N0 }. Z
目前将所有数据存储在 internal 数据中。
6 u5 Z* U4 y5 \' m! K% ?7 X$ r; t" a0 y
书与笔:9 a/ y. U' R' v  u
元数据类型ID：BOOK2 R+ T0 T" z2 H5 T
  1. title：<book title>
    ' A% n" K0 U  t0 w
  2. author：<author name> + N/ s0 l' x  y2 i4 E/ K7 f
  3. pages：- K1 ?1 O& n1 }' a$ n3 w2 j% a
  4. - <page text> 9 u3 ~' z% o6 r/ c' k0 E9 q( {4 R1 _) T, [1 h
  5. - <.. more pages ..>
    4 W" _( w* c  d! ?4 p
  6. generation：<generation code>
复制代码
生成代码可以在这里找到：http://minecraft.gamepedia.com/Written_book#Data_values) e; e8 N# V7 O3 m

7 E, n! W3 V# c' I$ P! Y2 w成书:
, b: Q. v& `( ]3 t元数据类型ID：BOOK_SIGNED 9 u# X" J+ \5 J+ n( a2 _
存储与书与笔相同的数据。' j  l4 \% E. k  T0 q

7 X7 Y, U3 g3 U/ r2 N: P头颅:
& w5 ], `# {2 |8 q) I元数据类型: SKULL
  1. skull-owner: <skull profile name>
复制代码
仅配置文件名称被存储。
6 }$ E+ _. {! K; O) Y, R
6 ~! L; H: F! J- A% K' |
, z0 p0 y7 h) o
第一页 上一页 下一页 最后一页