Modding:Простые частицы

Эта страница проверялась в последний раз для версии Vintage Story 1.15.

VintageStory предлагает множество различных типов частиц. Этот урок объяснит вам, как создавать простые частицы, и покажет вам некоторые возможности. Если вы хотите иметь пример того, как их использовать, я либо предложил вам прочитать о блочных частиц или о предметах коллекционирования.

Спавн частиц

Итак, давайте создадим несколько базовых частиц. Я предлагаю создать статическое поле для ваших свойств частиц:

        public static SimpleParticleProperties myParticles = new SimpleParticleProperties(1, 1, ColorUtil.ColorFromArgb(50, 220, 220, 220), new Vec3d(), new Vec3d(), new Vec3f(), new Vec3f());

Теперь у нас есть свойство, осталось только установить положение и создать частицы в мире. Я буду использовать метод OnHeldInteractStart и *Step внутри пользовательского класса Item (подробнее об этом можно прочитать в Collectibles Tutorial):

        public override void OnHeldInteractStart(ItemSlot slot, EntityAgent byEntity, BlockSelection blockSel, EntitySelection entitySel, ref EnumHandHandling handHandling)
        {
            handHandling = EnumHandHandling.Handled;
        }

        public override bool OnHeldInteractStep(float secondsUsed, ItemSlot slot, EntityAgent byEntity, BlockSelection blockSel, EntitySelection entitySel)
        {
            myParticles.minPos = byEntity.Pos.XYZ.Add(0, byEntity.EyeHeight(), 0).Ahead(1f, byEntity.Pos.Pitch, byEntity.Pos.Yaw);
            byEntity.World.SpawnParticles(myParticles);

            return true;
        }

Это создаст несколько белых кубических частиц прямо перед игроком, которые просто упадут на землю.

Обзор свойств

Есть несколько вещей, которые вы можете настроить. Вот обзор, который охватывает все свойства:

Позиция

В основном есть два свойства. Одним из них является свойство minPos, которое определяет точную позицию, в которой будут появляться частицы. addPos относится к этой позиции, как только частица появится, она будет рандомизирована и добавлена к позиции частицы. Если addPos не определен, все частицы будут появляться в определенной позиции.

Та же позиция:

Если мы сейчас установим addPos...

    myParticles.addPos = new Vec3d(0.5, 0.5, 0.5);

... частицы будут появляться в области 0,5³:

Скорость

Это следует так же, как положение. Вы можете настроить минимальную скорость (minPos) и дополнительную скорость (addPos).

    myParticles.minVelocity = new Vec3f(0, 3, 0);

В этом случае все частицы имеют одинаковую скорость (частицы летят в воздухе, но в конечном итоге снова падают):

Срок службы

Это свойство довольно прямолинейно. Продолжительность жизни одного равна одной секунде.

Частицы будут существовать в течение одних 200 миллисекунд...

    myParticles.lifeLength = 0.2F;

Частицы будут существовать одну секунду...

    myParticles.lifeLength = 1F;

Количество

Определяет, сколько частиц будет появляться.

    myParticles.minQuantity = 3;

Это будет порождать 3 частицы каждый тик.

Кроме того, вы можете указать дополнительный шанс количества ...

    myParticles.minQuantity = 0;
    myParticles.addQuantity = 100;

Это создаст от 0 до 100 частиц за тик.

Цвет

Цвет можно указать с помощью RGBA (альфа, красный, зеленый, синий). Все значения имеют диапазон от 0 до 255.

    myParticles.color = ColorUtil.ToRGBABytes(ColorUtil.ColorFromArgb(255, 255, 0, 0));

Это вызовет появление красных частиц...

    Random rand = new Random();
    myParticles.color = ColorUtil.ToRGBABytes(ColorUtil.ColorFromArgb(255, rand.Next(0, 255), rand.Next(0, 255), rand.Next(0, 255)));

Это создаст частицы случайного цвета...

Свечение

Это свойство позволяет определить, будут ли частицы видны в темноте или нет...

    myParticles.glowLevel = 20;

    myParticles.glowLevel = 255;

Гравитация

Эффект гравитации может не только увеличиваться или уменьшаться, ...

    myParticles.gravityEffect = 0.1F;

... но вы также можете отключить его полностью (используя невесомость) или инвертировать его (частицы будут летать вверх).

Размер

Опять же, вы можете указать минимальный размер и дополнительный рандомизированный размер...

    myParticles.minSize = 0.1F;
    myParticles.maxSize = 1.0F;

Кроме того, вы можете указать SizeEvolve вот так...

    myParticles.minSize = 0.1F;
    myParticles.maxSize = 1.0F;
    myParticles.SizeEvolve = new EvolvingNatFloat(EnumTransformFunction.LINEAR, 2);

Существует множество функций EnumTransformFunction, с которыми вы можете поиграться. Линейный — самый простой.

Модель

Есть два типа моделей. Cube (тот, который мы использовали до сих пор) и Quads:

    myParticles.model = EnumParticleModel.Quad;

Непрозрачность

Четырехугольники поддерживают пользовательскую непрозрачность. Это позволяет сделать их прозрачными...

    myParticles.color = ColorUtil.ToRGBABytes(ColorUtil.ColorFromArgb(130, rand.Next(0, 255), rand.Next(0, 255), rand.Next(0, 255)));

Подобно SizeEvolve, вы можете добавить OpacityEvolve...

    myParticles.OpacityEvolve = new EvolvingNatFloat(EnumTransformFunction.LINEAR, -255);

Самоходный

Это свойство заставит частицы не терять свою скорость, даже если они столкнутся с чем-то, как только места будет достаточно, они продолжат лететь в том же направлении (с той же скоростью)...

    myParticles.minVelocity = new Vec3f((float) (rand.NextDouble() - 0.5), 1f, (float) (rand.NextDouble() - 0.5));
    myParticles.SelfPropelled = true;

Умереть в воздухе/жидкости

Это свойство полезно для частиц в воде, которые должны исчезнуть, достигнув поверхности (умереть в жидкости). Конечно, это можно использовать и наоборот (умереть в воздухе).

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.