Setup & loading lab: the area-observer plugin

using System;
using System.Threading.Tasks;
using System.Windows.Controls;
using DreamPoeBot.Loki.Bot;
using DreamPoeBot.Loki.Common;
using DreamPoeBot.Loki.Game;
using log4net;
using Message = DreamPoeBot.Loki.Bot.Message;

namespace DeveloperAcademy
{
    // IPlugin alone does not include Tick, Start or Stop. Opt in explicitly.
    public sealed class AcademyObserver : IPlugin, ITickEvents, IStartStopEvents
    {
        private static readonly ILog Log = Logger.GetLoggerInstanceForType();
        private readonly WaitTimer _interval = new WaitTimer(TimeSpan.FromSeconds(2));
        private UserControl _control;
        private bool _enabled;
        private uint? _lastAreaHash;
        private string _lastAreaId;

        public string Name => "AcademyObserver";
        public string Description => "A read-only first plugin: report the current area.";
        public string Author => "Your name";
        public string Version => "1.0.0";
        public JsonSettings Settings => null; // No persisted settings in this first lesson.
        public UserControl Control => _control ?? (_control = new UserControl
        {
            Content = new TextBlock
            {
                Text = "Enable this plugin, select AcademyBot, then press Start. Watch the log.",
                TextWrapping = System.Windows.TextWrapping.Wrap,
                Margin = new System.Windows.Thickness(12)
            }
        });

        public void Initialize() { }
        public void Deinitialize() { _enabled = false; }
        public void Enable()
        {
            _enabled = true;
            ResetArea();
            Log.Info("[AcademyObserver] Enabled. Waiting for a bot to call Tick.");
        }
        public void Disable() { _enabled = false; Log.Info("[AcademyObserver] Disabled."); }
        public void Start() { ResetArea(); _interval.Stop(); }
        public void Stop() { ResetArea(); }
        private void ResetArea() { _lastAreaHash = null; _lastAreaId = null; }

        #region ObserveArea
        public void Tick()
        {
            if (!_enabled) return;
            // Loading screens and character selection are normal, not errors.
            if (!LokiPoe.IsInGame || LokiPoe.Me == null)
            {
                ResetArea(); // Reacquire state when the player becomes available again.
                return;
            }
            if (!_interval.IsFinished) return;
            _interval.Reset();
            var area = LokiPoe.CurrentWorldArea;
            var hash = LokiPoe.LocalData.AreaHash;
            if (area == null || hash == 0 || (hash == _lastAreaHash && area.Id == _lastAreaId))
                return;

            // Name is a label. Hash identifies the instance; Id also distinguishes local zones.
            _lastAreaHash = hash;
            _lastAreaId = area.Id;
            Log.Info("[AcademyObserver] Area: " + area.Name + " (" + area.Id + ", instance " + hash + ")");
        }
        #endregion

        #region HandleMessage
        public MessageResult Message(Message message)
        {
            // This ID belongs to this sample, not to the DPB platform.
            if (message.Id != "academy.reset-observer")
                return MessageResult.Unprocessed;
            ResetArea();
            return MessageResult.Processed;
        }
        #endregion

        public Task<LogicResult> Logic(Logic logic) => Task.FromResult(LogicResult.Unprovided);
    }
}

using System;
using System.Linq;
using System.Threading.Tasks;
using System.Windows.Controls;
using DreamPoeBot.Loki.Bot;
using DreamPoeBot.Loki.Common;
using DreamPoeBot.Loki.Coroutine;
using DreamPoeBot.Loki.Game;
using log4net;
using Message = DreamPoeBot.Loki.Bot.Message;

namespace DeveloperAcademy
{
    public sealed class AcademyBot : IBot
    {
        private static readonly ILog Log = Logger.GetLoggerInstanceForType();
        private Coroutine _loop;
        private UserControl _control;
        private IPlugin[] _plugins = Array.Empty<IPlugin>();
        private IRoutine _routine;
        private IPlayerMover _mover;
        public string Name => "AcademyBot";
        public string Description => "A teaching host: run the Academy components without game input.";
        public string Author => "Your name";
        public string Version => "1.0.0";
        public JsonSettings Settings => null;
        public UserControl Control => _control ?? (_control = new UserControl
        {
            Content = new TextBlock { Text = "Enable AcademyNearbyAlert or AcademyObserver. Optionally select AcademyRoutine and AcademyMover. This bot only drives named teaching components.",
                TextWrapping = System.Windows.TextWrapping.Wrap, Margin = new System.Windows.Thickness(12) }
        });
        public void Initialize() { }
        public void Deinitialize() { Stop(); }

        #region BotLifecycle
        public void Start()
        {
            Stop();
            // Keep the instances we started, so Stop never targets a later selection.
            _plugins = Observers();
            var selectedRoutine = RoutineManager.Current;
            _routine = selectedRoutine?.Name == "AcademyRoutine" ? selectedRoutine : null;
            var selectedMover = PlayerMoverManager.Current;
            _mover = selectedMover?.Name == "AcademyMover" ? selectedMover : null;
            try
            {
                foreach (var plugin in _plugins)
                    (plugin as IStartStopEvents)?.Start();
                _routine?.Start();
                _mover?.Start();
                _loop = new Coroutine(Run);
            }
            catch { Stop(); throw; }
            Log.Info("[AcademyBot] Started. Observation only; no movement or combat.");
        }

        public void Tick()
        {
            if (_loop == null) return;
            try
            {
                foreach (var plugin in _plugins)
                    (plugin as ITickEvents)?.Tick();
                _routine?.Tick();
                _mover?.Tick();
                if (_loop != null && !_loop.IsFinished)
                    _loop.Resume();
            }
            catch { Stop(); throw; }
        }

        public void Stop()
        {
            var loop = _loop;
            _loop = null;
            try { loop?.Dispose(); }
            finally
            {
                var plugins = _plugins;
                var routine = _routine;
                var mover = _mover;
                _plugins = Array.Empty<IPlugin>();
                _routine = null;
                _mover = null;
                foreach (var plugin in plugins) StopComponent(plugin as IStartStopEvents);
                StopComponent(routine);
                StopComponent(mover);
            }
        }
        private static void StopComponent(IStartStopEvents component)
        {
            try { component?.Stop(); }
            catch (Exception error) { Log.Warn("[AcademyBot] A component failed to stop; continuing cleanup.", error); }
        }
        #endregion

        #region BotLoop
        private async Task Run()
        {
            while (true)
            {
                if (LokiPoe.IsInGame && LokiPoe.Me != null)
                {
                    if (_routine != null)
                        await _routine.Logic(new Logic("academy.inspect-target", this));
                }
                // Return control to DPB between iterations. Never use Thread.Sleep here.
                await Coroutine.Yield();
            }
        }
        #endregion

        // Intentional teaching scope: do not drive unrelated installed extensions.
        // This name check is not an authentication or trust boundary.
        private static IPlugin[] Observers() => PluginManager.EnabledPlugins
            .Where(plugin => plugin.Name == "AcademyObserver" || plugin.Name == "AcademySettings" || plugin.Name == "AcademyNearbyAlert").ToArray();
        public MessageResult Message(Message message) => MessageResult.Unprocessed;
        public Task<LogicResult> Logic(Logic logic) => Task.FromResult(LogicResult.Unprovided);
    }
}