Grinder FSM

1// Définition déclarative de la structure multiblock
2private static readonly StructureBuilder Structure = new StructureBuilder("grinder")
3    .AddRectangleOutline(new Vector3Int(-1, -1, 1), new Vector3Int(1, -1, -1), Blocks.GrinderFrame)
4    .AddBlock(new Vector3Int(0, -1, 0), Blocks.GrinderCasing)
5    .AddBlock(new Vector3Int(0,  0, 0), Blocks.Lava)
6    .Add3DRectangleOutline(
7        new Vector3Int(-1, 0, 1), new Vector3Int(1, 0, -1),
8        Blocks.GrinderCasing, Blocks.GrinderFrame)
9    .AddBlock(new Vector3Int(-1, 0, 0), Blocks.GrinderForge)
10    .AddRectangleOutline(new Vector3Int(-1, 1, 1), new Vector3Int(1, 1, -1), Blocks.GrinderFrame)
11    .SetController(new Vector3Int(-1, 0, 0));  // bloc contrôleur

1// Validation du carburant déposé par le joueur
2private AddFuelResult TryAddFuel(ItemStack itemStack, int amount) {
3    if (!itemStack.HasComponent(GrinderFuelComponent.Id))
4        return AddFuelResult.NotFuel;
5
6    var fuel = itemStack.GetComponent<GrinderFuelComponent>(GrinderFuelComponent.Id);
7    int fuelAmount = amount * fuel.FuelAmount;
8
9    if (fuelAmount + _fuelAmount > GetComponent.MaxFuel)
10        return AddFuelResult.MaxFuelReached;
11
12    if (_fuelIdentifier != Items.Air && fuel.FuelIdentifier != _fuelIdentifier)
13        return AddFuelResult.InvalidFuel;
14
15    AddFuel(fuelAmount);
16    return AddFuelResult.Success;
17}
18
19// Mise à jour UI ciblée — 1 packet par composant
20private void AddFuel(int amount) {
21    _fuelAmount = Math.Clamp(_fuelAmount + amount, 0, GetComponent.MaxFuel);
22    _ui.FuelProgress.SeveralContext.StringValue = GetFuelProgress().ToString();
23    _ui.UpdateComponent(_ui.FuelProgress);
24    _ui.FuelAmount.SeveralContext.StringValue = _fuelAmount + "/" + GetComponent.MaxFuel;
25    _ui.UpdateComponent(_ui.FuelAmount);
26}

1// Base commune de tous les états
2public abstract class AbstractGrinderModuleState<T>(T module) : IGrinderModuleState
3    where T : IGrinderModule {
4
5    public T Module { get; } = module;
6    public abstract int State { get; }
7
8    // Implémentations par défaut neutres — seules les méthodes utiles sont surchargées
9    public virtual bool OnUpdate(...)                    => true;
10    public virtual bool OnEnter(...)                     => true;
11    public virtual void OnExit(...)                      { }
12    public virtual void OnBreak(...)                     { }
13    public virtual bool OnUseOn(...)                     => false;
14    public virtual bool OnGrinderStructureActive(...)    => true;
15    public virtual bool OnGrinderStructureUnActive(...)  => true;
16
17    // Par défaut : pas de transition
18    public virtual int GetNextState(GrinderModuleContextState ctx, bool context) => State;
19}

1// Moteur centralisé de transition
2public void TryNextState(IGrinderModuleState moduleState, GrinderModuleContextState ctx,
3    bool context, ILevel level, Vector3Int position, Block block) {
4
5    if (block.Identifier != level.GetBlock(position).Identifier) return; // sécurité monde dynamique
6
7    int next = moduleState.GetNextState(ctx, context);
8    if (next == moduleState.State) return;
9
10    SetState(next, level, block, position, newState: true);
11}
12
13private void ChangeState(int next, int old, ILevel level, Vector3Int position, Block block) {
14    GetModule().States[old].OnExit(level, position, block);
15    bool result = GetModule().States[next].OnEnter(level, position, block);
16
17    // OnEnter peut échouer → relance immédiate (rollback vers Idle possible)
18    TryNextState(GetModule().States[next], GrinderModuleContextState.OnEnter, result, level, position, block);
19}
20
21// Interaction joueur
22public override void OnInteract(..., Player player) {
23    int state = GetState(block);
24    var current = GetModule().States[state];
25    bool result = current.OnUseOn(block, level, position, item, slot, face, player);
26    TryNextState(current, GrinderModuleContextState.OnUseOn, result, level, position, block);
27}

1// Spawn d'une entité animée + timer module
2public void CreateAnimation(Vector3Int position, Vector3 worldPos, Identifier entityId, long ticks) {
3    SetModuleTimer(position, ticks);
4    var entity = GetLevel().SpawnEntity(entityId, new Location(worldPos));
5    _moduleActualAnimation[position] = (entityId, entity.Id);
6}
7
8// Nettoyage propre
9public void RemoveAnimation(Vector3Int position) {
10    _moduleTimer.TryRemove(position, out _);
11    if (!_moduleActualAnimation.TryGetValue(position, out var data)) return;
12    if (GetLevel().GetEntityManager().TryGetEntity(data.EntityId, out var entity)
13        && entity.Identifier == data.Identifier)
14        entity.DespawnFromAll();
15    _moduleActualAnimation.TryRemove(position, out _);
16}
17
18// Les deux animations du robinet
19public static void CreateUseAnimation(GrinderBlockEntity grinder, Vector3Int pos) =>
20    grinder.CreateAnimation(pos, pos + new Vector3(0.5f, 0.86f, 0.5f),
21        Entities.FaucetUseAnimation, FaucetAnimationUseTick);         // 20 ticks
22
23public static void CreateWorkingAnimation(GrinderBlockEntity grinder, Vector3Int pos) =>
24    grinder.CreateAnimation(pos, pos + new Vector3(0.5f, -0.01f, 0.5f),
25        Entities.FaucetFlowingAnimation, FaucetAnimationWorkingTick); // 50 ticks

1// Donnée complète d'un pattern
2public sealed record PatternDescriptor(
3    PatternType Type,       // Enum : Sword, Axe, Hammer…
4    Identifier PatternItem, // Item posé par le joueur
5    Identifier OutputItem,  // Item produit par la machine
6    int Cost                // Coût en fuel
7);
8
9// Liste des patterns disponibles
10public readonly List<PatternDescriptor> Patterns = [
11    new(PatternType.Sword,   Items.PatternSword,   Items.HeadSword,   Cost: 2),
12    new(PatternType.Pickaxe, Items.PatternPickaxe, Items.HeadPickaxe, Cost: 3),
13    new(PatternType.Hammer,  Items.PatternHammer,  Items.HeadHammer,  Cost: 12),
14    // ...
15];
16
17// Pose du pattern → block state (pas de NBT nécessaire)
18public static void SetPattern(ILevel level, Vector3Int pos, Block block, PatternType pattern) {
19    var newBlock = block.ComputeBlockState(BlockProps.Pattern, (int)pattern).GetBlock();
20    level.SetBlock(newBlock, pos, 0, false);
21}
22
23// Drop adaptatif selon l'état courant
24public void HandleDrop(Block block, ILevel level, Vector3 pos, bool all = false) {
25    if (!TryGetPatternDescriptor(block, out var pattern)) return;
26    bool dropped = false;
27    if (GrinderModuleBlockComponent.GetState(block) == WaitOutput) {
28        level.DropItem(pos + OffsetDrop, new ItemStack(pattern.OutputItem));
29        dropped = true;
30    }
31    if (!dropped || all)
32        level.DropItem(pos + OffsetDrop, new ItemStack(pattern.PatternItem));
33    level.SendChunkSound(pos, Sounds.Pop, 0.8f);
34}