Добавляем простой клаксон

​

Entities, components и systems

​

Entities

​

Components

1. Помечать определённые entity как имеющие определённое поведение. Например, в одной конкретной игре entity, представленная целым числом 37629, содержит NukeComponent и ActivatableUIComponent. Это означает, что эта entity ведёт себя как ядерная бомба, а также имеет пользовательский интерфейс, который можно вызвать, активировав её.
2. Хранить данные, необходимые для обработки её поведения. Например, NukeComponent может иметь поле данных Timer, которое представляет, сколько времени осталось до детонации бомбы.

​

Systems

​

Как мне создать Entity и дать ей Components?

- type: entity
  parent: BaseItem
  id: Skub
  name: skub
  description: Skub is the fifth Chaos God.
  components:
  - type: Sprite
    sprite: Objects/Misc/skub.rsi
    state: icon
  - type: Item
  - type: ItemCooldown
  - type: EmitSoundOnUse
    sound: /Audio/Items/skub.ogg
  - type: UseDelay
    delay: 2.0

​

Итак, я хочу бибикать!

- type: entity
  name: clown horn
  parent: BaseItem
  id: ClownHorn
  description: It goes honk honk!
  components:
  - type: Sprite
    sprite: Objects/Fun/bikehorn.rsi
    state: icon

​

Создание нашего компонента

​

Парадигма клиент-сервер

• СЕРВЕР и КЛИЕНТ выполняются РАЗДЕЛЬНО.
• Сервер должен обрабатывать большую часть логики для предотвращения эксплойтов. Всё, что находится на клиенте, может быть изменено злоумышленником.

• Клиент отправляет «Я использую этот предмет» на сервер.
• Сервер получает это, проверяет, имеет ли это смысл, и отправляет «воспроизвести бибик» всем клиентам в радиусе.
• Клиент получает это и воспроизводит «бибик».

​

Базовая реализация компонента

// Content.Server/Sound/PlaySoundOnUseComponent.cs

namespace Content.Server.Sound;

[RegisterComponent]
public sealed partial class PlaySoundOnUseComponent : Component
{
}

- type: entity
  name: clown horn
  parent: BaseItem
  id: ClownHorn
  description: It goes honk honk!
  components:
  - type: Sprite
    sprite: Objects/Fun/bikehorn.rsi
    state: icon
  - type: PlaySoundOnUse

// Content.Server/Sound/PlaySoundOnUseComponent.cs

namespace Content.Server.Sound;

[RegisterComponent]
public sealed partial class PlaySoundOnUseComponent : Component
{
    [DataField]
    public string Sound = string.Empty;
}

- type: entity
  name: clown horn
  parent: BaseItem
  id: ClownHorn
  description: It goes honk honk!
  components:
  - type: Sprite
    sprite: Objects/Fun/bikehorn.rsi
    state: icon
  - type: PlaySoundOnUse
    sound: /Audio/Items/bikehorn.ogg

​

Создание нашего EntitySystem

// Content.Server/Sound/PlaySoundOnUseSystem.cs

namespace Content.Server.Sound;
    
public sealed class PlaySoundOnUseSystem : EntitySystem
{

}

// Content.Server/Sound/PlaySoundOnUseSystem.cs

namespace Content.Server.Sound;

public sealed class PlaySoundOnUseSystem : EntitySystem
{
    public override void Initialize()
    {
        SubscribeLocalEvent<PlaySoundOnUseComponent, UseInHandEvent>(OnUseInHand);
    }
}

• UID (уникальный идентификатор) entity, на которой было вызвано событие
• Компонент, указанный в подписке, чтобы вы могли получить доступ к его данным и использовать их для изменения поведения
• Само событие, которое содержит полезные данные, такие как entity, которая активировала предмет.

namespace Content.Server.Sound;

public sealed class PlaySoundOnUseSystem : EntitySystem
{
    [Dependency] private readonly SharedAudioSystem _audio = default!;
    
    public override void Initialize()
    {
        SubscribeLocalEvent<PlaySoundOnUseComponent, UseInHandEvent>(OnUseInHand);
    }

    private void OnUseInHand(Entity<PlaySoundOnUseComponent> ent, ref UseInHandEvent args)
    {

    }
}

private void OnUseInHand(Entity<PlaySoundOnUseComponent> ent, ref UseInHandEvent args)
{
    _audio.PlayPvs(ent.Comp.Sound, ent.Owner);
}

1. Звук для воспроизведения.

2. Исходная entity

​

На этом всё

• Попробуйте реализовать клаксон с использованием существующих компонентов. Вы можете обратиться к skub.yml выше на этой странице.
• Добавьте задержку нажатия, добавив ItemCooldown в ваш прототип и вызывая RefreshItemCooldownEvent.
• Настройте громкость/вариативность воспроизводимого звука (см. аргумент audioParams функции PlayPvs()).
• Сделайте так, чтобы звук также воспроизводился, когда на клаксон наступают.
  • Это довольно сложно и включает добавление большого количества новых данных! Посмотрите на стекло (glass shards) в качестве примера.
• Сделайте так, чтобы клаксон наносил урон при атаке с помощью MeleeWeaponComponent.
• Сделайте клаксон съедобным с помощью FoodComponent и SolutionContainerComponent.
• Добавьте поддержку воспроизведения случайного звука из SoundCollection или SoundSpecifier вместо одного звука (настоящий EmitSoundOnUse делает это, если вам нужны подсказки).
• Погрузитесь в код взрывов и дайте ему 5% шанс взорваться при каждом бибикании!