这是本文档旧的修订版！

---



📚 World/Prop

Prop类是一个抽象概念类，主要用于Prop背包物品及游戏道具相关功能使用。

此类下所有的属性均是以抽象概念为基础的，具体物品的逻辑实现由开发者自行编写（例如物品磨损、武器子弹数量等）。

📒 Property

📘 prop.ID

prop.ID: int

📘 prop.Model

prop.Model: int

📘 prop.UUID

prop.UUID: string

📘 prop.Name

prop.Name: string

📘 prop.Tag

prop.Tag: string

📘 prop.Amount

prop.Amount = 1; //int

📘 prop.Data

prop.Data = {}; //any

//实现一个武器子弹功能
let chara = Character.Create(...);
 
//两种方式相同，建议优先考虑第一种
[1] chara.SetProp(0, 3, 1, {Bullet: 1000});
[2] chara.SetProp(0, 3, 1);
	chara.Prop.Data.Bullet = 1000;
 
//子弹功能属性实现完成，下面实现【子弹检测逻辑】
function OnCharacterPropActionBefore( character, prop )
{
    if(prop.Data.Bullet != null)
    {
        if(prop.Data.Bullet > 0) prop.Data.Bullet --;
        else{
            //子弹不足
            return 0; //阻止武器继续使用
        }
    }
}

补充：尽管在JavaScript里允许使用例如chara.Prop.BulletXXX这种直接字段赋值的方式，但考虑到生命周期和GC的问题，建议优先使用示例中的推荐做法（prop.Data.XXX）。

📒 Value Property

📘 prop.Damage

prop.Damage = 0; //int

📘 prop.DamageRange

prop.DamageRange = 0.8; //float

📘 prop.DamageShake

prop.DamageShake = 1.0; //float

📘 prop.Distance

prop.Distance = 0.0; //float

📘 prop.Direction

prop.Direction = 2; //int

📘 prop.PreloadTime

prop.PreloadTime = 1.0; //float

📘 prop.Speed

prop.Speed = 1.0; //float

📘 prop.MoveSpeedMultiplier

prop.MoveSpeedMultiplier = 1.0; //float

📘 prop.Flags

prop.Flags: int

📘 prop.Multiple

prop.Multiple: int

📒 Function

📘 prop.ExistFlag()

function prop.ExistFlag( flag: int ): bool

📘 prop.AddFlag()

function prop.AddFlag( flag: int )

📘 prop.RemoveFlag()

function prop.RemoveFlag( flag: int )